gist
gist copied to clipboard
ghedo
Gist command-line tool
#!/usr/bin/perl
use strict; use warnings;
use App::gist;
=head1 NAME
gist - Gist command-line tool
=cut
=head1 SYNOPSIS
gist [OPTIONS] FILE
=over
=item Create a new gist from a file
$ gist script.pl
=item Create a new gist from a pipe with a description
$ cat script.pl | gist -d 'some script' -n script.pl
=item 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
=back
=cut
App::gist -> run;
=head1 OPTIONS
=over 4
=item B<--description>, B<-d> DESCRIPTION
Set the description for the gist.
=item B<--name>, B<-n> NAME
Specify the name of the file (useful when using a pipe).
=item B<--update>, B<-u> GIST_ID
Update the given gist (identified by GIST_ID), with the given file.
=item B<--private>, B<-p>
Create a private gist.
=item B<--web>, B<-w>
Only output the web url.
=back
=head1 CONFIGURATION
Configure git with your GitHub credentials:
$ git config --global github.user LoginName
$ git config --global github.password GitHubPassword
Alternatively you can install LConfig::Identity and write your credentials in the (optionally GPG-encrypted) C<~/.github> file as follows:
login LoginName
password GitHubpassword
(if only the login name is set, the password will be asked interactively)
=head1 AUTHOR
Alessandro Ghedini [email protected]
=head1 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.
=cut
ghedo