sampleproject

So, the project you linked has a pyproject.toml file uses flit: requires = ["flit_core >=3.2,<4"] build-backend = "flit_core.buildapi" Python.org defaults to using hatchling in the docs[1]. PyPA has a sample repository using setuptools[2]. This project is linked from Python.org on this page.[3] Python.org recommends using setuptools under packaging recommendations as well, with no mention of hatchling or flit even on that page.[4] No wonder so many devs are frustrated about this. I've been writing mostly Python for work and fun the past 11 years and I'm f*cking confused what tools to use. When I start a new side project I don't know whether a tool is going to exist and still work in a few years, because there's 10 tools trying to do the same things and it's not clear what the community is actually getting behind. [1]: https://pac

Copy from https://github.com/pypa/sampleproject !

This looks like a nice fill-in between "How I start": http://howistart.org/ and the aosa-book "500-lines or less": http://aosabook.org/en/500L/introduction.html (and maybe with a hint of rosettacode in the mix: http://rosettacode.org/wiki/Rosetta_Code ) I'd love to see some collaborative projects like this - idiomatic/recommended setups of editing/debug/release, as well as approach to coding. I notice that Python is still absent from the "How I start"-series - something like https://github.com/pypa/sampleproject might form part of a starting point (also the Flask "flaskr" tutorial sets up a bare-bones python package, but needs minor adjustments for windows, as I've noticed using it for a small course on web programming - I'll have to find the time to file an issue and patch). The great thing about such projects being open to contribution,

.idea should be removed. Also this: https://github.com/pypa/sampleproject I trust PyPA, and in many ways they get to set what "canonical" is, so for something like this, if they say it, it's therefore true.

There is also these guides that provide plenty of information on how packages work and best practices: https://packaging.python.org/en/latest/distributing.html https://github.com/pypa/sampleproject