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
- 2024
- Reinstalling Windows at 1am
- SQLite DB Migrations with PRAGMA user_version
- My Custom Miniflux CSS Theme
- How to Disable Wayland in Debian Testing
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- My next chapter with Mastodon from Mastodon Blog
- How many pillars of observability can you fit on the head of a pin? from charity.wtf
- The Software Essays that Shaped Me from Refactoring English
- Give Your Spouse the Gift of a Couple's Email Domain from mtlynch.io
- Skip the Next iPhone from Articles on Jose M.
- Have smart glasses finally hit an inflection point? from The Torment Nexus
- The McPhee method from the jsomers.net blog
- Pluralistic: LLMs are slot-machines (16 Aug 2025) from Pluralistic: Daily links from Cory Doctorow
Articles from blogs I follow around the net
[RIDGELINE] No Phones in The Ten-don Shop
Ridgeline subscribers — (Originally published in Japanese in Esquire Japan, October 2025) Some twenty-three years ago in Tokyo, I used to eat at a funny little tendon shop called Imoya. I was a student at Waseda University back then, and this place was a ca…
via Craig Mod — Writer + Photographer November 29, 2025Jensen Huang Screwed Up Big Time, Revealed Big Tech’s Big Lie
Capitalists Gonna Capitalize on November 28, 2025 In a recent leaked all-hands meeting, Nvidia CEO Jensen Huang responded to a question regarding managers within the company leaning towards less frequent use of Generative AI with the following: My under…
via The Internet Review November 28, 2025Generated by openring