pytoolconfig

What it is and what it does

Pytoolconfig is a library for reading and managing configuration settings for Python development tools. It abstracts away the details of finding and parsing configuration from multiple sources—primarily pyproject.toml—so that tools like rope can access their settings through a consistent interface rather than implementing their own config parsing.

The library depends on tomli for TOML parsing and packaging for version handling. It is designed to work with Python 3.8 through 3.12, with uncertain support for 3.13+. The project is actively maintained but has limited adoption (around 1.3 million monthly downloads, ranking in the top 5000 packages), and carries a copyleft license that requires derivative works to remain open-source.

Use it for:

• Build a Python tool that reads its settings from pyproject.toml without implementing TOML parsing yourself
• Migrate tool configuration from scattered config files to a unified pyproject.toml format
• Access rope or other tool configurations programmatically from a Python script
• Standardize how a suite of Python tools discover and load their configuration

Worth the install?

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

Pytoolconfig reads and manages configuration for Python tools from pyproject.toml and other config files, providing a unified interface to access tool-specific settings.

Yes, if you are building or extending a Python tool that needs to read configuration from pyproject.toml and want to avoid writing config-parsing code yourself. The low install friction and active maintenance make it a reasonable choice. Be aware of the LGPL-3.0-or-later license if you plan to modify or redistribute the library. The modest project visibility and small dependency footprint suggest it is stable but not widely battle-tested.

Install

pytoolconfig on PyPI

pip install pytoolconfig

uv add pytoolconfig

poetry add pytoolconfig

Installing pytoolconfig

Before you install

Low install friction with only two runtime dependencies (tomli and packaging). Active maintenance with a recent commit as of 2026-08-13, though the project has modest visibility with 5 repository stars.

License in practice

Licensed under LGPL-3.0-or-later (copyleft). Any derivative work or modification must be released under a compatible license; using this library in proprietary code is permitted if you do not modify it, but modifications require copyleft compliance.

Quickstart

pip install pytoolconfig

from pytoolconfig.pytoolconfig import PyToolConfig

config = PyToolConfig()
tool_config = config.load_config(tool='rope')

Requires Python 3.8 or later; Python 3.13+ may work but is not tested.

Verify before relying

• Whether the library handles all pyproject.toml edge cases and format variations in practice
• Performance characteristics when reading large or complex configuration files
• Compatibility with Python 3.13+ despite the stated lack of testing

Package facts

Evidence: pytoolconfig-1.3.1-py3-none-any.whl

Tags

More Software Development packages