get_metadata

safir.metadata.get_metadata(*, package_name, application_name)

Retrieve metadata for the application.

Parameters:
  • pacakge_name – The name of the package (Python namespace). This name is used to look up metadata about the package.

  • application_name (str) – The value to return as the application name (the name metadata field).

Returns:

The package metadata as a Pydantic model, suitable for returning as the result of a FastAPI route.

Return type:

Metadata

Notes

get_metadata integrates extensively with your package’s metadata. Typically this metadata is set in pyproject.toml, setup.cfg, setup.py file (for setuptools-based applications). The pyproject.toml fields used are:

version

Used as the version metadata. This may be set automatically with setuptools_scm.

description

Use as the description metadata.

project.urls, Homepage

Used as the documentation_url metadata.

project.urls, Source

Used as the respository_url.

Packages using setup.cfg or setup.py get the last three items of metadata from different sources:

summary

Use as the description metadata.

url

Used as the documentation_url metadata.

project_urls, Source code

Used as the respository_url.

Parameters:

package_name (str)