refactor: create -> compose

Signed-off-by: Henry Schreiner <henryfs@princeton.edu>

Author: henryiii

docs/utils.rst

@@ -71,7 +71,7 @@ Reference
         >>> canonicalize_version('1.4.0.0.0')
         '1.4'
 
-.. function:: create_wheel_filename(name, version, build, tags)
+.. function:: compose_wheel_filename(name, version, build, tags)
 
     Combines a project name, version, build tag, and tag set
     to make a properly formatted wheel filename.
@@ -90,12 +90,12 @@ Reference
 
     .. doctest::
 
-        >>> from packaging.utils import create_wheel_filename
+        >>> from packaging.utils import compose_wheel_filename
         >>> from packaging.tags import Tag
         >>> from packaging.version import Version
         >>> version = Version("1.0")
         >>> tags = {Tag("py3", "none", "any")}
-        >>> "foo_bar-1.0-py3-none-any.whl" == create_wheel_filename("foo-bar", version, None, tags)
+        >>> "foo_bar-1.0-py3-none-any.whl" == compose_wheel_filename("foo-bar", version, None, tags)
         True
 
 .. function:: parse_wheel_filename(filename)
@@ -133,7 +133,7 @@ Reference
         >>> not build
         True
 
-.. function:: create_sdist_filename(name, version)
+.. function:: compose_sdist_filename(name, version)
 
     Combines the project name and a version to make a valid sdist filename.
 
@@ -142,9 +142,9 @@ Reference
 
     .. doctest::
 
-        >>> from packaging.utils import create_sdist_filename
+        >>> from packaging.utils import compose_sdist_filename
         >>> from packaging.version import Version
-        >>> "foo_bar-1.0.tar.gz" == create_sdist_filename("foo-bar", Version("1.0"))
+        >>> "foo_bar-1.0.tar.gz" == compose_sdist_filename("foo-bar", Version("1.0"))
         True
 
 .. function:: parse_sdist_filename(filename)

src/packaging/utils.py

@@ -24,8 +24,8 @@
     "NormalizedName",
     "canonicalize_name",
     "canonicalize_version",
-    "create_sdist_filename",
-    "create_wheel_filename",
+    "compose_sdist_filename",
+    "compose_wheel_filename",
     "is_normalized_name",
     "parse_sdist_filename",
     "parse_wheel_filename",
@@ -116,7 +116,7 @@ def _compress_tag_set(tags: AbstractSet[Tag]) -> str:
     return "-".join(_join_tag_attr(tags, x) for x in ("interpreter", "abi", "platform"))
 
 
-def create_wheel_filename(
+def compose_wheel_filename(
     name: str, version: Version, build: BuildTag | None, tags: AbstractSet[Tag]
 ) -> str:
     norm_name = canonicalize_name(name).replace("-", "_")
@@ -175,7 +175,7 @@ def parse_wheel_filename(
     return (name, version, build, tags)
 
 
-def create_sdist_filename(name: str, version: Version) -> str:
+def compose_sdist_filename(name: str, version: Version) -> str:
     norm_name = canonicalize_name(name).replace("-", "_")
     return f"{norm_name}-{version}.tar.gz"
 

tests/test_utils.py

@@ -14,8 +14,8 @@
     InvalidWheelFilename,
     canonicalize_name,
     canonicalize_version,
-    create_sdist_filename,
-    create_wheel_filename,
+    compose_sdist_filename,
+    compose_wheel_filename,
     is_normalized_name,
     parse_sdist_filename,
     parse_wheel_filename,
@@ -149,10 +149,10 @@ def test_canonicalize_version_no_strip_trailing_zero(version: str) -> None:
         ),
     ],
 )
-def test_create_wheel_filename(
+def test_compose_wheel_filename(
     filename: str, name: str, version: Version, build: BuildTag | None, tags: set[Tag]
 ) -> None:
-    assert create_wheel_filename(name, version, build, tags) == filename
+    assert compose_wheel_filename(name, version, build, tags) == filename
 
 
 @pytest.mark.parametrize(
@@ -233,8 +233,8 @@ def test_parse_wheel_invalid_filename(filename: str) -> None:
         ("foo_bar-1.0.tar.gz", "foo-bar", Version("1.0")),
     ],
 )
-def test_create_sdist_filename(filename: str, name: str, version: Version) -> None:
-    assert create_sdist_filename(name, version) == filename
+def test_compose_sdist_filename(filename: str, name: str, version: Version) -> None:
+    assert compose_sdist_filename(name, version) == filename
 
 
 @pytest.mark.parametrize(