{ "info": { "author": "Reuben Cummings", "author_email": "reubano@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Software Development :: Version Control" ], "description": "ongeza: your project versioning personal assistant\n==================================================\n|travis| |versions| |pypi|\n\n.. image:: https://raw.githubusercontent.com/reubano/ongeza/master/ongeza.png\n :alt: sample ongeza usage\n :width: 800\n :align: center\n\nIndex\n-----\n`Introduction`_ | `Requirements`_ | `Motivation`_ | `Usage`_ | `Installation`_ |\n`Project Structure`_ | `Design Principles`_ | `Limitations`_ | `Scripts`_ |\n`Contributing`_ | `License`_\n\nIntroduction\n------------\n\nongeza (Swahili for \"increase\") is a Python `command line application <#usage>`_ (CLI)\nthat makes following the `Semantic Versioning Specification`_ a breeze.\nIf called with no options, ``ongeza`` will print the repo's current git tag\nversion. With ongeza, you can\n\n- Quickly bump to a ``patch``, ``minor``, or ``major`` version\n- Stash uncommitted changes before bumping\n- Create a git tag with the new version number\n- Bump python, php, and javascript projects\n- and much more...\n\nRequirements\n------------\n\nongeza has been tested and is known to work on Python 2.7, 3.4, and 3.5;\nand PyPy 4.0\n\nMotivation\n----------\n\nI think we can all agree that `semver`_ is awesome sauce. But while\ncoding, who has time to constantly look up the current version and figure out\nthe new version? I created ongeza to relieve myself from this pain of having to\nworry about version numbers. For example, to bump to a ``minor`` version\ninside a python ``git`` repo, simply type:\n\n.. code-block:: bash\n\n ongeza --type=minor\n\nOr via the short option style:\n\n.. code-block:: bash\n\n ongeza -tn\n\nAs long as the repo contains a git tag with the current version, ongeza will\nautomagically:\n\n- calculate the new version number\n- figure out which file(s) to update with the new version number\n- make the appropriate updates and commit the changes\n- create a git tag with the new version number\n\nUsage\n-----\n\nongeza is intended to be used from the command line.\n\n.. code-block:: bash\n\n ongeza [options]