{ "info": { "author": "Damien Lebrun", "author_email": "dinoboff@hotmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2.5", "Topic :: Documentation", "Topic :: Software Development :: Version Control" ], "description": "Github features Git repository hosting, a download page for your Git tags \n(or any archive), a basic issue tracker, a wiki and static page hosting \n(`gh-pages `_). It would be perfect for hosting a \nPython package and its documentation if gh-pages was easy to setup and \nwas compatible with `Sphinx `_. \n\nSetting up a root branch for gh-pages is quite complex; Sphinx put its\nsource and static files in directories named \"_static\" and \"_source\"\nthat gh-pages doesn't want to serve them.\n\nThe Sphinx extension (``github.tools.sphinx``) corrects the last problem; \nsome paver tasks (``github.tools.task.*``) take care of the creation of a Git \nsubmodule to host the built html documentation; The PasteScript template \ncreate the basic layout and pavement.py script to get started.\n\nRequirements\n============\n\nThis extension and its dependencies require:\n\n * a GitHub user account and,\n * Git (tested with 1.6.2.4), \n * Python 2.5+.\n \nIt currently has only been tested on Ubuntu 8.04 (and Git built from source)\nwith Python 2.5.\n\nIt should work on os X. For Windows, It should work as long as \n`GitPython `_ does. However since it \nsimply start ``git`` subprocesses to work, it might be difficult to use with\nGit installers like `msysgit `_ or \n`gitextensions `_. \n\n\n\nInstallation\n============\n\nThe easiest way to get github-tools is if you have setuptools installed::\n\n\teasy_install github-tools\n\nWithout setuptools, download it from \n`Pypi `_ or from \n`Github `_, untar it\nand run::\n\n\tpython setup.py install\n\nThe current development version can be found at \nhttp://github.com/dinoboff/github-tools/tarball/master.\n\n\nUsage\n=====\n\nPackage layout\n--------------\n\nIf you are starting from scratch, create the basic layout with paster::\n\n\tpaster create -t gh_package \n\t\nThe project name will be used for pypi and for your Github repository\n(``http://github.com//``).\n\nTo finish your development environment setup, create a virtual environment\nand deploy your package in development mode::\n\n\tcd \n\tpython bootstrap.py --no-site-packages\n\t\nThe basic package comes with a virtualenv boostrap script\nto create an isolated Python environments. To activate this environment\nin your shell, run::\n\n\tsource ./virtual-env/bin/activate\n\t# or .\\virtual-env\\Scripts\\activate.bat on windows\n\nFinally::\n\n\tpaver generate_setup minilib develop.\n\nPaver add a ``setup.py`` file to your package and a portable paver library\n(required by ``setup.py``), and deploy your application in development mode;\nThe \"src\" folder which contains your package is added to the Python path.\n\n``setup.py`` does not contain much. All ``setup()`` parameters are set in \n``pavement.py``. All the distutils and setuptools task are available with paver \nand it is very easy to extends or add your own commands (see \n`paver documentation `_\nfor more details). \n\nYou are ready to write your package (in ``src/``) and its documentation\n(in ``docs/source``). You should probably start tracking your project now::\n\n\tgit init\n\tgit add .\n\tgit commit -m \"initial import\" \n\n\nGithub project creation\n-----------------------\n\nWhen you are ready to share your work, you will need to \ncreate a repository at GitHub and push your local repository. Paver can do it \nfor you. Paver will need your GitHub user name and token to create \nthe repository. You can set them with the following command::\n\n\tgit config --global github.user \n\tgit config --global github.token \n\t\nYou can find your token on your \n`Github account page `_.\n\nThen, to create the repository and upload your project::\n\n\tpaver gh_register\n\t\n\nDocumentation hosting\n---------------------\n\t\nOnce the project is created, you can create your gh-pages branch \nand upload it to GitHub::\n\n\tpaver gh_pages_create gh_pages_build\n\t\nPaver will create a submodule of your project at ``docs/build/html``,\ncreate a gh-pages root branch and push the branch to your project.\nIt then build the html doc. To clean the html build folder, it update \nthe submodule (you will lose changes not committed and pushed), \nremove every files and directory (except ``.git/``) \nand rebuild the documentation.\n\nWhen your documentation can be published, simply push your gh-pages submodule \nto GitHub::\n\n\tpaver gh_pages_build gh_pages_update -m \"update docs with...\"\n\t\nYour documentation should be available \nat ``http://.github.com/``.\n\nYou might also want to update the submodule reference (a submodule point \nto specific commit on a remote repository, not to the HEAD \nof a specific branch)::\n\n\tgit add docs/build/html\n\tgit commit -m \"update gh-pages submodule\"\n\t\nHelp and development\n====================\n\nIf you'd like to help out, you can fork the project\nat http://github.com/dinoboff/github-tools/ and report any bugs \nat http://github.com/dinoboff/github-tools/issues.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://dinoboff.github.com/github-tools/", "keywords": "sphinx,github,paster", "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "github-tools", "package_url": "https://pypi.org/project/github-tools/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/github-tools/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://dinoboff.github.com/github-tools/" }, "release_url": "https://pypi.org/project/github-tools/0.1.7/", "requires_dist": null, "requires_python": null, "summary": "Helpers for Python package hosting at GitHub", "version": "0.1.7" }, "last_serial": 792464, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "3810494c5c6531871c6b6979d43b16d1", "sha256": "4a4a61de6320715da7edf5dbcd9be0b262799b7c0c77350169428e0f662b3de9" }, "downloads": -1, "filename": "github-tools-0.1.0.tar.gz", "has_sig": false, "md5_digest": "3810494c5c6531871c6b6979d43b16d1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 68566, "upload_time": "2009-06-12T23:08:22", "url": "https://files.pythonhosted.org/packages/cc/15/a13e90d54443d4814d02e521ed11faa12ae471188cde25c1af35f3546e9f/github-tools-0.1.0.tar.gz" } ], "0.1.0a1": [ { "comment_text": "", "digests": { "md5": "45b5bb61713cb27544758f8a6fcf142a", "sha256": "81282412a567cdaa8066bc2ae3e230b17236e2089e0000ffb442cb56942f540f" }, "downloads": -1, "filename": "github-tools-0.1.0a1.tar.gz", "has_sig": false, "md5_digest": "45b5bb61713cb27544758f8a6fcf142a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63367, "upload_time": "2009-04-25T23:47:57", "url": "https://files.pythonhosted.org/packages/65/c9/09ff13f90e397011daad5abe15e74ca5358458f110e548726d0bfda39ec4/github-tools-0.1.0a1.tar.gz" } ], "0.1.0a2": [ { "comment_text": "", "digests": { "md5": "9db8fa5327bbd1ba6ba0c091101a1bd6", "sha256": "c8284977ec47b3023429a8738da89f2b9ec8fe99188853fde1015f9b09186d39" }, "downloads": -1, "filename": "github-tools-0.1.0a2.tar.gz", "has_sig": false, "md5_digest": "9db8fa5327bbd1ba6ba0c091101a1bd6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63797, "upload_time": "2009-04-25T23:59:32", "url": "https://files.pythonhosted.org/packages/48/82/7dce80ab3a11f5f4976436a793e9cb93e47c9a153773f0e47d4cf527def5/github-tools-0.1.0a2.tar.gz" } ], "0.1.0a3": [ { "comment_text": "", "digests": { "md5": "842a028912dce3e95ebabd9dee7b6059", "sha256": "91037b4c2efc03c5d349ee78a519db287395ab9d8f78494044509e1831e51ea9" }, "downloads": -1, "filename": "github-tools-0.1.0a3.tar.gz", "has_sig": false, "md5_digest": "842a028912dce3e95ebabd9dee7b6059", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 64361, "upload_time": "2009-04-27T04:01:01", "url": "https://files.pythonhosted.org/packages/c5/44/0857f369ff467d6ee2bf4e91a8ffd3a4a103a8e185f739a35603c41f2255/github-tools-0.1.0a3.tar.gz" } ], "0.1.0b1": [ { "comment_text": "", "digests": { "md5": "a0e31e30448bc67822b935abb5c29f6a", "sha256": "f460f3e283627f6743f91a88361c1804b7d5485ff09caf3b8d539662046b53f8" }, "downloads": -1, "filename": "github-tools-0.1.0b1.tar.gz", "has_sig": false, "md5_digest": "a0e31e30448bc67822b935abb5c29f6a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 67413, "upload_time": "2009-06-05T13:36:19", "url": "https://files.pythonhosted.org/packages/48/08/1eaf7ffab0d8ca978321242abff56e93e58ecb450ba9e0ef70840e7763bb/github-tools-0.1.0b1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "25191ebe8b045faa7e8ff9b09b966cad", "sha256": "665f29c95c408affad0dcc18f9596b9de7cf5173139582e27d3f9db922261988" }, "downloads": -1, "filename": "github-tools-0.1.1.tar.gz", "has_sig": false, "md5_digest": "25191ebe8b045faa7e8ff9b09b966cad", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 69404, "upload_time": "2009-06-14T23:48:23", "url": "https://files.pythonhosted.org/packages/7e/58/950c2671c4aee82d1089b2b89a35c598192a636bcf15386efa5495d09fdf/github-tools-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "64a0fad95f8fbc064529bd70a1870704", "sha256": "71323d58c3b40d9350fad9d0438d9995334c425d0e626e4f9dfe1b4286cacb91" }, "downloads": -1, "filename": "github-tools-0.1.2.tar.gz", "has_sig": false, "md5_digest": "64a0fad95f8fbc064529bd70a1870704", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 69546, "upload_time": "2009-06-14T23:58:03", "url": "https://files.pythonhosted.org/packages/5d/45/c5dd73cff1bfb8658e257bf2d33e86d8c3b1d570163526948cf9daa6726d/github-tools-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "85a46fb93352c947d8dd6059c5efefa2", "sha256": "c6779076664399657abe10bc063a59070d42d2094de641be0f1fb04c8a1fdbe8" }, "downloads": -1, "filename": "github-tools-0.1.3.tar.gz", "has_sig": false, "md5_digest": "85a46fb93352c947d8dd6059c5efefa2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 75991, "upload_time": "2009-06-17T22:32:04", "url": "https://files.pythonhosted.org/packages/00/81/cde91649b2f23cc0dc1480ba3aba9740cb001d67fcaec96340993144fa2e/github-tools-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "c0596c311d67a96a03eedc0d12102f09", "sha256": "f0063c1da800cb683003f58942283ca43a4bf175fc248b344faa4d34b0293297" }, "downloads": -1, "filename": "github-tools-0.1.4.tar.gz", "has_sig": false, "md5_digest": "c0596c311d67a96a03eedc0d12102f09", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 103248, "upload_time": "2009-07-05T14:07:27", "url": "https://files.pythonhosted.org/packages/ff/22/1234e5ea59ceaaa3c4ad801f4cf00c02550b5f21a0a5df82c0573248fdf9/github-tools-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "55aaa0b633da2d27f3ee7da30da2fdd3", "sha256": "845242b2e396fb2fd4b5f9a342a6db9ea72e645d54f12fef468f9ebd65013388" }, "downloads": -1, "filename": "github-tools-0.1.5.tar.gz", "has_sig": false, "md5_digest": "55aaa0b633da2d27f3ee7da30da2fdd3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 103677, "upload_time": "2009-07-09T16:42:41", "url": "https://files.pythonhosted.org/packages/fd/6c/57246b33ff01df7418af358b911af39aaba369ab15b00d6e5c2eb7304a82/github-tools-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "8394730e3a55bb509200e52ceb2384f0", "sha256": "0db40d9c092dbbbfeaf6d6412c3d8db669caae25e9677356f2ce6e113460c35a" }, "downloads": -1, "filename": "github-tools-0.1.6.tar.gz", "has_sig": false, "md5_digest": "8394730e3a55bb509200e52ceb2384f0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 103827, "upload_time": "2009-07-09T17:07:28", "url": "https://files.pythonhosted.org/packages/0f/b0/a9321f30c661e8fde70f565c55ec7cca2da4900e05bdb1b60002119b08c5/github-tools-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "85a77c74639598368f879bc07ca98b2b", "sha256": "b68e5e46542aa86a3f7e9ad99711f6957dfa2c2723d64e2fbdc55c143ed63238" }, "downloads": -1, "filename": "github-tools-0.1.7.tar.gz", "has_sig": false, "md5_digest": "85a77c74639598368f879bc07ca98b2b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 103791, "upload_time": "2009-07-18T16:18:39", "url": "https://files.pythonhosted.org/packages/0d/21/35fb8ae0bb6c1b2bd83c27b95aad6743dbeed852cad20eed300a7a053bcb/github-tools-0.1.7.tar.gz" } ], "0.2b1": [ { "comment_text": "", "digests": { "md5": "8770b7a1079e6984fa6db8d541fabb94", "sha256": "ff0f0e4f05062686b64051304740df5bfb8145bf7fbf5b104360c9318194cddc" }, "downloads": -1, "filename": "github-tools-0.2b1.tar.gz", "has_sig": false, "md5_digest": "8770b7a1079e6984fa6db8d541fabb94", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 102056, "upload_time": "2009-08-27T13:13:57", "url": "https://files.pythonhosted.org/packages/e4/9b/193f950fcb3e4c40ac0b0bef3839c0c70b058e1c7d4c42ccdec860158d13/github-tools-0.2b1.tar.gz" } ], "0.2b2": [ { "comment_text": "", "digests": { "md5": "e9acb2aa74e10bbc96d22beaf9925696", "sha256": "21bbaad8e3d065cec39d55169534dbcb802ce1f951af7db2c192d8d808e3804b" }, "downloads": -1, "filename": "github-tools-0.2b2.tar.gz", "has_sig": false, "md5_digest": "e9acb2aa74e10bbc96d22beaf9925696", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 99484, "upload_time": "2010-01-11T03:57:39", "url": "https://files.pythonhosted.org/packages/c9/5c/fbb38f8f90360656a719b43f107f23aa12a9da31b8be2a5468aee34a08f9/github-tools-0.2b2.tar.gz" } ], "0.2b3": [ { "comment_text": "", "digests": { "md5": "1f87c5b2b38352d20cb260c157f279f6", "sha256": "aca79fa655d1a8874f74b798922e803a0f6ee0fe1e7640f2ce1fca6123af55a1" }, "downloads": -1, "filename": "github-tools-0.2b3.tar.gz", "has_sig": false, "md5_digest": "1f87c5b2b38352d20cb260c157f279f6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 99758, "upload_time": "2010-01-30T18:33:53", "url": "https://files.pythonhosted.org/packages/69/46/3fd42f599854f15671fc07e7e830112cc18c983e5fb9cfdd3ef0e7a6bf24/github-tools-0.2b3.tar.gz" } ], "0.2rc1": [ { "comment_text": "", "digests": { "md5": "86bf14d32565dc8b6e42c6827dddd5f3", "sha256": "09a352adacca67f03f2c932bf7309a50dc31456b77009a7925036ca4d3839932" }, "downloads": -1, "filename": "github-tools-0.2rc1.tar.gz", "has_sig": false, "md5_digest": "86bf14d32565dc8b6e42c6827dddd5f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 100113, "upload_time": "2010-04-27T04:45:05", "url": "https://files.pythonhosted.org/packages/cc/fb/e5aa52dd99eb86705a1b3a107274dbb2bb028665ccab76b09d0fdb0a2416/github-tools-0.2rc1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "85a77c74639598368f879bc07ca98b2b", "sha256": "b68e5e46542aa86a3f7e9ad99711f6957dfa2c2723d64e2fbdc55c143ed63238" }, "downloads": -1, "filename": "github-tools-0.1.7.tar.gz", "has_sig": false, "md5_digest": "85a77c74639598368f879bc07ca98b2b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 103791, "upload_time": "2009-07-18T16:18:39", "url": "https://files.pythonhosted.org/packages/0d/21/35fb8ae0bb6c1b2bd83c27b95aad6743dbeed852cad20eed300a7a053bcb/github-tools-0.1.7.tar.gz" } ] }