{"id":16027772,"url":"https://github.com/followtheprocess/madonna","last_synced_at":"2025-07-29T02:32:12.022Z","repository":{"id":37797041,"uuid":"415100193","full_name":"FollowTheProcess/madonna","owner":"FollowTheProcess","description":"Python semver parsing library.","archived":false,"fork":false,"pushed_at":"2024-12-03T09:37:06.000Z","size":1749,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-03T18:14:22.750Z","etag":null,"topics":["library","python","semver","semver-parser"],"latest_commit_sha":null,"homepage":"https://followtheprocess.github.io/madonna/","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/FollowTheProcess.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing/code_of_conduct.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-08T19:09:08.000Z","updated_at":"2024-12-03T09:37:09.000Z","dependencies_parsed_at":"2024-01-15T19:39:59.387Z","dependency_job_id":"db4eef3c-651d-49f0-81a9-7ad6c0acfa5a","html_url":"https://github.com/FollowTheProcess/madonna","commit_stats":{"total_commits":468,"total_committers":3,"mean_commits":156.0,"dds":"0.33333333333333337","last_synced_commit":"1305fc3f403e6d374444a1f44e19ee57ee8b1fe8"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowTheProcess%2Fmadonna","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowTheProcess%2Fmadonna/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowTheProcess%2Fmadonna/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowTheProcess%2Fmadonna/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FollowTheProcess","download_url":"https://codeload.github.com/FollowTheProcess/madonna/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227971901,"owners_count":17849421,"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":["library","python","semver","semver-parser"],"created_at":"2024-10-08T20:23:24.969Z","updated_at":"2025-07-29T02:32:12.002Z","avatar_url":"https://github.com/FollowTheProcess.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Madonna\n\n[![License](https://img.shields.io/github/license/FollowTheProcess/madonna)](https://github.com/FollowTheProcess/madonna)\n[![PyPI](https://img.shields.io/pypi/v/madonna.svg?logo=python)](https://pypi.python.org/pypi/madonna)\n[![GitHub](https://img.shields.io/github/v/release/FollowTheProcess/madonna?logo=github\u0026sort=semver)](https://github.com/FollowTheProcess/madonna)\n[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![CI](https://github.com/FollowTheProcess/madonna/workflows/CI/badge.svg)](https://github.com/FollowTheProcess/madonna/actions?query=workflow%3ACI)\n[![codecov](https://codecov.io/gh/FollowTheProcess/madonna/branch/main/graph/badge.svg?token=OLMR2P3J6N)](https://codecov.io/gh/FollowTheProcess/madonna)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/FollowTheProcess/madonna/main.svg)](https://results.pre-commit.ci/latest/github/FollowTheProcess/madonna/main)\n\n**A Python semver parsing library.**\n\n* Free software: MIT License\n\n* Documentation: [https://FollowTheProcess.github.io/madonna/](\u003chttps://FollowTheProcess.github.io/madonna/\u003e)\n\n\u003e [!WARNING]\n\u003e `madonna` is no longer under active maintenance. I barely write any python any more, I haven't made changes to it in a while and I'm focussed on other projects 🧠\n\n## Project Description\n\nMadonna is a small, simple [semver] utility library with support for parsing, writing, and otherwise interacting with semantic versions in code.\n\n**Why the stupid name?**\n\nGet it? \"Like a Version\"... 👏🏻\n\nAlso naming things on PyPI is hard!\n\n## Installation\n\n```shell\npip install madonna\n```\n\n## Quickstart\n\nThe only construct in madonna is the `Version` object, you can use it for all sorts of useful things...\n\n### Create a New Version\n\n```python\nfrom madonna import Version\n\nv = Version(major=1, minor=2, patch=4)\n```\n\n### Parse a Version from a string\n\n```python\nfrom madonna import Version\n\nVersion.from_string(\"v1.2.4-rc.1+build.123\")\n# Version(major=1, minor=2, patch=4, prerelease=\"rc.1\", buildmetadata=\"build.123\")\n```\n\n### Or JSON\n\n```python\nfrom madonna import Version\n\nVersion.from_json('{\"major\": 1, \"minor\": 2, \"patch\": 4}')\n```\n\nAnd you can also dump a `Version` to a variety of formats too!\n\n## Contributing\n\n`madonna` is an open source project and, as such, welcomes contributions of all kinds :smiley:\n\nYour best bet is to check out the [contributing guide] in the docs!\n\n### Credits\n\nThis package was created with [cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [FollowTheProcess/cookie_pypackage] project template.\n\n[FollowTheProcess/cookie_pypackage]: https://github.com/FollowTheProcess/cookie_pypackage\n[contributing guide]: https://FollowTheProcess.github.io/madonna/contributing/contributing.html\n[semver]: https://semver.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffollowtheprocess%2Fmadonna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffollowtheprocess%2Fmadonna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffollowtheprocess%2Fmadonna/lists"}