{"id":25424968,"url":"https://github.com/pxbunny/update-tags","last_synced_at":"2025-10-31T15:30:25.502Z","repository":{"id":214888898,"uuid":"737058791","full_name":"dae-ne/update-tags","owner":"dae-ne","description":"GitHub Action for auto-updating tags using semantic versioning.","archived":false,"fork":false,"pushed_at":"2024-08-13T20:53:37.000Z","size":398,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-14T22:06:56.510Z","etag":null,"topics":["automation","git-tags","github-action","semantic-versioning","tags"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dae-ne.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":"2023-12-29T17:25:19.000Z","updated_at":"2024-08-13T21:06:32.000Z","dependencies_parsed_at":"2023-12-31T18:27:51.057Z","dependency_job_id":"2c5ca77d-cf6a-481f-bc60-06de127d985d","html_url":"https://github.com/dae-ne/update-tags","commit_stats":null,"previous_names":["dae-ne/update-tags"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dae-ne%2Fupdate-tags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dae-ne%2Fupdate-tags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dae-ne%2Fupdate-tags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dae-ne%2Fupdate-tags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dae-ne","download_url":"https://codeload.github.com/dae-ne/update-tags/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239207605,"owners_count":19600021,"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":["automation","git-tags","github-action","semantic-versioning","tags"],"created_at":"2025-02-16T23:18:34.772Z","updated_at":"2025-10-31T15:30:25.467Z","avatar_url":"https://github.com/dae-ne.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Update Tags - GitHub Action\n\nGitHub action that updates tags in a repository (still in development). Uses the [semantic versioning](https://semver.org/) to update the tags.\n\n\n## Inputs\n\n- `type`: The type of version update. The value can be **patch**, **minor**, or **major**. The default value is **patch**.\n- `version`: The specific version to update. The value can be any valid version string.\n- `skip-push`: A flag to skip pushing the changes to the remote repository. The value can be **true** or **false**. The default value is **false**. Mainly used for local development.\n\n\n## Outputs\n\n- `version`: The updated version.\n- `previous-version`: The previous version.\n\n\n## Usage example\n\n```yaml\nname: Update Tags\n\non:\n  workflow_dispatch:\n    inputs:\n      version:\n        description: 'specific version'\n        required: false\n        type: string\n      update-type:\n        description: 'version update type'\n        required: false\n        default: 'patch'\n        type: choice\n        options:\n          - patch\n          - minor\n          - major\n\njobs:\n  test:\n    runs-on: ubuntu-latest\n    permissions:\n      contents: write\n    steps:\n      - name: Checkout\n        uses: actions/checkout@v4\n      - name: Update tags\n        uses: dae-ne/update-tags@main # note that it's still in development, the version will be updated later (e.g. dae-ne/update-tags@v1)\n        with:\n          type: ${{ github.event.inputs.update-type }}\n          version: ${{ github.event.inputs.version }}\n```\n\n\n## User scenarios\n\nThe following examples show how to use the action in different scenarios.\n\n### Patch version bump\n\n**User scenario:** As an action user, I want to update the patch version of a repository to create a new release. The current version is `1.2.3`.\n\n**Solution:** Set the `type` input to `patch` and run the action.\n\n**Result:** The version is updated to `1.2.4`. The following tags are created or updated to point to the latest version:\n\n- `1.2.4`\n- `1.2`\n- `1`\n- `latest`\n\n### Minor version bump\n\n**User scenario:** As an action user, I want to update the minor version of a repository to create a new release. The current version is `v2.3.4`.\n\n**Solution:** Set the `type` input to `minor` and run the action.\n\n**Result:** The version is updated to `v2.4.0`. The following tags are created or updated to point to the latest version:\n\n- `v2.4.0`\n- `v2.4`\n- `v2`\n- `latest`\n\n### Major version bump\n\n**User scenario:** As an action user, I want to update the major version of a repository to create a new release. The current version is `v1.2.3`.\n\n**Solution:** Set the `type` input to `major` and run the action.\n\n**Result:** The version is updated to `v2.0.0`. The following tags are created or updated to point to the latest version:\n\n- `v2.0.0`\n- `v2.0`\n- `v2`\n- `latest`\n\n### Pre-release version update\n\n**User scenario:** As an action user, I want to create a pre-release vestion `v1.2.3-alpha.1`.\n\n**Solution:** Set the `version` input to `v1.2.3-alpha.1` and run the action.\n\n**Result:** The version is updated to `v1.2.3-alpha.1`. Only the `v1.2.3-alpha.1` tag is created.\n\n\n## Notes\n\n- When incrementing version using the `type` input, the latest full version, non pre-release, is used as a base. For example, even if the current version is `v1.2.0-alpha.1`, the `minor` type will increment the latest `v1.1.23` version to `v1.2.0`.\n\n- The `v` prefix can be used, but it's not required. Both `1.2.3` and `v1.2.3` are valid version strings.\n\n- When creating a development version, e.g. an initial `v0.1.0`, the `v0` tag is omitted (`v0.1.0`, `v0.1`, and `latest` are created as usual). Similarly, when creating a `v0.0.x` (e.g. `v0.0.1`), the `v0` and `v0.0` tags are omitted.\n\n\n## Run locally\n\n1. Clone the repository\n2. Install the dependencies using `npm install`\n3. Run the `npm run prepare` command to set up the environment\n4. Set input values in the `.env.dev` file\n5. Run the action using `npm run dev`\n\n\n## License\n\nGPL-3.0 - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpxbunny%2Fupdate-tags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpxbunny%2Fupdate-tags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpxbunny%2Fupdate-tags/lists"}