{"id":16061257,"url":"https://github.com/akx/hatch-calver","last_synced_at":"2025-09-13T10:36:20.536Z","repository":{"id":257398858,"uuid":"858176149","full_name":"akx/hatch-calver","owner":"akx","description":"CalVer versioning scheme for Hatch","archived":false,"fork":false,"pushed_at":"2024-09-26T10:23:59.000Z","size":11,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-06T05:25:26.599Z","etag":null,"topics":["calver","hatch","hatch-plugin","python-packaging","versioning"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/hatch-calver","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/akx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2024-09-16T12:51:40.000Z","updated_at":"2024-12-18T01:07:55.000Z","dependencies_parsed_at":"2024-09-16T13:42:06.178Z","dependency_job_id":"e89d4f03-db75-4169-8787-b2afe35583b6","html_url":"https://github.com/akx/hatch-calver","commit_stats":null,"previous_names":["akx/hatch-calver"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/akx/hatch-calver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akx%2Fhatch-calver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akx%2Fhatch-calver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akx%2Fhatch-calver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akx%2Fhatch-calver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akx","download_url":"https://codeload.github.com/akx/hatch-calver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akx%2Fhatch-calver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274949581,"owners_count":25379446,"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","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["calver","hatch","hatch-plugin","python-packaging","versioning"],"created_at":"2024-10-09T04:08:22.196Z","updated_at":"2025-09-13T10:36:20.514Z","avatar_url":"https://github.com/akx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hatch-calver\n\nA plugin for [hatch][hatch] to support [calendar versioning][calver].\n\n## Setup\n\nAdd `hatch-calver` as a build dependency to your project.\n\n```toml\n[build-system]\nrequires = [\n    \"hatchling\",\n    \"hatch-calver\",\n]\nbuild-backend = \"hatchling.build\"\n```\n\nThen, set `tool.hatch.version.scheme` to `\"calver\"`.\n\n```toml\n[tool.hatch.version]\nscheme = \"calver\"\n```\n\n### Configuring the CalVer scheme\n\nYou can optionally set `calver-scheme` to a dot-separated string\nof parts specified in the [calver scheme][calver_scheme] specification.\nIt defaults to `YYYY.MM.DD`.\n\n```toml\n[tool.hatch.version]\nscheme = \"calver\"\ncalver-scheme = \"YY.MM\"\n```\n\nNote that your project's versions should conform to the scheme you specify;\notherwise, determining where to put e.g. patch versions will be quite ambiguous.\n\n## Usage\n\nYou can use Hatch's [standard versioning][hatch_version_updating] commands.\n\nTo update your project's version to the current date, run `hatch version release`\n(or `hatch version date`).\n\nAs with the regular versioning scheme, you can chain multiple segment updates.\nThe date part of the version will _not_ be updated unless you explicitly specify it.\n\nThe CalVer scheme specified for your project specifies which segment of the\nPEP 440 \"release\" segments are automatically determined; for instance, for a `YYYY.MM.DD`\nscheme, the 4th field of the release segment will be considered the `patch` field.\n\nIn other words, if you specify `YYYY.MM.DD` as your scheme, and it's the 16th of September 2024:\n\n| Original version | Command                 | New version     |\n| ---------------- | ----------------------- | --------------- |\n| `2024.07.22`     | `hatch version release` | `2024.09.16`    |\n| `2024.07.22.1`   | `hatch version release` | `2024.09.16`    |\n| `2024.07.22`     | `hatch version date,a`  | `2024.09.16a0`  |\n| `2021.01.01`     | `hatch version rc`      | `2021.01.01rc0` |\n| `2024.7.22`      | `hatch version patch`   | `2024.07.22.1`  |\n\n## Version history\n\n### 2024.9.17\n\n- Initial release\n\n### 2024.9.26\n\n- Changed the `date`/`release` bump instructions to reset any non-date segments.\n  In other words, a `release` bump from `2024.07.22.1` no longer results in `2024.09.16.1`.\n\n[hatch]: https://hatch.pypa.io/\n[hatch_version_updating]: https://hatch.pypa.io/latest/version/#updating\n[hatch_version_segments]: https://hatch.pypa.io/latest/version/#supported-segments\n[calver]: https://calver.org/\n[calver_scheme]: https://calver.org/#scheme\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakx%2Fhatch-calver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakx%2Fhatch-calver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakx%2Fhatch-calver/lists"}