Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

264 lines (157 sloc) 4.809 kb

App::gh

App::gh is an utility helps you operate commands through GitHub's API, currently App::gh is migrating to GitHub API v3.

Installation

App::gh is written in Perl, so you might need a cpanminus to install CPAN modules, to install cpanminus:

$ curl -L http://cpanmin.us | perl - --sudo App::cpanminus

Now you have cpanm, you can install App::gh

$ cpanm https://github.com/c9s/App-gh/zipball/develop

Setup

To use App::gh, you need to configure your password or OAuth token in your .gitconfig file, just drop the lines below to setup your password:

    [github]
        user = c9s
        password = your password

Commands

clone

clone Plack repository from miyagawa:

$ gh clone miyagawa/Plack   # default: read-only

or:

$ gh clone miyagawa Plack

$ gh clone foo Social --http

$ gh clone foo Social --https

$ gh clone clkao Web-Hippie --ro

clone from read-only uri:

$ gh clone miyagawa/Plack --ro

clone from ssh uri:

$ gh clone miyagawa/Plack --ssh

all

To clone all repository of miyagawa:

$ gh all miyagawa

$ gh all facebook --into facebook

$ gh all perl6 --into perl6-stuff

$ gh all perl6 --into perl6-stuff --prompt

$ gh all perl6 --into perl6-stuff --verbose --prompt

$ gh all clkao --ro  # read-only

INSTALLATION

To install this module, run the following commands:

# Makefile.PL needs this
cpan Module::Install::AuthorTests

perl Makefile.PL
make
make test
make install

COMPLETION

zsh

$ mkdir ~/.zsh/functions
$ cp completion/zsh/_gh  ~/.zsh/functions

add ~/.zsh/functions to your fpath

$ vim ~/.zshrc

fpath=(~/.zsh/functions/ $fpath)

DEVELOPMENT

please keep the dependency simple and less.

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

perldoc App::gh

You can also look for information at:

RT, CPAN's request tracker
    http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-gh

AnnoCPAN, Annotated CPAN documentation
    http://annocpan.org/dist/App-gh

CPAN Ratings
    http://cpanratings.perl.org/d/App-gh

Search CPAN
    http://search.cpan.org/dist/App-gh/

LICENSE AND COPYRIGHT

Copyright (C) 2010 Cornelius

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.

Jump to Line
Something went wrong with that request. Please try again.