{"id":14979993,"url":"https://github.com/allegro/axion-release-plugin","last_synced_at":"2025-05-14T20:04:38.327Z","repository":{"id":20807363,"uuid":"24092835","full_name":"allegro/axion-release-plugin","owner":"allegro","description":"Gradle release \u0026 version management plugin.","archived":false,"fork":false,"pushed_at":"2025-04-28T20:20:05.000Z","size":2841,"stargazers_count":579,"open_issues_count":86,"forks_count":160,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-28T21:35:17.632Z","etag":null,"topics":["gradle","gradle-plugin","gradle-release","hacktoberfest","release","release-automation","semantic-versioning","versioning"],"latest_commit_sha":null,"homepage":"https://axion-release-plugin.readthedocs.io/","language":"Groovy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/allegro.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,"zenodo":null}},"created_at":"2014-09-16T09:09:16.000Z","updated_at":"2025-04-25T10:38:48.000Z","dependencies_parsed_at":"2023-02-16T07:45:25.729Z","dependency_job_id":"ae21b8d4-819b-4bd7-ab37-3183530b6c0f","html_url":"https://github.com/allegro/axion-release-plugin","commit_stats":{"total_commits":675,"total_committers":95,"mean_commits":7.105263157894737,"dds":0.682962962962963,"last_synced_commit":"48ba8e133a8e9de77b2a02910182aa378210003c"},"previous_names":[],"tags_count":105,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allegro%2Faxion-release-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allegro%2Faxion-release-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allegro%2Faxion-release-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allegro%2Faxion-release-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/allegro","download_url":"https://codeload.github.com/allegro/axion-release-plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254219354,"owners_count":22034396,"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":["gradle","gradle-plugin","gradle-release","hacktoberfest","release","release-automation","semantic-versioning","versioning"],"created_at":"2024-09-24T14:01:04.680Z","updated_at":"2025-05-14T20:04:38.298Z","avatar_url":"https://github.com/allegro.png","language":"Groovy","funding_links":[],"categories":[],"sub_categories":[],"readme":"axion-release-plugin\n====\n\n*gradle release and version management plugin*\n\n[![Build Status](https://github.com/allegro/axion-release-plugin/actions/workflows/ci.yml/badge.svg)](https://github.com/allegro/axion-release-plugin/actions/workflows/ci.yml)\n[![readthedocs](https://readthedocs.org/projects/axion-release-plugin/badge/?version=latest) ](http://axion-release-plugin.readthedocs.org/en/latest/)\n![Maven Central](https://img.shields.io/maven-central/v/pl.allegro.tech.build/axion-release-plugin)\n[![Gradle Plugin Portal](https://img.shields.io/gradle-plugin-portal/v/pl.allegro.tech.build.axion-release?versionPrefix=1.1)](https://plugins.gradle.org/plugin/pl.allegro.tech.build.axion-release)\n\nReleasing versions in Gradle is very different from releasing in Maven. Maven came with\n[maven-release-plugin](http://maven.apache.org/maven-release/maven-release-plugin/) which\ndid all the dirty work. Gradle has no such tool and probably doesn't need it anyway. Evolution of software craft came\nto the point, when we start thinking about SCM as ultimate source of truth about project version. Version should not be\nhardcoded in **pom.xml** or **build.gradle**.\n\n**axion-release-plugin** embraces this philosophy. Instead of reading project version from buildfile, it is derived\nfrom nearest tag in SCM (or set to default if nothing was tagged). If current commit is tagged commit, project has\na release version. If there were any commits after last tag, project is in SNAPSHOT version. This very simple and\nintuitive philosophy, alongside with [Semantic Versioning](http://semver.org/) rules, makes it a lot easier to manage\nproject versions along SCM tag versions.\n\nJDK11+ \u0026 Gradle 7+ required.\n\n## Basic usage\n\n```kotlin\nplugins {\n    id(\"pl.allegro.tech.build.axion-release\") version \"1.18.7\"\n}\n\nversion = scmVersion.version\n```\n\n```\n$ git tag\n\u003cempty list\u003e\n\n$ ./gradlew currentVersion\n0.1.0-branch-SNAPSHOT\n\n$ ./gradlew release\n\n$ git tag\nv0.1.0\n\n$ ./gradlew cV\n0.1.0\n\n$ git add -A \u0026\u0026 git commit -m \"Updates something\" \u0026\u0026 ./gradlew release\n\n$ git tag\nv0.1.0\nv0.1.1\n\n$ ./gradlew cV\n0.1.1\n```\n\n## Documentation\n\nDocumentation is available at [axion-release read the docs](https://readthedocs.org/docs/axion-release-plugin/en/latest).\n\n## License\n\n**axion-release-plugin** is published under [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallegro%2Faxion-release-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallegro%2Faxion-release-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallegro%2Faxion-release-plugin/lists"}