{"id":17150295,"url":"https://github.com/maxbrunet/bitbucket-semantic-pull-requests","last_synced_at":"2026-07-08T02:00:48.452Z","repository":{"id":37898202,"uuid":"456339247","full_name":"maxbrunet/bitbucket-semantic-pull-requests","owner":"maxbrunet","description":"Bitbucket Cloud status check that ensures your pull requests follow the Conventional Commits spec","archived":false,"fork":false,"pushed_at":"2026-06-24T16:30:57.000Z","size":1538,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-24T18:14:09.268Z","etag":null,"topics":["bitbucket","bitbucket-cloud","conventional-commits","pull-requests"],"latest_commit_sha":null,"homepage":"","language":"Go","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/maxbrunet.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-02-07T03:00:38.000Z","updated_at":"2026-06-24T16:31:12.000Z","dependencies_parsed_at":"2026-01-26T23:04:12.643Z","dependency_job_id":null,"html_url":"https://github.com/maxbrunet/bitbucket-semantic-pull-requests","commit_stats":null,"previous_names":[],"tags_count":229,"template":false,"template_full_name":null,"purl":"pkg:github/maxbrunet/bitbucket-semantic-pull-requests","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxbrunet%2Fbitbucket-semantic-pull-requests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxbrunet%2Fbitbucket-semantic-pull-requests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxbrunet%2Fbitbucket-semantic-pull-requests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxbrunet%2Fbitbucket-semantic-pull-requests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxbrunet","download_url":"https://codeload.github.com/maxbrunet/bitbucket-semantic-pull-requests/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxbrunet%2Fbitbucket-semantic-pull-requests/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35248842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["bitbucket","bitbucket-cloud","conventional-commits","pull-requests"],"created_at":"2024-10-14T21:35:19.841Z","updated_at":"2026-07-08T02:00:48.433Z","avatar_url":"https://github.com/maxbrunet.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bitbucket Semantic Pull Requests\n\n[![release](https://img.shields.io/github/v/release/maxbrunet/bitbucket-semantic-pull-requests?sort=semver)](https://github.com/maxbrunet/bitbucket-semantic-pull-requests/releases)\n[![build](https://github.com/maxbrunet/bitbucket-semantic-pull-requests/actions/workflows/build.yml/badge.svg)](https://github.com/maxbrunet/bitbucket-semantic-pull-requests/actions/workflows/build.yml)\n[![go report](https://goreportcard.com/badge/github.com/maxbrunet/bitbucket-semantic-pull-requests)](https://goreportcard.com/report/github.com/maxbrunet/bitbucket-semantic-pull-requests)\n\nBitbucket Cloud status check that ensures your pull requests follow the [Conventional Commits spec](https://conventionalcommits.org/).\n\nHeavily inspired by [zeke/semantic-pull-requests](https://github.com/zeke/semantic-pull-requests), if not a rewrite in Go for Bitbucket Cloud.\n\n## How it works\n\nBy default, only the PR title OR at least one commit message needs to have semantic prefix. If you wish to change this\nbehavior, see [configuration](#configuration) section below.\n\nScenario | Status | Status Check Message\n-------- | ------ | -------\nPR title is semantic | 💚 | `ready to be squashed`\nany commit is semantic | 💚 | `ready to be merged or fast-forwarded`\nnothing is semantic | 💛 | `add a semantic commit or PR title`\n\nPlease see [zeke/semantic-pull-requests](https://github.com/zeke/semantic-pull-requests#how-it-works) for the full rational.\n\n## Installation\n\n1. Create a Bitbucket Cloud account for the bot and add it to your team (Recommended)\n2. [Create an App password](https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/) with [`pullrequest`](https://developer.atlassian.com/cloud/bitbucket/bitbucket-cloud-rest-api-scopes/#pullrequest) scope (\"Pull request: Read\")\n3. [Grant read access on your repositories](https://support.atlassian.com/bitbucket-cloud/docs/grant-repository-access-to-users-and-groups/) to the bot account\n4. Export the bot's Bitbucket credentials via environment variables (or use `--help` flag for more options):\n    - `BITBUCKET_USERNAME`: Bitbucket username associated with the account used for renovate-approve-bot\n    - `BITBUCKET_PASSWORD`: Bitbucket App password created in step 2\n5. Start the bot:\n\n     - With Docker:\n\n       ```shell\n       docker run --rm \\\n         --env BITBUCKET_USERNAME \\\n         --env BITBUCKET_PASSWORD \\\n         --publish 8888:8888 \\\n         ghcr.io/maxbrunet/bitbucket-semantic-pull-requests:latest\n       ```\n\n     - With a binary (downloadable from the [Releases](https://github.com/maxbrunet/bitbucket-semantic-pull-requests/releases) page):\n\n       ```shell\n       ./bitbucket-semantic-pull-requests\n       ```\n\n6. [Add a webhook to your repository](https://support.atlassian.com/bitbucket-cloud/docs/manage-webhooks/#Create-webhooks)\n\n    - *Title*: Semantic Pull Requests\n    - *URL*: `https://\u003cbot-address\u003e/`\n    - *Status*: Active\n    - *Triggers*:\n        - `pullrequest:created`\n        - `pullrequest:updated`\n\n\n## Configuration\n\nIt is the same as [zeke/semantic-pull-requests](https://github.com/zeke/semantic-pull-requests).\n\nBy default, no configuration is necessary.\n\nIf you wish to override some behaviors, you can add a `semantic.yml` file to your `.bitbucket` directory with\nthe following optional settings:\n\n```yml\n# Disable validation, and skip status check creation\nenabled: false\n```\n\n```yml\n# Always validate the PR title, and ignore the commits\ntitleOnly: true\n```\n\n```yml\n# Always validate all commits, and ignore the PR title\ncommitsOnly: true\n```\n\n```yml\n# Always validate the PR title AND all the commits\ntitleAndCommits: true\n```\n\n```yml\n# Require at least one commit to be valid\n# this is only relevant when using commitsOnly: true or titleAndCommits: true,\n# which validate all commits by default\nanyCommit: true\n```\n\n```yml\n# You can define a list of valid scopes\nscopes:\n  - scope1\n  - scope2\n  ...\n```\n\n```yml\n# By default conventional types as definited by go-conventionalcommits are used.\n# See \"conventional\": https://github.com/leodido/go-conventionalcommits#types\n# You can override the valid types\ntypes:\n  - feat\n  - fix\n  - docs\n  - style\n  - refactor\n  - perf\n  - test\n  - build\n  - ci\n  - chore\n  - revert\n```\n\n```yml\n# Allow use of Merge commits (e.g. \"Merge branch 'master' into feature/ride-unicorns\")\nallowMergeCommits: true\n```\n\n```yml\n# Allow use of Revert commits (e.g. \"Revert \"feat: ride unicorns\"\")\nallowRevertCommits: true\n```\n\n## Note about conventional-changelog\n\nThe [`mergePattern`](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-commits-parser#mergepattern) parser option can be used to extract the Pull Request title from Bitbucket's merge message:\n\n```yaml\nparserOpts:\n  mergePattern: '^Merged in (\\S+) \\(pull request #(\\d+)\\)$'\n  mergeCorrespondence: ['branch', 'prId']\n```\n\n## License\n\n[Apache 2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxbrunet%2Fbitbucket-semantic-pull-requests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxbrunet%2Fbitbucket-semantic-pull-requests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxbrunet%2Fbitbucket-semantic-pull-requests/lists"}