sphinx-examples-as-code 0.6.0__tar.gz → 0.7.0__tar.gz

sphinx_examples_as_code-0.7.0/.github/dependabot.yml

@@ -0,0 +1,22 @@
+version: 2
+multi-ecosystem-groups:
+  maintenance:
+    schedule:
+      interval: quarterly
+    labels: [maintenance, dependencies]
+updates:
+- package-ecosystem: pip
+  directory: /
+  schedule:
+    interval: weekly
+  labels: [maintenance, dependencies]
+  allow:
+  - dependency-name: pyvista
+  - dependency-name: sphinx-gallery
+  groups:
+    project:
+      patterns: ['*']
+- package-ecosystem: github-actions
+  directory: /
+  patterns: ['*']
+  multi-ecosystem-group: maintenance

{sphinx_examples_as_code-0.6.0 → sphinx_examples_as_code-0.7.0}/.github/workflows/ci.yml

@@ -22,10 +22,10 @@ jobs:
       with:
         persist-credentials: false
         fetch-depth: 0
-    - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4   # v10.1.0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
       with:
         enable-cache: false
-    - run: uv sync --group dev
+    - run: uv sync --group dev --extra gallery
     - run: uv run pre-commit run --all-files --show-diff-on-failure
       env:
           # This hook exists to stop *local* commits straight to main; it
@@ -43,15 +43,15 @@ jobs:
       with:
         persist-credentials: false
         fetch-depth: 0
-    - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4   # v10.1.0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
       with:
         enable-cache: false
     - uses: pyvista/setup-headless-display-action@c103a2ff45650d38cb71684b5dc6cdfeb9442c79   # v5.1.0
       with:
         pyvista: true
-    - run: uv sync --group dev --python ${{ matrix.python-version }}
+    - run: uv sync --group dev --extra gallery --python ${{ matrix.python-version }}
     - run: uv run pytest tests/ --cov --cov-report=xml
-    - uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f   # v7.0.0
+    - uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5   # v7.1.1
       with:
         files: ./coverage.xml
       env:
@@ -65,7 +65,7 @@ jobs:
       with:
         persist-credentials: false
         fetch-depth: 0
-    - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4   # v10.1.0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7   # v10.2.0
       with:
         enable-cache: false
     - run: uv build
@@ -87,3 +87,19 @@ jobs:
         name: dist
         path: dist/
     - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33   # release/v1
+
+  release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+    - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c   # v8.0.1
+      with:
+        name: dist
+        path: dist/
+      # Notes come from the merged pull requests, shaped by .github/release.yml.
+    - env:
+        GH_TOKEN: ${{ github.token }}
+        TAG: ${{ github.ref_name }}
+      run: gh release create "$TAG" --repo "$GITHUB_REPOSITORY" --title "$TAG" --generate-notes --verify-tag dist/*

{sphinx_examples_as_code-0.6.0 → sphinx_examples_as_code-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sphinx-examples-as-code
-Version: 0.6.0
+Version: 0.7.0
 Summary: Sphinx extension for converting docstring examples into downloadable code.
 Author-email: The PyVista Developers <info@pyvista.org>
 License-Expression: MIT
@@ -23,12 +23,17 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyvista>=0.48
+Provides-Extra: gallery
+Requires-Dist: sphinx-gallery<0.23,>=0.22; extra == "gallery"
+Provides-Extra: marimo
+Requires-Dist: marimo>=0.14; extra == "marimo"
 Dynamic: license-file
 
 # sphinx-examples-as-code
 
 A Sphinx extension that turns docstring/page "Examples" sections into downloadable,
-runnable `.py` and/or `.ipynb` files, with a download link inserted into the section.
+runnable Python scripts, Jupyter notebooks and/or [marimo](https://marimo.io) notebooks,
+with a download link inserted into the section.
 
 Pages or docstrings without an Examples section are left completely untouched. Adding
 `sphinx_examples_as_code` to `conf.py`'s `extensions` is the only on/off switch.
@@ -39,6 +44,19 @@ Pages or docstrings without an Examples section are left completely untouched. A
 pip install sphinx-examples-as-code
 ```
 
+Sphinx-Gallery integration is opt-in and needs a compatible sphinx-gallery, which the
+`gallery` extra pins:
+
+```bash
+pip install 'sphinx-examples-as-code[gallery]'
+```
+
+marimo notebook downloads need marimo 0.14 or newer, which the `marimo` extra installs:
+
+```bash
+pip install 'sphinx-examples-as-code[marimo]'
+```
+
 Add it to your Sphinx `conf.py`:
 
 ```python
@@ -56,23 +74,29 @@ the keys you want to change from their default:
 ```python
 sphinx_examples_as_code_conf = {
     'link_position': 'top',
-    'formats': ['py', 'ipynb'],
+    'formats': ['python', 'jupyter', 'marimo'],
     'gallery_downloads': False,
     'footer': (
         'Generated by `sphinx-examples-as-code '
         '<https://github.com/pyvista/sphinx-examples-as-code>`_'
     ),
     'link_labels': {
-        'py': 'Download Python source code',
-        'ipynb': 'Download Jupyter notebook',
+        'python': 'Download Python script',
+        'jupyter': 'Download Jupyter notebook',
+        'marimo': 'Download marimo notebook',
     },
 }
 ```
 
 - `link_position`: where the download link(s) land within the Examples section. `'top'`
   (default) or `'bottom'`.
-- `formats`: which downloads to generate. A list containing `'py'`, `'ipynb'`, or both
-  (default). Always offered in that order regardless of how the list is written.
+- `formats`: which downloads to generate. A list containing any of `'python'` (a plain
+  Python script, `<name>.py`), `'jupyter'` (a Jupyter notebook, `<name>.ipynb`) and
+  `'marimo'` (a marimo notebook, `<name>.marimo.py`); defaults to all three. Always
+  offered in that order regardless of how the list is written. Without marimo 0.14 or
+  newer installed, the default skips the marimo download, and a `formats` that names
+  `'marimo'` (in `conf.py` or through `-D`) stops the build with a configuration error. An unknown format raises a configuration error too;
+  the old `'py'` and `'ipynb'` names say what replaced them.
 - `link_labels`: the text of the download link(s) themselves, per format. Set only the
   format(s) you want to change; any left unset keep reading their own default shown above.
 - `gallery_downloads`: opt-in takeover of
@@ -82,11 +106,11 @@ sphinx_examples_as_code_conf = {
 - `footer`: a string appended to the end of every generated file. Defaults to a one-line
   "generated file" credit linking back to this project; set to `None` to omit it
   entirely. Preceded by a blank line and a `-`-only divider line, which also renders as a
-  real horizontal rule in `.ipynb`; the footer always gets its own dedicated cell there.
+  real horizontal rule in notebooks; the footer always gets its own dedicated cell there.
   Parsed as RST: a hyperlink written as `` `text <url>`_ `` becomes a real clickable
-  Markdown link in `.ipynb`, and renders inline as `text url` in `.py`. Plain text with no
-  markup at all becomes one comment line per line of text, and blank-line-separated
-  paragraphs stay separated.
+  Markdown link in notebooks, and renders inline as `text url` in Python scripts. Plain
+  text with no markup at all becomes one comment line per line of text, and
+  blank-line-separated paragraphs stay separated.
 
 An unrecognized key raises a configuration error at build start.
 
@@ -107,39 +131,43 @@ What happens to the content of an Examples section:
 - `.. code-block:: python` (or `py`) blocks are kept as-is; other languages become
   comments, set off with blank lines on both sides like any other directive.
 - Admonitions (`.. note::`, `.. warning::`, ...) become a `# LABEL:` comment followed by
-  their content as comments, indented one level under the label in `.py` only.
+  their content as comments, indented one level under the label in Python scripts only.
 - A bullet/numbered list becomes a `-`/`N.`-marked line per item, set off with a blank
   line on both sides in either format — a bare `#` instead of a real blank line when
-  that falls inside an admonition or a definition's own body in `.py`, so the whole
-  thing still reads as one unbroken comment block. A definition list's term stays at
-  the surrounding indent; its definition (the body nested under it) is indented one
-  level further in `.py`, same as an admonition's own content.
+  that falls inside an admonition or a definition's own body in a Python script, so the
+  whole thing still reads as one unbroken comment block. A definition list's term stays
+  at the surrounding indent; its definition (the body nested under it) is indented one
+  level further in Python scripts, same as an admonition's own content.
 - Cross-references and inline code (`:class:`, `:meth:`, `:func:`, `:attr:`,
   double-backtick literals, ...) keep their display text, wrapped in backticks (e.g.
   ``:class:`pyvista.Plotter` `` -> `` `pyvista.Plotter` ``). If `html_baseurl` is set and
-  the reference resolves, `.ipynb` turns it into a clickable link; `.py` never writes the
-  link, only the display text.
+  the reference resolves, notebooks turn it into a clickable link; Python scripts never
+  write the link, only the display text.
 - Plain prose-style references (`:ref:`, `:doc:`) are treated the same way, minus the
   backticks.
 - Everything else text-bearing (prose, captions, other non-Python code) becomes a plain
   `#` comment.
 - A table becomes an aligned text table, its caption on the line above: an RST simple
-  table in `.py`, a Markdown pipe table in `.ipynb`. Each cell is flattened to a single
-  line, and a column left entirely empty -- one holding only images, say -- is dropped
-  along with its heading.
+  table in Python scripts, a Markdown pipe table in notebooks. Each cell is flattened to a
+  single line, and a column left entirely empty -- one holding only images, say -- is
+  dropped along with its heading.
 - Figures/images, raw HTML, sphinx-design dropdowns/tab-sets, and sphinx-tags' `.. tags::`
   line are dropped entirely.
 - "See Also" content is always dropped.
 
-Generated `.py` files start with a `# Examples from <qualified name>` title header
+Generated Python scripts start with a `# Examples from <qualified name>` title header
 (gallery mode uses the page's own title instead -- see below), with a few whitespace
 conventions: prose directly above a code block stays attached to it, a code block is
 always followed by a blank line, and a directive (header, `# NOTE:`-style block) gets
 blank lines on both sides.
 
-Generated `.ipynb` notebooks use the same content, split into alternating code/markdown
+Generated Jupyter notebooks use the same content, split into alternating code/markdown
 cells instead.
 
+Generated marimo notebooks are that same Jupyter notebook converted by marimo's own
+converter, the one behind `marimo convert`. `from __future__` imports are dropped first,
+so the notebook also runs as a plain script (`python <name>.marimo.py`).
+
 A download link is only added if the resulting code contains at least one real
 executable statement.
 
@@ -148,7 +176,7 @@ executable statement.
 With `sphinx_examples_as_code_conf['gallery_downloads'] = True`, this extension takes
 over the downloads on every page generated by
 [sphinx-gallery](https://sphinx-gallery.github.io): the "Go to the end to download the
-full example code" note and the `.py`/`.ipynb`/`.zip` download footer are removed from
+full example code" note and the `.py`/`.zip` download footer are removed from
 the page, replaced with download link(s) built by this extension instead — same
 conversion rules as above, applied to the whole page rather than one Examples section.
 The generated file's header uses the page's own title (e.g. `# Create Circular Arcs`)
@@ -163,7 +191,7 @@ is left completely untouched. Gallery pages and ordinary docstring/prose pages (
 the Examples-section behavior above) can coexist on the same site.
 
 A `# %%` cell with its own RST heading gets the same header treatment as the file's own
-title, and renders as a real Markdown heading in `.ipynb`. Level is relative to actual
+title, and renders as a real Markdown heading in notebooks. Level is relative to actual
 RST section nesting, not always one below the file's own header: a cell heading nested
 under the page's own title (the common case) is one level below it; one that reuses the
 page title's own underline character is level 1, the same as the file's own header; a
@@ -172,24 +200,30 @@ cell heading nested under *that* is level 2 relative to it, and so on.
 Each format uses one heading style consistently across every level, rather than mixing
 styles:
 
-- `.py` uses an RST-style title + underline, one character per level -- the same
+- Python scripts use an RST-style title + underline, one character per level -- the same
   sequence Sphinx's own documentation uses for sections through sub-paragraphs: `=`, `-`,
   `~`, `^`, `"`, `'` for levels 1 through 6.
-- `.ipynb` always uses ATX syntax (`#`, `##`, `###`, ...) at every level.
+- Notebooks always use ATX syntax (`#`, `##`, `###`, ...) at every level.
 
 Two things worth knowing before turning this on:
 
 - It's built against sphinx-gallery's own doctree output — the `sphx-glr-*` CSS classes
   its own theming depends on, and the private node type holding a highlighted code
   block — not a documented extension API. A future sphinx-gallery release could shift
-  that structure without warning. Tested against sphinx-gallery 0.22 and later.
-- sphinx-gallery's own `.py`/`.ipynb`/`.zip` downloads still end up copied into
-  `_downloads/`, even though nothing on the page links to them anymore.
+  that structure without warning. Only sphinx-gallery 0.22.x is tested, so the `gallery`
+  extra caps there rather than letting the next release quietly produce no downloads.
+- sphinx-gallery's own `.py`/`.zip` downloads still end up copied into `_downloads/`,
+  even though nothing on the page links to them anymore. Its `.ipynb` is never written:
+  with `gallery_downloads` on, this extension sets `sphinx_gallery_conf['pypandoc']` to
+  `False` and `sphinx_gallery_conf['notebook_extensions']` to an empty set before
+  sphinx-gallery reads them, so pandoc is not needed. Setting `pypandoc`,
+  `notebook_extensions`, `first_notebook_cell`, `last_notebook_cell` or `notebook_images`
+  yourself has no effect and is reported as a warning.
 
 ## Development
 
 ```bash
-uv sync --group dev
+uv sync --group dev --extra gallery
 uv run pytest
 uv run pre-commit run --all-files
 ```

{sphinx_examples_as_code-0.6.0 → sphinx_examples_as_code-0.7.0}/README.md

@@ -1,7 +1,8 @@
 # sphinx-examples-as-code
 
 A Sphinx extension that turns docstring/page "Examples" sections into downloadable,
-runnable `.py` and/or `.ipynb` files, with a download link inserted into the section.
+runnable Python scripts, Jupyter notebooks and/or [marimo](https://marimo.io) notebooks,
+with a download link inserted into the section.
 
 Pages or docstrings without an Examples section are left completely untouched. Adding
 `sphinx_examples_as_code` to `conf.py`'s `extensions` is the only on/off switch.
@@ -12,6 +13,19 @@ Pages or docstrings without an Examples section are left completely untouched. A
 pip install sphinx-examples-as-code
 ```
 
+Sphinx-Gallery integration is opt-in and needs a compatible sphinx-gallery, which the
+`gallery` extra pins:
+
+```bash
+pip install 'sphinx-examples-as-code[gallery]'
+```
+
+marimo notebook downloads need marimo 0.14 or newer, which the `marimo` extra installs:
+
+```bash
+pip install 'sphinx-examples-as-code[marimo]'
+```
+
 Add it to your Sphinx `conf.py`:
 
 ```python
@@ -29,23 +43,29 @@ the keys you want to change from their default:
 ```python
 sphinx_examples_as_code_conf = {
     'link_position': 'top',
-    'formats': ['py', 'ipynb'],
+    'formats': ['python', 'jupyter', 'marimo'],
     'gallery_downloads': False,
     'footer': (
         'Generated by `sphinx-examples-as-code '
         '<https://github.com/pyvista/sphinx-examples-as-code>`_'
     ),
     'link_labels': {
-        'py': 'Download Python source code',
-        'ipynb': 'Download Jupyter notebook',
+        'python': 'Download Python script',
+        'jupyter': 'Download Jupyter notebook',
+        'marimo': 'Download marimo notebook',
     },
 }
 ```
 
 - `link_position`: where the download link(s) land within the Examples section. `'top'`
   (default) or `'bottom'`.
-- `formats`: which downloads to generate. A list containing `'py'`, `'ipynb'`, or both
-  (default). Always offered in that order regardless of how the list is written.
+- `formats`: which downloads to generate. A list containing any of `'python'` (a plain
+  Python script, `<name>.py`), `'jupyter'` (a Jupyter notebook, `<name>.ipynb`) and
+  `'marimo'` (a marimo notebook, `<name>.marimo.py`); defaults to all three. Always
+  offered in that order regardless of how the list is written. Without marimo 0.14 or
+  newer installed, the default skips the marimo download, and a `formats` that names
+  `'marimo'` (in `conf.py` or through `-D`) stops the build with a configuration error. An unknown format raises a configuration error too;
+  the old `'py'` and `'ipynb'` names say what replaced them.
 - `link_labels`: the text of the download link(s) themselves, per format. Set only the
   format(s) you want to change; any left unset keep reading their own default shown above.
 - `gallery_downloads`: opt-in takeover of
@@ -55,11 +75,11 @@ sphinx_examples_as_code_conf = {
 - `footer`: a string appended to the end of every generated file. Defaults to a one-line
   "generated file" credit linking back to this project; set to `None` to omit it
   entirely. Preceded by a blank line and a `-`-only divider line, which also renders as a
-  real horizontal rule in `.ipynb`; the footer always gets its own dedicated cell there.
+  real horizontal rule in notebooks; the footer always gets its own dedicated cell there.
   Parsed as RST: a hyperlink written as `` `text <url>`_ `` becomes a real clickable
-  Markdown link in `.ipynb`, and renders inline as `text url` in `.py`. Plain text with no
-  markup at all becomes one comment line per line of text, and blank-line-separated
-  paragraphs stay separated.
+  Markdown link in notebooks, and renders inline as `text url` in Python scripts. Plain
+  text with no markup at all becomes one comment line per line of text, and
+  blank-line-separated paragraphs stay separated.
 
 An unrecognized key raises a configuration error at build start.
 
@@ -80,39 +100,43 @@ What happens to the content of an Examples section:
 - `.. code-block:: python` (or `py`) blocks are kept as-is; other languages become
   comments, set off with blank lines on both sides like any other directive.
 - Admonitions (`.. note::`, `.. warning::`, ...) become a `# LABEL:` comment followed by
-  their content as comments, indented one level under the label in `.py` only.
+  their content as comments, indented one level under the label in Python scripts only.
 - A bullet/numbered list becomes a `-`/`N.`-marked line per item, set off with a blank
   line on both sides in either format — a bare `#` instead of a real blank line when
-  that falls inside an admonition or a definition's own body in `.py`, so the whole
-  thing still reads as one unbroken comment block. A definition list's term stays at
-  the surrounding indent; its definition (the body nested under it) is indented one
-  level further in `.py`, same as an admonition's own content.
+  that falls inside an admonition or a definition's own body in a Python script, so the
+  whole thing still reads as one unbroken comment block. A definition list's term stays
+  at the surrounding indent; its definition (the body nested under it) is indented one
+  level further in Python scripts, same as an admonition's own content.
 - Cross-references and inline code (`:class:`, `:meth:`, `:func:`, `:attr:`,
   double-backtick literals, ...) keep their display text, wrapped in backticks (e.g.
   ``:class:`pyvista.Plotter` `` -> `` `pyvista.Plotter` ``). If `html_baseurl` is set and
-  the reference resolves, `.ipynb` turns it into a clickable link; `.py` never writes the
-  link, only the display text.
+  the reference resolves, notebooks turn it into a clickable link; Python scripts never
+  write the link, only the display text.
 - Plain prose-style references (`:ref:`, `:doc:`) are treated the same way, minus the
   backticks.
 - Everything else text-bearing (prose, captions, other non-Python code) becomes a plain
   `#` comment.
 - A table becomes an aligned text table, its caption on the line above: an RST simple
-  table in `.py`, a Markdown pipe table in `.ipynb`. Each cell is flattened to a single
-  line, and a column left entirely empty -- one holding only images, say -- is dropped
-  along with its heading.
+  table in Python scripts, a Markdown pipe table in notebooks. Each cell is flattened to a
+  single line, and a column left entirely empty -- one holding only images, say -- is
+  dropped along with its heading.
 - Figures/images, raw HTML, sphinx-design dropdowns/tab-sets, and sphinx-tags' `.. tags::`
   line are dropped entirely.
 - "See Also" content is always dropped.
 
-Generated `.py` files start with a `# Examples from <qualified name>` title header
+Generated Python scripts start with a `# Examples from <qualified name>` title header
 (gallery mode uses the page's own title instead -- see below), with a few whitespace
 conventions: prose directly above a code block stays attached to it, a code block is
 always followed by a blank line, and a directive (header, `# NOTE:`-style block) gets
 blank lines on both sides.
 
-Generated `.ipynb` notebooks use the same content, split into alternating code/markdown
+Generated Jupyter notebooks use the same content, split into alternating code/markdown
 cells instead.
 
+Generated marimo notebooks are that same Jupyter notebook converted by marimo's own
+converter, the one behind `marimo convert`. `from __future__` imports are dropped first,
+so the notebook also runs as a plain script (`python <name>.marimo.py`).
+
 A download link is only added if the resulting code contains at least one real
 executable statement.
 
@@ -121,7 +145,7 @@ executable statement.
 With `sphinx_examples_as_code_conf['gallery_downloads'] = True`, this extension takes
 over the downloads on every page generated by
 [sphinx-gallery](https://sphinx-gallery.github.io): the "Go to the end to download the
-full example code" note and the `.py`/`.ipynb`/`.zip` download footer are removed from
+full example code" note and the `.py`/`.zip` download footer are removed from
 the page, replaced with download link(s) built by this extension instead — same
 conversion rules as above, applied to the whole page rather than one Examples section.
 The generated file's header uses the page's own title (e.g. `# Create Circular Arcs`)
@@ -136,7 +160,7 @@ is left completely untouched. Gallery pages and ordinary docstring/prose pages (
 the Examples-section behavior above) can coexist on the same site.
 
 A `# %%` cell with its own RST heading gets the same header treatment as the file's own
-title, and renders as a real Markdown heading in `.ipynb`. Level is relative to actual
+title, and renders as a real Markdown heading in notebooks. Level is relative to actual
 RST section nesting, not always one below the file's own header: a cell heading nested
 under the page's own title (the common case) is one level below it; one that reuses the
 page title's own underline character is level 1, the same as the file's own header; a
@@ -145,24 +169,30 @@ cell heading nested under *that* is level 2 relative to it, and so on.
 Each format uses one heading style consistently across every level, rather than mixing
 styles:
 
-- `.py` uses an RST-style title + underline, one character per level -- the same
+- Python scripts use an RST-style title + underline, one character per level -- the same
   sequence Sphinx's own documentation uses for sections through sub-paragraphs: `=`, `-`,
   `~`, `^`, `"`, `'` for levels 1 through 6.
-- `.ipynb` always uses ATX syntax (`#`, `##`, `###`, ...) at every level.
+- Notebooks always use ATX syntax (`#`, `##`, `###`, ...) at every level.
 
 Two things worth knowing before turning this on:
 
 - It's built against sphinx-gallery's own doctree output — the `sphx-glr-*` CSS classes
   its own theming depends on, and the private node type holding a highlighted code
   block — not a documented extension API. A future sphinx-gallery release could shift
-  that structure without warning. Tested against sphinx-gallery 0.22 and later.
-- sphinx-gallery's own `.py`/`.ipynb`/`.zip` downloads still end up copied into
-  `_downloads/`, even though nothing on the page links to them anymore.
+  that structure without warning. Only sphinx-gallery 0.22.x is tested, so the `gallery`
+  extra caps there rather than letting the next release quietly produce no downloads.
+- sphinx-gallery's own `.py`/`.zip` downloads still end up copied into `_downloads/`,
+  even though nothing on the page links to them anymore. Its `.ipynb` is never written:
+  with `gallery_downloads` on, this extension sets `sphinx_gallery_conf['pypandoc']` to
+  `False` and `sphinx_gallery_conf['notebook_extensions']` to an empty set before
+  sphinx-gallery reads them, so pandoc is not needed. Setting `pypandoc`,
+  `notebook_extensions`, `first_notebook_cell`, `last_notebook_cell` or `notebook_images`
+  yourself has no effect and is reported as a warning.
 
 ## Development
 
 ```bash
-uv sync --group dev
+uv sync --group dev --extra gallery
 uv run pytest
 uv run pre-commit run --all-files
 ```

{sphinx_examples_as_code-0.6.0 → sphinx_examples_as_code-0.7.0}/pyproject.toml

@@ -4,6 +4,7 @@ requires = ['setuptools>=64', 'setuptools_scm>=8']
 
 [dependency-groups]
 dev = [
+  'marimo>=0.14',
   'nbformat',
   'numpydoc',
   'pre-commit',
@@ -11,7 +12,6 @@ dev = [
   'pytest-cov',
   'sphinx',
   'sphinx-design',
-  'sphinx-gallery>=0.22',
   'trame-pyvista',
 ]
 
@@ -41,6 +41,10 @@ name = 'sphinx-examples-as-code'
 readme = 'README.md'
 requires-python = '>=3.10'
 
+[project.optional-dependencies]
+gallery = ['sphinx-gallery>=0.22,<0.23']
+marimo = ['marimo>=0.14']
+
 [project.urls]
 Homepage = 'https://github.com/pyvista/sphinx-examples-as-code'