{"id":28425316,"url":"https://github.com/metamask/action-is-release","last_synced_at":"2025-07-06T22:05:56.320Z","repository":{"id":50409576,"uuid":"518970193","full_name":"MetaMask/action-is-release","owner":"MetaMask","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-15T21:43:53.000Z","size":18,"stargazers_count":6,"open_issues_count":3,"forks_count":2,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-06-05T10:50:31.238Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/MetaMask.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},"funding":{"github":null,"patreon":null,"open_collective":"metamask","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2022-07-28T19:25:49.000Z","updated_at":"2025-01-09T19:59:19.000Z","dependencies_parsed_at":"2024-01-15T23:19:05.155Z","dependency_job_id":null,"html_url":"https://github.com/MetaMask/action-is-release","commit_stats":{"total_commits":7,"total_committers":2,"mean_commits":3.5,"dds":0.2857142857142857,"last_synced_commit":"ae1ebc864afddef847279b999952c7b8fbe21005"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/MetaMask/action-is-release","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MetaMask%2Faction-is-release","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MetaMask%2Faction-is-release/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MetaMask%2Faction-is-release/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MetaMask%2Faction-is-release/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MetaMask","download_url":"https://codeload.github.com/MetaMask/action-is-release/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MetaMask%2Faction-is-release/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262022257,"owners_count":23246285,"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":"2025-06-05T10:36:57.705Z","updated_at":"2025-07-06T22:05:56.313Z","avatar_url":"https://github.com/MetaMask.png","language":"Shell","funding_links":["https://opencollective.com/metamask"],"categories":[],"sub_categories":[],"readme":"# action-is-release\n\n## Description\n\nCheck whether the current commit is a release commit. Primarily this action looks at the `.version` key in a repository's `package.json` to see whether it has changed. Optionally, it can also validate that the commit message starts with a specific string.\n\n![image](https://user-images.githubusercontent.com/675259/181828020-b54ef521-20f1-477c-83b4-3e9ac5b91398.png)\n\n## Usage\n\n## Basic usage\n\nThis will look at the current commit, comparing it to `github.event.before` to see whether the `version` field of the `package.json` file in the root directory of the repository has changed. If the version has been updated, `IS_RELEASE` will be set to `true`. Otherwise, it will be set to `false`.\n\n```yaml\njobs:\n  is-release:\n    outputs:\n      IS_RELEASE: ${{ steps.is-release.outputs.IS_RELEASE }}\n    runs-on: ubuntu-latest\n    steps:\n      - uses: MetaMask/action-is-release@v2\n        id: is-release\n```\n\n### Filter by merge commit author\n\nHere is an example of how to use this action with a merge author filter. This will act the same as the previous example, except that it will be skipped if the commit author is anyone other than \"GitHub\". When skipped, `IS_RELEASE` will be unset.\n\n```yaml\njobs:\n  is-release:\n    # Filter by commits made by the author \"github-actions\"\n    if: github.event.head_commit.author.name == 'github-actions'\n    outputs:\n      IS_RELEASE: ${{ steps.is-release.outputs.IS_RELEASE }}\n    runs-on: ubuntu-latest\n    steps:\n      - uses: MetaMask/action-is-release@v2\n        id: is-release\n```\n\n### With specific commit message prefix\n\nHere is an example of how to use the `commit-starts-with` option.\n\n```yaml\njobs:\n  is-release:\n    outputs:\n      IS_RELEASE: ${{ steps.is-release.outputs.IS_RELEASE }}\n    runs-on: ubuntu-latest\n    steps:\n      - uses: MetaMask/action-is-release@v2\n        id: is-release\n        with:\n          commit-starts-with: 'Release [version]'\n```\n\nThis will set `IS_RELEASE` to `true` if triggered on a commit where the package version changed, and where the commit message starts with \"Release [new package version]\" (e.g \"Release 1.0.0\", if the package version was updated to \"1.0.0\").\n\nThis field can support multiple patterns separated by a comma. For example, if `commit-starts-with` is set to `Release [version],Release/[version]`, it will match on both \"Release 1.0.0\" and \"Release/1.0.0\".\n\n### Conditionally running release jobs\n\nYou can then add filters in following jobs so those will skip if the `IS_RELEASE` criteria isn't met:\n\n```yaml\njobs:\n  is-release:\n    \u003c insert example from above \u003e\n  publish-release:\n    if: needs.is-release.outputs.IS_RELEASE == 'true'\n    runs-on: ubuntu-latest\n    needs: is-release\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetamask%2Faction-is-release","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetamask%2Faction-is-release","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetamask%2Faction-is-release/lists"}