Sphinx 8.2.0rc2__py3-none-any.whl → 8.3.0__py3-none-any.whl

sphinx/search/zh.py

@@ -4,19 +4,33 @@ from __future__ import annotations
 
 import re
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 import snowballstemmer
 
 from sphinx.search import SearchLanguage
 
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
 try:
     import jieba  # type: ignore[import-not-found]
-
-    JIEBA = True
-    JIEBA_DEFAULT_DICT = Path(jieba.__file__).parent / jieba.DEFAULT_DICT_NAME
+    from jieba import cut_for_search
+    from jieba import load_userdict as jieba_load_userdict
 except ImportError:
-    JIEBA = False
-    JIEBA_DEFAULT_DICT = Path()
+    JIEBA_DEFAULT_DICT = ''
+
+    def jieba_load_userdict(f: str) -> None:
+        pass
+
+    def cut_for_search(sentence: str, HMM: bool = True) -> Iterator[str]:
+        yield from ()
+
+else:
+    JIEBA_DEFAULT_DICT = (
+        Path(jieba.__file__, '..', jieba.DEFAULT_DICT_NAME).resolve().as_posix()
+    )
+    del jieba
 
 english_stopwords = {
     'a', 'and', 'are', 'as', 'at',
@@ -231,18 +245,14 @@ class SearchChinese(SearchLanguage):
         self.latin_terms: set[str] = set()
 
     def init(self, options: dict[str, str]) -> None:
-        if JIEBA:
-            dict_path = options.get('dict', JIEBA_DEFAULT_DICT)
-            if dict_path and Path(dict_path).is_file():
-                jieba.load_userdict(dict_path)
+        dict_path = options.get('dict', JIEBA_DEFAULT_DICT)
+        if dict_path and Path(dict_path).is_file():
+            jieba_load_userdict(str(dict_path))
 
         self.stemmer = snowballstemmer.stemmer('english')
 
     def split(self, input: str) -> list[str]:
-        if JIEBA:
-            chinese: list[str] = list(jieba.cut_for_search(input))
-        else:
-            chinese = []
+        chinese: list[str] = list(cut_for_search(input))
 
         latin1 = [term.strip() for term in self.latin1_letters.findall(input)]
         self.latin_terms.update(latin1)

sphinx/testing/path.py

@@ -58,18 +58,26 @@ class path(str):  # NoQA: FURB189
         """Returns ``True`` if the path is a directory."""
         return os.path.isdir(self)
 
+    is_dir = isdir
+
     def isfile(self) -> bool:
         """Returns ``True`` if the path is a file."""
         return os.path.isfile(self)
 
+    is_file = isfile
+
     def islink(self) -> bool:
         """Returns ``True`` if the path is a symbolic link."""
         return os.path.islink(self)
 
+    is_symlink = islink
+
     def ismount(self) -> bool:
         """Returns ``True`` if the path is a mount point."""
         return os.path.ismount(self)
 
+    is_mount = ismount
+
     def rmtree(
         self,
         ignore_errors: bool = False,

sphinx/themes/basic/static/basic.css.jinja

@@ -741,14 +741,6 @@ abbr, acronym {
     cursor: help;
 }
 
-.translated {
-    background-color: rgba(207, 255, 207, 0.2)
-}
-
-.untranslated {
-    background-color: rgba(255, 207, 207, 0.2)
-}
-
 /* -- code displays --------------------------------------------------------- */
 
 pre {

sphinx/util/__init__.py

@@ -62,6 +62,13 @@ def __getattr__(name: str) -> Any:
     obj: Callable[..., Any]
     mod: ModuleType
 
+    if name == 'console':
+        # Explicit temporary workaround for nbsphinx implicit imports.
+        # https://github.com/sphinx-doc/sphinx/issues/13352
+        import sphinx.util.console as mod
+
+        return mod
+
     # RemovedInSphinx90Warning
     if name == 'split_index_msg':
         from sphinx.util.index_entries import split_index_msg as obj

sphinx/util/_files.py

@@ -11,7 +11,7 @@ if TYPE_CHECKING:
     from collections.abc import Set
 
 
-class FilenameUniqDict(dict[str, tuple[set[str], str]]):
+class FilenameUniqDict(dict[str, tuple[set[str], str]]):  # NoQA: FURB189
     """A dictionary that automatically generates unique names for its keys,
     interpreted as filenames, and keeps track of a set of docnames they
     appear in.  Used for images and downloadable files in the environment.
@@ -61,7 +61,7 @@ class FilenameUniqDict(dict[str, tuple[set[str], str]]):
         self._existing = state
 
 
-class DownloadFiles(dict[Path, tuple[set[str], _StrPath]]):
+class DownloadFiles(dict[Path, tuple[set[str], _StrPath]]):  # NoQA: FURB189
     """A special dictionary for download files.
 
     .. important:: This class would be refactored in nearly future.

sphinx/util/fileutil.py

@@ -140,7 +140,8 @@ def copy_asset(
         return
 
     for root, dirs, files in os.walk(source, followlinks=True):
-        reldir = _relative_path(Path(root), source).as_posix()
+        root_p = Path(root)
+        reldir = _relative_path(root_p, source).as_posix()
         for dir in dirs.copy():
             if excluded(posixpath.join(reldir, dir)):
                 dirs.remove(dir)

sphinx/util/osutil.py

@@ -177,9 +177,14 @@ def _relative_path(path: Path, root: Path, /) -> Path:
     It returns the original path if *path* and *root* are on different drives,
     which may happen on Windows.
     """
+    # Path.relative_to() requires fully-resolved paths (no '..').
+    if '..' in path.parts:
+        path = path.resolve()
+    if '..' in root.parts:
+        root = root.resolve()
+
     if path.anchor != root.anchor or '..' in root.parts:
         # If the drives are different, no relative path exists.
-        # Path.relative_to() requires fully-resolved paths (no '..').
         return path
     if sys.version_info[:2] < (3, 12):
         return Path(os.path.relpath(path, root))

{sphinx-8.2.0rc2.dist-info → sphinx-8.3.0.dist-info}/METADATA

@@ -1,10 +1,11 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: Sphinx
-Version: 8.2.0rc2
+Version: 8.3.0
 Summary: Python documentation generator
 Author-email: Adam Turner <aa-turner@users.noreply.github.com>, Georg Brandl <georg@python.org>
 Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
+License-Expression: BSD-2-Clause
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Environment :: Web Environment
@@ -15,7 +16,6 @@ Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Other Audience
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
@@ -50,6 +50,7 @@ Classifier: Topic :: Text Processing :: Markup :: reStructuredText
 Classifier: Topic :: Text Processing :: Markup :: XML
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
+License-File: LICENSE.rst
 Requires-Dist: sphinxcontrib-applehelp>=1.0.7
 Requires-Dist: sphinxcontrib-devhelp>=1.0.6
 Requires-Dist: sphinxcontrib-htmlhelp>=2.0.6
@@ -68,17 +69,17 @@ Requires-Dist: roman-numerals-py>=1.0.0
 Requires-Dist: packaging>=23.0
 Requires-Dist: colorama>=0.4.6; sys_platform == 'win32'
 Requires-Dist: sphinxcontrib-websupport ; extra == "docs"
-Requires-Dist: ruff==0.9.6 ; extra == "lint"
+Requires-Dist: ruff==0.9.9 ; extra == "lint"
 Requires-Dist: mypy==1.15.0 ; extra == "lint"
 Requires-Dist: sphinx-lint>=0.9 ; extra == "lint"
 Requires-Dist: types-colorama==0.4.15.20240311 ; extra == "lint"
 Requires-Dist: types-defusedxml==0.7.0.20240218 ; extra == "lint"
 Requires-Dist: types-docutils==0.21.0.20241128 ; extra == "lint"
 Requires-Dist: types-Pillow==10.2.0.20240822 ; extra == "lint"
-Requires-Dist: types-Pygments==2.19.0.20250107 ; extra == "lint"
+Requires-Dist: types-Pygments==2.19.0.20250219 ; extra == "lint"
 Requires-Dist: types-requests==2.32.0.20241016 ; extra == "lint"
 Requires-Dist: types-urllib3==1.26.25.14 ; extra == "lint"
-Requires-Dist: pyright==1.1.394 ; extra == "lint"
+Requires-Dist: pyright==1.1.395 ; extra == "lint"
 Requires-Dist: pytest>=8.0 ; extra == "lint"
 Requires-Dist: pypi-attestations==0.0.21 ; extra == "lint"
 Requires-Dist: betterproto==2.0.0b6 ; extra == "lint"