pyscaffold / pyscaffold

🛠 Python project template generator with batteries included
https://pyscaffold.org
Other
2.1k stars 183 forks source link

Docs that mention `setup.py` need checking/updating #536

Open abravalheri opened 3 years ago

abravalheri commented 3 years ago

Description of your problem

Recently I noticed our docs still mention a lot of direct execution of setup.py, and that is now deprecated (see #535 for other details).

It would be nice to go through the docs and make sure these mentions are removed.

There are also a lot of complexity for making sure we show alternative commands when the person do not want to use tox. That is definetely going to be removed in the next version of PyScaffold, together with the --no-tox extension. But maybe the docs can also be simplified right now? (e.g. using a disclaimer in the top of the file saying something like: "if you don't use tox, see this link for alternatives")

FlorianWilhelm commented 2 years ago

BTW, what's the best way to do python setup.py --version now without using setup.py?

abravalheri commented 2 years ago

Unfortunately there is no official answer for that yet.

Some time ago I proposed a change in setuptools-scm to address this use case, and initially it was well received by the maintainers.

But I guess they did not have the chance yet/bandwidth to go through the review process :(

abravalheri commented 2 years ago

Just an update on this topic: setuptools-scm has accepted the PR, now we just need to wait until they release a new version :)