The Cheese Shop Sphinx extension

Ah! We do have some Camembert, sir…

This extension adds directives for easy linking to Cheese Shop (Python Package Index) packages. It requires Sphinx 4.0.

It’s a bit runny, sir…

It supports a directive and a role, as well as a new config value.

Well, as a matter of fact it’s very runny, sir…

The pypi-release directive adds an HTML-only output block that automatically fetches the download links for the latest release of the given package and displays them as a list. For example,

.. pypi-release:: Sphinx
   :prefix: Download
   :class: sidebar

will display “Download:” and a list of download links (eggs and the source distribution) for the latest Sphinx release. The “sidebar” class makes the resulting <div> appear like a reStructuredText sidebar. Using “prefix”, you can select what text precedes the list.

I think it’s runnier than you like it, sir…

The pypi role links to a package. Use it in one of these forms:

:pypi:`Sphinx`  -- link to latest release
:pypi:`the Sphinx package <Sphinx>`  -- dito, but explicit title given
:pypi:`Sphinx (0.6)`  -- link to specific release
:pypi:`the Sphinx package <Sphinx (0.6)>`  -- dito, with explicit title

This extension also adds a cheeseshop_url config value, which defaults to 'http://pypi.org/project' and is used to build URLs to the Cheese Shop.

Have fun!

Oh… The cat’s eaten it.