diff --git a/docs/utils.rst b/docs/utils.rst index 192def74..7a4c2f74 100644 --- a/docs/utils.rst +++ b/docs/utils.rst @@ -63,6 +63,8 @@ Reference instance of :class:`~packaging.tags.Tag`. :param str filename: The name of the wheel file. + :raises InvalidWheelFilename: If the filename in question + does not follow conventions outlined in `PEP 427`_. .. doctest:: @@ -87,6 +89,9 @@ Reference represented by an instance of :class:`~packaging.version.Version`. :param str filename: The name of the sdist file. + :raises InvalidSdistFilename: If the filename does not end + with an sdist extension (``.zip`` or ``.tar.gz``), or if it does not + contain a dash separating the name and the version of the distribution. .. doctest:: @@ -98,4 +103,14 @@ Reference >>> ver == Version('1.0') True + +.. exception:: InvalidWheelFilename + + Raised when a file name for a wheel is invalid. + +.. exception:: InvalidSdistFilename + + Raised when a source distribution file name is considered invalid. + .. _Source distribution format: https://packaging.python.org/specifications/source-distribution-format/#source-distribution-file-name +.. _`PEP 427`: https://peps.python.org/pep-0427/#file-name-convention