get_project_url

safir.metadata.get_project_url(meta, label)

Get a specific URL from a package’s project_urls metadata.

Parameters:

• meta (Message) – The package metadata, as returned by the importlib.metadata.metadata function.

• label (str) –

  The URL’s label. Consider the follow snippet of a pyproject.toml file:

  [project.urls]
  Homepage = "https://safir.lsst.io/"
  Source = "https://github.com/lsst-sqre/safir"
  

  To get the https://github.com/lsst-sqre/safir URL, the label is Source.

  Packages using setup.cfg use a different syntax but a similar approach.

  project_urls =
      Change log = https://safir.lsst.io/changelog.html
      Source code = https://github.com/lsst-sqre/safir
      Issue tracker = https://github.com/lsst-sqre/safir/issues
  

  To get the https://github.com/lsst-sqre/safir URL, the label is Source code.

Returns:

The URL. If the label is not found, the function returns None.

Return type:

str or None

Examples

>>> from importlib_metadata import metadata
>>> meta = metadata("safir")
>>> get_project_url(meta, "Source")
'https://github.com/lsst-sqre/safir'