I think we can all agree that packaging a Python project is harder
than it should be. With numerous guides & tutorials out there,
people still make mistakes. Some of these mistakes break a project,
some just make it less attractive, and some even cause a project to
step on the toes of other projects.
As the admin of the wheel-analysis and -browsing site
Wheelodex, I see a number of
poorly-built wheels each morning as I peruse the day’s new
entries. This eventually motivated me to create
— a program for scanning a wheel for many of the below problems plus
several others — in an attempt to get people to clean up their
wheels, yet still the poorly-packaged projects persist.
In yet another attempt to get people to fix their broken packages,
here now are some of the more frequent types of mistakes I see —
along with advice on how to avoid & correct them — in no particular