My First Pip Package
I finally got around to packaging up pg2cf and I am excited to see it out in the wild on pypi. Python packaging is pretty straightforward and this makes distribution of this tool much easier for us internally.
I could not have done it without this awesome python packaging guide.
Using setuptools also makes a lot of other things easier. For instance running tests is as simple as python setup.py test and installing the package locally can be done with python setup.py install. The main benifit of course is that now pg2cf is an executable so you once it is installed you can just run it.
The only “gotcha” that I ran into was that setuptools does not support markdown. Which makes it kind of weird since Markdown is now the standard for README and other documentation on GitHub.
I worked around this by using pandoc, this way I am able to convert my README.md to README.rst easily with pandoc README.md -o README.rst and then use that for PyPI.
Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.
Check out some more stuff to read down below.
Most popular posts this month
- SQLite DB Migrations with PRAGMA user_version
- My Custom Miniflux CSS Theme
- 2024
- Making cgit Pretty
- Ladybird on Debian Stable
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- Pluralistic: AI "journalists" prove that media bosses don't give a shit (11 Mar 2026) from Pluralistic: Daily links from Cory Doctorow
- Avi Alkalay: Uniqlo T-Shirt Bash Script Easter Egg from Fedora People
- Offline 23 hours a day from Derek Sivers blog
- Pluralistic: California can stop Larry Ellison from buying Warners (28 Feb 2026) from Pluralistic: Daily links from Cory Doctorow
- On Alliances from Smashing Frames
- Acting ethically in an imperfect world from Smashing Frames
- Diffusion of Responsibility from Smashing Frames
- My AI Adoption Journey from Mitchell Hashimoto
Articles from blogs I follow around the net
Issue 102 – The public will pay
Justin Sun buys his way out of an SEC fraud case, Iranian transactions on Binance draw DOJ scrutiny as the exchange sues the newspaper that reported on them, and crypto super PACs dump millions into Tuesday’s primaries in Illinois.
via Citation Needed March 16, 2026Back in February I bought a four-wheeler and I’ve been having a lot of fun putting in some miles, adding accessories, and being outdoors. It is a 2026 Polaris Sportsman. A great way to end winter. It affords me to get to locations to do some photography t…
via Colin Devroe March 16, 2026Fine Specimens by Elliot Jay Stocks
A curated collection of the best in contemporary type design Elliot is back with a new typography book! Elliot Jay Stocks
via Blog – Brad Frost March 16, 2026Generated by openring