Skip to main content

Validation library and CLI tool for checking on 'pyproject.toml' files using JSON Schema

Project description

Project generated with PyScaffold Built Status ReadTheDocs Coveralls PyPI-Server

validate-pyproject

Automated checks on pyproject.toml powered by JSON Schema definitions

Description

With the approval of PEP 517 and PEP 518, the Python community shifted towards a strong focus on standardisation for packaging software, which allows more freedom when choosing tools during development and make sure packages created using different technologies can interoperate without the need for custom installation procedures.

This shift became even more clear when PEP 621 was also approved, as a standardised way of specifying project metadata and dependencies.

validate-pyproject was born in this context, with the mission of validating pyproject.toml files, and make sure they are compliant with the standards and PEPs. Behind the scenes, validate-pyproject relies on JSON Schema files, which, in turn, are also a standardised way of checking if a given data structure complies with a certain specification.

Usage

The easiest way of using validate-pyproject is via CLI. To get started, you need to install the package, which can be easily done using pipx:

$ pipx install 'validate-pyproject[all]'

Now you can use validate-pyproject as a command line tool:

# in you terminal
$ validate-pyproject --help
$ validate-pyproject path/to/your/pyproject.toml

You can also use validate-pyproject in your Python scripts or projects:

# in your python code
from validate_pyproject import api, errors

# let's assume that you have access to a `loads` function
# responsible for parsing a string representing the TOML file
# (you can check the `toml` or `tomli` projects for that)
pyproject_as_dict = loads(pyproject_toml_str)

# now we can use validate-pyproject
validator = api.Validator()

try:
    validator(pyproject_as_dict)
except errors.ValidationError as ex:
    print(f"Invalid Document: {ex.message}")

To do so, don’t forget to add it to your virtual environment or specify it as a project or library dependency.

More details about validate-pyproject and its Python API can be found in our docs, which includes a description of the used JSON schemas, instructions for using it in a pre-compiled way and information about extending the validation with your own plugins.

Plugins

The validate-pyproject-schema-store plugin has a vendored copy of pyproject.toml related SchemaStore entries. You can even install this using the [store] extra:

$ pipx install ‘validate-pyproject[all,store]’

Some of the tools in SchemaStore also have integrated validate-pyproject plugins, like cibuildwheel and scikit-build-core. However, unless you want to pin an exact version of those tools, the SchemaStore copy is lighter weight than installing the entire package.

If you want to write a custom plugin for your tool, please consider also contributing a copy to SchemaStore.

pre-commit

validate-pyproject can be installed as a pre-commit hook:

---
repos:
  - repo: https://github.com/abravalheri/validate-pyproject
    rev: <insert current version here>
    hooks:
      - id: validate-pyproject
        # Optional extra validations from SchemaStore:
        additional_dependencies: ["validate-pyproject-schema-store[all]"]

By default, this pre-commit hook will only validate the pyproject.toml file at the root of the project repository. You can customize that by defining a custom regular expression pattern using the files parameter.

You can also use pre-commit autoupdate to update to the latest stable version of validate-pyproject (recommended).

You can also use validate-pyproject-schema-store as a pre-commit hook, which allows pre-commit to pin and update that instead of validate-pyproject itself.

Note

This project and its sister project ini2toml were initially created in the context of PyScaffold, with the purpose of helping migrating existing projects to PEP 621-style configuration when it is made available on setuptools. For details and usage information on PyScaffold see https://pyscaffold.org/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

validate_pyproject-0.24.1.tar.gz (117.1 kB view details)

Uploaded Source

Built Distribution

validate_pyproject-0.24.1-py3-none-any.whl (53.7 kB view details)

Uploaded Python 3

File details

Details for the file validate_pyproject-0.24.1.tar.gz.

File metadata

  • Download URL: validate_pyproject-0.24.1.tar.gz
  • Upload date:
  • Size: 117.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.16

File hashes

Hashes for validate_pyproject-0.24.1.tar.gz
Algorithm Hash digest
SHA256 e182fc51354add988e5bee6fc06ceb327832a78d921730fc618275e5b29e6b71
MD5 d1e87ded61de8a01e5485b3f02e3abf2
BLAKE2b-256 d2e5dd60cbfc9b0701d8621c73e56c261142c1a01d1f74d0da30133bd272ecc6

See more details on using hashes here.

File details

Details for the file validate_pyproject-0.24.1-py3-none-any.whl.

File metadata

File hashes

Hashes for validate_pyproject-0.24.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b7b05fa9117204c9c4606ab317acd095b18d1bfc78fb7dc8cc06f77d0582ca2d
MD5 a0efdc97595d158e92256da1d606e0b5
BLAKE2b-256 a4396983dd79f01aaa4c75d9ffa550fa393f0c4c28f7ccd6956e4188c62cefbc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page