SF.net SVN: docutils:[10307 ] trunk/docutils

milde--- via Docutils-checkins <[email protected]> Sat, 28 Mar 2026 18:54:15 +0000
Newsgroups gmane.text.docutils.cvs
Message-ID <[email protected]>
Revision: 10307
          http://sourceforge.net/p/docutils/code/10307
Author:   milde
Date:     2026-03-28 18:54:14 +0000 (Sat, 28 Mar 2026)
Log Message:
-----------
Add "SectionIDs" transform in standalone reader.

Add "SectionIDs" together with other transforms from `transforms.references`.

The change in `nodes.document.note_implicit_target()` affects all parsers,
so "SectionIDs" transform should be loaded by default for all parsers.

Modified Paths:
--------------
    trunk/docutils/HISTORY.rst
    trunk/docutils/docs/api/transforms.rst
    trunk/docutils/docutils/parsers/rst/__init__.py
    trunk/docutils/docutils/readers/standalone.py

Modified: trunk/docutils/HISTORY.rst
===================================================================
--- trunk/docutils/HISTORY.rst	2026-03-28 18:54:04 UTC (rev 10306)
+++ trunk/docutils/HISTORY.rst	2026-03-28 18:54:14 UTC (rev 10307)
@@ -42,7 +42,7 @@
 
   - New configuration setting `legacy_ids`_.
 
-* docutils/parsers/rst/__init__.py
+* docutils/readers/standalone.py
 
   - Load new transform `references.SectionIDs`.
 

Modified: trunk/docutils/docs/api/transforms.rst
===================================================================
--- trunk/docutils/docs/api/transforms.rst	2026-03-28 18:54:04 UTC (rev 10306)
+++ trunk/docutils/docs/api/transforms.rst	2026-03-28 18:54:14 UTC (rev 10307)
@@ -57,7 +57,7 @@
 
 references_.Substitutions           standalone_ (r), pep_ (r)     _`220`
 
-references_.SectionIDs              rst_ (p)                      _`240`
+references_.SectionIDs              standalone_ (r), pep_ (r)     _`240`
 
 references_.PropagateTargets        standalone_ (r), pep_ (r)     _`260`
 
@@ -186,6 +186,7 @@
 
 readers.standalone.Reader:
   | references.Substitutions            (220_)
+  | references.SectionIDs               (240_)
   | references.PropagateTargets         (260_)
   | frontmatter.\ DocTitle_             (320_)
   | frontmatter.\ DocInfo_              (340_)
@@ -202,6 +203,7 @@
 
 readers.pep.Reader:
   | references.Substitutions            (220_)
+  | references.SectionIDs               (240_)
   | references.PropagateTargets         (260_)
   | peps.Headers                        (360_)
   | peps.Contents                       (380_)
@@ -222,7 +224,6 @@
   .. _rst:
 
 parsers.rst.Parser
-  | references.SectionIDs               (240_)
   | universal.SmartQuotes               (855_)
 
   .. _writers:

Modified: trunk/docutils/docutils/parsers/rst/__init__.py
===================================================================
--- trunk/docutils/docutils/parsers/rst/__init__.py	2026-03-28 18:54:04 UTC (rev 10306)
+++ trunk/docutils/docutils/parsers/rst/__init__.py	2026-03-28 18:54:14 UTC (rev 10307)
@@ -75,7 +75,7 @@
 import docutils.statemachine
 from docutils.parsers.rst import roles, states
 from docutils import frontend, nodes
-from docutils.transforms import references, universal
+from docutils.transforms import universal
 
 
 class Parser(docutils.parsers.Parser):
@@ -160,8 +160,7 @@
         self.inliner = inliner
 
     def get_transforms(self):
-        return [*super().get_transforms(),
-                references.SectionIDs, universal.SmartQuotes]
+        return super().get_transforms() + [universal.SmartQuotes]
 
     def parse(self, inputstring, document) -> None:
         """Parse `inputstring` and populate `document`, a document tree."""

Modified: trunk/docutils/docutils/readers/standalone.py
===================================================================
--- trunk/docutils/docutils/readers/standalone.py	2026-03-28 18:54:04 UTC (rev 10306)
+++ trunk/docutils/docutils/readers/standalone.py	2026-03-28 18:54:14 UTC (rev 10307)
@@ -6,13 +6,18 @@
 Standalone file Reader for the reStructuredText markup syntax.
 """
 
+from __future__ import annotations
+
 __docformat__ = 'reStructuredText'
 
-
 from docutils import frontend, readers
 from docutils.transforms import frontmatter, references, misc
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from docutils.transforms import Transform
 
+
 class Reader(readers.Reader):
 
     supported = ('standalone',)
@@ -48,9 +53,10 @@
     config_section = 'standalone reader'
     config_section_dependencies = ('readers',)
 
-    def get_transforms(self):
+    def get_transforms(self) -> list[type[Transform]]:
         return super().get_transforms() + [
             references.Substitutions,
+            references.SectionIDs,
             references.PropagateTargets,
             frontmatter.DocTitle,
             frontmatter.SectionSubTitle,

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.