sphinxcontrib-cheeseshop 0.3

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.