{"id":15837575,"url":"https://github.com/muhammad-fiaz/checkversions","last_synced_at":"2026-01-20T13:01:48.211Z","repository":{"id":211242155,"uuid":"728217267","full_name":"muhammad-fiaz/checkversions","owner":"muhammad-fiaz","description":"CheckVersions is a powerful and intuitive version comparison tool designed to simplify the process of discerning the latest and older versions in software development.","archived":false,"fork":false,"pushed_at":"2024-12-02T12:42:58.000Z","size":84,"stargazers_count":1,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-05T03:19:18.022Z","etag":null,"topics":["check","check-version","check-versions","checkversion","checkversions","compare-version","compare-versions","major","minor","patch","pip","python","python-package","python3","version","version-check","version-checker","version-compare","version-control","version-number"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/checkversions/","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/muhammad-fiaz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["muhammad-fiaz"],"patreon":"muhammad_fiaz","ko_fi":"muhammadfiaz","open_collective":"muhammadfiaz"}},"created_at":"2023-12-06T13:30:55.000Z","updated_at":"2024-09-13T14:58:45.000Z","dependencies_parsed_at":"2023-12-07T10:32:33.268Z","dependency_job_id":"d13f93e1-2e5e-4794-9d7d-93585b3f996f","html_url":"https://github.com/muhammad-fiaz/checkversions","commit_stats":{"total_commits":50,"total_committers":4,"mean_commits":12.5,"dds":0.28,"last_synced_commit":"9de63f015da4f7d2448271b947bc3201bae27759"},"previous_names":["muhammad-fiaz/checkversions"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/muhammad-fiaz/checkversions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammad-fiaz%2Fcheckversions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammad-fiaz%2Fcheckversions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammad-fiaz%2Fcheckversions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammad-fiaz%2Fcheckversions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muhammad-fiaz","download_url":"https://codeload.github.com/muhammad-fiaz/checkversions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammad-fiaz%2Fcheckversions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28603404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T12:01:53.233Z","status":"ssl_error","status_checked_at":"2026-01-20T12:01:46.545Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["check","check-version","check-versions","checkversion","checkversions","compare-version","compare-versions","major","minor","patch","pip","python","python-package","python3","version","version-check","version-checker","version-compare","version-control","version-number"],"created_at":"2024-10-05T15:40:45.534Z","updated_at":"2026-01-20T13:01:48.194Z","avatar_url":"https://github.com/muhammad-fiaz.png","language":"Python","funding_links":["https://github.com/sponsors/muhammad-fiaz","https://patreon.com/muhammad_fiaz","https://ko-fi.com/muhammadfiaz","https://opencollective.com/muhammadfiaz","https://buymeacoffee.com/muhammadfiaz","https://patreon.com/muhammadfiaz"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n\r\n# CheckVersions\r\n\r\n[![Run Tests](https://github.com/muhammad-fiaz/checkversions/actions/workflows/python-package.yml/badge.svg)](https://github.com/muhammad-fiaz/checkversions/actions/workflows/python-package.yml)\r\n[![PyPI Version](https://img.shields.io/pypi/v/checkversions)](https://pypi.org/project/checkversions/)\r\n[![Python Versions](https://img.shields.io/pypi/pyversions/checkversions)](https://pypi.org/project/checkversions/)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\r\n[![Downloads](https://img.shields.io/pypi/dm/checkversions)](https://pypi.org/project/checkversions/)\r\n[![Last Commit](https://img.shields.io/github/last-commit/muhammad-fiaz/checkversions)](https://github.com/muhammad-fiaz/checkversions)\r\n[![GitHub Issues](https://img.shields.io/github/issues/muhammad-fiaz/checkversions)](https://github.com/muhammad-fiaz/checkversions/issues)\r\n[![GitHub Stars](https://img.shields.io/github/stars/muhammad-fiaz/checkversions)](https://github.com/muhammad-fiaz/checkversions/stargazers)\r\n[![GitHub Forks](https://img.shields.io/github/forks/muhammad-fiaz/checkversions)](https://github.com/muhammad-fiaz/checkversions/network)\r\n\r\n[![Maintainer](https://img.shields.io/badge/Maintainer-muhammad--fiaz-blue)](https://github.com/muhammad-fiaz)\r\n[![Sponsor on GitHub](https://img.shields.io/badge/Sponsor%20on%20GitHub-Become%20a%20Sponsor-blue)](https://github.com/sponsors/muhammad-fiaz)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\r\n[![Stability](https://img.shields.io/badge/Stability-Stable-green)](https://github.com/muhammad-fiaz/checkversions)\r\n\r\n\u003c/div\u003e\r\n\r\n\r\nCheckVersions is a powerful and intuitive version comparison tool designed to simplify the process of discerning the latest and older versions in software development.\r\n\r\n## Features\r\n\r\n- **Semantic Version Analysis:** 🧐 Leverage our sophisticated semantic versioning analysis engine to compare versions like \"0.0.0-beta\" effortlessly.\r\n\r\n- **Automated Version Ranking:** 🚀 CheckVersions automatically ranks versions based on their priority, allowing you to quickly identify the latest version.\r\n\r\n- **Efficient Version Delta Assessment:** 📊 CheckVersions provides a simple and efficient way to assess the difference between two versions.\r\n\r\n- **User-Friendly Interface:** 🎨 Our intuitive user interface ensures that developers can effortlessly compare versions.\r\n\r\n- **Secure Version Analysis:** 🔒 Security is paramount. CheckVersions ensures version comparison is performed securely, protecting your intellectual property and facilitating risk-free decision-making in your development process.\r\n\r\n- **Custom Hierarchy** 📝 Customize the hierarchy of version words to suit your needs. For instance, you can assign a higher priority to \"beta\" than \"alpha\" if you wish.\r\n\r\n- **Older Version Retrieval:** ⏳ Optionally retrieve the older version when comparing two versions by setting the `older_version` parameter to `True`.\r\n\r\n## Getting Started\r\n\r\n## Installation\r\n\r\n```bash\r\npip install checkversions\r\n```\r\n## Usage\r\n```python3\r\nfrom checkversions import *\r\n\r\n# Example 1: Basic Version Comparison\r\ncurrent_version = \"v1.0.0\"\r\nlatest_version = \"v1.0.0-beta\"\r\nresult = compare_versions(current_version, latest_version)\r\nprint(result)\r\n# Output: v1.0.0\r\n```\r\nIn this example, we demonstrate a basic version comparison. The compare_versions function is used to compare the current_version (v1.0.0) with the latest_version (v1.0.0-beta). The result is printed, and it shows that the latest version is v1.0.0.\r\n\r\n```python3\r\nfrom checkversions import *\r\n\r\n# Example 2: Comparing Versions with Hyphens and Words\r\nversion1 = \"2.0.0-beta\"\r\nversion2 = \"2.0.1-alpha\"\r\nresult = compare_versions(version1, version2)\r\nprint(result)\r\n# Output: 2.0.1-alpha\r\n\r\n```\r\nIn this example, we showcase version comparison with hyphens and additional words. The compare_versions function compares version1 (2.0.0-beta) with version2 (2.0.1-alpha). The result is printed, indicating that the latest version is 2.0.1-alpha.\r\n\r\n## Default Hierarchy\r\n```json\r\n{\r\n  \"beta\": 0,\r\n  \"prerelease\": 1,\r\n  \"alpha\": 2,\r\n  \"unstable\": 3,\r\n  \"stable\": 4,\r\n  \"release\": 5\r\n}\r\n\r\n```\r\nThe default hierarchy is a JSON representation that assigns priority values to version words. For instance, \"beta\" has a priority of 0, \"prerelease\" has a priority of 1, and so on.\r\n\r\n## Custom Hierarchy\r\n\r\n```python3\r\nfrom checkversions import *\r\n\r\n# Example 3: Custom Hierarchy\r\n# Define a custom hierarchy\r\ncustom_hierarchy = {\"beta\": 0, \"alpha\": 1, \"rc\": 2, \"gamma\": 3, \"stable\": 4}\r\n\r\nversion1 = \"v1.0.0-beta\"\r\nversion2 = \"v1.0.1-alpha\"\r\nresult = compare_versions(version1, version2, custom_hierarchy)\r\nprint(result)\r\n# Output: v1.0.1-alpha\r\n\r\n```\r\nIn this example, we introduce a custom hierarchy for version comparison. The custom_hierarchy dictionary is defined with version words and their corresponding priority. The compare_versions function uses this custom hierarchy to compare version1 (v1.0.0-beta) with version2 (v1.0.1-alpha). The result is printed, indicating that the latest version is v1.0.1-alpha.\r\n\r\n## Older Version\r\n\r\n```python3\r\nfrom checkversions import *\r\ncurrent_version = \"v1.0.0\"\r\nlatest_version = \"v1.0.0-beta\"\r\n# Example with older_version=True\r\nresult_older = compare_versions(current_version, latest_version, older_version=True)\r\nprint(f\"Older version: {result_older}\")\r\n# Output: Older version: v1.0.0-beta\r\n```\r\nIn this example, by setting older_version=True, the function returns and prints the older version (v1.0.0-beta) based on the provided versions (v1.0.0 and v1.0.0-beta). If older_version is omitted or set to False, it would return and print the latest version.\r\n\r\n## Contributing\r\nContributions are welcome! Before contributing, please read our [Contributing Guidelines](CONTRIBUTING.md) to ensure a smooth and collaborative development process.\r\n\r\n## Code of Conduct\r\n\r\nPlease review our [Code of Conduct](CODE_OF_CONDUCT.md) to understand the standards of behavior we expect from contributors and users of this project.\r\n\r\n## License\r\nThis project is licensed under the [MIT License](). See [LICENSE](LICENSE) for more details.\r\n\r\n## Support the Project\r\n\u003cbr\u003e\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n\u003ch5\u003e \u003cstrong\u003e 💰 You can help me improve more by offering a little support on any platform❤️\u003c/strong\u003e\u003c/h5\u003e\r\n\r\n[![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://buymeacoffee.com/muhammadfiaz) [![Patreon](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge\u0026logo=patreon\u0026logoColor=white)](https://patreon.com/muhammadfiaz) [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/muhammadfiaz)\r\n[![Sponsor muhammad-fiaz](https://img.shields.io/badge/Sponsor-%231EAEDB.svg?\u0026style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=white)](https://github.com/sponsors/muhammad-fiaz)\r\n[![Open Collective Backer](https://img.shields.io/badge/Open%20Collective-Backer-%238CC84B?style=for-the-badge\u0026logo=open-collective\u0026logoColor=white)](https://opencollective.com/muhammadfiaz)\r\n\u003c/div\u003e\r\n\r\n\r\n\r\n## Happy Coding ❤️\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhammad-fiaz%2Fcheckversions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuhammad-fiaz%2Fcheckversions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhammad-fiaz%2Fcheckversions/lists"}