How to make a Python package in 2021

Post by zomglings » Thu, Apr 08, 2021, 3:27 AM UTC

ehsankia wrote: post #22

zomglings wrote: post #15

Earlier quoted context omitted.

Iteratively. You don't need to solve all those problems at once. Version pinning can be done in setup.py using the same syntax you would see in a requirements.txt file. You should be very conservative when pinning versions in a library, though. You can lean on your ci tool (eg. Github actions) to handle testing, hash checking, credential management, etc. But I recommend all of this start as a bunch of locally runnabl…

To be fair, while this is a single article, if you only look at step 1, 2 and 3, you get a fully published package with only one tool used (flit) and not much extra. It's the succeeding sections (A, B, C, D, E) that get more advanced, but they're all optional. You should definitely do A, but the rest I'd say it's a lot more opinionated and definitely not needed.

Post by neolog » Thu, Apr 08, 2021, 3:28 AM UTC

zomglings wrote: post #26

neolog wrote: post #21

Earlier quoted context omitted.

> You don't need to solve all those problems at once. Why spend time tweaking the setup when you can just get it right in the first place with less work?

Do you recommend poetry? I've been meaning to try it but haven't had the time to migrate an existing project to poetry.

Post by acdanger » Thu, Apr 08, 2021, 3:30 AM UTC

tcbasche wrote: post #29

neolog wrote: post #27

Earlier quoted context omitted.

Poetry is better.

Well that settles it

Post by marcinzm » Thu, Apr 08, 2021, 3:32 AM UTC

zomglings wrote: post #30

staticassertion wrote: post #23

Earlier quoted context omitted.

TBH as someone trying to use Python professionally it is extremely frustrating that basic things with regards to package management are something you have to iterate towards, as opposed to just being obvious and default.

I sympathize. It is unfortunate that the python community never settled around a tool like leiningen for clojure or cargo for rust or npm for node. What we saw with npm was the entire community iterating towards a feature set and everyone reaping the benefits automatically with npm updates. package-lock.json is a good example of this.

Post by jimmaswell » Thu, Apr 08, 2021, 3:40 AM UTC

neolog wrote: post #25

perrygeo wrote: post #14

Why not to make a Python package in 2021. Even as a long time Python user, the packaging ecosystem feels fragmented and error-prone at best. Honestly, it sours the experience of writing Python code knowing you might eventually need to make it work on another computer.

It's fragmented, but it doesn't need to be error prone if people use the good tools instead of the old low-level tools.