Skip to main content

Create a pyproject.toml file from setuptools configuration

Project description


PyPI PyPI versions tests documentation Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public. Ruff Code style: Black skeleton


pyproject.toml represents the new era of Python packaging, but many old projects are still using setuptools. That's where this package comes in: just install it, run it, and it will print out a nicely formatted pyproject.toml file with the same metadata that you had in or setup.cfg.

Or at least, that's the goal. The project is currently a work in progress with only partial support for all the attributes that might exist in a setuptools configuration, so this won't yet work for anything complex. Feel free to file an issue to highlight anything that needs to be added!

Installation and usage

There are two different ways to install this project. You can use either or both depending on what you prefer.

Standalone application

To install setuptools-pyproject-migration as an application, we recommend using pipx (though of course you can also do this with pip install --user or in a virtual environment of your choice). First make sure you have pipx installed, then run

pipx install setuptools-pyproject-migration

After that, in any directory that has a and/or setup.cfg file, you can run


and it will print out the content of pyproject.toml as computed from your and/or setup.cfg. Running setuptools-pyproject-migration -h will print a brief usage summary.

You can also install and run the application in one go as follows:

pipx run setuptools-pyproject-migration

Virtual environment

Or you can use setuptools-pyproject-migration in a virtual environment you use to develop your project. Activate your virtual environment and then run

python -m pip install `setuptools-pyproject-migration

and then running

python pyproject

will print out the content of your pyproject.toml file.


Inspired by a conversation on Mastodon.

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

setuptools-pyproject-migration-0.2.0.tar.gz (52.7 kB view hashes)

Uploaded Source

Built Distribution

Supported by

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