Gist command-line tool
Perl
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib/App
Changes
README.pod
dist.ini

README.pod

#!/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 L<Config::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 <alexbio@cpan.org>

=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