{ "info": { "author": "Miguel \u00c1ngel Garc\u00eda", "author_email": "miguelangel.garcia@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent" ], "description": "============== =============== ========= ============\nVERSION DOWNLOADS TESTS COVERAGE\n============== =============== ========= ============\n|pip version| |pip downloads| |travis| |coveralls|\n============== =============== ========= ============\n\nGoal and Philosophy\n===================\n\n**Releaseme** should ease the process of **versioning** a product and **increment** its version when required, despite the version is managed as a file or a repository tag.\n\n\n\nDocumentation\n=============\n\nInstallation\n------------\n\nTwo options: to install it in your system/project::\n\n pip install releaseme\n\nAnd you can use it with::\n\n python -m releaseme -h\n\n\nOr just `download the lastest zip`_ and use it with::\n\n python releaseme-X.Y.Z.zip -h\n\n\nExamples and FAQ\n----------------\n\nLet's see an example. We have git project with a file in ``project/__init__.py``:\n\n.. code:: python\n\n __version__ = '2.3.4'\n\nWe want to manage versions with **releaseme**. And just a command is required::\n\n $ python -m releaseme.__main__ --git --file project/__init__.py\n\nWhat does this?\n~~~~~~~~~~~~~~~\n\n- Sets a git tag to 2.3.4\n- Upgrades the version in the file to '2.3.5'\n\nWhat??\n~~~~~~\n\nThis can seem a bit confusing at the beginning, but it is easy to explain: The git tag should mark the point where that version was launched, but the file should change to indicate the version we are working on.\n\nThis way, **the file will always contain the next version** to be used and the git tag, the point when it was released.\n\nCan I set an explicit version?\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nYes. Just edit the file with version and put the desired one.\n\nWhat happens if there are different versions?\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe higher one will be used.\n\nWhat if I want to maintain several files?\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nNot a problem, because you can use::\n\n $ python -m releaseme.__main__ --file project/__init__.py setup.py\n\nand it will set the same version for all of them.\n\n\nOptions\n-------\n\n**Releaseme** format is::\n\n [-h] [-v] [--git] [--mercurial] [--file [FILE [FILE ...]]] [ACTION]\n\nWhere **Action** is any of :code:`get` or :code:`increment`. If none is provided, `increment` will be used:\n\n- `get` shows current version after processing all files.\n- `increment` will read the version and increment it in all files.\n\n:code:`--git`\n~~~~~~~~~~~~~\n\nIf you are using a Git repository, this will use git tags to get/set the version. No more arguments are required.\n\n:code:`--hg` or :code:`--mercurial`\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIf you are using a Mercurial repository, this will use mercurial tags to get/set the version. No more arguments are required.\n\n:code:`--file`\n~~~~~~~~~~~~~~\n\nAllows you to select one or several files (space separated) to manage the version.\n\nAbout the version number\n========================\n\nVersions are up to 4 numbers separated by points. In addition, it can contain a hyphon ('-') and an alphanumeric string at the end. So, valid version numbers are:\n\n- 1\n- 1.2\n- 1.2.3\n- 1.2.3.4\n- 1-foo1\n- 1.2-foo1\n- 1.2.3-foo1\n- 1.2.3.4-foo1\n\nVersion numbers that will not be managed correctly include:\n\n- 1-1\n- 1.a.1\n- 1.foo1\n\nIf more than one number is retrieved, the higher one will be used. So:\n\n- '1' vs '1.2' will use '1.2'\n- '1.2.3.4' vs '1.2' will use '1.2.3.4'\n- '1.2.1' vs '1.3.0' will use '1.3.0'\n\nFinally, only the minor number will be incremented:\n\n- '1' increments to '2'\n- '1.1' increments to '1.2'\n- '1.1-foo1' increments to '1.2-foo1'\n\nUsing it like a pro\n===================\n\nThe best way to use it is launching it just after releasing. So, the best way to do it is to add the **releaseme** call to your publishing script.\n\nWhy it doesn't support NNNN technology?\n=======================================\n\nBecause I still didn't require it. Please, feel free to add an issue and/or send a pull-request.\n\n\nLicense\n=======\n\nCopyright (c) 2014 Miguel \u00c1ngel Garc\u00eda (`@magmax9`_).\n\nLicensed under `the MIT license`_.\n\n\n.. |travis| image:: https://travis-ci.org/magmax/python-releaseme.png\n :target: `Travis`_\n :alt: Travis results\n\n.. |coveralls| image:: https://coveralls.io/repos/magmax/python-releaseme/badge.png\n :target: `Coveralls`_\n :alt: Coveralls results_\n\n.. |pip version| image:: https://pypip.in/v/releaseme/badge.png\n :target: https://pypi.python.org/pypi/releaseme\n :alt: Latest PyPI version\n\n.. |pip downloads| image:: https://pypip.in/d/releaseme/badge.png\n :target: https://pypi.python.org/pypi/releaseme\n :alt: Number of PyPI downloads\n\n.. _Travis: https://travis-ci.org/magmax/python-releaseme\n.. _Coveralls: https://coveralls.io/r/magmax/python-releaseme\n\n.. _@magmax9: https://twitter.com/magmax9\n\n.. _the MIT license: http://opensource.org/licenses/MIT\n.. _download the lastest zip: https://pypi.python.org/pypi/releaseme", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/magmax/python-releaseme", "keywords": "version,versions,versioning,release,releasing", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "releaseme", "package_url": "https://pypi.org/project/releaseme/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/releaseme/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/magmax/python-releaseme" }, "release_url": "https://pypi.org/project/releaseme/0.2.8/", "requires_dist": null, "requires_python": null, "summary": "Library and command line app to manage project releases or versions", "version": "0.2.8" }, "last_serial": 1273383, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "50ea112fb65ddba50f78e77aa503ed14", "sha256": "760924193b2ff6c04945f6ec3c6ba6d8d90764223e17852eb3ff9025061bbf56" }, "downloads": -1, "filename": "releaseme-0.1.tar.gz", "has_sig": false, "md5_digest": "50ea112fb65ddba50f78e77aa503ed14", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2707, "upload_time": "2014-05-16T17:41:19", "url": "https://files.pythonhosted.org/packages/88/59/2086eef98b34a46dbb916db5375d22dcfa5a8f17b789af71073a2d40c702/releaseme-0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "32f897636e4e15fe4509103380e8a717", "sha256": "78976806e0ed5e85a07ae8eee772e7f0b76d76620fbc64c606f35e6e87344b43" }, "downloads": -1, "filename": "releaseme-0.1.1.tar.gz", "has_sig": false, "md5_digest": "32f897636e4e15fe4509103380e8a717", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2847, "upload_time": "2014-05-16T17:56:39", "url": "https://files.pythonhosted.org/packages/50/b8/88adf16667dc35e4005d807625b33b14fb74a0fbb330b2afd17fe78c9ed8/releaseme-0.1.1.tar.gz" }, { "comment_text": "", "digests": { "md5": "1840d1b6da89922043aa1f63fa91d532", "sha256": "f8a70e88d13315f1b8722be151f7f6552054078ce2a3617cb0057896381727d8" }, "downloads": -1, "filename": "releaseme-0.1.1.zip", "has_sig": false, "md5_digest": "1840d1b6da89922043aa1f63fa91d532", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6237, "upload_time": "2014-05-16T17:56:31", "url": "https://files.pythonhosted.org/packages/1d/93/cc7cb5d98561bf1031004a30c07e73d1dbe7d0f0140bd1914bd9b7ccdbbc/releaseme-0.1.1.zip" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "dc2976a8e6c4e4b629ba93bce9ebdefd", "sha256": "4d56922e67276b118dac637775e89c49c5c694474f3288d4600f1fde448ba9ef" }, "downloads": -1, "filename": "releaseme-0.2.2.tar.gz", "has_sig": false, "md5_digest": "dc2976a8e6c4e4b629ba93bce9ebdefd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4153, "upload_time": "2014-06-04T06:49:28", "url": "https://files.pythonhosted.org/packages/89/02/0ac7015032bada8f8aa04fdd5ca424a3ec8f033c6df59dac567627c36ada/releaseme-0.2.2.tar.gz" }, { "comment_text": "", "digests": { "md5": "8828b406d0646da2117d2003de502758", "sha256": "1007c657e1d70146b4813f62270ff5e3665a82e0f9dcef9501e7508b33f06c37" }, "downloads": -1, "filename": "releaseme-0.2.2.zip", "has_sig": false, "md5_digest": "8828b406d0646da2117d2003de502758", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8315, "upload_time": "2014-06-04T06:49:16", "url": "https://files.pythonhosted.org/packages/82/a4/163decfe605a7e02486b63cf27a76186e42a77e2f8cab2f9688ff97e7581/releaseme-0.2.2.zip" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "504440613e3874464726f456e742feaa", "sha256": "56f13a146fd0e6cf41a2d49f0376c99a03376cb4a0675e09ad728d157dfd511b" }, "downloads": -1, "filename": "releaseme-0.2.3.tar.gz", "has_sig": false, "md5_digest": "504440613e3874464726f456e742feaa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4310, "upload_time": "2014-06-05T06:31:31", "url": "https://files.pythonhosted.org/packages/3e/af/85544fc0bc1b9ba1ee496ff3435bcee6d9db2f9412ea1c927207627cde14/releaseme-0.2.3.tar.gz" }, { "comment_text": "", "digests": { "md5": "bc295e887cb8ff6dce81853b998f8fb8", "sha256": "8fe57a71a5829d2f3e5548444510915463086ceeaefcb2fae3201b784615fe20" }, "downloads": -1, "filename": "releaseme-0.2.3.zip", "has_sig": false, "md5_digest": "bc295e887cb8ff6dce81853b998f8fb8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8472, "upload_time": "2014-06-05T06:31:23", "url": "https://files.pythonhosted.org/packages/67/6c/32c906a3294f3d87cccdee01b55c60233da4c6dad4726987e45c3a211255/releaseme-0.2.3.zip" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "333e3ff2b5015e6952a1e99b6ac5c1cb", "sha256": "040b2061fb213aafe7f5b7ecba9dbb1cc754f4c92dea7bcbb0a4d161cf862733" }, "downloads": -1, "filename": "releaseme-0.2.4.tar.gz", "has_sig": false, "md5_digest": "333e3ff2b5015e6952a1e99b6ac5c1cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5852, "upload_time": "2014-06-05T17:44:29", "url": "https://files.pythonhosted.org/packages/17/77/1dfd56f1a5a5c32411bb5e1882dfdd30caffcff24641f6fde6cf9415e6e7/releaseme-0.2.4.tar.gz" }, { "comment_text": "", "digests": { "md5": "9130828c790b37c77aefc7edfe920aad", "sha256": "10dbbaa16cf45648ce965025cc82843a09558e13d82bb9c9224c24d547356f3d" }, "downloads": -1, "filename": "releaseme-0.2.4.zip", "has_sig": false, "md5_digest": "9130828c790b37c77aefc7edfe920aad", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12116, "upload_time": "2014-06-05T17:44:17", "url": "https://files.pythonhosted.org/packages/dc/c5/c9edaa30a83b52ec217ae03a0ab69f3bb78759841cc798fe86bb693da0a4/releaseme-0.2.4.zip" } ], "0.2.6": [ { "comment_text": "", "digests": { "md5": "109593d080e61d462b06a37e26ac0c3d", "sha256": "caf7fce427ba50135464f4f57ecb54d49d2be6b82d6630992ff7fb26562c0ced" }, "downloads": -1, "filename": "releaseme-0.2.6.tar.gz", "has_sig": false, "md5_digest": "109593d080e61d462b06a37e26ac0c3d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5843, "upload_time": "2014-06-05T17:47:06", "url": "https://files.pythonhosted.org/packages/b5/63/62c9f99119286515337434a04b7d7287e11f69db996eec8faec9a2122c6a/releaseme-0.2.6.tar.gz" }, { "comment_text": "", "digests": { "md5": "803dc037dc119209db2099b0e8029d1a", "sha256": "b47dd8b5024443cb084e703b660d3b3d2d230c851135a72145051c41aa6b7fca" }, "downloads": -1, "filename": "releaseme-0.2.6.zip", "has_sig": false, "md5_digest": "803dc037dc119209db2099b0e8029d1a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12118, "upload_time": "2014-06-05T17:46:52", "url": "https://files.pythonhosted.org/packages/97/d2/9457ac4fcb9caa0decf7ddff8779167b723268ff7b31d13ab7b0b1eb14ad/releaseme-0.2.6.zip" } ], "0.2.7": [ { "comment_text": "", "digests": { "md5": "b7ed4f09a653892ca7bcf47ee5febc74", "sha256": "5f78f814b2ab30505ef0117c63ede88257946acc88a75d1236a663f6ed1261f8" }, "downloads": -1, "filename": "releaseme-0.2.7-py2-none-any.whl", "has_sig": false, "md5_digest": "b7ed4f09a653892ca7bcf47ee5febc74", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 8989, "upload_time": "2014-10-17T04:21:33", "url": "https://files.pythonhosted.org/packages/8b/9d/d7abae2c0227ffaa8705d0b6f17307fdf0cd859d8c1b370d79a165898533/releaseme-0.2.7-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8c532ed4fd13cb78a7e78d19ffe83423", "sha256": "8a3e0f1657a9bccecef6a59a8b392f3469d6eeb828302dac4d852f3794d25348" }, "downloads": -1, "filename": "releaseme-0.2.7.tar.gz", "has_sig": false, "md5_digest": "8c532ed4fd13cb78a7e78d19ffe83423", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5581, "upload_time": "2014-10-17T04:21:39", "url": "https://files.pythonhosted.org/packages/8d/50/1438fded9f351e8f3d5ee11fb8d5c3e48997679ec1e81d0a7e4c020389cf/releaseme-0.2.7.tar.gz" }, { "comment_text": "", "digests": { "md5": "22671c2c13c3feae5a279f64aafca349", "sha256": "454ca78dd2432a67a520e20f3b86bb4e4c327a0ab9c4146ed72449cea614e524" }, "downloads": -1, "filename": "releaseme-0.2.7.zip", "has_sig": false, "md5_digest": "22671c2c13c3feae5a279f64aafca349", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11654, "upload_time": "2014-10-17T04:21:36", "url": "https://files.pythonhosted.org/packages/f2/5c/ea68e5b0d64598cb240ceaa75d93c45f03d134121516e4cfcbac6402190f/releaseme-0.2.7.zip" } ], "0.2.8": [ { "comment_text": "", "digests": { "md5": "2f85269b0a8c199dc31efc2024091b8a", "sha256": "2302b3803dd956a9e2f00df9c9cba45dbcddbeabdfef0c2f88cd671a9fa76437" }, "downloads": -1, "filename": "releaseme-0.2.8-py2-none-any.whl", "has_sig": false, "md5_digest": "2f85269b0a8c199dc31efc2024091b8a", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 8980, "upload_time": "2014-10-17T04:23:47", "url": "https://files.pythonhosted.org/packages/db/78/2da8b52fa29243f353d66676c5fcda33ff2964d956178e37e1dffdc45577/releaseme-0.2.8-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "79f2a2ea6e06167c66341412dc88d8a3", "sha256": "2df71e9eb69c42fea596eba2e41018b6de603170eddee6aca478dc08c6ecb9e9" }, "downloads": -1, "filename": "releaseme-0.2.8.tar.gz", "has_sig": false, "md5_digest": "79f2a2ea6e06167c66341412dc88d8a3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5581, "upload_time": "2014-10-17T04:23:53", "url": "https://files.pythonhosted.org/packages/56/0b/4f0ac13b3c12d1b0cace87c3a70ef2823fc4e17bd6fbcbf57c26271df340/releaseme-0.2.8.tar.gz" }, { "comment_text": "", "digests": { "md5": "31e0fe889bb0404288ebea5b148a31ad", "sha256": "139c82e2f5cf29e35fc53fb6e85f5fa812f61668c4ff14840f2b4276740172c3" }, "downloads": -1, "filename": "releaseme-0.2.8.zip", "has_sig": false, "md5_digest": "31e0fe889bb0404288ebea5b148a31ad", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11647, "upload_time": "2014-10-17T04:23:50", "url": "https://files.pythonhosted.org/packages/52/1f/d9b6ba4e287fe0d37ce38b74225f4d042b9d6f7ef333155ee30907468e3f/releaseme-0.2.8.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "2f85269b0a8c199dc31efc2024091b8a", "sha256": "2302b3803dd956a9e2f00df9c9cba45dbcddbeabdfef0c2f88cd671a9fa76437" }, "downloads": -1, "filename": "releaseme-0.2.8-py2-none-any.whl", "has_sig": false, "md5_digest": "2f85269b0a8c199dc31efc2024091b8a", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 8980, "upload_time": "2014-10-17T04:23:47", "url": "https://files.pythonhosted.org/packages/db/78/2da8b52fa29243f353d66676c5fcda33ff2964d956178e37e1dffdc45577/releaseme-0.2.8-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "79f2a2ea6e06167c66341412dc88d8a3", "sha256": "2df71e9eb69c42fea596eba2e41018b6de603170eddee6aca478dc08c6ecb9e9" }, "downloads": -1, "filename": "releaseme-0.2.8.tar.gz", "has_sig": false, "md5_digest": "79f2a2ea6e06167c66341412dc88d8a3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5581, "upload_time": "2014-10-17T04:23:53", "url": "https://files.pythonhosted.org/packages/56/0b/4f0ac13b3c12d1b0cace87c3a70ef2823fc4e17bd6fbcbf57c26271df340/releaseme-0.2.8.tar.gz" }, { "comment_text": "", "digests": { "md5": "31e0fe889bb0404288ebea5b148a31ad", "sha256": "139c82e2f5cf29e35fc53fb6e85f5fa812f61668c4ff14840f2b4276740172c3" }, "downloads": -1, "filename": "releaseme-0.2.8.zip", "has_sig": false, "md5_digest": "31e0fe889bb0404288ebea5b148a31ad", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11647, "upload_time": "2014-10-17T04:23:50", "url": "https://files.pythonhosted.org/packages/52/1f/d9b6ba4e287fe0d37ce38b74225f4d042b9d6f7ef333155ee30907468e3f/releaseme-0.2.8.zip" } ] }