pyproject-toml

What it is and what it does

pyproject-toml is a pre-alpha library for parsing and validating Python project configuration from pyproject.toml files. It aims to implement the Python Enhancement Proposals that define modern project metadata standards (PEP 517, 518, 621, 631, and others). The package wraps standard dependencies—setuptools, wheel, pydantic, packaging, and tomli—to handle TOML parsing and metadata validation.

The library is dormant but stable; its last commit was recent (2024-11-13) but no active development is occurring. It supports Python 3.9 through 3.13 and carries a permissive MIT license. Use it when you need programmatic access to pyproject.toml metadata in a Python application, though be aware the API is pre-alpha and may change before reaching version 1.0.

Use it for:

• Build tools and package managers that need to read and validate pyproject.toml configuration files.
• Development utilities that inspect project metadata to determine dependencies, build requirements, or version information.
• CI/CD pipelines that programmatically extract and validate project configuration without shell parsing.
• IDE plugins or linters that need to understand a project's pyproject.toml structure and constraints.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parses and validates Python project metadata from pyproject.toml files according to PEP 517, 518, 621, and 631 specifications.

Yes, if you need to parse pyproject.toml files programmatically and can tolerate a pre-alpha API. The package has low install friction, no known vulnerabilities, and a permissive license. However, expect no active maintenance—the last release was 640 days ago—so pin the version and avoid relying on future updates. Suitable for stable, internal tooling but not for packages that need ongoing support.

Install

pyproject-toml on PyPI

pip install pyproject-toml

uv add pyproject-toml

poetry add pyproject-toml

Installing pyproject-toml

Before you install

Low friction installation with a pure-Python wheel. Maintenance is dormant—last release was 640 days ago with a commit on 2024-11-13, though the repository remains active and unarchived. Suitable for stable use cases but expect no active development.

License in practice

MIT license is permissive; you may use, modify, and distribute this package freely with minimal restrictions, making it safe for both commercial and open-source projects.

Quickstart

pip install pyproject-toml

from pyproject_toml import PyProject
project = PyProject.from_file('pyproject.toml')

Requires Python 3.9 or later (supports up to 3.13); pyproject.toml file must exist and be valid TOML.

Verify before relying

• Whether the package fully implements all of PEP 631 or only partial coverage of the listed PEPs.
• API stability and whether breaking changes are expected before a 1.0 release (currently at 0.1.0 pre-alpha).
• Whether error handling and validation messages are production-ready or still experimental.

Package facts

Evidence: pyproject_toml-0.1.0-py3-none-any.whl

Tags

More Build Tools packages