ci: Debug issue with artifact upload

Author: pawamoy

.github/workflows/ci.yml

@@ -32,6 +32,9 @@ jobs:
     - name: Set up Graphviz
       uses: ts-graphviz/setup-graphviz@v1
 
+    - name: Setup D2
+      run: curl -fsSL https://d2lang.com/install.sh | sh -s --
+
     - name: Setup Python
       uses: actions/setup-python@v5
       with:
@@ -47,6 +50,8 @@ jobs:
       run: make setup
 
     - name: Check if the documentation builds correctly
+      env:
+        GH_TOKEN: ${{ github.token }}
       run: make check-docs
 
     - name: Check the code quality

docs/snippets/gallery/d2.py

@@ -1,7 +1,3 @@
-import os  # markdown-exec: hide
-if "CI" in os.environ:  # markdown-exec: hide
-    print("D2 is not installed in CI, skipping this gallery example.")  # markdown-exec: hide
-    raise SystemExit(0)  # markdown-exec: hide
 import subprocess
 
 diagram = """

docs/snippets/gallery/runpy.py

@@ -6,13 +6,13 @@
 
 old_argv = list(sys.argv)
 sys.argv = ["mkdocs"]
-old_stdout = sys.stdout
-sys.stdout = StringIO()
+old_stderr = sys.stderr
+sys.stderr = StringIO()
 warnings.filterwarnings("ignore", category=RuntimeWarning)
 with suppress(SystemExit):
     run_module("mkdocs", run_name="__main__")
-output = sys.stdout.getvalue()
-sys.stdout = old_stdout
+output = sys.stderr.getvalue()
+sys.stderr = old_stderr
 sys.argv = old_argv
 
 print(f"```\n{output}\n```")

src/markdown_exec/_internal/main.py

@@ -4,9 +4,6 @@
 import re
 from typing import TYPE_CHECKING, Any
 
-if TYPE_CHECKING:
-    from markdown import Markdown
-
 from markdown_exec._internal.formatters.base import default_tabs
 from markdown_exec._internal.formatters.bash import _format_bash
 from markdown_exec._internal.formatters.console import _format_console
@@ -16,10 +13,17 @@
 from markdown_exec._internal.formatters.python import _format_python
 from markdown_exec._internal.formatters.sh import _format_sh
 from markdown_exec._internal.formatters.tree import _format_tree
+from markdown_exec._internal.logger import get_logger
+
+if TYPE_CHECKING:
+    from markdown import Markdown
 
 MARKDOWN_EXEC_AUTO = [lang.strip() for lang in os.getenv("MARKDOWN_EXEC_AUTO", "").split(",")]
 """Languages to automatically execute."""
 
+
+_logger = get_logger("markdown-exec")
+
 formatters = {
     "bash": _format_bash,
     "console": _format_console,
@@ -116,6 +120,7 @@ def formatter(
         HTML contents.
     """
     fmt = formatters.get(language, lambda source, **kwargs: source)
+    _logger.debug("Executing %s code block with options: %s", language, options)
     return fmt(code=source, md=md, **options)  # type: ignore[operator]