POSH 0.9: Experimental support for gems

14 December 2024

One of the biggest releases in a while!

The main theme for this release is experimental support for gem docsets.

This required significant changes on all fronts - both back-end and client (TUI).

There is now a “POSH builder” project that handles all the heavy lifting of building Markdown documentation. It’s currently a semi-automatic process that requires some manual setup. However, eventually, the entire process could be automated; I’ve already managed to (web)hook into RubyGems.

Most of the work has been with the TUI client.

The TUI is able to parse the Gemfile.lock file, download all documentation it can find, and present it through a TUI view. While the flow of this entire process is not yet properly defined, the features for each step seem to be working.

Here’s a quick rundown of new features:

  • posh docsets to download all available docsets.
  • posh docsets --clear will remove all docsets from the system.
  • posh gemfile to view project gems with the ability to search and pick a docset for review.

Additionally:

  • The client now stores a local cache to avoid redownloading docsets multiple times.
  • There are many stability improvements to the client itself and better error handling.
  • Underlying libraries have been updated; the biggest win here is that the markdown renderer has received numerous improvements. This should generally help to present documentation better.

Development updates