CI - Check pyproject.toml dependencies

File to use: ci_check_pyproject_dependencies.yml

This workflow runs an Invoke task to check dependencies in a pyproject.toml file.

The reason for having this workflow and not using Dependabot is because it seems to not function properly with this use case.

Warning

If a PAT is not passed through for the PAT secret and GITHUB_TOKEN is used, beware that any other CI/CD jobs that run for, e.g., pull request events, may not run since GITHUB_TOKEN-generated PRs are designed to not start more workflows to avoid escalation. Hence, if it is important to run CI/CD workflows for pull requests, consider passing a PAT as a secret to this workflow represented by the PAT secret.

Info

The generated PR will be created from a new branch named ci/update-pyproject. If you wish to change this value, see the branch_name_extension input option.

Ignoring dependencies

To ignore or configure how specific dependencies should be updated, the ignore input option can be utilized. This is done by specifying a line per dependency that contains ellipsis-separated (...) key/value-pairs of:

Key	Description
dependency-name	Ignore updates for dependencies with matching names, optionally using * to match zero or more characters.
versions	Ignore specific versions or ranges of versions. Examples: ~=1.0.5, >= 1.0.5,<2, >=0.1.1.
update-types	Ignore types of updates, such as SemVer major, minor, patch updates on version updates (for example: version-update:semver-patch will ignore patch updates). This can be combined with dependency-name=* to ignore particular update-types for all dependencies.

Supported update-types values

Currently, only version-update:semver-major, version-update:semver-minor, and version-update:semver-patch are supported options for update-types.

The ignore option is essentially similar to the ignore option of Dependabot. If versions and update-types are used together, they will both be respected jointly.

Here is an example of different lines given as value for the ignore option that accomplishes different things:

# ...
jobs:
  check-dependencies:
    uses: SINTEF/ci-cd/.github/workflows/ci_check_pyproject_dependencies.yml@v2.8.2
    with:
      # ...
      # For Sphinx, ignore all updates for/from version 4.5.0 and up / keep the minimum version for Sphinx at 4.5.0.
      # For pydantic, ignore all patch updates
      # For numpy, ignore any and all updates
      ignore: |
        dependency-name=Sphinx...versions=>=4.5.0
        dependency-name=pydantic...update-types=version-update:semver-patch
        dependency-name=numpy
# ...

Expectations

The repository contains the following:

• (required) A repository root pyproject.toml file with the Python package's dependencies.

Inputs

Name	Description	Required	Default	Type
git_username	A git username (used to set the 'user.name' config option).	Yes		string
git_email	A git user's email address (used to set the 'user.email' config option).	Yes		string
runner	The runner to use for the workflow. Note, the callable workflow expects a Linux/Unix system..	No	ubuntu-latest	string
target_branch	The branch name for the target of the opened PR. Note: If a value is not given for this nor permanent_dependencies_branch, the default value for permanent_dependencies_branch will be used until v2.6.0, whereafter providing an explicit value for target_branch is required.	No	Empty string	string
permanent_dependencies_branch	DEPRECATED - Will be removed in v2.6.0. Use target_branch instead. The branch name for the permanent dependency updates branch.	No	ci/dependency-updates	string
python_version	The Python version to use for the workflow.	No	3.9	string
install_extras	Any extras to install from the local repository through 'pip'. Must be encapsulated in square parentheses ([]) and be separated by commas (,) without any spaces. Example: '[dev,release]'.	No	Empty string	string
pip_index_url	A URL to a PyPI repository index.	No	https://pypi.org/simple/	string
pip_extra_index_urls	A space-delimited string of URLs to additional PyPI repository indices.	No	Empty string	string
pr_body_file	Relative path to PR body file from the root of the repository. Example: '.github/utils/pr_body_deps_check.txt'.	No	Empty string	string
fail_fast	Whether the task to update dependencies should fail if any error occurs.	No	false	boolean
pr_labels	A comma separated list of strings of GitHub labels to use for the created PR.	No	Empty string	string
ignore	Create ignore conditions for certain dependencies. A multi-line string of ignore rules, where each line is an ellipsis-separated (...) string of key/value-pairs. One line per dependency. This option is similar to the ignore option of Dependabot. See also Single vs multi-line input.	No	Empty string	string
branch_name_extension	A string to append to the branch name of the created PR. Example: '-my-branch'. It will be appended after a forward slash, so the final branch name will be ci/update-pyproject/-my-branch.	No	Empty string	string
debug	Whether to run the workflow in debug mode, printing extra debug information.	No	false	boolean
skip_unnormalized_python_package_names	Whether to skip dependencies with unnormalized Python package names. Normalization is outlined here.	No	false	boolean

Secrets

Name	Description	Required
PAT	A personal access token (PAT) with rights to create PRs. This will fallback on GITHUB_TOKEN.	No

Usage example

The following is an example of how a workflow may look that calls CI - Check pyproject.toml dependencies. It is meant to be complete as is.

name: CI - Check dependencies

on:
  schedule:
    - cron: "30 5 * * 1"
  workflow_dispatch:

jobs:
  check-dependencies:
    name: Call external workflow
    uses: SINTEF/ci-cd/.github/workflows/ci_check_pyproject_dependencies.yml@v2.8.2
    if: github.repository_owner == 'SINTEF'
    with:
      git_username: "Casper Welzel Andersen"
      git_email: "CasperWA@github.com"
      target_branch: "ci/dependency-updates"
      python_version: "3.9"
      install_extras: "[dev]"
      pr_labels: "CI/CD"
    secrets:
      PAT: ${{ secrets.PAT }}