net::github(3pm) [debian man page]

Net::GitHub(3pm)					User Contributed Perl Documentation					  Net::GitHub(3pm)

NAME

       Net::GitHub - Perl Interface for github.com

SYNOPSIS

	   use Net::GitHub;

	   # default to v3
	   my $github = Net::GitHub->new(  # Net::GitHub::V3
	       login => 'fayland', pass => 'secret'
	   );

	   # suggested
	   # use OAuth to create token with user/pass
	   my $github = Net::GitHub->new(  # Net::GitHub::V3
	       access_token => $token
	   );

	   # for backwards, NOTE: Github will terminate API v1 and API v2 in 1 month on May 1st, 2012
	   my $github = Net::GitHub->new(
	       version => 2,
	       owner => 'fayland', name => 'perl-net-github'
	   );

	   # for V3
	   # L<Net::GitHub::V3::Users>
	   my $user = $github->user->show('nothingmuch');
	   $github->user->update( bio => 'Just Another Perl Programmer' );

	   # L<Net::GitHub::V3::Repos>
	   my @repos = $github->repos->list;
	   my $rp = $github->repos->create( {
	       "name" => "Hello-World",
	       "description" => "This is your first repo",
	       "homepage" => "https://github.com"
	   } );

DESCRIPTION

       <http://github.com> is a popular git host.

       This distribution provides easy methods to access GitHub via their APIs.

       Check <http://developer.github.com/> for more details of the GitHub APIs.

       Read Net::GitHub::V3 for API usage.

       If you prefer object oriented way, Pithub is 'There is more than one way to do it'.

   FAQ
       o   create access_token for Non-Web Application

	       my $gh = Net::GitHub::V3->new( login => 'fayland', pass => 'secret' );
	       my $oauth = $gh->oauth;
	       my $o = $oauth->create_authorization( {
		   scopes => ['user', 'public_repo', 'repo', 'gist'], # just ['public_repo']
		   note   => 'test purpose',
	       } );
	       print $o->{token};

	   after create the token, you can use it without your password publicly written

	       my $github = Net::GitHub->new(
		   access_token => $token, # from above
	       );

Git
       http://github.com/fayland/perl-net-github/ <http://github.com/fayland/perl-net-github/>

SEE ALSO

       Any::Moose, Pithub

AUTHOR

       Fayland Lam, "<fayland at gmail.com>"

       Everyone who is listed in Changes.

COPYRIGHT &; LICENSE
       Copyright 2009-2012 Fayland Lam all rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-05-07							  Net::GitHub(3pm)

Pod::Simple::PullParserEndToken(3pm)			User Contributed Perl Documentation		      Pod::Simple::PullParserEndToken(3pm)

NAME

       Pod::Simple::PullParserEndToken -- end-tokens from Pod::Simple::PullParser

SYNOPSIS

       (See Pod::Simple::PullParser)

DESCRIPTION

       When you do $parser->get_token on a Pod::Simple::PullParser, you might get an object of this class.

       This is a subclass of Pod::Simple::PullParserToken and inherits all its methods, and adds these methods:

       $token->tagname
	   This returns the tagname for this end-token object.	For example, parsing a "=head1 ..." line will give you a start-token with the
	   tagname of "head1", token(s) for its content, and then an end-token with the tagname of "head1".

       $token->tagname(somestring)
	   This changes the tagname for this end-token object.	You probably won't need to do this.

       $token->tag(...)
	   A shortcut for $token->tagname(...)

       $token->is_tag(somestring) or $token->is_tagname(somestring)
	   These are shortcuts for "$token->tag() eq somestring"

       You're unlikely to ever need to construct an object of this class for yourself, but if you want to, call
       "Pod::Simple::PullParserEndToken->new( tagname )"

SEE ALSO

       Pod::Simple::PullParserToken, Pod::Simple, Pod::Simple::Subclassing

SUPPORT

       Questions or discussion about POD and Pod::Simple should be sent to the pod-people@perl.org mail list. Send an empty email to
       pod-people-subscribe@perl.org to subscribe.

       This module is managed in an open GitHub repository, http://github.com/theory/pod-simple/ <http://github.com/theory/pod-simple/>. Feel free
       to fork and contribute, or to clone git://github.com/theory/pod-simple.git <git://github.com/theory/pod-simple.git> and send patches!

       Patches against Pod::Simple are welcome. Please send bug reports to <bug-pod-simple@rt.cpan.org>.

COPYRIGHT AND DISCLAIMERS

       Copyright (c) 2002 Sean M. Burke.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of
       merchantability or fitness for a particular purpose.

AUTHOR

       Pod::Simple was created by Sean M. Burke <sburke@cpan.org>.  But don't bother him, he's retired.

       Pod::Simple is maintained by:

       o   Allison Randal "allison@perl.org"

       o   Hans Dieter Pearcey "hdp@cpan.org"

       o   David E. Wheeler "dwheeler@cpan.org"

perl v5.14.2							    2012-05-23				      Pod::Simple::PullParserEndToken(3pm)