pybuilder/PyBuilder Action
PyBuilder Composite GitHub Action
View on GitHubTrust Signals
- Scorecard Score
- Scorecard 2–4scored Jul 6, 2026
- Maintenance Recency
- Activelast commit Mar 28, 2026
- License
- Apache 2.0
Pinned Snippet
uses: pybuilder/build@41f6808c42f2e7c715baa6eb5d6cb29358892170 # v14tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| checkout | Do checkout first | no | true |
| install-python | Whether to install Python | no | true |
| homebrew-python | Whether Python should be installed via Homebrew | no | false |
| python-version | Python version to use, if installing | no | 3.11 |
| architecture | Install Python for specific architecture, if installing | no | x64 |
| with-venv | Whether to use Virtualenv during a build | no | true |
| install-pyb | Install PyBuilder | no | true |
| pyb-version | PyBuilder version to install | no | >=0.12.0 |
| pyb-command | Command to run PyBuilder | no | pyb |
| pyb-args | PyBuilder command line arguments | no | -E ci -v -X |
| pyb-extra-args | PyBuilder extra command line arguments | no | "" |
| pre-build | Run a script before PyBuilder build | no | "" |
| is-upload | Whether this matrix slot runs the PyBuilder upload task | no | false |
| auto-release | Enable release automation on [release] in commit message | no | true |
| auto-release-version | Strip .dev from version when [release] detected | no | true |
| auto-github-release | Create GitHub Release with tag (upload job only) | no | true |
| auto-bump-dev | Bump to next .dev version after release (upload job only) | no | true |
| release-tag-prefix | Prefix for release tags | no | v |
| release-title-template | GitHub Release title template ({version} placeholder) | no | Release v{version} |
| build-py-path | Path to build.py relative to repo root | no | build.py |
| github-token | Token for git push and gh CLI; override with PAT for protected branches | no | ${{ github.token }} |
| release-app-id | GitHub App ID for generating release tokens that bypass branch protection | no | "" |
| release-app-private-key | GitHub App private key (PEM) for generating release tokens | no | "" |
Outputs
| name | description |
|---|---|
| is-release | true if [release] was detected in commit message |
| release-version | The release version, empty if not a release |