Sphinx 7.4.5__py3-none-any.whl → 7.4.7__py3-none-any.whl

sphinx/util/fileutil.py

@@ -8,12 +8,15 @@ from typing import TYPE_CHECKING, Any, Callable
 
 from docutils.utils import relative_path
 
+from sphinx.util import logging
 from sphinx.util.osutil import copyfile, ensuredir
 
 if TYPE_CHECKING:
     from sphinx.util.template import BaseRenderer
     from sphinx.util.typing import PathMatcher
 
+logger = logging.getLogger(__name__)
+
 
 def _template_basename(filename: str | os.PathLike[str]) -> str | None:
     """Given an input filename:
@@ -30,7 +33,8 @@ def _template_basename(filename: str | os.PathLike[str]) -> str | None:
 
 def copy_asset_file(source: str | os.PathLike[str], destination: str | os.PathLike[str],
                     context: dict[str, Any] | None = None,
-                    renderer: BaseRenderer | None = None) -> None:
+                    renderer: BaseRenderer | None = None,
+                    *, __overwrite_warning__: bool = True) -> None:
     """Copy an asset file to destination.
 
     On copying, it expands the template variables if context argument is given and
@@ -56,17 +60,38 @@ def copy_asset_file(source: str | os.PathLike[str], destination: str | os.PathLi
             renderer = SphinxRenderer()
 
         with open(source, encoding='utf-8') as fsrc:
-            destination = _template_basename(destination) or destination
-            with open(destination, 'w', encoding='utf-8') as fdst:
-                fdst.write(renderer.render_string(fsrc.read(), context))
+            template_content = fsrc.read()
+        rendered_template = renderer.render_string(template_content, context)
+
+        if (
+            __overwrite_warning__
+            and os.path.exists(destination)
+            and template_content != rendered_template
+        ):
+            # Consider raising an error in Sphinx 8.
+            # Certainly make overwriting user content opt-in.
+            # xref: RemovedInSphinx80Warning
+            # xref: https://github.com/sphinx-doc/sphinx/issues/12096
+            msg = ('Copying the rendered template %s to %s will overwrite data, '
+                   'as a file already exists at the destination path '
+                   'and the content does not match.')
+            # See https://github.com/sphinx-doc/sphinx/pull/12627#issuecomment-2241144330
+            # for the rationale for logger.info().
+            logger.info(msg, os.fsdecode(source), os.fsdecode(destination),
+                        type='misc', subtype='copy_overwrite')
+
+        destination = _template_basename(destination) or destination
+        with open(destination, 'w', encoding='utf-8') as fdst:
+            fdst.write(rendered_template)
     else:
-        copyfile(source, destination)
+        copyfile(source, destination, __overwrite_warning__=__overwrite_warning__)
 
 
 def copy_asset(source: str | os.PathLike[str], destination: str | os.PathLike[str],
                excluded: PathMatcher = lambda path: False,
                context: dict[str, Any] | None = None, renderer: BaseRenderer | None = None,
-               onerror: Callable[[str, Exception], None] | None = None) -> None:
+               onerror: Callable[[str, Exception], None] | None = None,
+               *, __overwrite_warning__: bool = True) -> None:
     """Copy asset files to destination recursively.
 
     On copying, it expands the template variables if context argument is given and
@@ -88,7 +113,8 @@ def copy_asset(source: str | os.PathLike[str], destination: str | os.PathLike[st
 
     ensuredir(destination)
     if os.path.isfile(source):
-        copy_asset_file(source, destination, context, renderer)
+        copy_asset_file(source, destination, context, renderer,
+                        __overwrite_warning__=__overwrite_warning__)
         return
 
     for root, dirs, files in os.walk(source, followlinks=True):
@@ -104,7 +130,8 @@ def copy_asset(source: str | os.PathLike[str], destination: str | os.PathLike[st
                 try:
                     copy_asset_file(posixpath.join(root, filename),
                                     posixpath.join(destination, reldir),
-                                    context, renderer)
+                                    context, renderer,
+                                    __overwrite_warning__=__overwrite_warning__)
                 except Exception as exc:
                     if onerror:
                         onerror(posixpath.join(root, filename), exc)

sphinx/util/inspect.py

@@ -652,7 +652,7 @@ def signature(
     try:
         # Resolve annotations using ``get_type_hints()`` and type_aliases.
         localns = TypeAliasNamespace(type_aliases)
-        annotations = typing.get_type_hints(subject, None, localns)
+        annotations = typing.get_type_hints(subject, None, localns, include_extras=True)
         for i, param in enumerate(parameters):
             if param.name in annotations:
                 annotation = annotations[param.name]

sphinx/util/inventory.py

@@ -172,8 +172,8 @@ class InventoryFile:
             inv_item: InventoryItem = projname, version, location, dispname
             invdata.setdefault(type, {})[name] = inv_item
         for ambiguity in actual_ambiguities:
-            logger.warning(__("inventory <%s> contains multiple definitions for %s"),
-                           uri, ambiguity, type='intersphinx',  subtype='external')
+            logger.info(__("inventory <%s> contains multiple definitions for %s"),
+                        uri, ambiguity, type='intersphinx',  subtype='external')
         return invdata
 
     @classmethod

sphinx/util/osutil.py

@@ -88,7 +88,12 @@ def copytimes(source: str | os.PathLike[str], dest: str | os.PathLike[str]) -> N
         os.utime(dest, (st.st_atime, st.st_mtime))
 
 
-def copyfile(source: str | os.PathLike[str], dest: str | os.PathLike[str]) -> None:
+def copyfile(
+    source: str | os.PathLike[str],
+    dest: str | os.PathLike[str],
+    *,
+    __overwrite_warning__: bool = True,
+) -> None:
     """Copy a file and its modification times, if possible.
 
     :param source: An existing source to copy.
@@ -101,7 +106,24 @@ def copyfile(source: str | os.PathLike[str], dest: str | os.PathLike[str]) -> No
         msg = f'{os.fsdecode(source)} does not exist'
         raise FileNotFoundError(msg)
 
-    if not path.exists(dest) or not filecmp.cmp(source, dest):
+    if (
+        not (dest_exists := path.exists(dest)) or
+        # comparison must be done using shallow=False since
+        # two different files might have the same size
+        not filecmp.cmp(source, dest, shallow=False)
+    ):
+        if __overwrite_warning__ and dest_exists:
+            # sphinx.util.logging imports sphinx.util.osutil,
+            # so use a local import to avoid circular imports
+            from sphinx.util import logging
+            logger = logging.getLogger(__name__)
+
+            msg = ('Copying the source path %s to %s will overwrite data, '
+                   'as a file already exists at the destination path '
+                   'and the content does not match.')
+            logger.info(msg, os.fsdecode(source), os.fsdecode(dest),
+                        type='misc', subtype='copy_overwrite')
+
         shutil.copyfile(source, dest)
         with contextlib.suppress(OSError):
             # don't do full copystat because the source may be read-only

sphinx/util/typing.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import dataclasses
 import sys
 import types
 import typing
@@ -157,6 +158,7 @@ def get_type_hints(
     obj: Any,
     globalns: dict[str, Any] | None = None,
     localns: dict[str, Any] | None = None,
+    include_extras: bool = False,
 ) -> dict[str, Any]:
     """Return a dictionary containing type hints for a function, method, module or class
     object.
@@ -167,7 +169,7 @@ def get_type_hints(
     from sphinx.util.inspect import safe_getattr  # lazy loading
 
     try:
-        return typing.get_type_hints(obj, globalns, localns)
+        return typing.get_type_hints(obj, globalns, localns, include_extras=include_extras)
     except NameError:
         # Failed to evaluate ForwardRef (maybe TYPE_CHECKING)
         return safe_getattr(obj, '__annotations__', {})
@@ -267,7 +269,20 @@ def restify(cls: Any, mode: _RestifyMode = 'fully-qualified-except-typing') -> s
             return f':py:class:`{module_prefix}{_INVALID_BUILTIN_CLASSES[cls]}`'
         elif _is_annotated_form(cls):
             args = restify(cls.__args__[0], mode)
-            meta = ', '.join(map(repr, cls.__metadata__))
+            meta_args = []
+            for m in cls.__metadata__:
+                if isinstance(m, type):
+                    meta_args.append(restify(m, mode))
+                elif dataclasses.is_dataclass(m):
+                    # use restify for the repr of field values rather than repr
+                    d_fields = ', '.join([
+                        fr"{f.name}=\ {restify(getattr(m, f.name), mode)}"
+                        for f in dataclasses.fields(m) if f.repr
+                    ])
+                    meta_args.append(fr'{restify(type(m), mode)}\ ({d_fields})')
+                else:
+                    meta_args.append(repr(m))
+            meta = ', '.join(meta_args)
             if sys.version_info[:2] <= (3, 11):
                 # Hardcoded to fix errors on Python 3.11 and earlier.
                 return fr':py:class:`~typing.Annotated`\ [{args}, {meta}]'
@@ -510,7 +525,25 @@ def stringify_annotation(
             return f'{module_prefix}Literal[{args}]'
         elif _is_annotated_form(annotation):  # for py39+
             args = stringify_annotation(annotation_args[0], mode)
-            meta = ', '.join(map(repr, annotation.__metadata__))
+            meta_args = []
+            for m in annotation.__metadata__:
+                if isinstance(m, type):
+                    meta_args.append(stringify_annotation(m, mode))
+                elif dataclasses.is_dataclass(m):
+                    # use stringify_annotation for the repr of field values rather than repr
+                    d_fields = ', '.join([
+                        f"{f.name}={stringify_annotation(getattr(m, f.name), mode)}"
+                        for f in dataclasses.fields(m) if f.repr
+                    ])
+                    meta_args.append(f'{stringify_annotation(type(m), mode)}({d_fields})')
+                else:
+                    meta_args.append(repr(m))
+            meta = ', '.join(meta_args)
+            if sys.version_info[:2] <= (3, 9):
+                if mode == 'smart':
+                    return f'~typing.Annotated[{args}, {meta}]'
+                if mode == 'fully-qualified':
+                    return f'typing.Annotated[{args}, {meta}]'
             if sys.version_info[:2] <= (3, 11):
                 if mode == 'fully-qualified-except-typing':
                     return f'Annotated[{args}, {meta}]'

{sphinx-7.4.5.dist-info → sphinx-7.4.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Sphinx
-Version: 7.4.5
+Version: 7.4.7
 Summary: Python documentation generator
 Author-email: Georg Brandl <georg@python.org>
 Requires-Python: >=3.9

{sphinx-7.4.5.dist-info → sphinx-7.4.7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sphinx/__init__.py,sha256=TqYrt2tp3rjs1RkaHALTKgB-3G0yAjYd6Jpp5JDsPgs,1690
+sphinx/__init__.py,sha256=n_3UX2bosIUYD6ZrQj7qrFlxFUMGyoi3yjcppOJ6NqI,1690
 sphinx/__main__.py,sha256=wIifwXlZHdi4gtQmkJ6KF0BsflvD9o0Wd5nARTdJc8A,127
 sphinx/addnodes.py,sha256=EQTIi9Zta6DaNa-2WGE3l9AVjdp7WzwwrfwRnax8vXE,18707
 sphinx/application.py,sha256=5QXM7tYRt1s4q00GHPtAK2EIxu6G_UkzMB3MOKOkuUI,57793
@@ -35,7 +35,7 @@ sphinx/builders/singlehtml.py,sha256=mYsB_J5AOi7wEswNbH0v5XXZnmZkBmLRHJaQtz_nB-c
 sphinx/builders/texinfo.py,sha256=cROws1DmYPp4-_uD62Ryu7Vn5Kv-JYIH1YCCm-_SRWU,9804
 sphinx/builders/text.py,sha256=YCNWggEL5GCjh5lQLT8z_NgVZdMYAHtAHfGAoUAvT0w,2996
 sphinx/builders/xml.py,sha256=SIblnQLGGzTPTv4xnFFy-Sf66YxP9q1n-28yoVajWhA,3901
-sphinx/builders/html/__init__.py,sha256=6xiPEQD9dlUZnnrEr7pJnwCPBxqlyZ-Jf9QjJ4f9LKk,59861
+sphinx/builders/html/__init__.py,sha256=kOffuQXanz5_vJghdp4hb3t0QLDHeLHxx3BRQaO84qM,59920
 sphinx/builders/html/_assets.py,sha256=9GhVCpJDTD17WzZavhONH9kqOEGS9glD62kBQ16jLeA,5599
 sphinx/builders/html/transforms.py,sha256=DhIabbXbvZM8lrT9AvKJb9JoawsmEt__DhpoeXA8Yvw,2597
 sphinx/builders/latex/__init__.py,sha256=fQvWHt7EuFFQBghaD2_TCwEBaheQKkFbxKu9GIP4lWU,24497
@@ -48,7 +48,7 @@ sphinx/cmd/__init__.py,sha256=X5XI0lk1-VMeBM6fjCLYc-a_094wd9KyOSKIjpXwge4,44
 sphinx/cmd/build.py,sha256=Ysqb1Bw16t3pFQQYTE1MubuDgMU9jgNSyNLglGobLhU,15814
 sphinx/cmd/make_mode.py,sha256=zyQrCH8tWPT2ifwDB5_Wm_H8MSwpQnh1Wg-F-LNrmco,7057
 sphinx/cmd/quickstart.py,sha256=XxF1hMsn7H0VZGy64yLEbTTSFc9ZANZHWIvEk21GOUE,24247
-sphinx/directives/__init__.py,sha256=PnsmKvTOcRgfwzp8NFfhmdVJfbcDktcHD7sd1fnddNE,15100
+sphinx/directives/__init__.py,sha256=ql28VHzQ6qisUHIuuTrnJmsFZo_U3OXwvUmlhhmOxug,15335
 sphinx/directives/code.py,sha256=yTy4GsZZ6PYKdnhysJpEj3eYRIpDEoYIsWtm9io59p8,18264
 sphinx/directives/other.py,sha256=IMVRQyPT_zkU34V4A9pdsR8S4HnryoJutYCpt4LnFh8,16492
 sphinx/directives/patches.py,sha256=cK4KPUe1U7MOOxQzXshAJEMPKnpG5_T-7Ch5pOB5PXs,7801
@@ -56,7 +56,7 @@ sphinx/domains/__init__.py,sha256=LLaAZAn0984o2LSYH_UZcEdndE9azmNUDALae74nuRE,15
 sphinx/domains/changeset.py,sha256=J9LWgh2dtBAXbX6L3a4J8YB3-wA62AMS1GolKTQsWJ0,5692
 sphinx/domains/citation.py,sha256=G9i8IYsR1tsGfAln7Z9Z_wNL2FDM2sXbWgTojxN_77I,5767
 sphinx/domains/index.py,sha256=3eHbatgPlpfeEbJtqQ6HfBQlEFSem9rYG8fdMUExypU,4266
-sphinx/domains/javascript.py,sha256=Wi6V3B0TykHGfLYcLqDhSmUxalBVntXEJtzzdFArsy4,19223
+sphinx/domains/javascript.py,sha256=LzjdqMlC8Bwz_x_buCiV7wERVKkfhXGlGe1kJ1ZjCTY,19194
 sphinx/domains/math.py,sha256=OJF3eKEZWGtR4zIQha3l_txUBUxEsrD1nHQc-HDDqNk,5728
 sphinx/domains/rst.py,sha256=HEd973tJlD8OXrg1Mmyufq9eed9M_W4utwtCHwDnhDY,10693
 sphinx/domains/c/__init__.py,sha256=xa8hn_dBre4oL9UD7VIVOLEEKwQwcmyGMv0u1ksxzG0,32679
@@ -69,8 +69,8 @@ sphinx/domains/cpp/_ast.py,sha256=GeM5V5UobeKgmycesZqwcZqSoWmTxWk3h_g8rFQA2lI,16
 sphinx/domains/cpp/_ids.py,sha256=-h42RrmFnuq4AyZ0EVHtAk_H_9Umrca24Tu-w73TKCw,18028
 sphinx/domains/cpp/_parser.py,sha256=EaKoUzpUgZnAFKZYfOBl_-Iw8z2LdYxfZtdWglpSE3Q,88250
 sphinx/domains/cpp/_symbol.py,sha256=0aiZMW2Lsn4Fiw3PCMT42u6zb9JZ52JbaGuAspp9DQk,48863
-sphinx/domains/python/__init__.py,sha256=mWEy28rgBrk1hBGoN5SOTw9PptIg58ghby_1iuLEVvA,35444
-sphinx/domains/python/_annotations.py,sha256=bLay4nHo1L7KxfX2exE2ttTLqwOnMBDVEg7r6v_YeSY,22302
+sphinx/domains/python/__init__.py,sha256=bOD71LelNZKkgutWktS8ju7qoz714__cv1VpPTGlvmM,35415
+sphinx/domains/python/_annotations.py,sha256=cO7U8JvRcKX1CObNlZrO57UcuhfTNRnczOHmVZiMixo,23388
 sphinx/domains/python/_object.py,sha256=5DjvYfjQwmJToudJQNSogfP4LIAMU8fp6rd-Xe6nhzY,17011
 sphinx/domains/std/__init__.py,sha256=gXNUycqNBSeFBXg89WStSk9pZsvaS6BuDtTBee-DWoM,49514
 sphinx/environment/__init__.py,sha256=8078TrLXUERa0RbBBLZxwPDndYqhqTZNrwlL2zwzj6A,32545
@@ -101,18 +101,18 @@ sphinx/ext/linkcode.py,sha256=x4Ku-cssPT771pj5Rp966kPSK20hq06O9pf03asl2lk,2352
 sphinx/ext/mathjax.py,sha256=ezbvP5pqDlTHhNwhGHj_sbquVLLqM2_8Th5YMIqIOWU,5408
 sphinx/ext/todo.py,sha256=xjoaguKakr0Xe6IMZASlCRD7YAlqCaHnK8KYtNL7Z-U,8327
 sphinx/ext/viewcode.py,sha256=KwmggBvSO0OK9w-WHDPKzG3SLsYNdN9xuJkb7xl8goQ,13792
-sphinx/ext/autodoc/__init__.py,sha256=aGYSAMwuGYQvIDNp365m7DM839yhn4wu-NfKEKzgktQ,116920
+sphinx/ext/autodoc/__init__.py,sha256=ue4kKqh6KkS9UinsnM_Ld-UwXuL0m0lH4YRsRO0K37s,117180
 sphinx/ext/autodoc/directive.py,sha256=IqDLJnc91_SxqlQkBR2yGoK_ewTzCjGwozCY0eP5HHY,5833
 sphinx/ext/autodoc/importer.py,sha256=RM8dL4e3dcXIooTg2guvEBcjYzd5lak8_QrGNiHgjEI,15841
 sphinx/ext/autodoc/mock.py,sha256=qMGXSS0-s4ODVC8u0Ao9-TSTqbw2Nhcg3ZuQhBcl9dc,6049
 sphinx/ext/autodoc/preserve_defaults.py,sha256=eimSeG8656Z9KpCTuOKmbbASWLIDLbVUkverJDqOHJM,7121
 sphinx/ext/autodoc/type_comment.py,sha256=FclaU566JP0ly2k0XupMi9efnBKWiW1Zoc9L1cQdliI,5422
 sphinx/ext/autodoc/typehints.py,sha256=LIO8sgLCCdvJAnmM5OSPQQHStwUa5igjZgnu803Fy4Q,7973
-sphinx/ext/autosummary/__init__.py,sha256=L3EoGQX_URQRh-ap_Kde6d6oGrByYqkSn5uBCAdWWpo,31862
-sphinx/ext/autosummary/generate.py,sha256=Eal-e67qHkJTlt6oAkTr-9LnorMujJIB8pqkYxkWHy8,28415
+sphinx/ext/autosummary/__init__.py,sha256=ZjH15H5z4auCQ45CsgvUiCUN1lQKXlOCtnUHlxSI9_g,32094
+sphinx/ext/autosummary/generate.py,sha256=q0n46AAiwCAwELSZ-pecEvL8OJFpLp3CISDKlXMMQkU,28199
 sphinx/ext/autosummary/templates/autosummary/base.rst,sha256=AfG9oeDMTKBsBf2lUKr-NolOeV7ImT_JrKG3KQkEGzE,106
 sphinx/ext/autosummary/templates/autosummary/class.rst,sha256=1uu4SSX9KRCeNlcr7FMRZ-DrPuW7E6tQ7QZC1asnAL0,553
-sphinx/ext/autosummary/templates/autosummary/module.rst,sha256=vF13Kh9MiXnAoqer8SWcKjY9TutSm7nEcUerqEAMtdo,1071
+sphinx/ext/autosummary/templates/autosummary/module.rst,sha256=HuEHeghiPzJ5jgDNy3_3vZ7De-AtWZjgYx_57LrP9tM,1085
 sphinx/ext/intersphinx/__init__.py,sha256=olSC7q5eSOaQ_hFv_YRMlUd4fVFzMaotspUCfc198_U,2675
 sphinx/ext/intersphinx/__main__.py,sha256=zapvRzIUEUskvRfaYkf0okrNxPVL2rMWso4NvHOsz7g,218
 sphinx/ext/intersphinx/_cli.py,sha256=pcq57fnqtKa_MO3Hl4KbvkKsaDhyJofYqrKVcQh_WeQ,1440
@@ -292,9 +292,9 @@ sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po,sha256=3CiWkDY6uvDbOc2qo5qXVVzVFVGJssJ
 sphinx/locale/sv/LC_MESSAGES/sphinx.js,sha256=sYbEozwp12g5BpvZ1epVdXQeVsBOe4crC7AXxg8VWqI,3261
 sphinx/locale/sv/LC_MESSAGES/sphinx.mo,sha256=gOy1O97wEJUf700KSm0C59hRdvzEwMT1h0JEzSexsi8,6376
 sphinx/locale/sv/LC_MESSAGES/sphinx.po,sha256=yZgPt7EzTRmzeX99MVDj14pzZ8T2tatS6ti_YjOP76I,93284
-sphinx/locale/ta/LC_MESSAGES/sphinx.js,sha256=lEF6xR0-WOr0rIGIZnvNZuJQbCCa2Rnpb-G_X2atfDM,10644
-sphinx/locale/ta/LC_MESSAGES/sphinx.mo,sha256=CaBJ88S-xWhr7lIKA598i8GVtB1MabDo56vEhK25-1A,137491
-sphinx/locale/ta/LC_MESSAGES/sphinx.po,sha256=bfh-Ef-H_shQ-tgYsnlc7xAGSWuAEBehwru_O5gqoIg,183430
+sphinx/locale/ta/LC_MESSAGES/sphinx.js,sha256=Z_VSkp6AQYsRsJceRKXMWp8pxxizmTbxCMbU3GLrxH0,2300
+sphinx/locale/ta/LC_MESSAGES/sphinx.mo,sha256=ZNLx56n-dKayAnZvnUqT4UhZ2IIvTYFv-ajKZ-LYKkw,647
+sphinx/locale/ta/LC_MESSAGES/sphinx.po,sha256=tuMT-0MUfi38EobuWb79Cn-e98FXinhM6yyf-tT6Uz8,84381
 sphinx/locale/te/LC_MESSAGES/sphinx.js,sha256=Xla07Tz_nhkxy7nQ7LRuL4dbA7KYk73gmACHGJSYwSI,2301
 sphinx/locale/te/LC_MESSAGES/sphinx.mo,sha256=aaMwmnaL4ZhtTvJ_eI-hgQNljSOEti12Y-Zzp270Cew,489
 sphinx/locale/te/LC_MESSAGES/sphinx.po,sha256=GSQ70s6Jal4YQdXr57R2qIYyaWxpsjdLejW-BUgOQ04,91440
@@ -315,7 +315,7 @@ sphinx/locale/yue/LC_MESSAGES/sphinx.mo,sha256=Qz2gEm8_iqiOU6t-MdRSpSWzchwb1IbFv
 sphinx/locale/yue/LC_MESSAGES/sphinx.po,sha256=fTInWiPcbMOzTkNCgpMxdHvuDoUZnortWl1VX5tcYu8,91438
 sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js,sha256=Ms4qOciN2sxV8xmIBFKsXOQEfcXf-GfhQ6kHsbkHPVs,4318
 sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo,sha256=I7m3GDvtssnuSn4veCuX9tEOqnI_b6NZcMwbhB9XyNE,73260
-sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po,sha256=45I8IgSvg4nXPVNYj2DPw4PmIwqS-8UN8mUaWme5Fzk,122030
+sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po,sha256=w8pU8agHA3FVklqO64Vap5vP6eiJXWGfQOOr1tvenGM,116867
 sphinx/locale/zh_HK/LC_MESSAGES/sphinx.js,sha256=ZbQAiim_q3ynWkqeCt0-eZART7CoNZXDi4URAaJFyzo,2302
 sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo,sha256=HOnr3tkv1EyLcegD9C0Xs03SYmACPjzAStcts7WjbN4,501
 sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po,sha256=eTObc-T9K2fT825zwk9xpwCxERDYT_IbwzLCQCpLUGQ,91452
@@ -555,18 +555,18 @@ sphinx/util/docfields.py,sha256=WIrmB3z4B1fsE7IGoRU9f7fB526HnOHFuBTb27Qz4m8,1697
 sphinx/util/docstrings.py,sha256=g__pCkpIBjCew6rP6ytJAYXgTKMKxjTdUDOaF2EDqCs,2944
 sphinx/util/docutils.py,sha256=A-msKRFgAD7UD-D6F-w4o9nKegHF0cX7fLuaF5MFsM0,24180
 sphinx/util/exceptions.py,sha256=_ZcjI6sTQv0bLlkBu5XsD_QwUHphjKKq17391azKs7c,2010
-sphinx/util/fileutil.py,sha256=J-R7g3nI6CywRpXk1iWEzL7BqFCwH5Ecus3eBfaOP6w,4328
+sphinx/util/fileutil.py,sha256=2JhqHXuNucc9lQB0siM51b-Dcrpc16PDmh5mdw1G4rI,5663
 sphinx/util/http_date.py,sha256=j9jvARRJrYjuIK_oR4H4dLyeCeZIDaOGCQz-8FDpufg,1626
 sphinx/util/i18n.py,sha256=K5smw0FQ3Hkr4Bp17o2BQRMK-8s76edJPsdWgLT5AFM,10542
 sphinx/util/images.py,sha256=Y5Oy1M_BD6HRsUyWFQ2DvvCL4VDOFHDPZxtYnO8QEfM,3701
 sphinx/util/index_entries.py,sha256=wEa55m_tez3UFNFEVuIesEQKWavANQ2O-l86k1If0sY,986
-sphinx/util/inspect.py,sha256=BdltEA-0lZKhCcCa3DmS7kIV7Xf5KZS6d8VKf6uLNMI,33077
-sphinx/util/inventory.py,sha256=qjbSlk51LQY2gXZW_d8i3-pyUewisaFpj955jf2IFz0,7973
+sphinx/util/inspect.py,sha256=QfyFfg7OwDEG8PnvxROOJAUYDQFJtLgdDqBep91Mh4w,33098
+sphinx/util/inventory.py,sha256=Mo9JGfs-4hFv8l94-w53L5uarrSMdWiagPCWjCeafI4,7967
 sphinx/util/logging.py,sha256=WokXNrpfjX7kekEE6N59MitS23DzdCpyEw0GTiQovug,20542
 sphinx/util/matching.py,sha256=pywT5EKjUUJ-PX4H6mm-LA3f37AvYfxwEpraHHrhVsI,5368
 sphinx/util/math.py,sha256=GuBqbvunQfOE2JpxjFsUoWwujDhWaYELczJIyNGzLhE,1984
 sphinx/util/nodes.py,sha256=X9mpo0MiLEWcYYDIDY5zUWnQwBIQYzfGj-TgP5loQMM,24638
-sphinx/util/osutil.py,sha256=hyqgVweL0QT7Lv402nZ-VaBWjXaUSNtfwe8nj0ww5WI,7005
+sphinx/util/osutil.py,sha256=JdPBSyyHMfBQ_X8yWnRtYBg7UGfx8hqyj8o46A7XzGE,7836
 sphinx/util/parallel.py,sha256=PActfjRJU0-NNqAgfuuVsyQc7mXiowuPLYwXYaAa7HI,5272
 sphinx/util/parsing.py,sha256=3F3mbV2OjHLUnrU2trwQxKabfk_x0c8_onCKGNDNUJk,3321
 sphinx/util/png.py,sha256=78SpKyEuQTlaHXIpnHZ3kDaTQZqhNivGcW7KXbrG7Ns,1445
@@ -575,7 +575,7 @@ sphinx/util/rst.py,sha256=YY2Wk4Pn1vNQAi1iDjUCYeBYGutYYo4curTpdsVcyKE,3585
 sphinx/util/tags.py,sha256=K6tiZhx-V60aKZ4Z3ie5kasMYGGV_WPUTq8ncWlWnJM,3927
 sphinx/util/template.py,sha256=jxQgY24NYYfMc1M951DKQn2oSk0-wxEGqKBPR98eRbc,5146
 sphinx/util/texescape.py,sha256=eGHE_GX732SVeSHcmprXbOa2euwNh37kREwWPTY1hvY,5442
-sphinx/util/typing.py,sha256=nSZtWgMw4IqRkjplxPANTlTd7Nj5hvUrT6VLVqThO9M,22617
+sphinx/util/typing.py,sha256=mkIMB6zhULCUUomUJ0E-2sZGecY10sJWoj1c_y1FA-w,24259
 sphinx/writers/__init__.py,sha256=efGdnx4MWlPEDzXACf4Q18Oi3GTyY5Ob14I_j3XXtXc,31
 sphinx/writers/html.py,sha256=ptitqWUkA4wnY0HuPIjy1GuKG4cOPCuPlAdH7aMRhyg,1604
 sphinx/writers/html5.py,sha256=KmE-WAPcIX1laEHXBX2H8zRwCDC66vGzys_32UV5yM4,37671
@@ -584,8 +584,8 @@ sphinx/writers/manpage.py,sha256=iLoC4i81W52dTl8Kpug65CV1M7cCz1buGgsN7FhazYo,162
 sphinx/writers/texinfo.py,sha256=UU3Zrt-zBgdwYgqj4BJFNthggzMr_Gllx2ewBeWrkcI,53451
 sphinx/writers/text.py,sha256=HEiYXsWXO9QVOazg2V3D0ehGTnK38dAtYP9v0rst684,42964
 sphinx/writers/xml.py,sha256=NyDl82hCFSRiHrCZV6vBfn4AsAyXH6khtSJEfhOX8a0,1502
-sphinx-7.4.5.dist-info/entry_points.txt,sha256=KU_c9jqXj7yyZylSz11XRIXG3gAZApQa0d5DmcfyA7M,188
-sphinx-7.4.5.dist-info/LICENSE.rst,sha256=HdZPUFcmQaLySBc9fKvRC5aOUNkxL9Gz5py0p6XGDk4,3135
-sphinx-7.4.5.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-sphinx-7.4.5.dist-info/METADATA,sha256=qyoEdApSTAM6yq2wEt_NxjmWIEDKGjjtN5bBR6O1xiQ,6113
-sphinx-7.4.5.dist-info/RECORD,,
+sphinx-7.4.7.dist-info/entry_points.txt,sha256=KU_c9jqXj7yyZylSz11XRIXG3gAZApQa0d5DmcfyA7M,188
+sphinx-7.4.7.dist-info/LICENSE.rst,sha256=HdZPUFcmQaLySBc9fKvRC5aOUNkxL9Gz5py0p6XGDk4,3135
+sphinx-7.4.7.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+sphinx-7.4.7.dist-info/METADATA,sha256=_w_jjP5ymKO_Z-vyWP8OKaEexA863gpcsZrd0-roucI,6113
+sphinx-7.4.7.dist-info/RECORD,,