Skip to content

Latest commit

 

History

History
61 lines (44 loc) · 2.24 KB

README.md

File metadata and controls

61 lines (44 loc) · 2.24 KB

cligh - Command-line Interface to GitHub

This is a simple command-line interface to the facilities of GitHub. It is written by Christopher Brannon chris@the-brannons.com. The current version is 0.1. This program is still in the early stage of development. It is by no means feature-complete. A friend and I consider it useful, but others may not.

Obtaining

Obtain the current stable version using this link: http://the-brannons.com/software/cligh-0.1.tar.gz. You can verify the integrity of the file using the gpg signature.

Installation

If you are using a version of Python prior to 2.7, you first need to install the argparse module. Get it from here. Python version 2.7 includes argparse in its standard library.

cligh also requires the PyGithub package. The homepage for PyGithub is https://github.com/jacquev6/PyGithub.

The final dependency is PyXDG. Get it from http://freedesktop.org/Software/pyxdg.

Once the dependencies are installed, type ./setup.py in the cligh source directory, in order to install the script.

Setup

cligh will read your username and github token from git's configuration files, so you must set them before proceeding. These authenticate various operations, such as repository creation. See this description of the configuration process for more details. Here are the example commands which you should run, replacing the final arguments with your own username and token.

git config --global github.user NoSuchUser
git config --global github.token 0123456789abcdef0123456789abcdef

Usage

Usage is straightforward, and the program provides informative help messages. Simply type cligh -h at a shell prompt, to see the introductory help message.

Development

The source for this project is managed by git. If you wish to contribute, or if you simply wish to use the unpublished "development" sources, clone it using a command such as the following:

git clone git://github.com/CMB/cligh.git

Patches are most appreciated. Please send them to chris@the-brannons.com.