This is a tool to automate publishing of pub packages from GitHub actions.
When run from a PR, this tool will validate the package pubspecs and changelogs and indicate whether the criteria for publishing has been met. Generally, each PR should add a new entry to the changelog, rev the pubspec version, and the changelog version and pubspec version should agree.
When run in response to a git tag event (a tag with a pattern like v1.2.3
or name_v1.2.3
for monorepos), this tool will publish the indicated package.
Pre-release versions (aka, '1.2.3-dev'
) are handled specially; this tool will validate the package but will not auto-publish it. This can be used to accumulate several changes and later publish them as a group.
In order to disable package validation and auto-publishing, add the publish_to: none
key to your pubspec.
For PRs, this tool:
dart pub publish --dry-run
In response to a git tag event, this tool:
dart pub publish --force
)This tool can work with either single package repos or with mono-repos (repos containing several packages). It will scan for and detect packages in a mono repo; to omit packages from validation and auto-publishing, add a publish_to: none
key to its pubspec.
For single package repos, the tag pattern should be v1.2.3
. For mono-repos, the tag pattern must be prefixed with the package name, e.g. foo-v1.2.3
.
.github/workflows/publish.yaml
file in your repomain
)tags: [ '[A-z]+-v[0-9]+.[0-9]+.[0-9]+' ]
# A CI configuration to auto-publish pub packages. name: Publish on: pull_request: branches: [ main ] types: [opened, synchronize, reopened, labeled, unlabeled] push: tags: [ 'v[0-9]+.[0-9]+.[0-9]+' ] jobs: publish: uses: dart-lang/ecosystem/.github/workflows/publish.yaml@main
publish.yaml
:with: write-comments: false
.github/workflows/post_summaries.yaml
file in your repo# A CI configuration to write comments on PRs. name: Comment on the pull request on: workflow_run: workflows: - Publish types: - completed jobs: upload: uses: dart-lang/ecosystem/.github/workflows/post_summaries.yaml@main permissions: pull-requests: write
Callers may optionally specify the version of the SDK to use when publishing a package. This can be useful if your package has a very recent minimum SDK constraint. This is done via the sdk
input parameter. Note that this parameter is not required; it defaults to stable
- using the most recent stable release of the Dart SDK. To pass this value:
jobs: publish: uses: dart-lang/ecosystem/.github/workflows/publish.yml@main with: sdk: beta
Callers may optionally specify the name of a github environment for the publish job to use. This is useful if you want to require approvals for the publish job to run. To pass this value:
jobs: publish: uses: dart-lang/ecosystem/.github/workflows/publish.yml@main with: environment: pub.dev # Can be any name, this is the convention though.
Make sure to also require this environment to be present in your package admin settings. See the pub.dev documentation on this.
The description of the common workflow for repos using this tool can be found at https://github.com/dart-lang/ecosystem/wiki/Publishing-automation.
This is a Github workflow to check PR health.
When run from a PR, this tool will check a configurable subset of the following
firehose
description above..dart
files have a license header.DO_NOT_SUBMIT
strings in the files or the description.This tool can work with either single package repos or with mono-repos (repos containing several packages).
.github/workflows/health.yaml
file in your repomain
)name: Health on: pull_request: branches: [ main ] types: [opened, synchronize, reopened, labeled, unlabeled] jobs: health: uses: dart-lang/ecosystem/.github/workflows/health.yaml@main # with: # sdk: beta # checks: "version,changelog,license,coverage,breaking,do-not-submit,leaking" # fail_on: "version,changelog,do-not-submit" # warn_on: "license,coverage,breaking,leaking" # coverage_web: false # upload_coverage: false # use-flutter: true # ignore_license: "**.g.dart" # ignore_coverage: "**.mock.dart,**.g.dart" # ignore_packages: "pkgs/helper_package" # checkout_submodules: false # experiments: "native-assets" permissions: pull-requests: write
.github/workflows/post_summaries.yaml
file in your repo. This is a necessary workaround to get PR Health comments on PRs from forks.name: Comment on the pull request on: # Trigger this workflow after the Health workflow completes. This workflow will have permissions to # do things like create comments on the PR, even if the original workflow couldn't. workflow_run: workflows: - Health # - Publish types: - completed jobs: upload: uses: dart-lang/ecosystem/.github/workflows/post_summaries.yaml@main permissions: pull-requests: write
Name | Type | Description | Example |
---|---|---|---|
checks | List of strings | What to check for in the PR health check | "version,changelog,license,coverage,breaking,do-not-submit,leaking" |
fail_on | List of strings | Which checks should lead to failure | "version,changelog,do-not-submit" |
warn_on | List of strings | Which checks should not fail, but only warn | "license,coverage,breaking,leaking" |
upload_coverage | boolean | Whether to upload the coverage to coveralls | true |
coverage_web | boolean | Whether to run dart test -p chrome for coverage | false |
use-flutter | boolean | Whether to setup Flutter in this workflow | false |
ignore_license | List of globs | "**.g.dart" | |
ignore_coverage | List of globs | Which files to ignore for the license check | "**.mock.dart,**.g.dart" |
ignore_packages | List of globs | Which packages to ignore | "pkgs/helper_package" |
checkout_submodules | boolean | Whether to checkout submodules of git repositories | false |
experiments | List of strings | Which experiments should be enabled for Dart | "native-assets" |
The description of the common workflow for repos using this tool can be found at https://github.com/dart-lang/ecosystem/wiki/Pull-Request-Health.