get_metadata

safir.metadata.get_metadata(*, package_name: str, application_name: str) → Metadata

Retrieve metadata for the application.

Parameters:

• pacakge_name (str) – 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:

metadata – 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.