SYNOPSIS

github-oauth [note-text]

DESCRIPTION

dpt github-oauth can be used for obtaining an OAuth2 token for authenticating to GitHub services without the need to enter your password on every request. The reason for this script is to allow you to populate the "DPT_GITHUB_OAUTH" setting in dpt.conf easily.

You cannot obtain an OAuth2 token with this script if you have two-factor authentication (2FA) enabled on GitHub.

An alternative method for obtaining the token is to use the GitHub web interface, Applications->Personal Access Tokens.

The token obtained with this program is authorized only for reporting issues.

The only supported argument, note-text, is a short note associated with the token. It is used for easy distinguishing different tokens and their purpose. If not specified, the string "pkg-perl-tools on host $HOSTNAME" is used, where $HOSTNAME is obtained via Sys::Hostname.

The GitHub user name and password are prompted for and can't be supplied as command-line options.

LICENSE AND COPYRIGHT

Copyright 2014 Damyan Ivanov.

Copyright 2016 Alex Muntada.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.