Cythonize in one pass with a shared utility module

Each extension was cythonized in its own call, so Cython's generated
utility code was duplicated into every module. Build the whole list in a
single cythonize() call with shared_utility_qualified_name set, which
emits the common code once into av._cyutil and has the other modules
import it.

Author: WyattBlue

pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=77.0", "cython>=3.1.0,<4"]
+requires = ["setuptools>=78.0", "cython>=3.3.0,<4"]
 
 [project]
 name = "av"
@@ -23,6 +23,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Multimedia :: Sound/Audio",
     "Topic :: Multimedia :: Sound/Audio :: Conversion",

setup.py

@@ -140,19 +140,7 @@ def parse_cflags(raw_flags):
     }
 
 IMPORT_NAME = "av"
-
-loudnorm_extension = Extension(
-    f"{IMPORT_NAME}.filter.loudnorm",
-    sources=[
-        f"{IMPORT_NAME}/filter/loudnorm.py",
-        f"{IMPORT_NAME}/filter/loudnorm_impl.c",
-    ],
-    include_dirs=[f"{IMPORT_NAME}/filter"] + extension_extra["include_dirs"],
-    libraries=extension_extra["libraries"],
-    library_dirs=extension_extra["library_dirs"],
-    define_macros=define_macros,
-    py_limited_api=py_limited_api,
-)
+SHARED_MODULE_NAME = f"{IMPORT_NAME}._cyutil"
 
 compiler_directives = {
     "c_string_type": "str",
@@ -163,17 +151,37 @@ def parse_cflags(raw_flags):
     "freethreading_compatible": True,
 }
 
-# Add the cythonized loudnorm extension to ext_modules
-ext_modules = cythonize(
-    loudnorm_extension,
-    compiler_directives=compiler_directives,
-    build_dir="src",
-    include_path=["include"],
-)
+
+def make_extension(name, sources, extra_include_dirs=()):
+    return Extension(
+        name,
+        sources=sources,
+        include_dirs=[*extra_include_dirs, *extension_extra["include_dirs"]],
+        libraries=extension_extra["libraries"],
+        library_dirs=extension_extra["library_dirs"],
+        define_macros=define_macros,
+        py_limited_api=py_limited_api,
+    )
+
+
+LOUDNORM_SOURCE = os.path.join(IMPORT_NAME, "filter", "loudnorm.py")
+
+extensions = [
+    Extension(
+        SHARED_MODULE_NAME,
+        sources=[],
+        define_macros=define_macros,
+        py_limited_api=py_limited_api,
+    ),
+    make_extension(
+        f"{IMPORT_NAME}.filter.loudnorm",
+        [LOUDNORM_SOURCE, os.path.join(IMPORT_NAME, "filter", "loudnorm_impl.c")],
+        [os.path.join(IMPORT_NAME, "filter")],
+    ),
+]
 
 for dirname, dirnames, filenames in os.walk(IMPORT_NAME):
     for filename in filenames:
-        # We are looking for Cython sources.
         if filename.startswith("."):
             continue
         if filename in {"__init__.py", "__main__.py", "about.py", "datasets.py"}:
@@ -182,27 +190,26 @@ def parse_cflags(raw_flags):
             continue
 
         pyx_path = os.path.join(dirname, filename)
+        if pyx_path == LOUDNORM_SOURCE:
+            continue
+
         base = os.path.splitext(pyx_path)[0]
 
         # Need to be a little careful because Windows will accept / or \
         # (where os.sep will be \ on Windows).
         mod_name = base.replace("/", ".").replace(os.sep, ".")
 
-        # Cythonize the module.
-        ext_modules += cythonize(
-            Extension(
-                mod_name,
-                include_dirs=extension_extra["include_dirs"],
-                libraries=extension_extra["libraries"],
-                library_dirs=extension_extra["library_dirs"],
-                sources=[pyx_path],
-                define_macros=define_macros,
-                py_limited_api=py_limited_api,
-            ),
-            compiler_directives=compiler_directives,
-            build_dir="src",
-            include_path=["include"],
-        )
+        extensions.append(make_extension(mod_name, [pyx_path]))
+
+# Cythonize in one pass so that the shared module can be generated alongside the
+# modules that import from it.
+ext_modules = cythonize(
+    extensions,
+    compiler_directives=compiler_directives,
+    build_dir="src",
+    include_path=["include"],
+    shared_utility_qualified_name=SHARED_MODULE_NAME,
+)
 
 
 package_folders = pathlib.Path(IMPORT_NAME).glob("**/")