---
id: pyproject-parser
version: "0.14.0"
license: Copyright (c) 2021 Dominic Davis-Foster Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# pyproject-parser — Parser for 'pyproject.toml'

License: permissive · Maintenance: active · Downloads: 788.7K/mo

## What it is and what it does

pyproject-parser reads and parses pyproject.toml files—the standard Python project configuration format defined by PEP 518 and PEP 621—and exposes their metadata as structured Python objects. It handles both build system configuration (PEP 518) and project metadata (PEP 621), making it useful for tools that need to inspect or manipulate project definitions programmatically.

The package depends on dom-toml for TOML parsing, packaging for version handling, and several utility libraries from the domdf ecosystem. It's typed and actively maintained, supporting Python 3.7 through 3.13 on CPython and PyPy. An optional readme extra adds validation to check whether a project's README will render correctly on PyPI.

Use it for:

- Build tools and CI/CD systems that need to read project metadata without loading the entire project.
- Package management utilities that inspect or validate pyproject.toml structure and compliance.
- Development tools that extract dependencies, version strings, or author information from project configuration.
- Linters or analyzers that check pyproject.toml for correctness or best practices.
- Project scaffolding or migration tools that parse and transform project metadata.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses and extracts metadata from pyproject.toml files according to PEP 518 and PEP 621 specifications.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and solves a concrete problem—parsing pyproject.toml—that many build and packaging tools need. No known vulnerabilities. Install it if your tool or script needs to read project metadata from pyproject.toml files.

## Install

pip install pyproject-parser
uv add pyproject-parser
poetry add pyproject-parser

## Installing pyproject-parser

Before you install: Low friction installation with a pure-Python wheel and active maintenance as of 2026-07-08. Nine runtime dependencies are all well-established packaging and utility libraries, posing minimal compatibility risk.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you retain the copyright notice and license text.

Quickstart:

from pyproject_parser import PyProject

project = PyProject.load('pyproject.toml')
print(project.metadata)

Verify before relying:

- Whether the package handles malformed or non-compliant pyproject.toml files gracefully or raises exceptions.
- Performance characteristics when parsing large or deeply nested pyproject.toml files.
- Extent of support for PEP 621 optional fields and vendor-specific extensions beyond the core specification.

## Package facts

- License: Copyright (c) 2021 Dominic Davis-Foster Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 788.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyproject.toml parser, pep 621 metadata extraction, python project configuration reader, toml project metadata, pep 518 build backend parser, pyproject metadata loader, python packaging metadata, metadata-extraction, pep-compliance, build-tools

[View on SkillFed](https://skillfed.io/packages/pyproject-parser) · [View on PyPI](https://pypi.org/project/pyproject-parser/)