{"id":22117652,"url":"https://github.com/bioblaze/game-semver-action","last_synced_at":"2025-03-24T06:14:17.090Z","repository":{"id":226138116,"uuid":"767872584","full_name":"Bioblaze/game-semver-action","owner":"Bioblaze","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-09T05:49:03.000Z","size":3456,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-29T11:46:09.916Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/Bioblaze.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-03-06T03:34:10.000Z","updated_at":"2025-01-07T06:34:12.000Z","dependencies_parsed_at":"2024-12-01T13:37:56.585Z","dependency_job_id":"a3ec18f6-570a-41d4-b300-ef1e05217168","html_url":"https://github.com/Bioblaze/game-semver-action","commit_stats":null,"previous_names":["bioblaze/game-semver-action"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bioblaze%2Fgame-semver-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bioblaze%2Fgame-semver-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bioblaze%2Fgame-semver-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bioblaze%2Fgame-semver-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bioblaze","download_url":"https://codeload.github.com/Bioblaze/game-semver-action/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245217935,"owners_count":20579300,"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":[],"created_at":"2024-12-01T13:37:47.157Z","updated_at":"2025-03-24T06:14:17.059Z","avatar_url":"https://github.com/Bioblaze.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Game-Semver-Action GitHub Action\n\nThe `Game-Semver-Action` is a GitHub Action designed to automatically generate a new semantic version (semver) for your project based on commit messages. It's tailored for game development workflows but can be easily adapted for any type of project that follows semantic versioning principles.\n\n## Features\n\n- **Commit Message Driven**: Generates new versions by analyzing commit messages for semver cues (`major`, `minor`, `patch`).\n- **Flexible Versioning**: Supports additional identifiers for prerelease versions (e.g., alpha, beta) and can include the commit SHA as build metadata.\n- **Branch Name as Identifier**: Optionally uses the branch name as an identifier for the prerelease versions, adding more context to your versioning.\n\n## Inputs\n\n| Input                   | Description                                                                 | Required | Default |\n|-------------------------|-----------------------------------------------------------------------------|----------|---------|\n| `personal_github_token` | Token to get tags and commits from the repo. Use `secrets.PGITHUB_TOKEN`.   | Yes      | N/A     |\n| `identifier`            | Optional identifier for the version (e.g., beta, alpha).                    | No       | `''`    |\n| `branch_as_identifier`  | Use the branch name as an identifier for prerelease versions.               | No       | `false` |\n| `include_commit_sha`    | Include the commit SHA in the version as build metadata.                    | No       | `false` |\n\n## Outputs\n\n### `build_version`\n\nExample: 0.0.298-alpha+build.ee9050469dca1f407c6f21361054e05181d6a9e9\n\n### `simple_version`\n\nExample: 0.0.298\n\n### `revision_version`\n\nExample: 0.0.298.0\n\n\n```yaml\nsteps:\n  - name: Generate Semver/w Build SHA\n    id: semver\n    uses: Bioblaze/game-semver-action@v9\n    with:\n      personal_github_token: ${{ secrets.PGITHUB_TOKEN }}\n      include_commit_sha: true\n\n  - name: Use the Generated Version\n    run: echo \"The new version is ${{ steps.semver.outputs.build_version }}\"\n```\n\n### `version`\n\nExample: 0.0.298-alpha\n\nThe generated semantic version based on your commit history and action inputs. This version can be used in subsequent workflow steps, for example, to tag a release or to update version files within your project.\n\nTo use this output in another step in your workflow, you can reference it by the step's ID. For example:\n\n```yaml\nsteps:\n  - name: Generate Semver\n    id: semver\n    uses: Bioblaze/game-semver-action@v9\n    with:\n      personal_github_token: ${{ secrets.PGITHUB_TOKEN }}\n\n  - name: Use the Generated Version\n    run: echo \"The new version is ${{ steps.semver.outputs.version }}\"\n```\n\nThis output provides a powerful way to automate your release process, ensuring that each new release is correctly versioned according to the semantic versioning rules and your project's specific requirements.\n\n## Usage\n\nBelow is a sample workflow that demonstrates how to use `Game-Semver-Action`:\n\n```yaml\nname: Auto Versioning\n\non:\n  push:\n    branches:\n      - main\n\njobs:\n  versioning:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v2\n\n      - name: Generate Semver\n        uses: Bioblaze/game-semver-action@v9\n        with:\n          personal_github_token: ${{ secrets.PGITHUB_TOKEN }}\n          identifier: 'beta'\n          branch_as_identifier: false\n          include_commit_sha: true\n```\n\n## License\n\nThis GitHub Action is distributed under the MIT license. See the `LICENSE` file for more details.\n\n---\n\nThis action is maintained by Randolph William Aarseth II \u003crandolph@divine.games\u003e. Please reach out for support or contributions.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbioblaze%2Fgame-semver-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbioblaze%2Fgame-semver-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbioblaze%2Fgame-semver-action/lists"}