Home

Awesome

Sync with PDM

CI codecov pre-commit.ci status pre-commit Code style: black pdm-managed

A .pre-commit hook for keeping in sync the repos rev in .pre-commit-config.yaml with the packages version locked into pdm.lock. Check out pre-commit.com for more about the main framework.

Do you rely on Poetry? See this equivalent sync repo: sync_with_poetry.

What problem does this hook help us solve?

PDM is a modern Python package and dependency manager supporting the latest PEP standards. Sometimes, you might want to install dev dependencies locally (e.g., black, flake8, isort, mypy, ...) to make your IDE (e.g., VS Code) play nicely with dev packages. This approach usually turns on a live feedback as you code (e.g., suggestions, linting, formatting, errors highlighting). PDM pins dev packages in pdm.lock.

This hook updates the rev of each repo in .pre-commit-config.yaml with the corresponding package version stored in pdm.lock.

E.g., starting from the following files:

# pdm.lock
[[package]]
name = "black"
version = "21.12b0"
# ...
# .pre-commit-config.yaml
repos:
  # black - formatting
  - repo: https://github.com/psf/black
    rev: 21.11b1
    hooks:
      - id: black

this hook will bump black in .pre-commit-config.yaml as follows:

# .pre-commit-config.yaml
repos:
  # black - formatting
  - repo: https://github.com/psf/black
    rev: 21.12b0
    hooks:
      - id: black

Usage

Excerpt from a .pre-commit-config.yaml using an example of this hook:

- repo: https://github.com/floatingpurr/sync_with_pdm
  rev: "" # the revision or tag to clone at
  hooks:
    - id: sync_with_pdm
      args: [] # optional args

Args

  --all              Scan all dependencies in pdm.lock (main, optional and dev)
  --skip [SKIP ...]  Packages to skip
  --config CONFIG    Path to a custom .pre-commit-config.yaml file
  --db PACKAGE_LIST  Path to a custom package list (json)

Usually this hook uses only dev packages to sync the hooks. Pass --all, if you want to scan also the main project packages.

Pass --skip <package_1> <package_2> ... to disable the automatic synchronization of the repos such packages correspond to.

Pass --config <config_file> to point to an alternative config file (it defaults to .pre-commit-config.yaml).

Pass --db <package_list_file> to point to an alternative package list (json). Such a file overrides the mapping in db.py.

Supported packages

Supported packages out-of-the-box are listed in db.py:

From version 0.4.0, you can create your very own package list, passing a custom json file with the arg --db. Such a file specifies how to map a package to the corresponding repo, following this pattern:

{
  "<package_name_in_PyPI>": {
    "repo": "<repo_url_for_the_package>",
    "rev": "<revision_template>"
  }
}

Sometimes the template of the version number of a package in PyPI differs from the one used in the repo rev. For example, version 0.910 of mypy in PyPI (no pun intended) maps to repo rev: v0.910. To make this hook aware of the leading v, you need to specify "v${rev}" as a "<revision_template>". Use "${rev}" if both the package version and the repo rev follow the same pattern.

PRs extending db.py are welcome.

Contributing

See CONTRIBUTING.md.

Credits

This hook is inspired by pre-commit autoupdate.