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
- Great Lakes, Illinois
- My Custom Miniflux CSS Theme
- Ladybird on Debian Stable
- SQLite DB Migrations with PRAGMA user_version
- Are we inside a Sarlacc?
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- A Year Of Vibes from Armin Ronacher's Thoughts and Writings
- Pluralistic: A perfect distillation of the social uselessness of finance (18 Dec 2025) from Pluralistic: Daily links from Cory Doctorow
- Moving from WordPress to Substack from charity.wtf
- Grow, Like a Tree Not a Cancer from Jim Nielsen’s Blog
- Pluralistic: All the books I reviewed in 2025 (02 Dec 2025) from Pluralistic: Daily links from Cory Doctorow
- DEP-18: A proposal for Git-based collaboration in Debian from Optimized by Otto
- [RIDGELINE] No Phones in The Ten-don Shop from Craig Mod — Writer + Photographer
- Open design: the opportunity design students didn’t know they were missing from Ubuntu blog
Articles from blogs I follow around the net
Binance's Trust Wallet extension hacked; users lose $7 million
The Trust Wallet Chrome extension was compromised in an apparent supply chain attack. People who used the non-custodial wallet extension after it updated to version 2.68 lost funds after malicious code was introduced to exfiltrate wa…
via Web3 is Going Just Great December 27, 20251Password Dependency Breaks Syntax Highlighting
Why does a password manager need a syntax highlighter?
via Fernando Borretti December 27, 2025How Rob Pike got spammed with an AI slop "act of kindness"
Rob Pike (that Rob Pike) is furious. Here's a Bluesky link for if you have an account there and a link to it in my thread viewer if you don't. Fuck you people. Raping the planet, spending trillions on toxic, unrecyclable equipment while blowing up …
via Simon Willison's Weblog: Entries December 26, 2025Generated by openring