markdown-include-variants 0.0.6__tar.gz → 0.0.7__tar.gz

{markdown_include_variants-0.0.6 → markdown_include_variants-0.0.7}/.github/workflows/smokeshow.yml

@@ -27,11 +27,7 @@ jobs:
       - uses: actions/setup-python@v6
         with:
           python-version: '3.9'
-      - name: Setup uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          version: "0.4.15"
-          enable-cache: true
+      - uses: astral-sh/setup-uv@v7
       - name: Install Dependencies
         run: uv sync
       - uses: actions/download-artifact@v6

{markdown_include_variants-0.0.6 → markdown_include_variants-0.0.7}/.github/workflows/test.yml

@@ -25,11 +25,7 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: "3.11"
-      - name: Setup uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          version: "0.4.15"
-          enable-cache: true
+      - uses: astral-sh/setup-uv@v7
       - name: Install Dependencies
         run: uv sync
       - name: Lint
@@ -52,11 +48,7 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Setup uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          version: "0.4.15"
-          enable-cache: true
+      - uses: astral-sh/setup-uv@v7
       - name: Install Dependencies
         run: uv sync
       - run: mkdir coverage
@@ -85,11 +77,7 @@ jobs:
       - uses: actions/setup-python@v6
         with:
           python-version: '3.11'
-      - name: Setup uv
-        uses: astral-sh/setup-uv@v7
-        with:
-          version: "0.4.15"
-          enable-cache: true
+      - uses: astral-sh/setup-uv@v7
       - name: Get coverage files
         uses: actions/download-artifact@v6
         with:

{markdown_include_variants-0.0.6 → markdown_include_variants-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-include-variants
-Version: 0.0.6
+Version: 0.0.7
 Summary: Markdown extension to expand directives to include source example files to also include their variants. Only useful to tiangolo's projets. Don't use it. 😅
 Project-URL: Homepage, https://github.com/tiangolo/markdown-include-variants
 Project-URL: Repository, https://github.com/tiangolo/markdown-include-variants

{markdown_include_variants-0.0.6 → markdown_include_variants-0.0.7}/pyproject.toml

@@ -25,11 +25,8 @@ Repository = "https://github.com/tiangolo/markdown-include-variants"
 Issues = "https://github.com/tiangolo/markdown-include-variants/issues"
 Changelog = "https://github.com/tiangolo/markdown-include-variants/release-notes.md"
 
-[tool.hatch.version]
-path = "src/markdown_include_variants/_version.py"
-
-[tool.uv]
-dev-dependencies = [
+[dependency-groups]
+dev = [
     "coverage[toml]>=7.6.1",
     "inline-snapshot>=0.13.3",
     "mdx-include>=1.4.2",
@@ -41,6 +38,9 @@ dev-dependencies = [
     "types-markdown>=3.7.0.20240822",
 ]
 
+[tool.hatch.version]
+path = "src/markdown_include_variants/_version.py"
+
 [tool.coverage.run]
 parallel = true
 data_file = "coverage/.coverage"

{markdown_include_variants-0.0.6 → markdown_include_variants-0.0.7}/release-notes.md

@@ -2,6 +2,16 @@
 
 ## Latest Changes
 
+## 0.0.7
+
+### Features
+
+* ✨ Support `title` option. PR [#39](https://github.com/tiangolo/markdown-include-variants/pull/39) by [@YuriiMotov](https://github.com/YuriiMotov).
+
+### Upgrades
+
+* ⬆️ Upgrade uv config in pyproject.toml. PR [#40](https://github.com/tiangolo/markdown-include-variants/pull/40) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.0.6
 
 ### Features

{markdown_include_variants-0.0.6 → markdown_include_variants-0.0.7}/src/markdown_include_variants/_main.py

@@ -279,15 +279,18 @@ class IncludeVariantsPreprocessor(Preprocessor):
             configs_str = line_match.group(2).strip()
             include_lines: list[tuple[int, int]] = []
             highlight_lines: list[tuple[int, int]] = []
+            title: Union[str, None] = None
             for config_match in re.finditer(re_config, configs_str):
                 if config_match:
                     name = config_match.group(1)
-                    ranges_str = config_match.group(2)
-                    ranges = parse_lines_index(ranges_str)
+                    value_str = config_match.group(2)
                     if name == "ln":
-                        include_lines.extend(ranges)
+                        include_lines.extend(parse_lines_index(value_str))
                     elif name == "hl":
-                        highlight_lines.extend(ranges)
+                        highlight_lines.extend(parse_lines_index(value_str))
+                    elif name == "title":
+                        assert value_str.startswith('"') and value_str.endswith('"')
+                        title = value_str[1:-1]
             use_hl_lines: list[tuple[int, int]] = []
             if highlight_lines:
                 if include_lines:
@@ -356,6 +359,8 @@ class IncludeVariantsPreprocessor(Preprocessor):
                 first_line = "```python"
                 if use_hl_lines:
                     first_line += f' hl_lines="{use_hl_lines_str}"'
+                if title:
+                    first_line += f' title="{title}"'
 
                 block_lines.extend(
                     [
@@ -373,6 +378,8 @@ class IncludeVariantsPreprocessor(Preprocessor):
                 if highlight_lines:
                     hl_lines_full_str = generate_hl_string(highlight_lines)
                     first_line_full += f' hl_lines="{hl_lines_full_str}"'
+                if title:
+                    first_line_full += f' title="{title}"'
                 block_lines.extend(
                     [
                         "///// details | 👀 Full file preview",
@@ -390,6 +397,9 @@ class IncludeVariantsPreprocessor(Preprocessor):
                     ]
                 )
             if len(sorted_variants):
+                first_line_variant = "```python"
+                if title:
+                    first_line_variant += f' title="{title}"'
                 block_lines.extend(
                     [
                         "///// details | 🤓 Other versions and variants",
@@ -413,7 +423,7 @@ class IncludeVariantsPreprocessor(Preprocessor):
 
                     block_lines.extend(
                         [
-                            "```python",
+                            first_line_variant,
                             f"{{!{variant.path}!}}",
                             "```",
                             "////",

markdown_include_variants-0.0.7/src/markdown_include_variants/_version.py

@@ -0,0 +1 @@
+__version__ = "0.0.7"

{markdown_include_variants-0.0.6 → markdown_include_variants-0.0.7}/tests/test_all_variants.py

@@ -142,6 +142,77 @@ def test_all_variants_ln_hl():
     )
 
 
+def test_all_variants_ln_hl_title():
+    input_md = inspect.cleandoc(
+        """
+        {* docs_src/all_variants/tutorial001_an_py311.py ln[3:5] hl[4:5] title["main.py"] *}
+        """
+    )
+
+    result = markdown.markdown(input_md, extensions=[IncludeVariantsExtension()])
+    assert result == snapshot(
+        inspect.cleandoc(
+            """
+            <p>//// tab | Python 3.11+
+            ```python hl_lines="4-5" title="main.py"</p>
+            <h1>Code above omitted 👆</h1>
+            <p>{!docs_src/all_variants/tutorial001_an_py311.py[ln:3-5]!}</p>
+            <h1>Code below omitted 👇</h1>
+            <p>```</p>
+            <p>////</p>
+            <p>///// details | 👀 Full file preview</p>
+            <p>//// tab | Python 3.11+</p>
+            <p><code>python hl_lines="4-5" title="main.py"
+            {!docs_src/all_variants/tutorial001_an_py311.py!}</code></p>
+            <p>////</p>
+            <p>/////</p>
+            <p>///// details | 🤓 Other versions and variants</p>
+            <p>//// tab | Python 3.10+</p>
+            <p><code>python title="main.py"
+            {!docs_src/all_variants/tutorial001_an_py310.py!}</code>
+            ////
+            //// tab | Python 3.9+</p>
+            <p><code>python title="main.py"
+            {!docs_src/all_variants/tutorial001_an_py39.py!}</code>
+            ////
+            //// tab | Python 3.8+</p>
+            <p><code>python title="main.py"
+            {!docs_src/all_variants/tutorial001_an.py!}</code>
+            ////
+            //// tab | Python 3.11+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><code>python title="main.py"
+            {!docs_src/all_variants/tutorial001_py311.py!}</code>
+            ////
+            //// tab | Python 3.10+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><code>python title="main.py"
+            {!docs_src/all_variants/tutorial001_py310.py!}</code>
+            ////
+            //// tab | Python 3.9+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><code>python title="main.py"
+            {!docs_src/all_variants/tutorial001_py39.py!}</code>
+            ////
+            //// tab | Python 3.8+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><code>python title="main.py"
+            {!docs_src/all_variants/tutorial001.py!}</code>
+            ////</p>
+            <p>/////</p>
+            """
+        )
+    )
+
+
 def test_all_variants_ln_hl_include():
     input_md = inspect.cleandoc(
         """
@@ -294,3 +365,157 @@ def test_all_variants_ln_hl_include():
             """
         )
     )
+
+
+def test_all_variants_ln_hl_title_include():
+    input_md = inspect.cleandoc(
+        """
+        {* docs_src/all_variants/tutorial001_an_py311.py ln[3:5] hl[4:5] title["main.py"] *}
+        """
+    )
+
+    result = markdown.markdown(
+        input_md,
+        extensions=[
+            IncludeVariantsExtension(),
+            IncludeExtension(),
+            SuperFencesCodeExtension(),
+            HighlightExtension(),
+        ],
+    )
+    assert result == snapshot(
+        inspect.cleandoc(
+            """
+            <p>//// tab | Python 3.11+
+            <div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="c1"># Code above omitted 👆</span>
+
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 3&quot;</span><span class="p">)</span>
+            <span class="hll"><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 4&quot;</span><span class="p">)</span>
+            </span><span class="hll"><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 5&quot;</span><span class="p">)</span>
+            </span>
+            <span class="c1"># Code below omitted 👇</span>
+            </code></pre></div></p>
+            <p>////</p>
+            <p>///// details | 👀 Full file preview</p>
+            <p>//// tab | Python 3.11+</p>
+            <div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 3&quot;</span><span class="p">)</span>
+            <span class="hll"><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 4&quot;</span><span class="p">)</span>
+            </span><span class="hll"><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 5&quot;</span><span class="p">)</span>
+            </span><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py311 line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            <p>////</p>
+            <p>/////</p>
+            <p>///// details | 🤓 Other versions and variants</p>
+            <p>//// tab | Python 3.10+</p>
+            <p><div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 3&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 4&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 5&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py310 line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            ////
+            //// tab | Python 3.9+</p>
+            <p><div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 3&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 4&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 5&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an py39 line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            ////
+            //// tab | Python 3.8+</p>
+            <p><div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 3&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 4&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 5&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;an line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            ////
+            //// tab | Python 3.11+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 3&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 4&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 5&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py311 line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            ////
+            //// tab | Python 3.10+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 3&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 4&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 5&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py310 line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            ////
+            //// tab | Python 3.9+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 3&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 4&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 5&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;py39 line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            ////
+            //// tab | Python 3.8+ - non-Annotated</p>
+            <p>/// tip</p>
+            <p>Prefer to use the <code>Annotated</code> version if possible.</p>
+            <p>///</p>
+            <p><div class="highlight"><span class="filename">main.py</span><pre><span></span><code><span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 1&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 2&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 3&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 4&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 5&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 6&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 7&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 8&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 9&quot;</span><span class="p">)</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;simple line 10&quot;</span><span class="p">)</span>
+            </code></pre></div>
+            ////</p>
+            <p>/////</p>
+            """
+        )
+    )

markdown_include_variants-0.0.7/tests/test_simple_title.py

@@ -0,0 +1,59 @@
+import inspect
+
+import markdown
+from inline_snapshot import snapshot
+from mdx_include.mdx_include import IncludeExtension
+
+from markdown_include_variants import IncludeVariantsExtension
+
+
+def test_simple_title():
+    input_md = inspect.cleandoc(
+        """
+        {*docs_src/simple/tutorial001.py title["Example 1"] *}
+        """
+    )
+
+    result = markdown.markdown(input_md, extensions=[IncludeVariantsExtension()])
+    assert result == snapshot(
+        inspect.cleandoc(
+            """
+            <p>//// tab | Python 3.8+
+            <code>python title="Example 1"
+            {!docs_src/simple/tutorial001.py!}</code></p>
+            <p>////</p>
+            """
+        )
+    )
+
+
+def test_simple_include():
+    input_md = inspect.cleandoc(
+        """
+        {* docs_src/simple/tutorial001.py title["Example 1"] *}
+        """
+    )
+
+    result = markdown.markdown(
+        input_md, extensions=[IncludeVariantsExtension(), IncludeExtension()]
+    )
+    assert result == snapshot(
+        inspect.cleandoc(
+            """
+            <p>//// tab | Python 3.8+
+            ```python title="Example 1"
+            print("simple line 1")
+            print("simple line 2")
+            print("simple line 3")
+            print("simple line 4")
+            print("simple line 5")
+            print("simple line 6")
+            print("simple line 7")
+            print("simple line 8")
+            print("simple line 9")
+            print("simple line 10")</p>
+            <p>```</p>
+            <p>////</p>
+            """
+        )
+    )