{"id":15637971,"url":"https://github.com/dawidd6/action-homebrew-bump-formula","last_synced_at":"2025-04-12T19:49:20.068Z","repository":{"id":40582344,"uuid":"245265260","full_name":"dawidd6/action-homebrew-bump-formula","owner":"dawidd6","description":":gear: A GitHub Action to easily bump Homebrew formula on new release","archived":false,"fork":false,"pushed_at":"2024-10-15T10:31:49.000Z","size":242,"stargazers_count":102,"open_issues_count":7,"forks_count":26,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-12T19:49:04.396Z","etag":null,"topics":["action","actions","bump","formula","github","github-actions","homebrew","livecheck","tap","update"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/dawidd6.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":"2020-03-05T20:51:33.000Z","updated_at":"2025-04-02T17:00:53.000Z","dependencies_parsed_at":"2024-06-18T12:38:09.121Z","dependency_job_id":"1fbfcba4-d3e0-4111-8567-a1b240baa92a","html_url":"https://github.com/dawidd6/action-homebrew-bump-formula","commit_stats":{"total_commits":200,"total_committers":10,"mean_commits":20.0,"dds":0.06499999999999995,"last_synced_commit":"a0a0d5655eb02dec380adcbf6110eca5cc41e2b3"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":"actions/container-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidd6%2Faction-homebrew-bump-formula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidd6%2Faction-homebrew-bump-formula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidd6%2Faction-homebrew-bump-formula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawidd6%2Faction-homebrew-bump-formula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dawidd6","download_url":"https://codeload.github.com/dawidd6/action-homebrew-bump-formula/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248625501,"owners_count":21135513,"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":["action","actions","bump","formula","github","github-actions","homebrew","livecheck","tap","update"],"created_at":"2024-10-03T11:16:37.511Z","updated_at":"2025-04-12T19:49:20.045Z","avatar_url":"https://github.com/dawidd6.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Homebrew bump formula GitHub Action\n\nAn action that wraps `brew bump-formula-pr` to ease the process of updating the formula on new project releases.\n\nWorks on Ubuntu and macOS runners.\n\n## Usage\n\nOne should use the [Personal Access Token](https://github.com/settings/tokens/new?scopes=public_repo,workflow) for `token` input to this Action, not the default `GITHUB_TOKEN`, because `brew bump-formula-pr` creates a fork of the formula's tap repository (if needed) and then creates a pull request.\n\n\u003e There are two ways to use this Action.\n\n### Standard mode\n\nUse if you want to simply bump the formula, when a new release happens.\n\nListen for new tags in workflow:\n\n```yaml\non:\n  # trigger when release got created (preferred)\n  release:\n    types: [released]\n  # trigger on tag push\n  # push:\n  #   tags:\n  #     - \"*\"\n```\n\nThe Action will extract all needed informations by itself, you just need to specify the following step in your workflow:\n\n```yaml\n- name: Update Homebrew formula\n  uses: dawidd6/action-homebrew-bump-formula@v4\n  with:\n    # Required, custom GitHub access token with the 'public_repo' and 'workflow' scopes\n    token: ${{secrets.TOKEN}}\n    # Optional, will commit with this user name\n    user_name: name\n    # Optional, will commit with this user email\n    user_email: email@example.com\n    # Optional, will create tap repo fork in organization\n    org: ORG\n    # Optional, use the origin repository instead of forking\n    no_fork: false\n    # Optional, defaults to homebrew/core\n    tap: USER/REPO\n    # Formula name, required\n    formula: FORMULA\n    # Optional, will be determined automatically\n    tag: ${{github.ref}}\n    # Optional, will be determined automatically\n    revision: ${{github.sha}}\n    # Optional, if don't want to check for already open PRs\n    force: false # true\n```\n\n### Livecheck mode\n\nIf `livecheck` input is set to `true`, the Action will run `brew livecheck` to check if any provided formulae are outdated or if tap contains any outdated formulae and then will run `brew bump-formula-pr` on each of those formulae with proper arguments to bump them.\n\nMight be a good idea to run this on schedule in your tap repo, so one gets automated PRs updating outdated formulae.\n\nIf there are no outdated formulae, the Action will just exit.\n\n```yaml\n- name: Update Homebrew formula\n  uses: dawidd6/action-homebrew-bump-formula@v4\n  with:\n    # Required, custom personal GitHub access token with only the 'public_repo' scope enabled\n    token: ${{secrets.CUSTOM_PERSONAL_ACCESS_TOKEN}}\n    # Optional, will commit with this user name\n    user_name: user_name\n    # Optional, will commit with this user email\n    user_email: email@example.com\n    # Optional, will create tap repo fork in organization\n    org: ORG\n    # Bump all outdated formulae in this tap\n    tap: USER/REPO\n    # Bump only these formulae if outdated\n    formula: FORMULA-1, FORMULA-2, FORMULA-3, ...\n    # Optional, if don't want to check for already open PRs\n    force: false # true\n    # Need to set this input if want to use `brew livecheck`\n    livecheck: true\n```\n\nIf only `tap` input is provided, all formulae in given tap will be checked and bumped if needed.\n\n## Examples\n\n- https://github.com/dawidd6/action-homebrew-bump-formula/blob/master/.github/workflows/test.yml\n- https://github.com/dawidd6/ba-bump/blob/master/.github/workflows/bump.yml\n- https://github.com/ablinov/declutter/blob/master/.github/workflows/bump_homebrew_formula.yml\n- https://github.com/jesseduffield/lazygit/blob/master/.github/workflows/cd.yml\n- https://github.com/stephan-hesselmann-by/homebrew-BlueYonder/blob/master/.github/workflows/update-tap.yml\n- https://github.com/crunchtime-ali/brew-formula-updater/blob/master/.github/workflows/main.yml\n- https://github.com/asciidoc/asciidoc-py3/blob/master/.github/workflows/release.yml\n- https://github.com/bow-swift/nef/blob/master/.github/workflows/bump-formula.yml\n- https://github.com/dandavison/delta/blob/master/.github/workflows/cd.yml\n- https://github.com/GitTools/GitVersion/blob/main/.github/workflows/homebrew.yml\n- https://github.com/wormi4ok/evernote2md/blob/master/.github/workflows/publish.yml\n- https://github.com/cloudskiff/driftctl/blob/main/.github/workflows/homebrew.yml\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawidd6%2Faction-homebrew-bump-formula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdawidd6%2Faction-homebrew-bump-formula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawidd6%2Faction-homebrew-bump-formula/lists"}