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'