NAME

       dpt-github-oauth - Generate GitHub OAuth2 token

SYNOPSIS

        dpt 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 or
       ~/.config/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.