Niko Heikkilä

January 30, 2022

New Release – Publicator

Lately, I've been investing more time in Python projects. However, having worked with Node.js and TypeScript for the better part of the last few years, I instantly began to miss the comforts provided by the Node ecosystem, namely the fantastic Yarn package manager.

Python ecosystem has had its fair share of package management solutions starting from the classic Pip and advancing to Pipenv a few years ago. Unfortunately, both tools lack a wholesome user experience similar to Yarn. I was lucky to stumble upon Poetry some time ago and haven't looked back at other tools since.

While Poetry finally brings us a sane solution for publishing and maintaining Python packages, many developers crave a more enhanced and safer user experience. Sindre Sorhus and contributors have given us np for the Node ecosystem, which I've happily used to publish both private and public NPM packages.

Was there anything like this for Poetry? Probably, if I've bothered to search through the packages carefully, but why not make a tool to fit precisely for my use cases? Thus, my latest open-source tool, Publicator, aims to offer the same convenient solution for publishing your everyday Python packages.

Out of the box, its most helpful features include:

  • Ensuring you're publishing from your default branch (you can ignore this)
  • Ensuring the working directory is clean and removing any untracked dependencies from the virtual environment
  • Running the unit tests (defaults to running pytest, but you may specify another test command)
  • Automatically bumping the package version in your pyproject.toml file
  • Committing the version bump, pushing a new tag to your Git server, and publishing the new package to Python Package Index (or your private repository)
  • Projects hosted on open a new browser window for drafting the release with pre-filled details. Sweet!

Developing and testing Publicator has been an incredible luxury because of the dogfooding – that is, I can release new versions using the tool itself. On another note, the codebase has over 100 micro-tests I've obediently written following TDD cycles. Hence, you won't find any technical debt here, making your contribution efforts easier.

As is the custom, my employer generously funds the development through The Spice Program. I'm also sharing my work under the MIT license so you can use it for your commercial projects as well.

More features will follow in the future, and you're welcome to contribute to them. If anything crashes or feels buggy, let me know by opening a new issue.

About Niko Heikkilä

Software Craftsman and Extreme Programmer. Currently shipping quality code at Futurice. Building proprietary software for a living and loving it as much as free and open-source software. Linux, Windows, and macOS user. Follow this blog for insights on TDD, BDD, DDD, mob programming, technical agility, lean software development, continuous integration, and delivery.

For shorter posts, check my account on Mastodon.