{"id":24517779,"url":"https://github.com/fstab50/versionpro","last_synced_at":"2025-03-15T11:11:06.087Z","repository":{"id":62587288,"uuid":"228362076","full_name":"fstab50/versionpro","owner":"fstab50","description":"Automated version management for Python projects","archived":false,"fork":false,"pushed_at":"2021-07-11T16:52:20.000Z","size":2524,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-04-26T12:47:59.861Z","etag":null,"topics":["automation","build-automation","build-tools","ci-cd","cicd","continuous-deployment","continuous-integration","pipeline","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fstab50.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-12-16T10:31:48.000Z","updated_at":"2021-07-11T16:52:23.000Z","dependencies_parsed_at":"2022-11-03T22:10:18.704Z","dependency_job_id":null,"html_url":"https://github.com/fstab50/versionpro","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fversionpro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fversionpro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fversionpro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fversionpro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fstab50","download_url":"https://codeload.github.com/fstab50/versionpro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243719399,"owners_count":20336607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","build-automation","build-tools","ci-cd","cicd","continuous-deployment","continuous-integration","pipeline","python3"],"created_at":"2025-01-22T01:35:13.447Z","updated_at":"2025-03-15T11:11:06.065Z","avatar_url":"https://github.com/fstab50.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"top\"\u003e\u003c/a\u003e\n* * *\n# Version Pro\n* * *\n\n## Summary\n\nPython 3 build automation utility for managing Python project version labels\n\n    * Easily imported into any Code project\n    * Conveniently called by build logic to update version prior to deployment\n\n**Version**: 0.6.7\n\n* * *\n\n## Contents\n\n* [**Dependencies**](#dependencies)\n\n* [**Installation**](#installation)\n\n* [**Options**](#options)\n\n* [**Use**](#use)\n\n* [**Author \u0026 Copyright**](#author--copyright)\n\n* [**License**](#license)\n\n* [**Disclaimer**](#disclaimer)\n\n--\n\n[back to the top](#top)\n\n* * *\n\n## Dependencies\n\n### I. Runtime Environment\n\n* [Python 3.6+](https://docs.python.org/3/).\n* [Libtools](https://github.com/fstab50/libtools) General utilities library\n\n### II. Projects\n\nEach Python project you for which you wish to automate versioning must:\n\n* Store version number in a python module (file ending in '.py').  Module must contain `version` in the name.  Examples:\n    * `_version.py`\n    * `version.py`\n\n* Have a `DESCRIPTION.rst` file.  File must contain a line `PACKAGE = \u003cdir containing python modules\u003e`. Example:\n\n    ```\n    $ cat DESCRIPTION.rst\n    ```\n\n    [![description](./assets/description.rst.png)](http://images.awspros.world/versionpro/description.rst.png)\u0026nbsp;\n\n--\n\n[back to the top](#top)\n\n* * *\n## Installation\n\n**versionpro** may be installed on Linux via [pip, python package installer](https://pypi.org/project/pip) in one of 3 slightly different ways:\n\n1. Global install **versionpro** for a single user:\n\n    ```\n    $  pip3 install versionpro --user\n    ```\n\n2. Global install **versionpro** for all users (Linux):\n\n    ```\n    $  sudo -H pip3 install versionpro\n    ```\n\n3. Installation for only 1 project (virtual environment install):\n\n    ```\n    $ cd  \u003cproject root\u003e\n    $ . p3_venv/bin/activate     # virtual env = p3_venv\n    $  pip install versionpro\n    ```\n\nMethods 1 and 2, one installation of **versionpro** will work for all local python 3 projects. For method 3, each python 3 project requires its own installation of **versionpro**.\n\n[back to the top](#top)\n\n* * *\n## Options\n\n```bash\n$ versionpro --help\n```\n\n[![help](./assets/help-menu.png)](http://images.awspros.world/versionpro/help-menu.png)\u0026nbsp;\n\n--\n\n[back to the top](#top)\n\n* * *\n## Use\n\n**versionpro** automatically extracts the current project name from either DESCRIPTION.rst or MANIFEST.ln artifacts. Before issuing any of the following commands, cd to the project root directory (top level).\n\n\n1. Increment project version:\n\n    ```bash\n    $ versionpro  --update\n    ```\n\n2. Hard Set project version::\n\n    ```bash\n    $ versionpro  --update --force-set 1.8.1\n    ```\n\n3. Utilise pypi version instead of project version:\n\n    ```bash\n    $ versionpro  --update --pypi\n    ```\n\n4. Dry (test only) run, no actual version update:\n\n    ```bash\n    $ versionpro  --dryrun\n    ```\n\n[![dryrun](./assets/dryrun.png)](http://images.awspros.world/versionpro/dryrun.png)\u0026nbsp;\n\n--\n\n[back to the top](#top)\n\n* * *\n\n## Author \u0026 Copyright\n\nAll works contained herein copyrighted via below author unless work is explicitly noted by an alternate author.\n\n* Copyright Blake Huber, All Rights Reserved.\n\n[back to the top](#top)\n\n* * *\n\n## License\n\n* Software contained in this repo is licensed under the [license agreement](./LICENSE.md).  You may display the license and copyright information by issuing the following command:\n\n```\n$ versionpro --version\n```\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"http://images.awspros.world/versionpro/version-copyright_large.png\" target=\"_blank\"\u003e\u003cimg src=\"./assets/version-copyright.png\"\u003e\n\u003c/p\u003e\n\n[back to the top](#top)\n\n* * *\n\n## Disclaimer\n\n*Code is provided \"as is\". No liability is assumed by either the code's originating author nor this repo's owner for their use at AWS or any other facility. Furthermore, running function code at AWS may incur monetary charges; in some cases, charges may be substantial. Charges are the sole responsibility of the account holder executing code obtained from this library.*\n\nAdditional terms may be found in the complete [license agreement](./LICENSE.md).\n\n[back to the top](#top)\n\n* * *\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffstab50%2Fversionpro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffstab50%2Fversionpro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffstab50%2Fversionpro/lists"}