{"id":44014387,"url":"https://github.com/metaborg/gitonium","last_synced_at":"2026-02-07T15:34:14.196Z","repository":{"id":44909438,"uuid":"171890485","full_name":"metaborg/gitonium","owner":"metaborg","description":"Gradle plugin for automatic versioning based on Git branch and tag","archived":false,"fork":false,"pushed_at":"2024-05-22T09:54:02.000Z","size":194,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-05-22T10:55:59.688Z","etag":null,"topics":["git","gradle","gradle-plugin","gradle-plugins","publishing","versioning"],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","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/metaborg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2019-02-21T14:51:40.000Z","updated_at":"2024-07-14T00:20:14.693Z","dependencies_parsed_at":"2024-02-22T14:51:39.449Z","dependency_job_id":"2dc41762-37c6-4b3d-a2d0-efbf104aa011","html_url":"https://github.com/metaborg/gitonium","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/metaborg/gitonium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaborg%2Fgitonium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaborg%2Fgitonium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaborg%2Fgitonium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaborg%2Fgitonium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metaborg","download_url":"https://codeload.github.com/metaborg/gitonium/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaborg%2Fgitonium/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29198178,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T14:35:27.868Z","status":"ssl_error","status_checked_at":"2026-02-07T14:25:51.081Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["git","gradle","gradle-plugin","gradle-plugins","publishing","versioning"],"created_at":"2026-02-07T15:34:13.071Z","updated_at":"2026-02-07T15:34:14.189Z","avatar_url":"https://github.com/metaborg.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n!! THIS FILE WAS GENERATED USING repoman !!\nModify `repo.yaml` instead and use `repoman` to update this file\nSee: https://github.com/metaborg/metaborg-gradle/\n--\u003e\n\n# Gitonium\n[![Build][github-badge:build]][github:build]\n[![License][license-badge]][license]\n[![GitHub Release][github-badge:release]][github:release]\n[![Documentation][documentation-badge]][documentation]\n\nGitonium is a Gradle plugin for automatic versioning based on the current Git branch and/or tag.\n\n\n[![Documentation][documentation-button]][documentation]\n\n## Spoofax 3 Artifacts\n\n\n\n| Gradle Plugin | Latest Release | Latest Snapshot |\n|---------------|----------------|-----------------|\n| `org.metaborg.gitonium` | [![Release][mvn-rel-badge:org.metaborg.gitonium:org.metaborg.gitonium.gradle.plugin]][mvn:org.metaborg.gitonium:org.metaborg.gitonium.gradle.plugin] | [![Snapshot][mvn-snap-badge:org.metaborg.gitonium:org.metaborg.gitonium.gradle.plugin]][mvn:org.metaborg.gitonium:org.metaborg.gitonium.gradle.plugin] |\n\n\n\n## Requirements\nGradle 7 or higher is required. The code snippets in this README assume you are using Gradle with Kotlin, but should be translatable to Groovy as well.\n\n\n## Prerequisites\nThe Gitonium plugin is not yet published to the Gradle plugins repository. Therefore, to enable downloading the plugin, add our repository to your `settings.gradle(.kts)` file:\n\n```kotlin\npluginManagement {\n    repositories {\n        maven(\"https://artifacts.metaborg.org/content/repositories/releases/\")\n    }\n}\n```\n\n\n## Applying the plugin\nApply the gitonium plugin to a project (a `build.gradle(.kts)` file) as follows:\n\n```kotlin\nplugins {\n    id(\"org.metaborg.gitonium\") version \"\u003cversion\u003e\"\n}\n\nversion = gitonium.version\n```\n\nThe latest version of the plugin can be found at the top of this README. Gitonium will then lazily set the version of the project, and all sub-projects, to a version based on the Git repository. To override the version of a project, simply set the version manually, and this will override the lazily set version.\n\n\n## Usage\nGitonium sets the version of the project based on the latest version tag (of the form `release-{version}`) found on the current branch. For example, if the HEAD of the current branch is tagged `release-0.1.3`, then the version is assigned `0.1.3`. Alternatively, if an earlier commit on the `develop` branch is tagged `release-0.1.3`, then the version `0.1.4-develop-SNAPSHOT` is assigned, one patch version higher than the last release.\n\nIf no release tag was found, the version is not set and therefore defaults to Gradle's default version of `unspecified`.\n\nIf the repository has no HEAD, Gitonium will fail.\n\n\u003e [!IMPORTANT]\n\u003e A shallow clone of a repository (as commonly performed by CI) might not checkout the tags of the repository.\n\u003e In this case, Gitonium will fail to find the version tag.\n\u003e\n\u003e For example, when using GitHub CI `actions/checkout` action, specify a non-shallow checkout including tags:\n\u003e\n\u003e ```yaml\n\u003e - name: Checkout\n\u003e   uses: actions/checkout@v4\n\u003e   with:\n\u003e     fetch-depth: 0\n\u003e     fetch-tags: true\n\u003e  ```\n\n\n## License\nCopyright 2018-2024 [Programming Languages Group](https://pl.ewi.tudelft.nl/), [Delft University of Technology](https://www.tudelft.nl/)\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at \u003chttps://www.apache.org/licenses/LICENSE-2.0\u003e\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an **\"as is\" basis, without warranties or conditions of any kind**, either express or implied. See the License for the specific language governing permissions and limitations under the License.\n\n[github-badge:build]: https://img.shields.io/github/actions/workflow/status/metaborg/gitonium/build.yaml\n[github:build]: https://github.com/metaborg/gitonium/actions\n[license-badge]: https://img.shields.io/github/license/metaborg/gitonium\n[license]: https://github.com/metaborg/gitonium/blob/master/LICENSE.md\n[github-badge:release]: https://img.shields.io/github/v/release/metaborg/gitonium?display_name=release\n[github:release]: https://github.com/metaborg/gitonium/releases\n[documentation-badge]: https://img.shields.io/badge/docs-latest-brightgreen\n[documentation]: https://spoofax.dev/gitonium/\n[documentation-button]: https://img.shields.io/badge/Documentation-blue?style=for-the-badge\u0026logo=googledocs\u0026logoColor=white\n[mvn:org.metaborg.gitonium:org.metaborg.gitonium.gradle.plugin]: https://artifacts.metaborg.org/#nexus-search;gav~org.metaborg.gitonium~org.metaborg.gitonium.gradle.plugin~~~\n[mvn-rel-badge:org.metaborg.gitonium:org.metaborg.gitonium.gradle.plugin]: https://img.shields.io/nexus/r/org.metaborg.gitonium/org.metaborg.gitonium.gradle.plugin?server=https%3A%2F%2Fartifacts.metaborg.org\u0026label=%20\n[mvn-snap-badge:org.metaborg.gitonium:org.metaborg.gitonium.gradle.plugin]: https://img.shields.io/nexus/s/org.metaborg.gitonium/org.metaborg.gitonium.gradle.plugin?server=https%3A%2F%2Fartifacts.metaborg.org\u0026label=%20\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetaborg%2Fgitonium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetaborg%2Fgitonium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetaborg%2Fgitonium/lists"}