{ "info": { "author": "Hong Minhee", "author_email": "minhee@dahlia.kr", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Framework :: Setuptools Plugin", "Intended Audience :: Developers", "License :: Public Domain", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.5", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Topic :: Software Development", "Topic :: System :: Software Distribution" ], "description": "github-distutils\r\n================\r\n\r\n.. warning::\r\n\r\n This project is abandoned, and we recommend not to use this anymore.\r\n Because PyPI and pip_ disallows to download package distributions\r\n from other than official PyPI for security reasons.\r\n\r\n.. _pip: http://pip-installer.org/\r\n\r\nIntro\r\n-----\r\n\r\nDistribute_/setuptools_/distutils_ command for GitHub_. You can use\r\nGitHub downloads instead of PyPI_ downloads for release.\r\n\r\nTo use this, follow the instruction.\r\n\r\n.. _Distribute: http://packages.python.org/distribute/\r\n.. _setuptools: http://pypi.python.org/pypi/setuptools\r\n.. _distutils: http://docs.python.org/library/distutils.html\r\n.. _GitHub: https://github.com/\r\n.. _PyPI: http://pypi.python.org/\r\n\r\n\r\nInstruction\r\n-----------\r\n\r\nFirst of all your software must be packaged within the standard distribution\r\nway: use distutils_, Distribute_ or setuptools_. This package contains\r\nan extension command for that.\r\n\r\nThen, add this package into ``setup_requires`` parameter of your ``setup()``\r\nconfiguration (of ``setup.py`` script)::\r\n\r\n setup(name='YourPackageName',\r\n version='1.2.3',\r\n ...,\r\n setup_requires=['github-distutils >= 0.1.0'])\r\n\r\nNow there will be ``github_upload`` command for your ``setup.py``::\r\n\r\n $ python setup.py github_upload --help\r\n Common commands: (see '--help-commands' for more)\r\n\r\n ...\r\n\r\n Options for 'github_upload' command:\r\n --repository (-R) GitHub repository name e.g. user/reponame\r\n --username (-u) GitHub username\r\n --password (-p) GitHub password\r\n\r\n ...\r\n\r\nIf ``-u``/``--username`` and ``-p``/``--password`` are not present, it will\r\nshows the prompt. ``-R``/``--repository`` is required.\r\n\r\n\r\nUpload\r\n------\r\n\r\nUpload is very easy::\r\n\r\n $ python setup.py sdist github_upload -R user/reponame register\r\n\r\nBy explained:\r\n\r\n``sdist``\r\n Makes the source distribution file. If your package name is\r\n ``YourPackageName`` and its version is ``1.2.3``, and then its file name\r\n becomes ``YourPackageName-1.2.3.tar.gz``.\r\n\r\n``github_upload -R user/reponame``\r\n Uploads the built source distribution file into your GitHub repository.\r\n It does not mean that it will be version-controlled, but it will be simply\r\n uploaded to its downloads page.\r\n\r\n``register``\r\n Using the GitHub download URL registers the package of this version\r\n into PyPI.\r\n The URL of PyPI page will be http://pypi.python.org/YourPackageName/1.2.3\r\n\r\n\r\nDefaulting options\r\n------------------\r\n\r\nYou can make default values for these options by specifying in the ``setup.cfg``\r\nconfiguration file. For example, if you want to default ``--repository``,\r\nmake ``setup.cfg`` file like (hyphens becomes underscores)::\r\n\r\n [upload]\r\n repository = user/reponame\r\n\r\nYou can make a shorthand alias as well::\r\n\r\n [aliases]\r\n release = sdist github_upload register\r\n\r\n\r\nAuthor and license\r\n------------------\r\n\r\nIt is distributed under Public Domain. Just do what you want to do with this.\r\nWritten by `Hong Minhee`__.\r\n\r\nYou can checkout the source code from its `GitHub repository`__::\r\n\r\n $ git clone git://github.com/dahlia/github-distutils.git\r\n\r\nIf you found a bug, please report it to the `issue tracker`__.\r\n\r\n__ http://dahlia.kr/\r\n__ https://github.com/dahlia/github-distutils\r\n__ https://github.com/dahlia/github-distutils/issues\r\n\r\n\r\nFor Bitbucket users\r\n-------------------\r\n\r\nUse bitbucket-distutils_ which is a package by the same author\r\nif you are using Bitbucket instead of GitHub.\r\n\r\n.. _bitbucket-distutils: https://bitbucket.org/dahlia/bitbucket-distutils\r\n\r\n\r\nChangelog\r\n---------\r\n\r\nVersion 0.1.1\r\n'''''''''''''\r\n\r\nReleased on June 20, 2012. Beta version.\r\n\r\n- Allow upper cases for GitHub repository names.\r\n [`#1`__ by Xavier Barbosa]\r\n- Windows compatibility: fixed ``UnicodeDecodeError`` for uploads.\r\n\r\n__ https://github.com/dahlia/github-distutils/pull/1\r\n\r\n\r\nVersion 0.1.0\r\n'''''''''''''\r\n\r\nReleased on May 27, 2012. First alpha version.", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/downloads/dahlia/github-distutils/github-distutils-0.1.1.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dahlia/github-distutils", "keywords": "", "license": "Public Domain", "maintainer": "", "maintainer_email": "", "name": "github-distutils", "package_url": "https://pypi.org/project/github-distutils/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/github-distutils/", "project_urls": { "Download": "https://github.com/downloads/dahlia/github-distutils/github-distutils-0.1.1.tar.gz", "Homepage": "https://github.com/dahlia/github-distutils" }, "release_url": "https://pypi.org/project/github-distutils/0.1.1/", "requires_dist": null, "requires_python": null, "summary": "Distribute/setuptools/distutils command for GitHub. You can use GitHub downloads instead of PyPI downloads for release.", "version": "0.1.1" }, "last_serial": 2240982, "releases": { "0.1.0": [], "0.1.1": [] }, "urls": [] }