Sphinx 8.2.0rc1__py3-none-any.whl → 8.2.1__py3-none-any.whl

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/_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/writers/html5.py

@@ -906,8 +906,8 @@ class HTML5Translator(SphinxTranslator, BaseTranslator):  # type: ignore[misc]
 
     def visit_abbreviation(self, node: Element) -> None:
         attrs = {}
-        if node.hasattr('explanation'):
-            attrs['title'] = node['explanation']
+        if explanation := node.get('explanation', ''):
+            attrs['title'] = explanation
         self.body.append(self.starttag(node, 'abbr', '', **attrs))
 
     def depart_abbreviation(self, node: Element) -> None:

sphinx/writers/latex.py

@@ -2082,11 +2082,12 @@ class LaTeXTranslator(SphinxTranslator):
         self.body.append('}}')
 
     def visit_abbreviation(self, node: Element) -> None:
+        explanation = node.get('explanation', '')
         abbr = node.astext()
         self.body.append(r'\sphinxstyleabbreviation{')
         # spell out the explanation once
-        if node.hasattr('explanation') and abbr not in self.handled_abbrs:
-            self.context.append('} (%s)' % self.encode(node['explanation']))
+        if explanation and abbr not in self.handled_abbrs:
+            self.context.append('} (%s)' % self.encode(explanation))
             self.handled_abbrs.add(abbr)
         else:
             self.context.append('}')

sphinx/writers/texinfo.py

@@ -1537,10 +1537,11 @@ class TexinfoTranslator(SphinxTranslator):
         pass
 
     def visit_abbreviation(self, node: Element) -> None:
+        explanation = node.get('explanation', '')
         abbr = node.astext()
         self.body.append('@abbr{')
-        if node.hasattr('explanation') and abbr not in self.handled_abbrs:
-            self.context.append(',%s}' % self.escape_arg(node['explanation']))
+        if explanation and abbr not in self.handled_abbrs:
+            self.context.append(',%s}' % self.escape_arg(explanation))
             self.handled_abbrs.add(abbr)
         else:
             self.context.append('}')

sphinx/writers/text.py

@@ -1237,8 +1237,8 @@ class TextTranslator(SphinxTranslator):
         self.add_text('')
 
     def depart_abbreviation(self, node: Element) -> None:
-        if node.hasattr('explanation'):
-            self.add_text(' (%s)' % node['explanation'])
+        if explanation := node.get('explanation', ''):
+            self.add_text(f' ({explanation})')
 
     def visit_manpage(self, node: Element) -> None:
         return self.visit_literal_emphasis(node)

{sphinx-8.2.0rc1.dist-info → sphinx-8.2.1.dist-info}/METADATA

@@ -1,10 +1,11 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: Sphinx
-Version: 8.2.0rc1
+Version: 8.2.1
 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,18 +69,20 @@ 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.7 ; 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: pytest>=8.0 ; extra == "lint"
+Requires-Dist: pypi-attestations==0.0.21 ; extra == "lint"
+Requires-Dist: betterproto==2.0.0b6 ; extra == "lint"
 Requires-Dist: pytest>=8.0 ; extra == "test"
 Requires-Dist: pytest-xdist[psutil]>=3.4 ; extra == "test"
 Requires-Dist: defusedxml>=0.7.1 ; extra == "test"