Mastodawn

Python packaging tools won't let you install help files for your CLI app, and argparse won't let you add an epilogue for subparsers.

I want to write documentation, but apparently the only valid option for Python CLI tools is publishing some rando sphinx deployment on readthedocs.

Show thread

Eli Schwartz 3h ago

@ebassi

Gentle reminder that "python packaging tools" as governed by #pypa and distributable via #pypi are solely intended to be used for packaging importable libraries and as an extension, simple "script entrypoints".

All other asset files have been explicitly declared off limits and out of scope.

`setup.py install` used to support installing other assets, and this support was deprecated and removed by the move to *.whl as the sole supported ecosystem format.

Show thread

Eli Schwartz

@ebassi

Formal advice by #pypa is "desktop application packaging shouldn't be packaged via python packaging tools".

So don't -- use meson and forget that python dist-info or pip exists. :)

setup.py was, long ago, used as "pythonic Makefiles", but that time is long passed.