Implicitly use pycon (#168)

Author: felix-hilden

docs/src/release_notes.rst

@@ -19,6 +19,8 @@ sphinx-codeautolink adheres to
   and ``highlight_language`` configuration (:issue:`166`)
 - Add :confval:`codeautolink_warn_on_default_parse_fail` to warn about
   failing to link code blocks without a language parameter (:issue:`166`)
+- Detect and implicitly use ``pycon`` lexer for blocks that look like
+  console code (:issue:`168`)
 - Fix skipping blocks with identical content to linked ones (:issue:`172`)
 
 0.16.2 (2025-01-16)

pyproject.toml

@@ -89,6 +89,7 @@ isort.split-on-trailing-comma = false
     "ANN", # annotations
     "S101", # assertions - necessary in tests
     "T201", # print - helpful in tests
+    "PLR2004", # magic number
 ]
 # TODO: support future annotated hints properly
 "tests/extension/src/test_project/__init__.py" = ["FA100"]

src/sphinx_codeautolink/extension/block.py

@@ -224,6 +224,11 @@ def parse_source(  # noqa: C901
         if skip:
             return
 
+        # Sphinx uses a similar trick to use pycon implicitly (#168)
+        pycon_candidates = ("py", "python", "py3", "python3", "default", "pycon3")
+        if source.startswith(">>>") and language in pycon_candidates:
+            language = "pycon"
+
         transformer = self.transformers[language]
         if transformer:
             try:

tests/extension/fail/ref_invalid_block_type.txt

@@ -4,7 +4,7 @@ Test project
 
 .. code:: python
 
-   >>> import test_project
-   >>> test_project.bar()
+   In[1]: import test_project
+      ... test_project.bar()
 
 .. automodule:: test_project

tests/extension/ref/lexer_pycon_implicit.txt

@@ -0,0 +1,24 @@
+test_project
+test_project.bar
+attr
+test_project.Foo
+test_project.Foo
+# split
+# split
+Test project
+============
+
+.. code:: python
+
+   >>> import test_project
+   >>> test_project.bar().attr
+   >>> def foo():
+   ...     test_project.Foo
+   this is an output line
+   test_project.Baz
+   <BLANKLINE>
+   ... test_project.Baz
+   >>> test_project.Foo
+   <BLANKLINE>
+
+.. automodule:: test_project