{"id":15286096,"url":"https://github.com/swimmwatch/openapi-diff-semver-bump","last_synced_at":"2026-05-06T07:38:25.580Z","repository":{"id":65161933,"uuid":"489686315","full_name":"swimmwatch/openapi-diff-semver-bump","owner":"swimmwatch","description":"A GitHub Action for getting appropriate updated SemVer OpenAPI package version.","archived":false,"fork":false,"pushed_at":"2023-03-11T09:57:57.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-03-14T20:51:48.117Z","etag":null,"topics":["github-actions","openapi","openapi-specification","semver"],"latest_commit_sha":null,"homepage":"","language":null,"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/swimmwatch.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":"2022-05-07T13:50:11.000Z","updated_at":"2022-05-07T13:54:50.000Z","dependencies_parsed_at":"2024-12-26T17:37:14.892Z","dependency_job_id":null,"html_url":"https://github.com/swimmwatch/openapi-diff-semver-bump","commit_stats":{"total_commits":8,"total_committers":1,"mean_commits":8.0,"dds":0.0,"last_synced_commit":"edfc70e2cbb8767726226c16ed86be0358bbf053"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimmwatch%2Fopenapi-diff-semver-bump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimmwatch%2Fopenapi-diff-semver-bump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimmwatch%2Fopenapi-diff-semver-bump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swimmwatch%2Fopenapi-diff-semver-bump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swimmwatch","download_url":"https://codeload.github.com/swimmwatch/openapi-diff-semver-bump/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245169889,"owners_count":20571973,"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":["github-actions","openapi","openapi-specification","semver"],"created_at":"2024-09-30T15:10:26.860Z","updated_at":"2026-05-06T07:38:25.553Z","avatar_url":"https://github.com/swimmwatch.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# openapi-diff-semver-bump\nA GitHub Action for getting appropriate updated [SemVer](https://semver.org/) OpenAPI package version.\n\n## Usage\nThe following example [workflow steps](https://help.github.com/en/actions/configuring-and-managing-workflows/configuring-a-workflow) will generate a new version by previous tag and updated state from [OpenAPITools/openapi-diff](https://github.com/OpenAPITools/openapi-diff).\n\n```yml\n- name: \"Find difference between OpenAPI specifications\"\n  id: diff_state\n  uses: swimmwatch/openapi-diff-action@v1.0.2\n  with:\n    old-spec: \"old_spec.json\"\n    new-spec: \"new_spec.json\"\n- name: \"Get previous tag\"\n  id: previous_tag\n  uses: WyriHaximus/github-action-get-previous-tag@v1\n  env:\n    GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}\n- name: \"Get appropriate new package version\"\n  id: updated_version\n  uses: swimmwatch/openapi-diff-semver-bump@v1\n  with:\n    package-version: ${{steps.previous_tag.outputs.tag}}\n    updated-state: ${{steps.diff_state.outputs.state}}\n```\n\n## Options\nThe following input variables options can/must be configured:\n\n|Input variable|Necessity|Description|Default|\n|----|----|----|----|\n|`package-version`|Required|Package [SemVer](https://semver.org/) version||\n|`updated-state`|Required|Output state from [OpenAPITools/openapi-diff](https://github.com/OpenAPITools/openapi-diff): `no_changes`, `incompatible`, `compatible`||\n\n## Outputs\n- `new-package-version`: New package [SemVer](https://semver.org/) version e.g. `1.2.3`.\n\n## License\nopenapi-diff-semver-bump is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswimmwatch%2Fopenapi-diff-semver-bump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswimmwatch%2Fopenapi-diff-semver-bump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswimmwatch%2Fopenapi-diff-semver-bump/lists"}