Sphinx 7.4.1__py3-none-any.whl → 7.4.3__py3-none-any.whl

sphinx/__init__.py

@@ -1,6 +1,6 @@
 """The Sphinx documentation toolchain."""
 
-__version__ = '7.4.1'
+__version__ = '7.4.3'
 __display_version__ = __version__  # used for command line version
 
 # Keep this file executable as-is in Python 3!
@@ -27,7 +27,7 @@ warnings.filterwarnings(
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (7, 4, 1, 'final', 0)
+version_info = (7, 4, 3, 'final', 0)
 
 package_dir = os.path.abspath(os.path.dirname(__file__))
 

sphinx/config.py

@@ -582,13 +582,17 @@ def convert_source_suffix(app: Sphinx, config: Config) -> None:
         # The default filetype is determined on later step.
         # By default, it is considered as restructuredtext.
         config.source_suffix = {source_suffix: 'restructuredtext'}
+        logger.info(__("Converting `source_suffix = %r` to `source_suffix = %r`."),
+                    source_suffix, config.source_suffix)
     elif isinstance(source_suffix, (list, tuple)):
         # if list, considers as all of them are default filetype
         config.source_suffix = dict.fromkeys(source_suffix, 'restructuredtext')
+        logger.info(__("Converting `source_suffix = %r` to `source_suffix = %r`."),
+                    source_suffix, config.source_suffix)
     elif not isinstance(source_suffix, dict):
-        logger.warning(__("The config value `source_suffix' expects "
-                          "a string, list of strings, or dictionary. "
-                          "But `%r' is given." % source_suffix))
+        msg = __("The config value `source_suffix' expects a dictionary,"
+                 "a string, or a list of strings. Got `%r' instead (type %s).")
+        raise ConfigError(msg % (source_suffix, type(source_suffix)))
 
 
 def convert_highlight_options(app: Sphinx, config: Config) -> None:

sphinx/environment/__init__.py

@@ -59,7 +59,7 @@ default_settings: dict[str, Any] = {
 
 # This is increased every time an environment attribute is added
 # or changed to properly invalidate pickle files.
-ENV_VERSION = 61
+ENV_VERSION = 62
 
 # config status
 CONFIG_UNSET = -1

sphinx/registry.py

@@ -504,10 +504,14 @@ def merge_source_suffix(app: Sphinx, config: Config) -> None:
     for suffix, filetype in app.registry.source_suffix.items():
         if suffix not in app.config.source_suffix:  # NoQA: SIM114
             app.config.source_suffix[suffix] = filetype
-        elif app.config.source_suffix[suffix] is None:
-            # filetype is not specified (default filetype).
+        elif app.config.source_suffix[suffix] == 'restructuredtext':
+            # The filetype is not specified (default filetype).
             # So it overrides default filetype by extensions setting.
             app.config.source_suffix[suffix] = filetype
+        elif app.config.source_suffix[suffix] is None:
+            msg = __('`None` is not a valid filetype for %r.') % suffix
+            logger.warning(msg)
+            app.config.source_suffix[suffix] = filetype
 
     # copy config.source_suffix to registry
     app.registry.source_suffix = app.config.source_suffix

{sphinx-7.4.1.dist-info → sphinx-7.4.3.dist-info}/METADATA

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

{sphinx-7.4.1.dist-info → sphinx-7.4.3.dist-info}/RECORD

@@ -1,8 +1,8 @@
-sphinx/__init__.py,sha256=w-4bjWqtJTSdO5jpuogpASovgSk6fgyGpZ1qOBoAh7Q,1690
+sphinx/__init__.py,sha256=yHiprJSiTyxDdQrMU1sRfPUr6-4sbs698kAwfh1gHN0,1690
 sphinx/__main__.py,sha256=wIifwXlZHdi4gtQmkJ6KF0BsflvD9o0Wd5nARTdJc8A,127
 sphinx/addnodes.py,sha256=EQTIi9Zta6DaNa-2WGE3l9AVjdp7WzwwrfwRnax8vXE,18707
 sphinx/application.py,sha256=5QXM7tYRt1s4q00GHPtAK2EIxu6G_UkzMB3MOKOkuUI,57793
-sphinx/config.py,sha256=us4U_j4FbDKTOZ0q3xqS2kEonC1yvlaMLLSERKgzmQc,30879
+sphinx/config.py,sha256=8q1CB3Yr4LXrYqOyiw_OUxLsTaWjihONrOyLnNQ3_9g,31179
 sphinx/deprecation.py,sha256=ABIo1t4mSwCTT2uxpUKNcwQHb3X6qur_tziCWzIhqtE,2437
 sphinx/errors.py,sha256=mFyE7P1fmnVTeYtpP3wv8oXrKyTw1H0WcE46VypUPd0,3412
 sphinx/events.py,sha256=zb0K0Mq2a_MRr6lwLaD8ODhUnASd16vmYI8rKc_g-KY,4383
@@ -14,7 +14,7 @@ sphinx/parsers.py,sha256=86Yn9xUBWWe8FxvDf1_BlEzqvSDZ8AMFeYJCbx7AtMQ,3179
 sphinx/project.py,sha256=t8mzAJgG6nvYFbm94VMik4PuCd3YAN4lux9-EZV981M,4389
 sphinx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sphinx/pygments_styles.py,sha256=0RJn6WC7rPnQu7BDqrqb0gkJcb3elRfizGVBW9bcmRE,2861
-sphinx/registry.py,sha256=LCWv2mDKNiN6IaE5tgUeWzmff9SFN7UWYwEN3QxbK4Q,22593
+sphinx/registry.py,sha256=RQoHNd0VaHEFD3fGBbELJlNuVsEhTDi0jqNnBdO8eyY,22826
 sphinx/roles.py,sha256=mTnbo0R6w5V9wlOmx2BU4P0MnpSj0csE9zeEdqT06zs,16966
 sphinx/theming.py,sha256=M9fQgECyQevHffOUZFR9MVHg0IHWv18TDSx8UVvTP_U,20312
 sphinx/versioning.py,sha256=IlROZblXuBBJGLgQkcuCiWa4DNDm3iNUrvHmzayASps,6240
@@ -73,7 +73,7 @@ sphinx/domains/python/__init__.py,sha256=mWEy28rgBrk1hBGoN5SOTw9PptIg58ghby_1iuL
 sphinx/domains/python/_annotations.py,sha256=bLay4nHo1L7KxfX2exE2ttTLqwOnMBDVEg7r6v_YeSY,22302
 sphinx/domains/python/_object.py,sha256=5DjvYfjQwmJToudJQNSogfP4LIAMU8fp6rd-Xe6nhzY,17011
 sphinx/domains/std/__init__.py,sha256=gXNUycqNBSeFBXg89WStSk9pZsvaS6BuDtTBee-DWoM,49514
-sphinx/environment/__init__.py,sha256=-dweW4btgtJsku0MGp4WLEnnN98ZWTaZQ4qgCtFSNWU,32545
+sphinx/environment/__init__.py,sha256=8078TrLXUERa0RbBBLZxwPDndYqhqTZNrwlL2zwzj6A,32545
 sphinx/environment/adapters/__init__.py,sha256=VnDotW2UbxjWeVITmz7iTsVrzqQcvmLHr3euKqqKHwo,34
 sphinx/environment/adapters/asset.py,sha256=huGHWMReM80cD9b88thQeqvJZG3G6BCnG_DY2uIZt0Q,418
 sphinx/environment/adapters/indexentries.py,sha256=v_U51MZyYgkwVcFG0cCVICwSJALjlIxFHCpcxg2Nqbs,8926
@@ -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.1.dist-info/entry_points.txt,sha256=KU_c9jqXj7yyZylSz11XRIXG3gAZApQa0d5DmcfyA7M,188
-sphinx-7.4.1.dist-info/LICENSE.rst,sha256=HdZPUFcmQaLySBc9fKvRC5aOUNkxL9Gz5py0p6XGDk4,3135
-sphinx-7.4.1.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-sphinx-7.4.1.dist-info/METADATA,sha256=RQle7-sHgt-XGrAJ_AIRQWp5vSHbdPtpJ29891fHkLE,6113
-sphinx-7.4.1.dist-info/RECORD,,
+sphinx-7.4.3.dist-info/entry_points.txt,sha256=KU_c9jqXj7yyZylSz11XRIXG3gAZApQa0d5DmcfyA7M,188
+sphinx-7.4.3.dist-info/LICENSE.rst,sha256=HdZPUFcmQaLySBc9fKvRC5aOUNkxL9Gz5py0p6XGDk4,3135
+sphinx-7.4.3.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+sphinx-7.4.3.dist-info/METADATA,sha256=HdBXZsmIiSOmuAviGIzMMQGQPj_8yMS9Y2rZq7EA-S8,6113
+sphinx-7.4.3.dist-info/RECORD,,