ghedo/gist

Gist command-line tool

NAME

gist - Gist command-line tool

SYNOPSIS

gist [OPTIONS] FILE

Create a new gist from a file

$ gist script.pl

Create a new gist from a pipe with a description

$ cat script.pl | gist -d 'some script' -n script.pl

Create a new gist and copy the web URL in the clipboard

$ echo "something" | gist -w | xclip
$ echo "something" | gist -w | pbcopy # on Mac OS X

OPTIONS

--description, -d DESCRIPTION

Set the description for the gist.

--name, -n NAME

Specify the name of the file (useful when using a pipe).

--update, -u GIST_ID

Update the given gist (identified by GIST_ID), with the given file.

--private, -p

Create a private gist.

--web, -w

Only output the web url.

CONFIGURATION

Configure git with your GitHub credentials:

$ git config --global github.user LoginName
$ git config --global github.password GitHubPassword

Alternatively you can install Config::Identity and write your credentials in the (optionally GPG-encrypted) ~/.github file as follows:

login LoginName
password GitHubpassword

(if only the login name is set, the password will be asked interactively)

AUTHOR

Alessandro Ghedini <[email protected]>

LICENSE AND COPYRIGHT

Copyright 2011 Alessandro Ghedini.

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.

gist's Issues

Two-factor auth appears to break app

If I set up my ~/.github config file as:

user somename
password somepass
token sometoken

I get the error:

Err: Login with GitHub token is deprecated.

If I comment or remove the token declaration line from the config file, I get:

Err: Must specify two-factor authentication OTP code..

The two-factor authentication is strongly encouraged, so I'm wondering about the rationale behind the 'deprecated' message and also I'd like to know if there is a workaround in this case.