markdown-exec 1.9.3__tar.gz → 1.10.1__tar.gz

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/CHANGELOG.md

@@ -5,6 +5,30 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 <!-- insertion marker -->
+## [1.10.1](https://github.com/pawamoy/markdown-exec/releases/tag/1.10.1) - 2025-03-11
+
+<small>[Compare with 1.10.0](https://github.com/pawamoy/markdown-exec/compare/1.10.0...1.10.1)</small>
+
+### Build
+
+- Add lower bound to pygments-ansi-color extra ([a8e17c9](https://github.com/pawamoy/markdown-exec/commit/a8e17c9cd1bf9ba8ab5008a83c77a0b1208a1b25) by Timothée Mazzucotelli).
+
+### Bug Fixes
+
+- Fix emoji display in pyodide fence for themes other than Material ([e09e9b2](https://github.com/pawamoy/markdown-exec/commit/e09e9b2005f9fe0599db7bc9f053e7227b824a6a) by Timothée Mazzucotelli). [Issue-83](https://github.com/pawamoy/markdown-exec/issues/83), [PR-84](https://github.com/pawamoy/markdown-exec/pull/84)
+
+## [1.10.0](https://github.com/pawamoy/markdown-exec/releases/tag/1.10.0) - 2024-12-06
+
+<small>[Compare with 1.9.3](https://github.com/pawamoy/markdown-exec/compare/1.9.3...1.10.0)</small>
+
+### Build
+
+- Drop support for Python 3.8 ([103bc1d](https://github.com/pawamoy/markdown-exec/commit/103bc1dc5f07f330b9e7ca4f052714350c52389d) by Timothée Mazzucotelli).
+
+### Features
+
+- Allow setting Pyodide version ([912c8c7](https://github.com/pawamoy/markdown-exec/commit/912c8c75a5f579a949644f33bcead0b71e9637fd) by Andrew). [Issue-66](https://github.com/pawamoy/markdown-exec/issues/66), [PR-67](https://github.com/pawamoy/markdown-exec/pull/67), Co-authored-by: Timothée Mazzucotelli <dev@pawamoy.fr>
+
 ## [1.9.3](https://github.com/pawamoy/markdown-exec/releases/tag/1.9.3) - 2024-06-24
 
 <small>[Compare with 1.9.2](https://github.com/pawamoy/markdown-exec/compare/1.9.2...1.9.3)</small>

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/CONTRIBUTING.md

@@ -23,12 +23,11 @@ make setup
 > You can install it with:
 >
 > ```bash
-> python3 -m pip install --user pipx
-> pipx install uv
+> curl -LsSf https://astral.sh/uv/install.sh | sh
 > ```
 >
 > Now you can try running `make setup` again,
-> or simply `uv install`.
+> or simply `uv sync`.
 
 You now have the dependencies installed.
 
@@ -36,13 +35,11 @@ Run `make help` to see all the available actions!
 
 ## Tasks
 
-This project uses [duty](https://github.com/pawamoy/duty) to run tasks.
-A Makefile is also provided. The Makefile will try to run certain tasks
-on multiple Python versions. If for some reason you don't want to run the task
-on multiple Python versions, you run the task directly with `make run duty TASK`.
-
-The Makefile detects if a virtual environment is activated,
-so `make` will work the same with the virtualenv activated or not.
+The entry-point to run commands and tasks is the `make` Python script,
+located in the `scripts` directory. Try running `make` to show the available commands and tasks.
+The *commands* do not need the Python dependencies to be installed,
+while the *tasks* do.
+The cross-platform tasks are written in Python, thanks to [duty](https://github.com/pawamoy/duty).
 
 If you work in VSCode, we provide
 [an action to configure VSCode](https://pawamoy.github.io/copier-uv/work/#vscode-setup)

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: markdown-exec
-Version: 1.9.3
+Version: 1.10.1
 Summary: Utilities to execute code blocks in Markdown files.
 Keywords: markdown,python,exec,shell,bash,mkdocs
 Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
@@ -10,12 +10,12 @@ Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Documentation
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
@@ -28,10 +28,10 @@ Project-URL: Issues, https://github.com/pawamoy/markdown-exec/issues
 Project-URL: Discussions, https://github.com/pawamoy/markdown-exec/discussions
 Project-URL: Gitter, https://gitter.im/markdown-exec/community
 Project-URL: Funding, https://github.com/sponsors/pawamoy
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Requires-Dist: pymdown-extensions>=9
-Requires-Dist: pygments-ansi-color; extra == "ansi"
 Provides-Extra: ansi
+Requires-Dist: pygments-ansi-color>=0.3; extra == "ansi"
 Description-Content-Type: text/markdown
 
 # Markdown Exec
@@ -39,7 +39,6 @@ Description-Content-Type: text/markdown
 [![ci](https://github.com/pawamoy/markdown-exec/workflows/ci/badge.svg)](https://github.com/pawamoy/markdown-exec/actions?query=workflow%3Aci)
 [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/markdown-exec/)
 [![pypi version](https://img.shields.io/pypi/v/markdown-exec.svg)](https://pypi.org/project/markdown-exec/)
-[![gitpod](https://img.shields.io/badge/gitpod-workspace-708FCC.svg?style=flat)](https://gitpod.io/#https://github.com/pawamoy/markdown-exec)
 [![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#markdown-exec:gitter.im)
 
 Utilities to execute code blocks in Markdown files.
@@ -49,10 +48,8 @@ and this HTML is injected in place of the code block.
 
 ## Installation
 
-With `pip`:
-
 ```bash
-pip install markdown-exec[ansi]
+pip install "markdown-exec[ansi]"
 ```
 
 The `ansi` extra provides the necessary bits (`pygments-ansi-color` and a CSS file)

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/README.md

@@ -3,7 +3,6 @@
 [![ci](https://github.com/pawamoy/markdown-exec/workflows/ci/badge.svg)](https://github.com/pawamoy/markdown-exec/actions?query=workflow%3Aci)
 [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/markdown-exec/)
 [![pypi version](https://img.shields.io/pypi/v/markdown-exec.svg)](https://pypi.org/project/markdown-exec/)
-[![gitpod](https://img.shields.io/badge/gitpod-workspace-708FCC.svg?style=flat)](https://gitpod.io/#https://github.com/pawamoy/markdown-exec)
 [![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#markdown-exec:gitter.im)
 
 Utilities to execute code blocks in Markdown files.
@@ -13,10 +12,8 @@ and this HTML is injected in place of the code block.
 
 ## Installation
 
-With `pip`:
-
 ```bash
-pip install markdown-exec[ansi]
+pip install "markdown-exec[ansi]"
 ```
 
 The `ansi` extra provides the necessary bits (`pygments-ansi-color` and a CSS file)

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/config/ruff.toml

@@ -1,4 +1,4 @@
-target-version = "py38"
+target-version = "py39"
 line-length = 120
 
 [lint]

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/.overrides/main.html

@@ -2,17 +2,19 @@
 
 {% block announce %}
   
-    <a href="{{ 'insiders/#how-to-become-a-sponsor' | url }}"><strong>Sponsorship</strong></a>
-    is now available!
+    <strong>Fund this project</strong> through
+    <a href="{{ 'insiders/#how-to-become-a-sponsor' | url }}"><strong>sponsorship</strong></a>
     <span class="twemoji heart pulse">
       {% include ".icons/octicons/heart-fill-16.svg" %}
     </span> &mdash;
   
-  For updates follow <strong>@pawamoy</strong> on
+  Follow
+  <strong>@pawamoy</strong> on
   <a rel="me" href="https://fosstodon.org/@pawamoy">
     <span class="twemoji mastodon">
       {% include ".icons/fontawesome/brands/mastodon.svg" %}
     </span>
     <strong>Fosstodon</strong>
   </a>
+  for updates
 {% endblock %}

markdown_exec-1.10.1/docs/.overrides/partials/comments.html

@@ -0,0 +1,57 @@
+<!-- Giscus -->
+<!-- https://squidfunk.github.io/mkdocs-material/setup/adding-a-comment-system/#giscus-integration -->
+<div id="feedback" style="display: none;">
+    <h2 id="__comments">Feedback</h2>
+    <script src="https://giscus.app/client.js"
+        data-repo="pawamoy/markdown-exec"
+        data-repo-id="R_kgDOG1IOMQ"
+        data-category="Documentation"
+        data-category-id="DIC_kwDOG1IOMc4Ck2cD"
+        data-mapping="pathname"
+        data-strict="1"
+        data-reactions-enabled="0"
+        data-emit-metadata="0"
+        data-input-position="top"
+        data-theme="preferred_color_scheme"
+        data-lang="en"
+        data-loading="lazy"
+        crossorigin="anonymous"
+        async>
+    </script>
+
+    <!-- Synchronize Giscus theme with palette -->
+    <script>
+        var giscus = document.querySelector("script[src*=giscus]")
+
+        // Set palette on initial load
+        var palette = __md_get("__palette")
+        if (palette && typeof palette.color === "object") {
+            var theme = palette.color.scheme === "slate"
+                ? "transparent_dark"
+                : "light"
+
+            // Instruct Giscus to set theme
+            giscus.setAttribute("data-theme", theme) 
+        }
+
+        // Register event handlers after documented loaded
+        document.addEventListener("DOMContentLoaded", function() {
+            var ref = document.querySelector("[data-md-component=palette]")
+            ref.addEventListener("change", function() {
+                var palette = __md_get("__palette")
+                if (palette && typeof palette.color === "object") {
+                    var theme = palette.color.scheme === "slate"
+                        ? "transparent_dark"
+                        : "light"
+
+                    // Instruct Giscus to change theme
+                    var frame = document.querySelector(".giscus-frame")
+                    frame.contentWindow.postMessage(
+                        { giscus: { setConfig: { theme } } },
+                        "https://giscus.app"
+                    )
+                }
+            })
+        })
+    </script>
+</div>

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/gallery.md

@@ -21,7 +21,7 @@ Welcome to our gallery of examples!
 
 ### with [D2](https://d2lang.com/)
 
-> A modern diagram scripting language that turns text to diagrams. 
+> A modern diagram scripting language that turns text to diagrams.
 
 ````md exec="1" source="tabbed-right"
 ```python exec="true" html="true"
@@ -184,6 +184,20 @@ If you installed Markdown Exec with the `ansi` extra (`pip install markdown-exec
 ```
 ````
 
+## File-trees
+
+This example displays a file-tree of the current project, in which you can descend thanks to Material for MkDocs' [code annotations](https://squidfunk.github.io/mkdocs-material/reference/code-blocks/#code-annotations). It uses a recursive Python function which accept a code block session name as parameter 🤯:
+
+````md exec="1" source="tabbed-right"
+```python exec="1" session="filetree"
+--8<-- "gallery/expandable_filetree.py"
+```
+
+```python exec="1" session="filetree"
+exptree(".", "filetree")
+```
+````
+
 ## Python CLI documentation
 
 ### with [`argparse`](https://docs.python.org/3/library/argparse.html#module-argparse) (code block)
@@ -206,8 +220,6 @@ In this example, we inspect the `argparse` parser to build better-looking Markdo
 ```
 ````
 
-## Other techniques
-
 ### with [`runpy`](https://docs.python.org/3/library/runpy.html#module-runpy)
 
 This example uses Python's `runpy` module to run another Python module. This other module's output is captured by temporarily patching `sys.stdout` with a text buffer.

markdown_exec-1.10.1/docs/index.md

@@ -0,0 +1,6 @@
+---
+hide:
+- feedback
+---
+
+--8<-- "README.md"

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/insiders/index.md

@@ -88,6 +88,8 @@ else:
 ```
 <!-- blacken-docs:on -->
 
+Additionally, your sponsorship will give more weight to your upvotes on issues, helping us prioritize work items in our backlog. For more information on how we prioritize work, see this page: [Backlog management](https://pawamoy.github.io/backlog/).
+
 ## How to become a sponsor
 
 Thanks for your interest in sponsoring! In order to become an eligible sponsor
@@ -95,6 +97,10 @@ with your GitHub account, visit [pawamoy's sponsor profile][github sponsor profi
 and complete a sponsorship of **$10 a month or more**.
 You can use your individual or organization GitHub account for sponsoring.
 
+Sponsorships lower than $10 a month are also very much appreciated, and useful.
+They won't grant you access to Insiders, but they will be counted towards reaching sponsorship goals.
+*Every* sponsorship helps us implementing new features and releasing them to the public.
+
 **Important**: If you're sponsoring **[@pawamoy][github sponsor profile]**
 through a GitHub organization, please send a short email
 to insiders@pawamoy.fr with the name of your
@@ -152,7 +158,7 @@ You can cancel your sponsorship anytime.[^5]
 
 The following section lists all funding goals. Each goal contains a list of
 features prefixed with a checkmark symbol, denoting whether a feature is
-:octicons-check-circle-fill-24:{ style="color: #00e676" } already available or 
+:octicons-check-circle-fill-24:{ style="color: #00e676" } already available or
 :octicons-check-circle-fill-24:{ style="color: var(--md-default-fg-color--lightest)" } planned,
 but not yet implemented. When the funding goal is hit,
 the features are released for general availability.
@@ -212,7 +218,7 @@ by the [ISC License][license]. However, we kindly ask you to respect our
 
 - Please **don't distribute the source code** of Insiders. You may freely use
   it for public, private or commercial projects, privately fork or mirror it,
-  but please don't make the source code public, as it would counteract the 
+  but please don't make the source code public, as it would counteract the
   sponsorware strategy.
 
 - If you cancel your subscription, you're automatically removed as a

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/insiders/installation.md

@@ -42,21 +42,21 @@ Or using HTTPS:
 pip install git+https://${GH_TOKEN}@github.com/pawamoy-insiders/markdown-exec.git
 ```
 
->? NOTE: **How to get a GitHub personal access token**  
+>? NOTE: **How to get a GitHub personal access token**
 > The `GH_TOKEN` environment variable is a GitHub token.
 > It can be obtained by creating a [personal access token] for
 > your GitHub account. It will give you access to the Insiders repository,
 > programmatically, from the command line or GitHub Actions workflows:
-> 
+>
 > 1.  Go to https://github.com/settings/tokens
 > 2.  Click on [Generate a new token]
 > 3.  Enter a name and select the [`repo`][scopes] scope
 > 4.  Generate the token and store it in a safe place
-> 
+>
 >   [personal access token]: https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token
 >   [Generate a new token]: https://github.com/settings/tokens/new
 >   [scopes]: https://docs.github.com/en/developers/apps/scopes-for-oauth-apps#available-scopes
-> 
+>
 > Note that the personal access
 > token must be kept secret at all times, as it allows the owner to access your
 > private repositories.

markdown_exec-1.10.1/docs/js/feedback.js

@@ -0,0 +1,14 @@
+const feedback = document.forms.feedback;
+feedback.hidden = false;
+
+feedback.addEventListener("submit", function(ev) {
+    ev.preventDefault();
+    const commentElement = document.getElementById("feedback");
+    commentElement.style.display = "block";
+    feedback.firstElementChild.disabled = true;
+    const data = ev.submitter.getAttribute("data-md-value");
+    const note = feedback.querySelector(".md-feedback__note [data-md-value='" + data + "']");
+    if (note) {
+        note.hidden = false;
+    }
+})

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/license.md

@@ -1,3 +1,8 @@
+---
+hide:
+- feedback
+---
+
 # License
 
 ```

markdown_exec-1.10.1/docs/snippets/gallery/expandable_filetree.py

@@ -0,0 +1,41 @@
+from fnmatch import fnmatch
+from pathlib import Path
+
+exclude = {"dist", "*cache*", ".devbox", ".hypothesis", ".pdm*", ".coverage*", "profile.*"}
+no_recurse = {".venv*", "site", "htmlcov", ".git"}
+
+
+def exptree(path: str, session: str) -> None:
+    # List files and directories separately.
+    files = []
+    dirs = []
+    for node in Path(path).iterdir():
+        if any(fnmatch(node.name, pattern) for pattern in exclude):
+            continue
+        if node.is_dir():
+            dirs.append(node)
+        else:
+            files.append(node)
+
+    # Print directories first, then files (both sorted).
+    recurse = []
+    print("```tree")
+    for directory in sorted(dirs):
+        if any(fnmatch(directory.name, pattern) for pattern in no_recurse):
+            print(f"{directory.name}/")
+        else:
+            recurse.append(directory.name)
+            # Add code annotation at the end.
+            print(f"{directory.name}/ # ({len(recurse)})!")
+    for file in sorted(files):
+        print(file.name)
+    print("```\n")
+
+    # Print contents of each annotated directory.
+    for index, directory in enumerate(recurse, 1):
+        new_path = f"{path}/{directory}"
+        print(f"{index}. \n")
+        # The recursive part!
+        print(f'    ```python exec="1" session="{session}"')
+        print(f'    exptree("{new_path}", "{session}")')
+        print("    ```\n")

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/snippets/gallery/matplotlib.py

@@ -8,14 +8,14 @@ import numpy as np
 # Load a numpy record array from yahoo csv data with fields date, open, close,
 # volume, adj_close from the mpl-data/example directory. The record array
 # stores the date as an np.datetime64 with a day unit ('D') in the date column.
-price_data = cbook.get_sample_data("goog.npz", np_load=True)["price_data"].view(np.recarray)
+price_data = cbook.get_sample_data("goog.npz")["price_data"]
 price_data = price_data[-250:]  # get the most recent 250 trading days
 
-delta1 = np.diff(price_data.adj_close) / price_data.adj_close[:-1]
+delta1 = np.diff(price_data["adj_close"]) / price_data["adj_close"][:-1]
 
 # Marker size in units of points^2
-volume = (15 * price_data.volume[:-2] / price_data.volume[0]) ** 2
-close = 0.003 * price_data.close[:-2] / 0.003 * price_data.open[:-2]
+volume = (15 * price_data["volume"][:-2] / price_data["volume"][0])**2
+close = 0.003 * price_data["close"][:-2] / 0.003 * price_data["open"][:-2]
 
 fig, ax = plt.subplots()
 ax.scatter(delta1[:-1], delta1[1:], c=close, s=volume, alpha=0.5)

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/usage/index.md

@@ -171,7 +171,7 @@ with one of the following values:
 ```
 ````
 
-NOTE: **Important**  
+NOTE: **Important:**
 The `material-block` source option requires that you enable the [`md_in_html`][md_in_html] Markdown extension.
 
 ---
@@ -184,7 +184,7 @@ The `material-block` source option requires that you enable the [`md_in_html`][m
 ```
 ````
 
-NOTE: **Important**  
+NOTE: **Important:**
 The `tabbed-left` source option requires that you enable the [`pymdownx.tabbed`][pymdownx.tabbed] Markdown extension.
 
 ---
@@ -197,7 +197,7 @@ The `tabbed-left` source option requires that you enable the [`pymdownx.tabbed`]
 ```
 ````
 
-NOTE: **Important**  
+NOTE: **Important:**
 The `tabbed-left` source option requires that you enable the [`pymdownx.tabbed`][pymdownx.tabbed] Markdown extension.
 
 ---
@@ -258,7 +258,7 @@ and the "Result" tab title second. It allows to switch from tabbed-left
 to tabbed-right and inversely without having to switch the titles as well.
 
 
-WARNING: **Limitation**  
+WARNING: **Limitation:**
 Changing the title for only one tab is not supported.
 
 ## Wrap result in a code block
@@ -271,7 +271,7 @@ $ cat .git/config
 ```
 ````
 
-WARNING: **Limitation**  
+WARNING: **Limitation:**
 Wrapping the result is not possible when HTML output is enabled.
 
 ## Change the console width
@@ -380,7 +380,7 @@ assert 1 + 1 == 11
 WARNING  -  markdown_exec: Execution of python code block 'print hello' exited with errors
 ```
 
-> TIP: **Titles act as IDs as well!**  
+> TIP: **Titles act as IDs as well!**
 > You *don't need* to provide an ID
 > if you already set a (Material for MkDocs) title:
 >
@@ -413,7 +413,7 @@ greet("Ping")
 ```
 ````
 
-WARNING: **Limitation**  
+WARNING: **Limitation:**
 Sessions only work with Python and Pycon syntax for now.
 
 ## Literate Markdown
@@ -435,9 +435,9 @@ That makes for a very meta-markdown markup:
 ```
 ````
 
-> TIP: **So power, such meta**  
+> TIP: **So power, such meta.**
 > The above example (both tabs) was entirely generated using *a literate code block in a literate code block* 🤯:
-> 
+>
 > `````md
 > ````md exec="1" source="tabbed-left"
 > ```md exec="1" source="material-block" title="Markdown link"

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/usage/pyodide.md

@@ -33,6 +33,18 @@ cowsay.cow("Hello World")
 Packages installed with Micropip are cached by the browser as well,
 making future installations much faster.
 
+## Pyodide version
+
+You can select a specific Pyodide version with the `version` option:
+
+````md
+```pyodide version="0.26.4"
+print("Hello.")
+```
+````
+
+NOTE: **All Pyodide blocks on the same page should use the same version!**
+
 ## Sessions
 
 Editors with the same session share the same `globals()` dictionary,

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/usage/shell.md

@@ -2,7 +2,7 @@
 
 Shell code blocks are executed using the same interpreter specified
 as language of the code block, in sub-processes. The output is captured
-and rendered as Markdown or HTML (see [Usage](../index.md#html-vs-markdown)).
+and rendered as Markdown or HTML (see [Usage](index.md#html-vs-markdown)).
 
 ## Bash
 
@@ -360,7 +360,7 @@ so we cannot provide generic guidance here.
 > when using our MkDocs plugin and enabling ANSI support,
 > to help tools like MkDocs and its `get-deps` command
 > know that the `ansi` extra dependency is required.
-> 
+>
 > ```yaml
 > plugins:
 > - markdown-exec:

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/docs/usage/tree.md

@@ -70,5 +70,5 @@ root1
 
 It is recommended to always append trailing slashes to directory anyway.
 
-WARNING: **Limitation**  
+WARNING: **Limitation:**
 Spaces in file names are not supported when searching for a trailing slash.

{markdown_exec-1.9.3 → markdown_exec-1.10.1}/duties.py

@@ -7,11 +7,13 @@ import sys
 from contextlib import contextmanager
 from importlib.metadata import version as pkgversion
 from pathlib import Path
-from typing import TYPE_CHECKING, Iterator
+from typing import TYPE_CHECKING
 
 from duty import duty, tools
 
 if TYPE_CHECKING:
+    from collections.abc import Iterator
+
     from duty.context import Context
 
 
@@ -43,10 +45,6 @@ def material_insiders() -> Iterator[bool]:  # noqa: D103
         yield False
 
 
-below_312 = sys.version_info < (3, 12)
-skip_docs_reason = pyprefix("Building docs is not supported on Python 3.12, skipping")
-
-
 @duty
 def changelog(ctx: Context, bump: str = "") -> None:
     """Update the changelog in-place with latest commits.
@@ -57,8 +55,8 @@ def changelog(ctx: Context, bump: str = "") -> None:
     ctx.run(tools.git_changelog(bump=bump or None), title="Updating changelog")
 
 
-@duty(pre=["check_quality", "check_types", "check_docs", "check_dependencies", "check-api"])
-def check(ctx: Context) -> None:  # noqa: ARG001
+@duty(pre=["check-quality", "check-types", "check-docs", "check-api"])
+def check(ctx: Context) -> None:
     """Check it all!"""
 
 
@@ -71,7 +69,7 @@ def check_quality(ctx: Context) -> None:
     )
 
 
-@duty(skip_if=not below_312, skip_reason=skip_docs_reason)
+@duty(skip_if=sys.version_info[:2] != (3, 12), skip_reason="Docs build only on Python 3.12")
 def check_docs(ctx: Context) -> None:
     """Check if the documentation builds correctly."""
     Path("htmlcov").mkdir(parents=True, exist_ok=True)
@@ -86,6 +84,7 @@ def check_docs(ctx: Context) -> None:
 @duty
 def check_types(ctx: Context) -> None:
     """Check that the code is correctly typed."""
+    os.environ["FORCE_COLOR"] = "1"
     ctx.run(
         tools.mypy(*PY_SRC_LIST, config_file="config/mypy.ini"),
         title=pyprefix("Type-checking"),
@@ -102,7 +101,7 @@ def check_api(ctx: Context, *cli_args: str) -> None:
     )
 
 
-@duty(skip_if=not below_312, skip_reason=skip_docs_reason)
+@duty
 def docs(ctx: Context, *cli_args: str, host: str = "127.0.0.1", port: int = 8000) -> None:
     """Serve the documentation (localhost:8000).
 
@@ -118,17 +117,40 @@ def docs(ctx: Context, *cli_args: str, host: str = "127.0.0.1", port: int = 8000
         )
 
 
-@duty(skip_if=not below_312, skip_reason=skip_docs_reason)
-def docs_deploy(ctx: Context) -> None:
-    """Deploy the documentation to GitHub pages."""
+@duty
+def docs_deploy(ctx: Context, *, force: bool = False) -> None:
+    """Deploy the documentation to GitHub pages.
+
+    Parameters:
+        force: Whether to force deployment, even from non-Insiders version.
+    """
     os.environ["DEPLOY"] = "true"
     with material_insiders() as insiders:
         if not insiders:
             ctx.run(lambda: False, title="Not deploying docs without Material for MkDocs Insiders!")
-        ctx.run(
-            tools.mkdocs.gh_deploy(force=True),
-            title="Deploying documentation",
-        )
+        origin = ctx.run("git config --get remote.origin.url", silent=True, allow_overrides=False)
+        if "pawamoy-insiders/markdown-exec" in origin:
+            ctx.run(
+                "git remote add upstream git@github.com:pawamoy/markdown-exec",
+                silent=True,
+                nofail=True,
+                allow_overrides=False,
+            )
+            ctx.run(
+                tools.mkdocs.gh_deploy(remote_name="upstream", force=True),
+                title="Deploying documentation",
+            )
+        elif force:
+            ctx.run(
+                tools.mkdocs.gh_deploy(force=True),
+                title="Deploying documentation",
+            )
+        else:
+            ctx.run(
+                lambda: False,
+                title="Not deploying docs from public repository (do that from insiders instead!)",
+                nofail=True,
+            )
 
 
 @duty