docdo 0.0.2__tar.gz

docdo-0.0.2/.github/workflows/pypi.yml

@@ -0,0 +1,44 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v7
+        with:
+          name: wheels
+          path: dist
+
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    needs: [build]
+    environment:
+      name: pypi
+      url: https://pypi.org/p/docdo/
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: wheels
+          path: dist
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

docdo-0.0.2/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

docdo-0.0.2/.python-version

@@ -0,0 +1 @@
+3.12

docdo-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 javi22020
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docdo-0.0.2/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: docdo
+Version: 0.0.2
+Summary: A CLI tool to render Markdown files to PDF via HTML templates and Playwright.
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: click>=8.0
+Requires-Dist: markdown-it-py>=3.0
+Requires-Dist: playwright>=1.40
+Requires-Dist: pygments>=2.17
+Description-Content-Type: text/markdown
+
+# Docdo
+
+CLI tool that converts Markdown files to PDF using Playwright and CSS themes.
+
+## Install
+
+```bash
+uv tool install docdo
+playwright install chromium
+```
+
+## Usage
+
+```bash
+docdo -i README.md                       # outputs README.pdf next to it
+docdo -i docs/ -o out/                   # converts a whole folder
+docdo -i README.md -t dracula            # use a built-in theme
+docdo -i README.md -t ./my-style.css     # use a custom CSS file
+```
+
+| Flag | Description |
+|------|-------------|
+| `-i`, `--input` | Markdown file or folder (required) |
+| `-o`, `--output` | Output PDF file or folder (defaults to input location) |
+| `-t`, `--theme` | Built-in theme name (`default`, `dracula`) or path to a `.css` file |
+
+## Themes
+
+Built-in themes live in `src/docdo/themes/`. To add your own, drop a `.css` file there or just pass any CSS file path with `-t`.
+
+## How it works
+
+1. Parses Markdown with `markdown-it-py` (with `pygments` for syntax highlighting).
+2. Wraps the HTML with the selected CSS theme.
+3. Renders to PDF via Playwright (headless Chromium).
+
+## Dev
+
+```bash
+uv sync
+uv run docdo -i README.md
+```

docdo-0.0.2/README.md

@@ -0,0 +1,42 @@
+# Docdo
+
+CLI tool that converts Markdown files to PDF using Playwright and CSS themes.
+
+## Install
+
+```bash
+uv tool install docdo
+playwright install chromium
+```
+
+## Usage
+
+```bash
+docdo -i README.md                       # outputs README.pdf next to it
+docdo -i docs/ -o out/                   # converts a whole folder
+docdo -i README.md -t dracula            # use a built-in theme
+docdo -i README.md -t ./my-style.css     # use a custom CSS file
+```
+
+| Flag | Description |
+|------|-------------|
+| `-i`, `--input` | Markdown file or folder (required) |
+| `-o`, `--output` | Output PDF file or folder (defaults to input location) |
+| `-t`, `--theme` | Built-in theme name (`default`, `dracula`) or path to a `.css` file |
+
+## Themes
+
+Built-in themes live in `src/docdo/themes/`. To add your own, drop a `.css` file there or just pass any CSS file path with `-t`.
+
+## How it works
+
+1. Parses Markdown with `markdown-it-py` (with `pygments` for syntax highlighting).
+2. Wraps the HTML with the selected CSS theme.
+3. Renders to PDF via Playwright (headless Chromium).
+
+## Dev
+
+```bash
+uv sync
+uv run docdo -i README.md
+```

docdo-0.0.2/main.py

@@ -0,0 +1,4 @@
+from docdo.cli import main
+
+if __name__ == "__main__":
+    main()

docdo-0.0.2/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "docdo"
+version = "0.0.2"
+description = "A CLI tool to render Markdown files to PDF via HTML templates and Playwright."
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "click>=8.0",
+    "playwright>=1.40",
+    "markdown-it-py>=3.0",
+    "pygments>=2.17",
+]
+
+[project.scripts]
+docdo = "docdo.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/docdo"]
+
+[dependency-groups]
+dev = ["pytest>=8.0"]

docdo-0.0.2/pyrightconfig.json

@@ -0,0 +1,12 @@
+{
+  "venvPath": ".",
+  "venv": ".venv",
+  "pythonVersion": "3.12",
+  "include": ["src", "main.py"],
+  "executionEnvironments": [
+    {
+      "root": ".",
+      "extraPaths": ["src"]
+    }
+  ]
+}

docdo-0.0.2/src/docdo/__init__.py

@@ -0,0 +1,5 @@
+"""docdo - Markdown to PDF converter."""
+
+from docdo.converter import convert
+
+__all__ = ["convert"]

docdo-0.0.2/src/docdo/cli.py

@@ -0,0 +1,113 @@
+"""Click CLI entry point for docdo."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+from docdo import themes as _themes
+from docdo.converter import convert as _convert
+
+
+def _default_output(input_path: Path) -> Path:
+    """Return a default PDF path next to the input file."""
+    return input_path.with_suffix(".pdf")
+
+
+@click.command(context_settings={"help_option_names": ["-h", "--help"]})
+@click.option(
+    "-i", "--input", "input_path",
+    required=True,
+    type=click.Path(exists=True, readable=True, path_type=Path),
+    help="Input Markdown file or folder.",
+)
+@click.option(
+    "-o", "--output", "output_path",
+    default=None,
+    type=click.Path(path_type=Path),
+    help="Output PDF file or folder. Defaults to the input location.",
+)
+@click.option(
+    "-t", "--theme",
+    default=None,
+    metavar="NAME_OR_PATH",
+    help=(
+        f"Theme name ({', '.join(_themes.list_themes())}) "
+        "or path to a .css file. Defaults to 'default'."
+    ),
+)
+@click.version_option(package_name="docdo")
+def main(input_path: Path, output_path: Path | None, theme: str | None) -> None:
+    """Convert Markdown files to PDF with beautiful CSS themes."""
+
+    if input_path.is_dir():
+        _convert_folder(input_path, output_path, theme)
+    else:
+        _convert_file(input_path, output_path, theme)
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _convert_file(
+    input_path: Path,
+    output_path: Path | None,
+    theme: str | None,
+) -> None:
+    if output_path is None:
+        output_path = _default_output(input_path)
+    if output_path.is_dir():
+        output_path = output_path / input_path.with_suffix(".pdf").name
+
+    click.echo(f"  → {input_path.name}  ➜  {output_path}")
+    try:
+        _convert(input_path, output_path, theme)
+    except (FileNotFoundError, ValueError) as exc:
+        click.secho(f"Error: {exc}", fg="red", err=True)
+        sys.exit(1)
+    click.secho("  ✓ Done", fg="green")
+
+
+def _convert_folder(
+    input_folder: Path,
+    output_folder: Path | None,
+    theme: str | None,
+) -> None:
+    md_files = sorted(input_folder.rglob("*.md"))
+    if not md_files:
+        click.secho(f"No .md files found in {input_folder}", fg="yellow")
+        return
+
+    if output_folder is None:
+        output_folder = input_folder
+
+    output_folder.mkdir(parents=True, exist_ok=True)
+    errors = 0
+
+    for md_file in md_files:
+        # Preserve sub-folder structure relative to input_folder
+        relative = md_file.relative_to(input_folder)
+        out_file = output_folder / relative.with_suffix(".pdf")
+        out_file.parent.mkdir(parents=True, exist_ok=True)
+
+        click.echo(f"  → {relative}  ➜  {out_file.relative_to(output_folder)}")
+        try:
+            _convert(md_file, out_file, theme)
+            click.secho("    ✓", fg="green")
+        except Exception as exc:  # noqa: BLE001
+            click.secho(f"    ✗ {exc}", fg="red", err=True)
+            errors += 1
+
+    total = len(md_files)
+    success = total - errors
+    color = "green" if errors == 0 else "yellow"
+    click.secho(
+        f"\nConverted {success}/{total} file(s).",
+        fg=color,
+    )
+    if errors:
+        sys.exit(1)

docdo-0.0.2/src/docdo/converter.py

@@ -0,0 +1,38 @@
+"""High-level converter: glues themes, renderer, and PDF exporter together."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from docdo import pdf as _pdf
+from docdo import renderer as _renderer
+from docdo import themes as _themes
+
+
+def convert(
+    input_path: str | Path,
+    output_path: str | Path,
+    theme: str | None = None,
+) -> None:
+    """Convert a single Markdown file to PDF.
+
+    Args:
+        input_path:  Path to the source ``.md`` file.
+        output_path: Destination path for the generated ``.pdf`` file.
+        theme:       Built-in theme name or path to a ``.css`` file.
+                     Defaults to the ``"default"`` theme.
+
+    Raises:
+        FileNotFoundError: If *input_path* does not exist.
+        ValueError:        If *theme* is an unknown name and not a valid path.
+    """
+    input_path = Path(input_path)
+    output_path = Path(output_path)
+
+    if not input_path.is_file():
+        raise FileNotFoundError(f"Input file not found: {input_path.resolve()}")
+
+    markdown_source = input_path.read_text(encoding="utf-8")
+    css = _themes.load_theme(theme)
+    html = _renderer.render(markdown_source, css)
+    _pdf.html_to_pdf(html, output_path)

docdo-0.0.2/src/docdo/pdf.py

@@ -0,0 +1,45 @@
+"""HTML → PDF exporter via Playwright (headless Chromium)."""
+
+from __future__ import annotations
+
+import tempfile
+from pathlib import Path
+
+from playwright.sync_api import sync_playwright
+
+
+def html_to_pdf(html: str, output_path: Path) -> None:
+    """Render *html* to a PDF file at *output_path*.
+
+    Args:
+        html:        Complete HTML document string.
+        output_path: Destination path for the generated PDF (created/overwritten).
+
+    Raises:
+        RuntimeError: If Playwright fails to render the page.
+    """
+    output_path = Path(output_path)
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Write the HTML to a temporary file so that relative paths (images, etc.)
+    # resolve correctly from the file's directory.
+    with tempfile.NamedTemporaryFile(
+        suffix=".html", mode="w", encoding="utf-8", delete=False
+    ) as tmp:
+        tmp.write(html)
+        tmp_path = Path(tmp.name)
+
+    try:
+        with sync_playwright() as p:
+            browser = p.chromium.launch()
+            page = browser.new_page()
+            page.goto(tmp_path.as_uri(), wait_until="networkidle")
+            page.pdf(
+                path=str(output_path),
+                format="A4",
+                print_background=True,
+                margin={"top": "0", "right": "0", "bottom": "0", "left": "0"},
+            )
+            browser.close()
+    finally:
+        tmp_path.unlink(missing_ok=True)

docdo-0.0.2/src/docdo/renderer.py

@@ -0,0 +1,90 @@
+"""Markdown → styled HTML page renderer."""
+
+from __future__ import annotations
+
+import re
+
+from pygments import highlight
+from pygments.formatters import HtmlFormatter
+from pygments.lexers import get_lexer_by_name, guess_lexer
+from pygments.util import ClassNotFound
+
+
+# ---------------------------------------------------------------------------
+# Syntax highlighter (used as a callback by markdown-it-py)
+# ---------------------------------------------------------------------------
+
+
+def _highlight_code(code: str, lang: str, _info: str) -> str:
+    """Pygments syntax highlighter called by markdown-it-py."""
+    try:
+        lexer = get_lexer_by_name(lang, stripall=True) if lang else guess_lexer(code)
+    except ClassNotFound:
+        lexer = guess_lexer(code)
+
+    formatter = HtmlFormatter(nowrap=True)
+    highlighted = highlight(code, lexer, formatter)
+    return f'<pre class="highlight"><code>{highlighted}</code></pre>'
+
+
+# ---------------------------------------------------------------------------
+# Markdown parser (created after the highlight callback is defined)
+# ---------------------------------------------------------------------------
+
+from markdown_it import MarkdownIt  # noqa: E402
+
+_md = MarkdownIt("commonmark", {"highlight": _highlight_code})
+
+
+# ---------------------------------------------------------------------------
+# HTML page template
+# ---------------------------------------------------------------------------
+
+_HTML_TEMPLATE = """\
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>{title}</title>
+  <style>
+{css}
+  </style>
+</head>
+<body>
+  <div class="md-page">
+{body}
+  </div>
+</body>
+</html>
+"""
+
+
+def _derive_title(markdown_source: str) -> str:
+    """Extract an H1 title from the Markdown source, falling back to 'Document'."""
+    match = re.search(r"^#\s+(.+)$", markdown_source, re.MULTILINE)
+    return match.group(1).strip() if match else "Document"
+
+
+# ---------------------------------------------------------------------------
+# Public API
+# ---------------------------------------------------------------------------
+
+
+def render(markdown_source: str, css: str) -> str:
+    """Convert *markdown_source* to a full HTML page string styled with *css*.
+
+    Args:
+        markdown_source: Raw Markdown text.
+        css:             CSS string (already resolved by the themes module).
+
+    Returns:
+        A complete, self-contained HTML document as a string.
+    """
+    body_html = _md.render(markdown_source)
+    title = _derive_title(markdown_source)
+    return _HTML_TEMPLATE.format(
+        title=title,
+        css=css,
+        body=body_html,
+    )

docdo-0.0.2/src/docdo/themes/__init__.py

@@ -0,0 +1,5 @@
+"""Built-in themes package — CSS files live here as package data."""
+
+from docdo.themes.resolver import list_themes, load_theme
+
+__all__ = ["list_themes", "load_theme"]

docdo-0.0.2/src/docdo/themes/default.css

@@ -0,0 +1,193 @@
+/* docdo: Default (light) theme */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;600&display=swap');
+
+:root {
+  --color-bg: #ffffff;
+  --color-text: #1a1a2e;
+  --color-muted: #6b7280;
+  --color-border: #e5e7eb;
+  --color-accent: #3b82f6;
+  --color-code-bg: #f3f4f6;
+  --color-code-border: #e5e7eb;
+  --color-blockquote-border: #3b82f6;
+  --color-blockquote-bg: #eff6ff;
+  --color-table-header: #f9fafb;
+  --color-table-row-alt: #f9fafb;
+  --color-link: #2563eb;
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  font-size: 15px;
+  line-height: 1.75;
+  color: var(--color-text);
+  background: var(--color-bg);
+}
+
+.md-page {
+  max-width: 760px;
+  margin: 0 auto;
+  padding: 48px 48px;
+}
+
+/* ── Headings ─────────────────────────────────────────────── */
+h1, h2, h3, h4, h5, h6 {
+  font-weight: 700;
+  line-height: 1.25;
+  margin-top: 2em;
+  margin-bottom: 0.6em;
+}
+
+h1 { font-size: 2.2em; border-bottom: 2px solid var(--color-border); padding-bottom: 0.3em; margin-top: 0; }
+h2 { font-size: 1.6em; border-bottom: 1px solid var(--color-border); padding-bottom: 0.25em; }
+h3 { font-size: 1.25em; }
+h4 { font-size: 1.05em; }
+
+/* ── Paragraphs & spacing ──────────────────────────────────── */
+p { margin-bottom: 1em; }
+
+/* ── Links ─────────────────────────────────────────────────── */
+a { color: var(--color-link); text-decoration: underline; text-underline-offset: 2px; }
+
+/* ── Code (inline) ─────────────────────────────────────────── */
+code {
+  font-family: 'JetBrains Mono', 'Fira Code', 'Courier New', monospace;
+  font-size: 0.88em;
+  background: var(--color-code-bg);
+  border: 1px solid var(--color-code-border);
+  border-radius: 4px;
+  padding: 0.15em 0.45em;
+}
+
+/* ── Code (block) ───────────────────────────────────────────── */
+pre {
+  background: var(--color-code-bg);
+  border: 1px solid var(--color-code-border);
+  border-radius: 8px;
+  padding: 1.2em 1.5em;
+  overflow-x: auto;
+  margin: 1.2em 0;
+  font-size: 0.87em;
+  line-height: 1.6;
+}
+
+pre code {
+  background: none;
+  border: none;
+  padding: 0;
+  font-size: inherit;
+}
+
+/* ── Blockquote ─────────────────────────────────────────────── */
+blockquote {
+  border-left: 4px solid var(--color-blockquote-border);
+  background: var(--color-blockquote-bg);
+  border-radius: 0 6px 6px 0;
+  padding: 0.8em 1.2em;
+  margin: 1.2em 0;
+  color: #374151;
+}
+
+blockquote > p:last-child { margin-bottom: 0; }
+
+/* ── Lists ──────────────────────────────────────────────────── */
+ul, ol { padding-left: 1.6em; margin-bottom: 1em; }
+li + li { margin-top: 0.25em; }
+li > ul, li > ol { margin-top: 0.25em; margin-bottom: 0; }
+
+/* ── Horizontal rule ────────────────────────────────────────── */
+hr { border: none; border-top: 2px solid var(--color-border); margin: 2em 0; }
+
+/* ── Tables ─────────────────────────────────────────────────── */
+table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1.2em 0;
+  font-size: 0.9em;
+}
+
+thead th {
+  background: var(--color-table-header);
+  font-weight: 600;
+  text-align: left;
+  padding: 0.6em 0.9em;
+  border: 1px solid var(--color-border);
+}
+
+tbody td {
+  padding: 0.55em 0.9em;
+  border: 1px solid var(--color-border);
+}
+
+tbody tr:nth-child(even) { background: var(--color-table-row-alt); }
+
+/* ── Images ─────────────────────────────────────────────────── */
+img { max-width: 100%; border-radius: 6px; display: block; margin: 1em auto; }
+
+/* ── Pygments syntax highlighting (monokai light) ───────────── */
+.highlight .hll { background-color: #ffffcc }
+.highlight .c  { color: #6a9955; font-style: italic }
+.highlight .k  { color: #0000ff; font-weight: bold }
+.highlight .o  { color: #666666 }
+.highlight .cm { color: #6a9955; font-style: italic }
+.highlight .cp { color: #bc7a00 }
+.highlight .c1 { color: #6a9955; font-style: italic }
+.highlight .cs { color: #6a9955; font-style: italic }
+.highlight .gd { color: #a61717; background-color: #ffe0e0 }
+.highlight .ge { font-style: italic }
+.highlight .gr { color: #aa0000 }
+.highlight .gh { color: #000080; font-weight: bold }
+.highlight .gi { color: #00a000 }
+.highlight .go { color: #888888 }
+.highlight .gp { color: #000080; font-weight: bold }
+.highlight .gs { font-weight: bold }
+.highlight .gu { color: #800080; font-weight: bold }
+.highlight .gt { color: #0044dd }
+.highlight .kc { color: #0000ff; font-weight: bold }
+.highlight .kd { color: #0000ff; font-weight: bold }
+.highlight .kn { color: #0000ff; font-weight: bold }
+.highlight .kp { color: #0000ff }
+.highlight .kr { color: #0000ff; font-weight: bold }
+.highlight .kt { color: #b00040 }
+.highlight .m  { color: #808000 }
+.highlight .s  { color: #ba2121 }
+.highlight .na { color: #7d9029 }
+.highlight .nb { color: #008000 }
+.highlight .nc { color: #0000ff; font-weight: bold }
+.highlight .no { color: #880000 }
+.highlight .nd { color: #aa22ff }
+.highlight .ni { color: #999999; font-weight: bold }
+.highlight .ne { color: #d2413a; font-weight: bold }
+.highlight .nf { color: #0000ff }
+.highlight .nl { color: #a0a000 }
+.highlight .nn { color: #0000ff; font-weight: bold }
+.highlight .nt { color: #008000; font-weight: bold }
+.highlight .nv { color: #19177c }
+.highlight .ow { color: #aa22ff; font-weight: bold }
+.highlight .w  { color: #bbbbbb }
+.highlight .mf { color: #808000 }
+.highlight .mh { color: #808000 }
+.highlight .mi { color: #808000 }
+.highlight .mo { color: #808000 }
+.highlight .sb { color: #ba2121 }
+.highlight .sc { color: #ba2121 }
+.highlight .sd { color: #ba2121; font-style: italic }
+.highlight .s2 { color: #ba2121 }
+.highlight .se { color: #bb6622; font-weight: bold }
+.highlight .sh { color: #ba2121 }
+.highlight .si { color: #bb6688; font-weight: bold }
+.highlight .sx { color: #008000 }
+.highlight .sr { color: #bb6688 }
+.highlight .s1 { color: #ba2121 }
+.highlight .ss { color: #19177c }
+.highlight .bp { color: #008000 }
+.highlight .vc { color: #19177c }
+.highlight .vg { color: #19177c }
+.highlight .vi { color: #19177c }
+.highlight .il { color: #808000 }

docdo-0.0.2/src/docdo/themes/dracula.css

@@ -0,0 +1,216 @@
+/* docdo: Dracula (dark) theme */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;600&display=swap');
+
+:root {
+  --color-bg: #282a36;
+  --color-bg-secondary: #343746;
+  --color-text: #f8f8f2;
+  --color-muted: #6272a4;
+  --color-border: #44475a;
+  --color-accent: #bd93f9;
+  --color-code-bg: #21222c;
+  --color-code-border: #44475a;
+  --color-blockquote-border: #bd93f9;
+  --color-blockquote-bg: #343746;
+  --color-table-header: #343746;
+  --color-table-row-alt: #2e303f;
+  --color-link: #8be9fd;
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  font-size: 15px;
+  line-height: 1.75;
+  color: var(--color-text);
+  background: var(--color-bg);
+}
+
+.md-page {
+  max-width: 760px;
+  margin: 0 auto;
+  padding: 48px 48px;
+}
+
+/* ── Headings ─────────────────────────────────────────────── */
+h1, h2, h3, h4, h5, h6 {
+  font-weight: 700;
+  line-height: 1.25;
+  margin-top: 2em;
+  margin-bottom: 0.6em;
+  color: #f1fa8c;
+}
+
+h1 { font-size: 2.2em; border-bottom: 2px solid var(--color-border); padding-bottom: 0.3em; margin-top: 0; color: #bd93f9; }
+h2 { font-size: 1.6em; border-bottom: 1px solid var(--color-border); padding-bottom: 0.25em; color: #ff79c6; }
+h3 { font-size: 1.25em; color: #50fa7b; }
+h4 { font-size: 1.05em; color: #ffb86c; }
+
+/* ── Paragraphs ─────────────────────────────────────────────── */
+p { margin-bottom: 1em; }
+
+/* ── Links ─────────────────────────────────────────────────── */
+a { color: var(--color-link); text-decoration: underline; text-underline-offset: 2px; }
+
+/* ── Code (inline) ─────────────────────────────────────────── */
+code {
+  font-family: 'JetBrains Mono', 'Fira Code', 'Courier New', monospace;
+  font-size: 0.88em;
+  background: var(--color-code-bg);
+  border: 1px solid var(--color-code-border);
+  border-radius: 4px;
+  padding: 0.15em 0.45em;
+  color: #ff79c6;
+}
+
+/* ── Code (block) ───────────────────────────────────────────── */
+pre {
+  background: var(--color-code-bg);
+  border: 1px solid var(--color-code-border);
+  border-radius: 8px;
+  padding: 1.2em 1.5em;
+  overflow-x: auto;
+  margin: 1.2em 0;
+  font-size: 0.87em;
+  line-height: 1.6;
+}
+
+pre code {
+  background: none;
+  border: none;
+  padding: 0;
+  font-size: inherit;
+  color: var(--color-text);
+}
+
+/* ── Blockquote ─────────────────────────────────────────────── */
+blockquote {
+  border-left: 4px solid var(--color-blockquote-border);
+  background: var(--color-blockquote-bg);
+  border-radius: 0 6px 6px 0;
+  padding: 0.8em 1.2em;
+  margin: 1.2em 0;
+  color: #6272a4;
+}
+
+blockquote > p:last-child { margin-bottom: 0; }
+
+/* ── Lists ──────────────────────────────────────────────────── */
+ul, ol { padding-left: 1.6em; margin-bottom: 1em; }
+li + li { margin-top: 0.25em; }
+li > ul, li > ol { margin-top: 0.25em; margin-bottom: 0; }
+
+/* ── Horizontal rule ────────────────────────────────────────── */
+hr { border: none; border-top: 2px solid var(--color-border); margin: 2em 0; }
+
+/* ── Tables ─────────────────────────────────────────────────── */
+table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1.2em 0;
+  font-size: 0.9em;
+}
+
+thead th {
+  background: var(--color-table-header);
+  font-weight: 600;
+  text-align: left;
+  padding: 0.6em 0.9em;
+  border: 1px solid var(--color-border);
+  color: #bd93f9;
+}
+
+tbody td {
+  padding: 0.55em 0.9em;
+  border: 1px solid var(--color-border);
+}
+
+tbody tr:nth-child(even) { background: var(--color-table-row-alt); }
+
+/* ── Images ─────────────────────────────────────────────────── */
+img { max-width: 100%; border-radius: 6px; display: block; margin: 1em auto; }
+
+/* ── Pygments Dracula syntax highlighting ───────────────────── */
+.highlight { background: var(--color-code-bg); }
+.highlight .hll { background-color: #44475a }
+.highlight .c  { color: #6272a4; font-style: italic }
+.highlight .err { color: #ff5555 }
+.highlight .g  { color: #f8f8f2 }
+.highlight .k  { color: #ff79c6; font-weight: bold }
+.highlight .l  { color: #f8f8f2 }
+.highlight .n  { color: #f8f8f2 }
+.highlight .o  { color: #ff79c6 }
+.highlight .x  { color: #f8f8f2 }
+.highlight .p  { color: #f8f8f2 }
+.highlight .ch { color: #6272a4; font-style: italic }
+.highlight .cm { color: #6272a4; font-style: italic }
+.highlight .cp { color: #ff79c6 }
+.highlight .cpf { color: #6272a4; font-style: italic }
+.highlight .c1 { color: #6272a4; font-style: italic }
+.highlight .cs { color: #6272a4; font-style: italic }
+.highlight .gd { color: #8b080b }
+.highlight .ge { font-style: italic }
+.highlight .gr { color: #ff5555 }
+.highlight .gh { color: #f8f8f2; font-weight: bold }
+.highlight .gi { color: #50fa7b }
+.highlight .go { color: #44475a }
+.highlight .gp { color: #f8f8f2; font-weight: bold }
+.highlight .gs { font-weight: bold }
+.highlight .gu { color: #f8f8f2; font-weight: bold }
+.highlight .gt { color: #ff5555 }
+.highlight .kc { color: #ff79c6; font-weight: bold }
+.highlight .kd { color: #8be9fd; font-style: italic }
+.highlight .kn { color: #ff79c6; font-weight: bold }
+.highlight .kp { color: #ff79c6 }
+.highlight .kr { color: #ff79c6; font-weight: bold }
+.highlight .kt { color: #8be9fd }
+.highlight .ld { color: #f8f8f2 }
+.highlight .m  { color: #bd93f9 }
+.highlight .s  { color: #f1fa8c }
+.highlight .na { color: #50fa7b }
+.highlight .nb { color: #8be9fd; font-style: italic }
+.highlight .nc { color: #50fa7b }
+.highlight .no { color: #f8f8f2 }
+.highlight .nd { color: #f8f8f2 }
+.highlight .ni { color: #f8f8f2 }
+.highlight .ne { color: #f8f8f2 }
+.highlight .nf { color: #50fa7b }
+.highlight .nl { color: #f8f8f2 }
+.highlight .nn { color: #f8f8f2 }
+.highlight .nx { color: #f8f8f2 }
+.highlight .py { color: #f8f8f2 }
+.highlight .nt { color: #ff79c6; font-weight: bold }
+.highlight .nv { color: #8be9fd; font-style: italic }
+.highlight .ow { color: #ff79c6; font-weight: bold }
+.highlight .pm { color: #f8f8f2 }
+.highlight .w  { color: #f8f8f2 }
+.highlight .mb { color: #bd93f9 }
+.highlight .mf { color: #bd93f9 }
+.highlight .mh { color: #bd93f9 }
+.highlight .mi { color: #bd93f9 }
+.highlight .mo { color: #bd93f9 }
+.highlight .sa { color: #f1fa8c }
+.highlight .sb { color: #f1fa8c }
+.highlight .sc { color: #f1fa8c }
+.highlight .dl { color: #f1fa8c }
+.highlight .sd { color: #f1fa8c }
+.highlight .s2 { color: #f1fa8c }
+.highlight .se { color: #f1fa8c }
+.highlight .sh { color: #f1fa8c }
+.highlight .si { color: #f1fa8c }
+.highlight .sx { color: #f1fa8c }
+.highlight .sr { color: #f1fa8c }
+.highlight .s1 { color: #f1fa8c }
+.highlight .ss { color: #f1fa8c }
+.highlight .bp { color: #f8f8f2 }
+.highlight .fm { color: #50fa7b }
+.highlight .vc { color: #8be9fd; font-style: italic }
+.highlight .vg { color: #8be9fd; font-style: italic }
+.highlight .vi { color: #8be9fd; font-style: italic }
+.highlight .vm { color: #8be9fd; font-style: italic }
+.highlight .il { color: #bd93f9 }

docdo-0.0.2/src/docdo/themes/resolver.py

@@ -0,0 +1,57 @@
+"""Theme resolver: maps a name or CSS file path to a CSS string."""
+
+from __future__ import annotations
+
+import importlib.resources
+from pathlib import Path
+
+# Built-in theme registry: name → filename inside the themes/ package directory
+_BUILTIN_THEMES: dict[str, str] = {
+    "default": "default.css",
+    "dracula": "dracula.css",
+}
+
+
+def list_themes() -> list[str]:
+    """Return the names of all built-in themes."""
+    return list(_BUILTIN_THEMES.keys())
+
+
+def load_theme(theme: str | None) -> str:
+    """Resolve *theme* to a CSS string.
+
+    *theme* may be:
+    - ``None`` or ``"default"`` → built-in default theme
+    - A registered theme name (e.g. ``"dracula"``)
+    - An absolute or relative path to a ``.css`` file
+
+    Raises:
+        FileNotFoundError: if *theme* is a path that does not exist.
+        ValueError: if *theme* is an unrecognised name.
+    """
+    if not theme:
+        theme = "default"
+
+    # Check if it looks like a file path
+    path = Path(theme)
+    if path.suffix.lower() == ".css":
+        if not path.is_file():
+            raise FileNotFoundError(
+                f"Theme CSS file not found: {path.resolve()}"
+            )
+        return path.read_text(encoding="utf-8")
+
+    # Treat as a built-in theme name
+    if theme not in _BUILTIN_THEMES:
+        choices = ", ".join(sorted(_BUILTIN_THEMES))
+        raise ValueError(
+            f"Unknown theme '{theme}'. "
+            f"Available built-in themes: {choices}. "
+            "You can also pass a path to a .css file."
+        )
+
+    filename = _BUILTIN_THEMES[theme]
+    # Use importlib.resources for reliable access inside installed packages
+    package = importlib.resources.files("docdo.themes")
+    css_path = package.joinpath(filename)
+    return css_path.read_text(encoding="utf-8")

docdo-0.0.2/uv.lock

@@ -0,0 +1,207 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "click"
+version = "8.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "docdo"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "click" },
+    { name = "markdown-it-py" },
+    { name = "playwright" },
+    { name = "pygments" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "click", specifier = ">=8.0" },
+    { name = "markdown-it-py", specifier = ">=3.0" },
+    { name = "playwright", specifier = ">=1.40" },
+    { name = "pygments", specifier = ">=2.17" },
+]
+
+[package.metadata.requires-dev]
+dev = [{ name = "pytest", specifier = ">=8.0" }]
+
+[[package]]
+name = "greenlet"
+version = "3.3.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a3/51/1664f6b78fc6ebbd98019a1fd730e83fa78f2db7058f72b1463d3612b8db/greenlet-3.3.2.tar.gz", hash = "sha256:2eaf067fc6d886931c7962e8c6bede15d2f01965560f3359b27c80bde2d151f2", size = 188267, upload-time = "2026-02-20T20:54:15.531Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ea/ab/1608e5a7578e62113506740b88066bf09888322a311cff602105e619bd87/greenlet-3.3.2-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:ac8d61d4343b799d1e526db579833d72f23759c71e07181c2d2944e429eb09cd", size = 280358, upload-time = "2026-02-20T20:17:43.971Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/23/0eae412a4ade4e6623ff7626e38998cb9b11e9ff1ebacaa021e4e108ec15/greenlet-3.3.2-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3ceec72030dae6ac0c8ed7591b96b70410a8be370b6a477b1dbc072856ad02bd", size = 601217, upload-time = "2026-02-20T20:47:31.462Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/16/5b1678a9c07098ecb9ab2dd159fafaf12e963293e61ee8d10ecb55273e5e/greenlet-3.3.2-cp312-cp312-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a2a5be83a45ce6188c045bcc44b0ee037d6a518978de9a5d97438548b953a1ac", size = 611792, upload-time = "2026-02-20T20:55:58.423Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/c5/cc09412a29e43406eba18d61c70baa936e299bc27e074e2be3806ed29098/greenlet-3.3.2-cp312-cp312-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ae9e21c84035c490506c17002f5c8ab25f980205c3e61ddb3a2a2a2e6c411fcb", size = 626250, upload-time = "2026-02-20T21:02:46.596Z" },
+    { url = "https://files.pythonhosted.org/packages/50/1f/5155f55bd71cabd03765a4aac9ac446be129895271f73872c36ebd4b04b6/greenlet-3.3.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:43e99d1749147ac21dde49b99c9abffcbc1e2d55c67501465ef0930d6e78e070", size = 613875, upload-time = "2026-02-20T20:21:01.102Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/dd/845f249c3fcd69e32df80cdab059b4be8b766ef5830a3d0aa9d6cad55beb/greenlet-3.3.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:4c956a19350e2c37f2c48b336a3afb4bff120b36076d9d7fb68cb44e05d95b79", size = 1571467, upload-time = "2026-02-20T20:49:33.495Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/50/2649fe21fcc2b56659a452868e695634722a6655ba245d9f77f5656010bf/greenlet-3.3.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:6c6f8ba97d17a1e7d664151284cb3315fc5f8353e75221ed4324f84eb162b395", size = 1640001, upload-time = "2026-02-20T20:21:09.154Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/40/cc802e067d02af8b60b6771cea7d57e21ef5e6659912814babb42b864713/greenlet-3.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:34308836d8370bddadb41f5a7ce96879b72e2fdfb4e87729330c6ab52376409f", size = 231081, upload-time = "2026-02-20T20:17:28.121Z" },
+    { url = "https://files.pythonhosted.org/packages/58/2e/fe7f36ff1982d6b10a60d5e0740c759259a7d6d2e1dc41da6d96de32fff6/greenlet-3.3.2-cp312-cp312-win_arm64.whl", hash = "sha256:d3a62fa76a32b462a97198e4c9e99afb9ab375115e74e9a83ce180e7a496f643", size = 230331, upload-time = "2026-02-20T20:17:23.34Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/48/f8b875fa7dea7dd9b33245e37f065af59df6a25af2f9561efa8d822fde51/greenlet-3.3.2-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:aa6ac98bdfd716a749b84d4034486863fd81c3abde9aa3cf8eff9127981a4ae4", size = 279120, upload-time = "2026-02-20T20:19:01.9Z" },
+    { url = "https://files.pythonhosted.org/packages/49/8d/9771d03e7a8b1ee456511961e1b97a6d77ae1dea4a34a5b98eee706689d3/greenlet-3.3.2-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ab0c7e7901a00bc0a7284907273dc165b32e0d109a6713babd04471327ff7986", size = 603238, upload-time = "2026-02-20T20:47:32.873Z" },
+    { url = "https://files.pythonhosted.org/packages/59/0e/4223c2bbb63cd5c97f28ffb2a8aee71bdfb30b323c35d409450f51b91e3e/greenlet-3.3.2-cp313-cp313-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d248d8c23c67d2291ffd47af766e2a3aa9fa1c6703155c099feb11f526c63a92", size = 614219, upload-time = "2026-02-20T20:55:59.817Z" },
+    { url = "https://files.pythonhosted.org/packages/94/2b/4d012a69759ac9d77210b8bfb128bc621125f5b20fc398bce3940d036b1c/greenlet-3.3.2-cp313-cp313-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ccd21bb86944ca9be6d967cf7691e658e43417782bce90b5d2faeda0ff78a7dd", size = 628268, upload-time = "2026-02-20T21:02:48.024Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/34/259b28ea7a2a0c904b11cd36c79b8cef8019b26ee5dbe24e73b469dea347/greenlet-3.3.2-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b6997d360a4e6a4e936c0f9625b1c20416b8a0ea18a8e19cabbefc712e7397ab", size = 616774, upload-time = "2026-02-20T20:21:02.454Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/03/996c2d1689d486a6e199cb0f1cf9e4aa940c500e01bdf201299d7d61fa69/greenlet-3.3.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:64970c33a50551c7c50491671265d8954046cb6e8e2999aacdd60e439b70418a", size = 1571277, upload-time = "2026-02-20T20:49:34.795Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/c4/2570fc07f34a39f2caf0bf9f24b0a1a0a47bc2e8e465b2c2424821389dfc/greenlet-3.3.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1a9172f5bf6bd88e6ba5a84e0a68afeac9dc7b6b412b245dd64f52d83c81e55b", size = 1640455, upload-time = "2026-02-20T20:21:10.261Z" },
+    { url = "https://files.pythonhosted.org/packages/91/39/5ef5aa23bc545aa0d31e1b9b55822b32c8da93ba657295840b6b34124009/greenlet-3.3.2-cp313-cp313-win_amd64.whl", hash = "sha256:a7945dd0eab63ded0a48e4dcade82939783c172290a7903ebde9e184333ca124", size = 230961, upload-time = "2026-02-20T20:16:58.461Z" },
+    { url = "https://files.pythonhosted.org/packages/62/6b/a89f8456dcb06becff288f563618e9f20deed8dd29beea14f9a168aef64b/greenlet-3.3.2-cp313-cp313-win_arm64.whl", hash = "sha256:394ead29063ee3515b4e775216cb756b2e3b4a7e55ae8fd884f17fa579e6b327", size = 230221, upload-time = "2026-02-20T20:17:37.152Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/ae/8bffcbd373b57a5992cd077cbe8858fff39110480a9d50697091faea6f39/greenlet-3.3.2-cp314-cp314-macosx_11_0_universal2.whl", hash = "sha256:8d1658d7291f9859beed69a776c10822a0a799bc4bfe1bd4272bb60e62507dab", size = 279650, upload-time = "2026-02-20T20:18:00.783Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/c0/45f93f348fa49abf32ac8439938726c480bd96b2a3c6f4d949ec0124b69f/greenlet-3.3.2-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:18cb1b7337bca281915b3c5d5ae19f4e76d35e1df80f4ad3c1a7be91fadf1082", size = 650295, upload-time = "2026-02-20T20:47:34.036Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/de/dd7589b3f2b8372069ab3e4763ea5329940fc7ad9dcd3e272a37516d7c9b/greenlet-3.3.2-cp314-cp314-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c2e47408e8ce1c6f1ceea0dffcdf6ebb85cc09e55c7af407c99f1112016e45e9", size = 662163, upload-time = "2026-02-20T20:56:01.295Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/ac/85804f74f1ccea31ba518dcc8ee6f14c79f73fe36fa1beba38930806df09/greenlet-3.3.2-cp314-cp314-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e3cb43ce200f59483eb82949bf1835a99cf43d7571e900d7c8d5c62cdf25d2f9", size = 675371, upload-time = "2026-02-20T21:02:49.664Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/d8/09bfa816572a4d83bccd6750df1926f79158b1c36c5f73786e26dbe4ee38/greenlet-3.3.2-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:63d10328839d1973e5ba35e98cccbca71b232b14051fd957b6f8b6e8e80d0506", size = 664160, upload-time = "2026-02-20T20:21:04.015Z" },
+    { url = "https://files.pythonhosted.org/packages/48/cf/56832f0c8255d27f6c35d41b5ec91168d74ec721d85f01a12131eec6b93c/greenlet-3.3.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:8e4ab3cfb02993c8cc248ea73d7dae6cec0253e9afa311c9b37e603ca9fad2ce", size = 1619181, upload-time = "2026-02-20T20:49:36.052Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/23/b90b60a4aabb4cec0796e55f25ffbfb579a907c3898cd2905c8918acaa16/greenlet-3.3.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:94ad81f0fd3c0c0681a018a976e5c2bd2ca2d9d94895f23e7bb1af4e8af4e2d5", size = 1687713, upload-time = "2026-02-20T20:21:11.684Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/ca/2101ca3d9223a1dc125140dbc063644dca76df6ff356531eb27bc267b446/greenlet-3.3.2-cp314-cp314-win_amd64.whl", hash = "sha256:8c4dd0f3997cf2512f7601563cc90dfb8957c0cff1e3a1b23991d4ea1776c492", size = 232034, upload-time = "2026-02-20T20:20:08.186Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/4a/ecf894e962a59dea60f04877eea0fd5724618da89f1867b28ee8b91e811f/greenlet-3.3.2-cp314-cp314-win_arm64.whl", hash = "sha256:cd6f9e2bbd46321ba3bbb4c8a15794d32960e3b0ae2cc4d49a1a53d314805d71", size = 231437, upload-time = "2026-02-20T20:18:59.722Z" },
+    { url = "https://files.pythonhosted.org/packages/98/6d/8f2ef704e614bcf58ed43cfb8d87afa1c285e98194ab2cfad351bf04f81e/greenlet-3.3.2-cp314-cp314t-macosx_11_0_universal2.whl", hash = "sha256:e26e72bec7ab387ac80caa7496e0f908ff954f31065b0ffc1f8ecb1338b11b54", size = 286617, upload-time = "2026-02-20T20:19:29.856Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/0d/93894161d307c6ea237a43988f27eba0947b360b99ac5239ad3fe09f0b47/greenlet-3.3.2-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8b466dff7a4ffda6ca975979bab80bdadde979e29fc947ac3be4451428d8b0e4", size = 655189, upload-time = "2026-02-20T20:47:35.742Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/2c/d2d506ebd8abcb57386ec4f7ba20f4030cbe56eae541bc6fd6ef399c0b41/greenlet-3.3.2-cp314-cp314t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b8bddc5b73c9720bea487b3bffdb1840fe4e3656fba3bd40aa1489e9f37877ff", size = 658225, upload-time = "2026-02-20T20:56:02.527Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/67/8197b7e7e602150938049d8e7f30de1660cfb87e4c8ee349b42b67bdb2e1/greenlet-3.3.2-cp314-cp314t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:59b3e2c40f6706b05a9cd299c836c6aa2378cabe25d021acd80f13abf81181cf", size = 666581, upload-time = "2026-02-20T21:02:51.526Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/30/3a09155fbf728673a1dea713572d2d31159f824a37c22da82127056c44e4/greenlet-3.3.2-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b26b0f4428b871a751968285a1ac9648944cea09807177ac639b030bddebcea4", size = 657907, upload-time = "2026-02-20T20:21:05.259Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/fd/d05a4b7acd0154ed758797f0a43b4c0962a843bedfe980115e842c5b2d08/greenlet-3.3.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:1fb39a11ee2e4d94be9a76671482be9398560955c9e568550de0224e41104727", size = 1618857, upload-time = "2026-02-20T20:49:37.309Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/e1/50ee92a5db521de8f35075b5eff060dd43d39ebd46c2181a2042f7070385/greenlet-3.3.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:20154044d9085151bc309e7689d6f7ba10027f8f5a8c0676ad398b951913d89e", size = 1680010, upload-time = "2026-02-20T20:21:13.427Z" },
+    { url = "https://files.pythonhosted.org/packages/29/4b/45d90626aef8e65336bed690106d1382f7a43665e2249017e9527df8823b/greenlet-3.3.2-cp314-cp314t-win_amd64.whl", hash = "sha256:c04c5e06ec3e022cbfe2cd4a846e1d4e50087444f875ff6d2c2ad8445495cf1a", size = 237086, upload-time = "2026-02-20T20:20:45.786Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
+]
+
+[[package]]
+name = "playwright"
+version = "1.58.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "greenlet" },
+    { name = "pyee" },
+]
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f8/c9/9c6061d5703267f1baae6a4647bfd1862e386fbfdb97d889f6f6ae9e3f64/playwright-1.58.0-py3-none-macosx_10_13_x86_64.whl", hash = "sha256:96e3204aac292ee639edbfdef6298b4be2ea0a55a16b7068df91adac077cc606", size = 42251098, upload-time = "2026-01-30T15:09:24.028Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/40/59d34a756e02f8c670f0fee987d46f7ee53d05447d43cd114ca015cb168c/playwright-1.58.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:70c763694739d28df71ed578b9c8202bb83e8fe8fb9268c04dd13afe36301f71", size = 41039625, upload-time = "2026-01-30T15:09:27.558Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/ee/3ce6209c9c74a650aac9028c621f357a34ea5cd4d950700f8e2c4b7fe2c4/playwright-1.58.0-py3-none-macosx_11_0_universal2.whl", hash = "sha256:185e0132578733d02802dfddfbbc35f42be23a45ff49ccae5081f25952238117", size = 42251098, upload-time = "2026-01-30T15:09:30.461Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/af/009958cbf23fac551a940d34e3206e6c7eed2b8c940d0c3afd1feb0b0589/playwright-1.58.0-py3-none-manylinux1_x86_64.whl", hash = "sha256:c95568ba1eda83812598c1dc9be60b4406dffd60b149bc1536180ad108723d6b", size = 46235268, upload-time = "2026-01-30T15:09:33.787Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/a6/0e66ad04b6d3440dae73efb39540c5685c5fc95b17c8b29340b62abbd952/playwright-1.58.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8f9999948f1ab541d98812de25e3a8c410776aa516d948807140aff797b4bffa", size = 45964214, upload-time = "2026-01-30T15:09:36.751Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/4b/236e60ab9f6d62ed0fd32150d61f1f494cefbf02304c0061e78ed80c1c32/playwright-1.58.0-py3-none-win32.whl", hash = "sha256:1e03be090e75a0fabbdaeab65ce17c308c425d879fa48bb1d7986f96bfad0b99", size = 36815998, upload-time = "2026-01-30T15:09:39.627Z" },
+    { url = "https://files.pythonhosted.org/packages/41/f8/5ec599c5e59d2f2f336a05b4f318e733077cd5044f24adb6f86900c3e6a7/playwright-1.58.0-py3-none-win_amd64.whl", hash = "sha256:a2bf639d0ce33b3ba38de777e08697b0d8f3dc07ab6802e4ac53fb65e3907af8", size = 36816005, upload-time = "2026-01-30T15:09:42.449Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/c4/cc0229fea55c87d6c9c67fe44a21e2cd28d1d558a5478ed4d617e9fb0c93/playwright-1.58.0-py3-none-win_arm64.whl", hash = "sha256:32ffe5c303901a13a0ecab91d1c3f74baf73b84f4bedbb6b935f5bc11cc98e1b", size = 33085919, upload-time = "2026-01-30T15:09:45.71Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pyee"
+version = "13.0.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/8b/04/e7c1fe4dc78a6fdbfd6c337b1c3732ff543b8a397683ab38378447baa331/pyee-13.0.1.tar.gz", hash = "sha256:0b931f7c14535667ed4c7e0d531716368715e860b988770fc7eb8578d1f67fc8", size = 31655, upload-time = "2026-02-14T21:12:28.044Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/c4/b4d4827c93ef43c01f599ef31453ccc1c132b353284fc6c87d535c233129/pyee-13.0.1-py3-none-any.whl", hash = "sha256:af2f8fede4171ef667dfded53f96e2ed0d6e6bd7ee3bb46437f77e3b57689228", size = 15659, upload-time = "2026-02-14T21:12:26.263Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]