#!/usr/bin/perl

use strict;
use warnings;

use App::gist;

=head1 NAME

gist - GitHub Gist creator

=head1 VERSION

version 0.11

=cut

=head1 SYNOPSIS

 gist [OPTIONS] FILE

 Options:
   --description, -d  DESCRIPTION
   --update, -u       GIST_ID
   --private, -p
   --web, -w

 Examples:
   $ gist script.pl
   $ cat script | gist
   $ echo "something" | gist -w | xclip
   $ echo "something" | gist -w | pbcopy # on Mac OS X

=cut

App::gist -> run;

=head1 OPTIONS

=over 4

=item B<--description>, B<-d> DESCRIPTION

Set the description for the gist.

=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
