Potential minor improvements on Creating an open source Python project from scratch about website HOT 4 OPEN

readthedocs ... update your packages ... or to pin dependency versions

Could you expand on this? What problems were you having?

Looking back probably more nbsphinx related than readthedocs directly, but I had a weird internal error for the latex rendering on sphinx=4.1.2, which was newer than what I had locally, and ended up pinning on 3.5.4, I missed 2 non-obvious dependencies (because of course I already locally had added matplotlib to my env) and then a newer matplotlib version on readthedocs decided to throw an error my older local version didn't throw.

Nothing crazily unexpected, and all fixable, but the warning to carefully check env versions and requirements beforehand would have saved me quite some googling headache and awkward extra commits :-)

from website.

Just came across this series again.

Yay! Yeah I was also setting up a new project yesterday and did it all with pyproject.toml. Maybe this series is due an update.

I would probably also use ruff over many of the linting tools I used to use.

from website.

Thanks for the feedback this is really helpful!

codecov

Awesome that's a quick fix.

napoleon

Yeah I need to go back and add that.

readthedocs ... update your packages ... or to pin dependency versions

Could you expand on this? What problems were you having?

pyproject.toml

I've heard a little about pyproject.toml but I've never used it in a project. I'm aware that the current trend is to move static metadata out of setup.py and into setup.cfg. I should get more familiar with this and then go back and update things.

from website.

Just came across this series again. It's great Jacob! Having just set up a new project for the first time in a while it seems like the current trend it to just have a pyproject.toml and not a setup.cfg or a setup.py

from website.