Software Index
Linux Software Utilities  

github-tools

download download home home   report broken
important software information
company name:
Damien Lebrun
license: Freeware
minimum requirements: · Python
functional limitations:
github-tools description
Github features Git repository hosting, a download page for your Git tags (or any archive), a basic issue tracker, a wiki and static page hosting (gh-pages). It would be perfect for hosting a Python package and its documentation if gh-pages was easy to setup and was compatible with Sphinx.

Setting up a root branch for gh-pages is quite complex and Sphinx put its source and static files in directories named "_source" and "_static" that gh-pages doesn't want to serve.

The Sphinx extension (github.tools.sphinx) corrects the last problem; some paver tasks (github.tools.task.*) take care of the creation of a Git submodule to host the built html documentation; The PasteScript template create the basic layout and pavement.py script to get started.

Installation:

Assuming easy_install is installed, simple execute:

easy_install github-tools

Usage:

Package layout

If you are starting from scratch, create the basic layout with paster:

paster create -t gh_package < project name >

The project name will be used for pypi and for your Github repository (http://github.com/< user >/< project name >). The project details are saved in src/< package name >/__init__.py.

To finish your development environment setup, create a virtual environment and deploy your package in development mode:

cd < project name >
python bootstrap.py --no-site-packages

The basic package comes with a virtualenv boostrap script to create an isolated Python environments. To activate this environment in your shell, run:

source ./virtual-env/bin/activate
# or .virtual-envScriptsactivate.bat on windows

Finally:

paver generate_setup minilib develop.

Paver add a setup.py file to your package and a portable paver library (required by setup.py), and deploy your application in development mode; the src folder which contains your package is added to the python path.

You are ready to write your package (in src/) and its documentation (in docs/source). You should probably start tracking your project now:

git init
git add .
git commit -m "initial import"

Github project creation

When you are ready to share your work, you will need to create a repository at GitHub and push your local repository. Paver can do it for you. Paver will need your GitHub user name and token to create the repository. You can set them with the following command:

git config --global github.user < user >
git config --global github.token < token >

You can find your token on your Github account page.

Then, to create the repository and upload your project:

paver gh_register

Documentation hosting

Once the project is created, you can create your gh-pages branch and upload it to github:

paver gh_pages_create gh_html

Paver will create a submodule of your project at docs/build/html, create a gh-pages root branch and push the branch to your project. It then build the html doc. To clean the html build folder, it update the submodule (you will lose changes not committed and pushed), remove every files and directory (except .git/) and rebuild the documentation.

When your documentation can be published, simply push your gh-pages submodule to GitHub:

paver gh_pages_update -m "update docs with..."

You might also want to update the submodule reference (a submodule point to specific commit on a remote repository, not to the HEAD of a specific branch):. . Publisher of github-tools, Author of github-tools 0.1.2. Github features Git repository hosting, a download page for your Git tags (or any archive), a basic issue tracker, a wiki and static page hosting (gh-pages). It would be perfect for hosting
Similar software
Gedit XML Tools (Popularity: ) : Gedit XML Tools is a plugin for GNOME's text editor, Gedit, which is going to include many useful tools for xml development. XML validation (DTD, XSD), Xpath, XQuery etc. The plugin (version 0.1) is currently able to do XML validation ...
GNOME System Tools (Popularity: ) : Formerly known as the Ximian Setup Tools, GNOME System Tools are a fully integrated set of tools aimed to make easy the job that means the computer administration on an UNIX or Linux system.

They're thought to help from the new ...

dvd+rw-tools (Popularity: ) : dvd+rw-tools project makes it possible to burn DVD images created by "dvdauthor" or "mkisofs" to DVD+R, DVD+RW, DVD-R, and DVD-RW disks, replacing "cdrecord-proDVD" in many cases.

The package contains "growisofs" to burn DVD images or create a data DVD on the ...

zisofs-tools (Popularity: ) : zisofs filesystem is an extension to the ISO9660 filesystem that allows files, on a file-by-file basis, to be stored compressed and decompressed in real time.

The zisofs filesystem is supported by recent versions of Linux (2.4.14 or later).

Legacy systems can still ...

Burn-CD (Popularity: ) : Burn-CD is a handy frontend for the well-known cd/dvd writing packages cdrtools & dvd+rw-tools. Burn-CD is written in the Python programming language and intended for use on any modern GNU/Linux OS.

Here are some key features of "Burn-CD":

· simple and convenient ...

cpufrequtils (Popularity: ) : cpufrequtils project consists of a library which offers an unified access method for userspace tools and programs to the CPU frequency and voltage scaling (cpufreq) subsystem in the Linux kernel, the "cpufreq-info" and "cpufreq-set" to

"libcpufreq" is a library which offers ...

py65 (Popularity: ) : py65 is a Python library to simulate 6502-based microcomputer systems. It has the following goals:

* Focus on ease of use and modularity rather than performance. Py65 is written in the Python programming language for productivity, while similar programs are written ...

PocketAsterisk RemotePocketAsterisk (Popularity: ) : PocketAsterisk is a small utility for Pocket PC devices that reveals that passwords stored behind the asterisks ('***') in standard password text-boxes. You can use it to recover the passwords of POP3/IMAP accounts stored by the 'Messaging' application of Pocket ...
Parted Magic (Popularity: ) : Parted Magic is a Linux LiveCD/USB/PXE with its elemental purpose being to partition hard drives. Optimized at approximately 30MB, the Parted Magic OS employs core programs of GParted and Parted to handle partitioning tasks with ease, while featuring other useful ...
Samba TNG (Popularity: ) : Samba TNG is another SMB server for Unix-like operating systems. This software is concentrating on MSRPC interoperatability with Windows NT, 2000, XP, and 2003.

It provides PDC support and tools to remotely administer NT servers and workstations. Note that Samba TNG ...

Geo::Coder::US (Popularity: ) : Geo::Coder::US is a Perl module with geocode (estimate latitude and longitude) for any US address.

SYNOPSIS

use Geo::Coder::US;

Geo::Coder::US->set_db( "geocoder.db" );

my @matches = Geo::Coder::US->geocode(
"1600 Pennsylvania Ave., Washington, DC" );

my @matches = Geo::Coder::US->geocode(
"42nd & Broadway New York NY" ...

Go Ollie! (Popularity: ) : Ollie the Oligocheata is a worm on a mission.

He is on a mission to bring mouse controlled platforming fun to everyone!

Go Ollie is a free Linux game with beautifully rendered scenes and animations

The latest in innovative mouse controlled platform gaming ...

User reviews

Write a review:
1 2 3 4 5 6 7 8 9 10
1=poor 10=excellent
Write review*
Your name*
Email*
  (Comments are moderated, and will not appear on this site until the editor has approved them)
 
Similar scripts
Admin Tools (Popularity: ) : Admin Tools is an addon module for the Admin module, which provides a sidebar navigation for selected roles.The Admin Tools module adds functionality and quick access for clearing caches, running cron and updates much like Admin Menu.This project has been ...
Cgi2you.com | cgi tools for your site. (Popularity: ) : CGI tools for your site's easy, unique and FREE !!
This is one of the best free CGI Web sites. It's well-designed, easy to navigate and serves up some extremely useful scripts. At CGI2You.com, a free counter, voters poll, message board ...

Holdem Tools (Popularity: ) : Holdem Tools is a web based Texas Holdem odds calculator. The front end is generated using PHP and JavaScript and makes use of the scriptaculous library. The backend is powered by the poker-eval library, which is written in C.
GG Tools (Popularity: ) : GG Tools is a flash drawing tools extension package. It highly extend the power of line (stroke) in Macromedia Flash. The current version of GG Tools available only for Flash MX2004 and Flash 8 under Windows platform.The current version of ...
ifetch-tools (Popularity: ) : ifetch-tools is a set of tools that can collect images from ip based cameras, monitor collection process, and provide an interface to view collected history.
Wikipedia Tools (Popularity: ) : Wikipedia Tools is a rich interface to query wikipedia (suggest, find as you type..), browse its categories (graphical tree), and... more to come. It is written on OpenLaszlo (lzx), so it's compiled in Flash, and will soon be available in ...
School Reporting Tools (Popularity: ) : School Reporting Toolslong is a suite of PHP/MySQL tools for schools. It provides: - A tool for producing and managing student reports. - A tool for managing an office supplies room. - Tools for managing a small library or a ...
Dictionary Tools (Popularity: ) : Dictionary Tools script shows you a collection of some dictionary tools.
Computational tools for microarray data (Popularity: ) : The very nature of microarrays, with unprecedented scalability in parallelizing experiments, leads to large quantities of measurement data. This project aims at providing a few (hopefully) useful tools for processing microarray data.
Cheminformatics tools (Popularity: ) : This project aims at providing a cheminformatics tools shell and a simple plugin mechanism for extending the system with additional tools on an on-going basis.
Rate me
supported os's
stats
downloads 8
version 0.1.2
size in Kb 72
popularity   
1705/1272475
user rating 5/10
our rating 0 Stars
share info
Recommend github-tools
Report spyware
New Software
Popular Software
Latest Reviews