---
id: pytoolconfig
version: "1.3.1"
license: LGPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# pytoolconfig — Python tool configuration

License: copyleft · Maintenance: active · Downloads: 1.3M/mo

## 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 above — 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

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

- License: LGPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyproject.toml configuration reader, python tool config management, read tool settings from config files, pyproject.toml parser, tool configuration loader, config file abstraction layer, python tool settings manager, config-management, pyproject-toml

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