[Docutils-develop] [docutils:patches] Re: #186 Modernise packaging

[Dmitry S. <man...@us...>]

> and packagers like Dmitry Shachnev (@mandriver) a chance to speak up.

Debian/Ubuntu's build tooling supports both setuptools and flit as first-class citizens, and we have recently got a new tooling to work with custom `pyproject.toml` files as well. So whatever you decide to do will be fine for us.

If you want to keep `setup.py` for some time for compatibility, then I would suggest to keep using setuptools, switch to declarative config in `setup.cfg` and add a `pyproject.toml` which specifies `build-backend = "setuptools.build_meta"` (e.g. like done in [this project](https://github.com/jaraco/keyring)). This way both old and new tools should be happy, and the packaging will be still quite modern.


---

** [patches:#186] Modernise packaging**

**Status:** open
**Group:** None
**Created:** Fri Dec 31, 2021 03:16 AM UTC by Adam  Turner
**Last Updated:** Thu Jan 06, 2022 09:02 PM UTC
**Owner:** nobody
**Attachments:**

- [0001-Use-flit-and-pyproject.toml.patch](https://sourceforge.net/p/docutils/patches/186/attachment/0001-Use-flit-and-pyproject.toml.patch) (12.2 kB; application/octet-stream)
- [0002-Use-entry-points.patch](https://sourceforge.net/p/docutils/patches/186/attachment/0002-Use-entry-points.patch) (20.7 kB; application/octet-stream)
- [0003-update-docs-etc-after-packaging-changes.patch](https://sourceforge.net/p/docutils/patches/186/attachment/0003-update-docs-etc-after-packaging-changes.patch) (49.3 kB; application/octet-stream)


Hi,

I had a go at modernising the packaging stack. `setup.py` based invocations have been deprecated (https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html), and setuptools may remove them in the future. 

This takes the opportunity to move to a PEP 621 based declarative config, and also fixes a longstanding TODO item about providing script wappers for the frontend tools on windows, by migrating them to entry points.

I've updated install and development docs with the new guidance, and updated references to the frontend tools to remove `.py`, given they are now installed as proper scripts.

Hope this is appreciated -- happy to make revisions etc to help getting this merged.

A


---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/patches/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/patches/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.