mdengine 0.5.0__tar.gz → 0.6.0__tar.gz

{mdengine-0.5.0 → mdengine-0.6.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: mdengine
-Version: 0.5.0
-Summary: Convert PDF, Office, images, audio, video, text/JSON/XML, ZIP archives, and web URLs to Markdown.
+Version: 0.6.0
+Summary: Convert PDF, Office, images, audio, video, text/JSON/XML, ZIP archives, web URLs, databases, graphs, and OpenAPI specs to Markdown.
 Author: mdengine contributors
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/vishal7090/md-generator
 Project-URL: Repository, https://github.com/vishal7090/md-generator
 Project-URL: Issues, https://github.com/vishal7090/md-generator/issues
-Keywords: markdown,pdf,docx,pptx,xlsx,ocr,zip,url,html,youtube,playwright,database
+Keywords: markdown,pdf,docx,pptx,xlsx,ocr,zip,url,html,youtube,playwright,database,openapi
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Text Processing :: Markup :: Markdown
@@ -99,6 +99,10 @@ Provides-Extra: graph
 Requires-Dist: networkx>=3.2.0; extra == "graph"
 Requires-Dist: neo4j>=5.14.0; extra == "graph"
 Requires-Dist: pyyaml>=6.0.0; extra == "graph"
+Provides-Extra: openapi
+Requires-Dist: pyyaml>=6.0.0; extra == "openapi"
+Requires-Dist: prance>=23.6.0; extra == "openapi"
+Requires-Dist: openapi-spec-validator>=0.7.0; extra == "openapi"
 Provides-Extra: api
 Requires-Dist: fastapi>=0.115.0; extra == "api"
 Requires-Dist: uvicorn[standard]>=0.32.0; extra == "api"
@@ -120,6 +124,7 @@ Requires-Dist: mdengine[url]; extra == "dev"
 Requires-Dist: mdengine[playwright]; extra == "dev"
 Requires-Dist: mdengine[db]; extra == "dev"
 Requires-Dist: mdengine[graph]; extra == "dev"
+Requires-Dist: mdengine[openapi]; extra == "dev"
 Provides-Extra: all
 Requires-Dist: pymupdf>=1.24.0; extra == "all"
 Requires-Dist: pdfplumber>=0.11.0; extra == "all"
@@ -279,17 +284,26 @@ If the shell reports “command not found”, ensure the Python **Scripts** dire
 | `md-video-mcp` | `md_generator.media.video.api.mcp_server:main` | Same for video |
 | `md-youtube-mcp` | `md_generator.media.youtube.api.mcp_server:main` | Same for YouTube (`youtube_url_to_markdown`) |
 | `md-db` | `md_generator.db.cli.main:main` | `pip install "mdengine[db]"` then `md-db --config db.yaml` (or `mdengine db-to-md …`) |
-| `md-db-api` | `md_generator.db.api.run:main` | FastAPI on port **8010** (`DB_TO_MD_PORT`): `POST /db-to-md/run`, `/db-to-md/job`, SSE `/db-to-md/job/{id}/events` |
+| `md-db-api` | `md_generator.db.api.run:main` | FastAPI on port **8010** (`DB_TO_MD_PORT`): `POST /db-to-md/run`, `POST /db-to-md/run/sqlite` (upload + ZIP), `POST /db-to-md/job`, `POST /db-to-md/job/sqlite` (upload + async job), SSE `/db-to-md/job/{id}/events` |
 | `md-db-mcp` | `md_generator.db.api.mcp_server:main` | Standalone MCP for metadata export tools |
 | `md-graph` | `md_generator.graph.cli.main:main` | `pip install "mdengine[graph]"` then `md-graph --source neo4j --uri bolt://…` (or `mdengine graph-to-md …`) |
 | `md-graph-api` | `md_generator.graph.api.run:main` | FastAPI on port **8012** (`GRAPH_TO_MD_PORT`): `POST /graph-to-md/run`, `/graph-to-md/job`, SSE `/graph-to-md/job/{id}/events` |
 | `md-graph-mcp` | `md_generator.graph.api.mcp_server:main` | Standalone MCP for graph export tools |
-| `mdengine` | `md_generator.engine_cli:main` | `mdengine db-to-md …` / `mdengine graph-to-md …` (delegates to `md-db` / `md-graph`) |
+| `md-openapi` | `md_generator.openapi.cli.main:main` | `pip install "mdengine[openapi]"` then `md-openapi generate --file openapi.yaml --output ./docs` (or `mdengine openapi-to-md generate …`) |
+| `md-openapi-api` | `md_generator.openapi.api.run:main` | FastAPI on port **8015** (`OPENAPI_TO_MD_PORT`): `POST /openapi-to-md/generate` (OpenAPI upload → ZIP), `/health`, MCP at **`/mcp`** |
+| `md-openapi-mcp` | `md_generator.openapi.api.mcp_server:main` | Standalone MCP: `api_validate_openapi_yaml`, `api_generate_readme_markdown`, `api_run_sync_zip_base64` |
+| `mdengine` | `md_generator.engine_cli:main` | `mdengine db-to-md …` / `mdengine graph-to-md …` / `mdengine openapi-to-md generate …` |
+
+**openapi-to-md (`md-openapi`):** OpenAPI **3.x** is parsed directly; **Swagger 2.0** (`swagger: "2.0"`) documents are **converted in-process** to OpenAPI 3.0.3 (deterministic, in-repo converter) before `$ref` resolution. Edge-heavy specs (unusual OAuth2 flows, vendor extensions) may still need fixes after conversion.
 
 **db-to-md ER diagrams:** add **`erd`** to the export feature list (YAML `features.include`, API body, or CLI `--include …,erd`). **Preferred:** **Graphviz** (`dot` on `PATH`, or **`GRAPHVIZ_DOT`**) produces `erd/*.dot`, `erd/*.png`, and `erd/*.svg`. **If Graphviz is missing,** the exporter falls back to **Mermaid** (`erDiagram`): it writes `erd/*.mermaid` plus a fenced **`erd/*.md`** for GitHub-style preview. With **`mermaid-py`** (included in `mdengine[db]`), it also requests **PNG/SVG** via mermaid.ink (requires network unless you self-host mermaid.ink and set **`MERMAID_INK_SERVER`** per [mermaid-py](https://pypi.org/project/mermaid-py/)). Tune **`erd.max_tables`** (default 100) and **`erd.scope`** (`full` \| `per_schema` \| `per_table`) under `erd:` in YAML; CLI: `--erd-max-tables`, `--erd-scope`. Async job SSE uses `progress_update` with `current` starting with `erd:`.
 
 **db-to-md split exports and README merge:** with **`output.split_files: true`**, set **`output.write_combined_feature_markdown: true`** to also write root-level combined Markdown (for example `tables.md`, `functions.md`, `indexes.md`, and feature-specific paths such as `oracle/packages.md` or `mongodb/collections.md` when those features run). Set **`output.readme_feature_merge`** to **`inline`** (append full bundle bodies into `README.md`) or **`toc`** (append a linked list to those files). If merge is not **`none`** and split files are on, combined bundle writes are turned on automatically when loading config. CLI: `--write-combined-feature-markdown`, `--readme-feature-merge none|inline|toc`.
 
+**db-to-md SQLite:** set **`database.type: sqlite`** and **`database.uri`** to a SQLAlchemy URL such as **`sqlite:///my.db`** or **`sqlite:////C:/data/my.db`**. The default SQLite catalog is **`main`**; packaged YAML that still has **`schema: public`** is normalized to **`main`** when the type is SQLite. CLI: **`--type sqlite`**. Stored routines, sequences, and partitions are not used by SQLite and stay empty; tables, indexes, views, triggers, and ERD (via FK introspection) follow the same export path as other SQL engines.
+
+**db-to-md API SQLite upload:** **`POST /db-to-md/run/sqlite`** — `multipart/form-data` with field **`file`** (the `.sqlite` / `.db` bytes; must start with the standard `SQLite format 3` header) and optional **`config`** (JSON string with the same shape as a normal run body minus `database`: `schema`, `output`, `features`, `execution`, `limits`, `erd`). Returns the metadata ZIP immediately. **`POST /db-to-md/job/sqlite`** — same form fields; saves the file under the job workspace and runs the existing job pipeline (`GET /db-to-md/job/{id}/download` when complete). Upload size cap: env **`DB_TO_MD_MAX_SQLITE_UPLOAD_MB`** (default **256**). Large ZIPs may still require the async job path if they exceed **`DB_TO_MD_MAX_SYNC_ZIP_MB`** on the sync upload route.
+
 **graph-to-md (Neo4j + NetworkX):** library lives under [`md_generator/graph/`](src/md_generator/graph/). **Sources:** **`networkx`** (GraphML/GML via `graph.graph_file` or `--graph-file`) or **`neo4j`** (`graph.uri`, `graph.user`, `graph.password`, optional `graph.database` for `session(database=…)`). **Output layout:** by default **`output.combine_markdown: true`** writes **`nodes.md`**, **`relationship.md`**, and **`graph_summary.md`** (summary plus embedded nodes and relationships). Set **`combine_markdown: false`** or CLI **`--individual` / `--markdown-layout individual`** for per-entity files under **`nodes/`** and **`relationships/`**. **Diagrams:** **`viz.mermaid: true`** (default) writes **`graph/graph.mmd`** and embeds a fenced Mermaid block in the export **`README.md`** (no Graphviz required). **`viz.enabled: true`** or CLI **`--viz`** also writes **`graph/graph.dot`** and runs **`dot`** for PNG/SVG/PDF when Graphviz is on `PATH` (or **`GRAPHVIZ_DOT`**). CLI **`--no-mermaid`** disables Mermaid; **`--depth`**, **`--start-node`**, **`--max-nodes`**, **`--max-edges`** bound traversal. Packaged defaults: [`src/md_generator/graph/config/default.yaml`](src/md_generator/graph/config/default.yaml). Tests: **`graph-to-md/tests/`**; API image: [`graph-to-md/Dockerfile.api`](graph-to-md/Dockerfile.api).
 
 Every command accepts **`-h` / `--help`** for full flags (artifact layout, OCR, ZIP options, etc.).
@@ -606,7 +620,7 @@ Equivalent modules: `python -m md_generator.media.audio.api.mcp_server`, `python
 
 ### Thin shims (repo clone)
 
-[`audio-to-md/converter.py`](audio-to-md/converter.py), [`video-to-md/converter.py`](video-to-md/converter.py), and [`youtube-to-md/converter.py`](youtube-to-md/converter.py) delegate to the same `main` as `md-audio` / `md-video` / `md-youtube`. Tests and `pytest.ini` live under `audio-to-md/tests/`, `video-to-md/tests/`, and `youtube-to-md/tests/`. [`db-to-md/converter.py`](db-to-md/converter.py) delegates to `md-db`; tests live under `db-to-md/tests/`. **graph-to-md** uses `md-graph` / `mdengine graph-to-md` directly (no thin `converter.py` shim); tests live under [`graph-to-md/tests/`](graph-to-md/tests/).
+[`audio-to-md/converter.py`](audio-to-md/converter.py), [`video-to-md/converter.py`](video-to-md/converter.py), and [`youtube-to-md/converter.py`](youtube-to-md/converter.py) delegate to the same `main` as `md-audio` / `md-video` / `md-youtube`. Tests and `pytest.ini` live under `audio-to-md/tests/`, `video-to-md/tests/`, and `youtube-to-md/tests/`. [`db-to-md/converter.py`](db-to-md/converter.py) delegates to `md-db`; tests live under `db-to-md/tests/`. **graph-to-md** uses `md-graph` / `mdengine graph-to-md` directly (no thin `converter.py` shim); tests live under [`graph-to-md/tests/`](graph-to-md/tests/). [`openapi-to-md/converter.py`](openapi-to-md/converter.py) delegates to `md-openapi`; tests live under [`openapi-to-md/tests/`](openapi-to-md/tests/); example OpenAPI and output notes: [`openapi-to-md/examples/`](openapi-to-md/examples/).
 
 ---
 
@@ -638,6 +652,7 @@ Install `mdengine[api]` plus the format extra(s), then run the **`app`** object
 | Playwright / SPA | `md_generator.playwright.api.main:app` | `playwright`, `api`, `mcp` |
 | Database metadata | `md_generator.db.api.main:app` | `db`, `api`, `mcp` |
 | Graph metadata (Neo4j / NetworkX) | `md_generator.graph.api.main:app` | `graph`, `api`, `mcp` |
+| OpenAPI → Markdown | `md_generator.openapi.api.main:app` | `openapi`, `api`, `mcp` |
 | Audio (Whisper) | `md_generator.media.audio.api.main:create_app` (use **`--factory`**) or `…main:app` | `audio`, `api`, `mcp` |
 | Video (Whisper) | `md_generator.media.video.api.main:create_app` (use **`--factory`**) or `…main:app` | `video`, `api`, `mcp` |
 | YouTube | `md_generator.media.youtube.api.main:create_app` (use **`--factory`**) or `…main:app` | `youtube`, `api`, `mcp` |
@@ -651,12 +666,13 @@ uvicorn md_generator.archive.api.main:app --host 127.0.0.1 --port 8010
 uvicorn md_generator.url.api.main:app --host 127.0.0.1 --port 8011
 uvicorn md_generator.playwright.api.main:app --host 127.0.0.1 --port 8014
 uvicorn md_generator.graph.api.main:app --host 127.0.0.1 --port 8012
+uvicorn md_generator.openapi.api.main:app --host 127.0.0.1 --port 8015
 uvicorn md_generator.media.audio.api.main:create_app --factory --host 127.0.0.1 --port 8011
 uvicorn md_generator.media.video.api.main:create_app --factory --host 127.0.0.1 --port 8012
 uvicorn md_generator.media.youtube.api.main:create_app --factory --host 127.0.0.1 --port 8013
 ```
 
-**Port note:** **`md-graph-api`** and **`md-video-api`** both default to **8012**; set **`GRAPH_TO_MD_PORT`** or **`MD_VIDEO_API_PORT`** when you need both on one machine.
+**Port note:** **`md-graph-api`** and **`md-video-api`** both default to **8012**; set **`GRAPH_TO_MD_PORT`** or **`MD_VIDEO_API_PORT`** when you need both on one machine. **`md-openapi-api`** defaults to **8015** (`OPENAPI_TO_MD_PORT`) so it does not collide with **`md-youtube-api`** (**8013**) or **`md-playwright-api`** (**8014**).
 
 ### MCP over HTTP on the same server
 
@@ -678,6 +694,7 @@ Prefixes differ per service (often read from a `.env` file next to the process):
 | Playwright / SPA | `PLAYWRIGHT_TO_MD_` | `PLAYWRIGHT_TO_MD_MAX_SYNC_URLS`, `PLAYWRIGHT_TO_MD_MAX_JOB_URLS`, `PLAYWRIGHT_TO_MD_JOB_TTL_SECONDS`, `PLAYWRIGHT_TO_MD_TEMP_DIR`, `PLAYWRIGHT_TO_MD_CORS_ORIGINS`, `PLAYWRIGHT_TO_MD_API_HOST`, `PLAYWRIGHT_TO_MD_API_PORT` (default **8014**) |
 | Database metadata | `DB_TO_MD_` | `DB_TO_MD_JOB_SQLITE_PATH`, `DB_TO_MD_JOB_WORKSPACE_ROOT`, `DB_TO_MD_CORS_ORIGINS`, `DB_TO_MD_MAX_SYNC_ZIP_MB`, `DB_TO_MD_HOST`, `DB_TO_MD_PORT` (default **8010**) |
 | Graph metadata | `GRAPH_TO_MD_` | `GRAPH_TO_MD_JOB_SQLITE_PATH`, `GRAPH_TO_MD_JOB_WORKSPACE_ROOT`, `GRAPH_TO_MD_CORS_ORIGINS`, `GRAPH_TO_MD_MAX_SYNC_ZIP_MB`, `GRAPH_TO_MD_HOST`, `GRAPH_TO_MD_PORT` (default **8012**) |
+| OpenAPI → Markdown | `OPENAPI_TO_MD_` | `OPENAPI_TO_MD_CORS_ORIGINS`, `OPENAPI_TO_MD_MAX_SYNC_ZIP_MB`, `OPENAPI_TO_MD_HOST`, `OPENAPI_TO_MD_PORT` (default **8015**) |
 | Audio API | `MD_AUDIO_` | `MD_AUDIO_MAX_UPLOAD_MB`, `MD_AUDIO_MAX_SYNC_UPLOAD_MB`, `MD_AUDIO_JOB_TTL_SECONDS`, `MD_AUDIO_TEMP_DIR`, `MD_AUDIO_CORS_ORIGINS`, `MD_AUDIO_API_HOST`, `MD_AUDIO_API_PORT` |
 | Video API | `MD_VIDEO_` | Same pattern as audio with `MD_VIDEO_*` (defaults: larger upload/sync caps, port **8012**) |
 | YouTube API | `MD_YOUTUBE_` | `MD_YOUTUBE_JOB_TTL_SECONDS`, `MD_YOUTUBE_TEMP_DIR`, `MD_YOUTUBE_CORS_ORIGINS`, `MD_YOUTUBE_API_HOST`, `MD_YOUTUBE_API_PORT` (default **8013**); optional `MD_YOUTUBE_YTDLP` path for audio fallback |
@@ -710,6 +727,7 @@ Two usage patterns:
 | YouTube | `md-youtube-mcp` or `python -m md_generator.media.youtube.api.mcp_server` — same transports |
 | Database metadata | `md-db-mcp` or `python -m md_generator.db.api.mcp_server` — `--transport stdio` (default), `sse`, `streamable-http` |
 | Graph (Neo4j / NetworkX) | `md-graph-mcp` or `python -m md_generator.graph.api.mcp_server` — `--transport stdio` (default), `sse`, `streamable-http` |
+| OpenAPI → Markdown | `md-openapi-mcp` or `python -m md_generator.openapi.api.mcp_server` — `--transport stdio` (default), `sse`, `streamable-http` |
 
 **Word** and **XLSX** also ship a small runner script in the repo:
 
@@ -734,7 +752,7 @@ pip install -e ".[dev,all]"   # or a smaller subset of extras
 python -m pytest
 ```
 
-Tests live under each legacy folder’s `tests/` directory (e.g. `pdf-to-md/tests/`) and **`graph-to-md/tests/`**; `pyproject.toml` configures `pythonpath = ["src"]` so `md_generator` resolves without a separate `PYTHONPATH`.
+Tests live under each legacy folder’s `tests/` directory (e.g. `pdf-to-md/tests/`), **`graph-to-md/tests/`**, and **`openapi-to-md/tests/`**; `pyproject.toml` configures `pythonpath = ["src"]` so `md_generator` resolves without a separate `PYTHONPATH`.
 
 ---
 

{mdengine-0.5.0 → mdengine-0.6.0}/README.md

@@ -129,17 +129,26 @@ If the shell reports “command not found”, ensure the Python **Scripts** dire
 | `md-video-mcp` | `md_generator.media.video.api.mcp_server:main` | Same for video |
 | `md-youtube-mcp` | `md_generator.media.youtube.api.mcp_server:main` | Same for YouTube (`youtube_url_to_markdown`) |
 | `md-db` | `md_generator.db.cli.main:main` | `pip install "mdengine[db]"` then `md-db --config db.yaml` (or `mdengine db-to-md …`) |
-| `md-db-api` | `md_generator.db.api.run:main` | FastAPI on port **8010** (`DB_TO_MD_PORT`): `POST /db-to-md/run`, `/db-to-md/job`, SSE `/db-to-md/job/{id}/events` |
+| `md-db-api` | `md_generator.db.api.run:main` | FastAPI on port **8010** (`DB_TO_MD_PORT`): `POST /db-to-md/run`, `POST /db-to-md/run/sqlite` (upload + ZIP), `POST /db-to-md/job`, `POST /db-to-md/job/sqlite` (upload + async job), SSE `/db-to-md/job/{id}/events` |
 | `md-db-mcp` | `md_generator.db.api.mcp_server:main` | Standalone MCP for metadata export tools |
 | `md-graph` | `md_generator.graph.cli.main:main` | `pip install "mdengine[graph]"` then `md-graph --source neo4j --uri bolt://…` (or `mdengine graph-to-md …`) |
 | `md-graph-api` | `md_generator.graph.api.run:main` | FastAPI on port **8012** (`GRAPH_TO_MD_PORT`): `POST /graph-to-md/run`, `/graph-to-md/job`, SSE `/graph-to-md/job/{id}/events` |
 | `md-graph-mcp` | `md_generator.graph.api.mcp_server:main` | Standalone MCP for graph export tools |
-| `mdengine` | `md_generator.engine_cli:main` | `mdengine db-to-md …` / `mdengine graph-to-md …` (delegates to `md-db` / `md-graph`) |
+| `md-openapi` | `md_generator.openapi.cli.main:main` | `pip install "mdengine[openapi]"` then `md-openapi generate --file openapi.yaml --output ./docs` (or `mdengine openapi-to-md generate …`) |
+| `md-openapi-api` | `md_generator.openapi.api.run:main` | FastAPI on port **8015** (`OPENAPI_TO_MD_PORT`): `POST /openapi-to-md/generate` (OpenAPI upload → ZIP), `/health`, MCP at **`/mcp`** |
+| `md-openapi-mcp` | `md_generator.openapi.api.mcp_server:main` | Standalone MCP: `api_validate_openapi_yaml`, `api_generate_readme_markdown`, `api_run_sync_zip_base64` |
+| `mdengine` | `md_generator.engine_cli:main` | `mdengine db-to-md …` / `mdengine graph-to-md …` / `mdengine openapi-to-md generate …` |
+
+**openapi-to-md (`md-openapi`):** OpenAPI **3.x** is parsed directly; **Swagger 2.0** (`swagger: "2.0"`) documents are **converted in-process** to OpenAPI 3.0.3 (deterministic, in-repo converter) before `$ref` resolution. Edge-heavy specs (unusual OAuth2 flows, vendor extensions) may still need fixes after conversion.
 
 **db-to-md ER diagrams:** add **`erd`** to the export feature list (YAML `features.include`, API body, or CLI `--include …,erd`). **Preferred:** **Graphviz** (`dot` on `PATH`, or **`GRAPHVIZ_DOT`**) produces `erd/*.dot`, `erd/*.png`, and `erd/*.svg`. **If Graphviz is missing,** the exporter falls back to **Mermaid** (`erDiagram`): it writes `erd/*.mermaid` plus a fenced **`erd/*.md`** for GitHub-style preview. With **`mermaid-py`** (included in `mdengine[db]`), it also requests **PNG/SVG** via mermaid.ink (requires network unless you self-host mermaid.ink and set **`MERMAID_INK_SERVER`** per [mermaid-py](https://pypi.org/project/mermaid-py/)). Tune **`erd.max_tables`** (default 100) and **`erd.scope`** (`full` \| `per_schema` \| `per_table`) under `erd:` in YAML; CLI: `--erd-max-tables`, `--erd-scope`. Async job SSE uses `progress_update` with `current` starting with `erd:`.
 
 **db-to-md split exports and README merge:** with **`output.split_files: true`**, set **`output.write_combined_feature_markdown: true`** to also write root-level combined Markdown (for example `tables.md`, `functions.md`, `indexes.md`, and feature-specific paths such as `oracle/packages.md` or `mongodb/collections.md` when those features run). Set **`output.readme_feature_merge`** to **`inline`** (append full bundle bodies into `README.md`) or **`toc`** (append a linked list to those files). If merge is not **`none`** and split files are on, combined bundle writes are turned on automatically when loading config. CLI: `--write-combined-feature-markdown`, `--readme-feature-merge none|inline|toc`.
 
+**db-to-md SQLite:** set **`database.type: sqlite`** and **`database.uri`** to a SQLAlchemy URL such as **`sqlite:///my.db`** or **`sqlite:////C:/data/my.db`**. The default SQLite catalog is **`main`**; packaged YAML that still has **`schema: public`** is normalized to **`main`** when the type is SQLite. CLI: **`--type sqlite`**. Stored routines, sequences, and partitions are not used by SQLite and stay empty; tables, indexes, views, triggers, and ERD (via FK introspection) follow the same export path as other SQL engines.
+
+**db-to-md API SQLite upload:** **`POST /db-to-md/run/sqlite`** — `multipart/form-data` with field **`file`** (the `.sqlite` / `.db` bytes; must start with the standard `SQLite format 3` header) and optional **`config`** (JSON string with the same shape as a normal run body minus `database`: `schema`, `output`, `features`, `execution`, `limits`, `erd`). Returns the metadata ZIP immediately. **`POST /db-to-md/job/sqlite`** — same form fields; saves the file under the job workspace and runs the existing job pipeline (`GET /db-to-md/job/{id}/download` when complete). Upload size cap: env **`DB_TO_MD_MAX_SQLITE_UPLOAD_MB`** (default **256**). Large ZIPs may still require the async job path if they exceed **`DB_TO_MD_MAX_SYNC_ZIP_MB`** on the sync upload route.
+
 **graph-to-md (Neo4j + NetworkX):** library lives under [`md_generator/graph/`](src/md_generator/graph/). **Sources:** **`networkx`** (GraphML/GML via `graph.graph_file` or `--graph-file`) or **`neo4j`** (`graph.uri`, `graph.user`, `graph.password`, optional `graph.database` for `session(database=…)`). **Output layout:** by default **`output.combine_markdown: true`** writes **`nodes.md`**, **`relationship.md`**, and **`graph_summary.md`** (summary plus embedded nodes and relationships). Set **`combine_markdown: false`** or CLI **`--individual` / `--markdown-layout individual`** for per-entity files under **`nodes/`** and **`relationships/`**. **Diagrams:** **`viz.mermaid: true`** (default) writes **`graph/graph.mmd`** and embeds a fenced Mermaid block in the export **`README.md`** (no Graphviz required). **`viz.enabled: true`** or CLI **`--viz`** also writes **`graph/graph.dot`** and runs **`dot`** for PNG/SVG/PDF when Graphviz is on `PATH` (or **`GRAPHVIZ_DOT`**). CLI **`--no-mermaid`** disables Mermaid; **`--depth`**, **`--start-node`**, **`--max-nodes`**, **`--max-edges`** bound traversal. Packaged defaults: [`src/md_generator/graph/config/default.yaml`](src/md_generator/graph/config/default.yaml). Tests: **`graph-to-md/tests/`**; API image: [`graph-to-md/Dockerfile.api`](graph-to-md/Dockerfile.api).
 
 Every command accepts **`-h` / `--help`** for full flags (artifact layout, OCR, ZIP options, etc.).
@@ -456,7 +465,7 @@ Equivalent modules: `python -m md_generator.media.audio.api.mcp_server`, `python
 
 ### Thin shims (repo clone)
 
-[`audio-to-md/converter.py`](audio-to-md/converter.py), [`video-to-md/converter.py`](video-to-md/converter.py), and [`youtube-to-md/converter.py`](youtube-to-md/converter.py) delegate to the same `main` as `md-audio` / `md-video` / `md-youtube`. Tests and `pytest.ini` live under `audio-to-md/tests/`, `video-to-md/tests/`, and `youtube-to-md/tests/`. [`db-to-md/converter.py`](db-to-md/converter.py) delegates to `md-db`; tests live under `db-to-md/tests/`. **graph-to-md** uses `md-graph` / `mdengine graph-to-md` directly (no thin `converter.py` shim); tests live under [`graph-to-md/tests/`](graph-to-md/tests/).
+[`audio-to-md/converter.py`](audio-to-md/converter.py), [`video-to-md/converter.py`](video-to-md/converter.py), and [`youtube-to-md/converter.py`](youtube-to-md/converter.py) delegate to the same `main` as `md-audio` / `md-video` / `md-youtube`. Tests and `pytest.ini` live under `audio-to-md/tests/`, `video-to-md/tests/`, and `youtube-to-md/tests/`. [`db-to-md/converter.py`](db-to-md/converter.py) delegates to `md-db`; tests live under `db-to-md/tests/`. **graph-to-md** uses `md-graph` / `mdengine graph-to-md` directly (no thin `converter.py` shim); tests live under [`graph-to-md/tests/`](graph-to-md/tests/). [`openapi-to-md/converter.py`](openapi-to-md/converter.py) delegates to `md-openapi`; tests live under [`openapi-to-md/tests/`](openapi-to-md/tests/); example OpenAPI and output notes: [`openapi-to-md/examples/`](openapi-to-md/examples/).
 
 ---
 
@@ -488,6 +497,7 @@ Install `mdengine[api]` plus the format extra(s), then run the **`app`** object
 | Playwright / SPA | `md_generator.playwright.api.main:app` | `playwright`, `api`, `mcp` |
 | Database metadata | `md_generator.db.api.main:app` | `db`, `api`, `mcp` |
 | Graph metadata (Neo4j / NetworkX) | `md_generator.graph.api.main:app` | `graph`, `api`, `mcp` |
+| OpenAPI → Markdown | `md_generator.openapi.api.main:app` | `openapi`, `api`, `mcp` |
 | Audio (Whisper) | `md_generator.media.audio.api.main:create_app` (use **`--factory`**) or `…main:app` | `audio`, `api`, `mcp` |
 | Video (Whisper) | `md_generator.media.video.api.main:create_app` (use **`--factory`**) or `…main:app` | `video`, `api`, `mcp` |
 | YouTube | `md_generator.media.youtube.api.main:create_app` (use **`--factory`**) or `…main:app` | `youtube`, `api`, `mcp` |
@@ -501,12 +511,13 @@ uvicorn md_generator.archive.api.main:app --host 127.0.0.1 --port 8010
 uvicorn md_generator.url.api.main:app --host 127.0.0.1 --port 8011
 uvicorn md_generator.playwright.api.main:app --host 127.0.0.1 --port 8014
 uvicorn md_generator.graph.api.main:app --host 127.0.0.1 --port 8012
+uvicorn md_generator.openapi.api.main:app --host 127.0.0.1 --port 8015
 uvicorn md_generator.media.audio.api.main:create_app --factory --host 127.0.0.1 --port 8011
 uvicorn md_generator.media.video.api.main:create_app --factory --host 127.0.0.1 --port 8012
 uvicorn md_generator.media.youtube.api.main:create_app --factory --host 127.0.0.1 --port 8013
 ```
 
-**Port note:** **`md-graph-api`** and **`md-video-api`** both default to **8012**; set **`GRAPH_TO_MD_PORT`** or **`MD_VIDEO_API_PORT`** when you need both on one machine.
+**Port note:** **`md-graph-api`** and **`md-video-api`** both default to **8012**; set **`GRAPH_TO_MD_PORT`** or **`MD_VIDEO_API_PORT`** when you need both on one machine. **`md-openapi-api`** defaults to **8015** (`OPENAPI_TO_MD_PORT`) so it does not collide with **`md-youtube-api`** (**8013**) or **`md-playwright-api`** (**8014**).
 
 ### MCP over HTTP on the same server
 
@@ -528,6 +539,7 @@ Prefixes differ per service (often read from a `.env` file next to the process):
 | Playwright / SPA | `PLAYWRIGHT_TO_MD_` | `PLAYWRIGHT_TO_MD_MAX_SYNC_URLS`, `PLAYWRIGHT_TO_MD_MAX_JOB_URLS`, `PLAYWRIGHT_TO_MD_JOB_TTL_SECONDS`, `PLAYWRIGHT_TO_MD_TEMP_DIR`, `PLAYWRIGHT_TO_MD_CORS_ORIGINS`, `PLAYWRIGHT_TO_MD_API_HOST`, `PLAYWRIGHT_TO_MD_API_PORT` (default **8014**) |
 | Database metadata | `DB_TO_MD_` | `DB_TO_MD_JOB_SQLITE_PATH`, `DB_TO_MD_JOB_WORKSPACE_ROOT`, `DB_TO_MD_CORS_ORIGINS`, `DB_TO_MD_MAX_SYNC_ZIP_MB`, `DB_TO_MD_HOST`, `DB_TO_MD_PORT` (default **8010**) |
 | Graph metadata | `GRAPH_TO_MD_` | `GRAPH_TO_MD_JOB_SQLITE_PATH`, `GRAPH_TO_MD_JOB_WORKSPACE_ROOT`, `GRAPH_TO_MD_CORS_ORIGINS`, `GRAPH_TO_MD_MAX_SYNC_ZIP_MB`, `GRAPH_TO_MD_HOST`, `GRAPH_TO_MD_PORT` (default **8012**) |
+| OpenAPI → Markdown | `OPENAPI_TO_MD_` | `OPENAPI_TO_MD_CORS_ORIGINS`, `OPENAPI_TO_MD_MAX_SYNC_ZIP_MB`, `OPENAPI_TO_MD_HOST`, `OPENAPI_TO_MD_PORT` (default **8015**) |
 | Audio API | `MD_AUDIO_` | `MD_AUDIO_MAX_UPLOAD_MB`, `MD_AUDIO_MAX_SYNC_UPLOAD_MB`, `MD_AUDIO_JOB_TTL_SECONDS`, `MD_AUDIO_TEMP_DIR`, `MD_AUDIO_CORS_ORIGINS`, `MD_AUDIO_API_HOST`, `MD_AUDIO_API_PORT` |
 | Video API | `MD_VIDEO_` | Same pattern as audio with `MD_VIDEO_*` (defaults: larger upload/sync caps, port **8012**) |
 | YouTube API | `MD_YOUTUBE_` | `MD_YOUTUBE_JOB_TTL_SECONDS`, `MD_YOUTUBE_TEMP_DIR`, `MD_YOUTUBE_CORS_ORIGINS`, `MD_YOUTUBE_API_HOST`, `MD_YOUTUBE_API_PORT` (default **8013**); optional `MD_YOUTUBE_YTDLP` path for audio fallback |
@@ -560,6 +572,7 @@ Two usage patterns:
 | YouTube | `md-youtube-mcp` or `python -m md_generator.media.youtube.api.mcp_server` — same transports |
 | Database metadata | `md-db-mcp` or `python -m md_generator.db.api.mcp_server` — `--transport stdio` (default), `sse`, `streamable-http` |
 | Graph (Neo4j / NetworkX) | `md-graph-mcp` or `python -m md_generator.graph.api.mcp_server` — `--transport stdio` (default), `sse`, `streamable-http` |
+| OpenAPI → Markdown | `md-openapi-mcp` or `python -m md_generator.openapi.api.mcp_server` — `--transport stdio` (default), `sse`, `streamable-http` |
 
 **Word** and **XLSX** also ship a small runner script in the repo:
 
@@ -584,7 +597,7 @@ pip install -e ".[dev,all]"   # or a smaller subset of extras
 python -m pytest
 ```
 
-Tests live under each legacy folder’s `tests/` directory (e.g. `pdf-to-md/tests/`) and **`graph-to-md/tests/`**; `pyproject.toml` configures `pythonpath = ["src"]` so `md_generator` resolves without a separate `PYTHONPATH`.
+Tests live under each legacy folder’s `tests/` directory (e.g. `pdf-to-md/tests/`), **`graph-to-md/tests/`**, and **`openapi-to-md/tests/`**; `pyproject.toml` configures `pythonpath = ["src"]` so `md_generator` resolves without a separate `PYTHONPATH`.
 
 ---
 

{mdengine-0.5.0 → mdengine-0.6.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mdengine"
-version = "0.5.0"
-description = "Convert PDF, Office, images, audio, video, text/JSON/XML, ZIP archives, and web URLs to Markdown."
+version = "0.6.0"
+description = "Convert PDF, Office, images, audio, video, text/JSON/XML, ZIP archives, web URLs, databases, graphs, and OpenAPI specs to Markdown."
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [{ name = "mdengine contributors" }]
-keywords = ["markdown", "pdf", "docx", "pptx", "xlsx", "ocr", "zip", "url", "html", "youtube", "playwright", "database"]
+keywords = ["markdown", "pdf", "docx", "pptx", "xlsx", "ocr", "zip", "url", "html", "youtube", "playwright", "database", "openapi"]
 classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
@@ -106,6 +106,11 @@ graph = [
   "neo4j>=5.14.0",
   "pyyaml>=6.0.0",
 ]
+openapi = [
+  "pyyaml>=6.0.0",
+  "prance>=23.6.0",
+  "openapi-spec-validator>=0.7.0",
+]
 api = [
   "fastapi>=0.115.0",
   "uvicorn[standard]>=0.32.0",
@@ -126,6 +131,7 @@ dev = [
   "mdengine[playwright]",
   "mdengine[db]",
   "mdengine[graph]",
+  "mdengine[openapi]",
 ]
 all = [
   "pymupdf>=1.24.0",
@@ -187,6 +193,9 @@ md-db-mcp = "md_generator.db.api.mcp_server:main"
 md-graph = "md_generator.graph.cli.main:main"
 md-graph-api = "md_generator.graph.api.run:main"
 md-graph-mcp = "md_generator.graph.api.mcp_server:main"
+md-openapi = "md_generator.openapi.cli.main:main"
+md-openapi-api = "md_generator.openapi.api.run:main"
+md-openapi-mcp = "md_generator.openapi.api.mcp_server:main"
 mdengine = "md_generator.engine_cli:main"
 
 [tool.setuptools.packages.find]
@@ -195,6 +204,7 @@ where = ["src"]
 [tool.setuptools.package-data]
 "md_generator.db.config" = ["*.yaml"]
 "md_generator.graph.config" = ["*.yaml"]
+"md_generator.openapi.config" = ["*.yaml"]
 
 [tool.pytest.ini_options]
 pythonpath = ["src"]
@@ -213,5 +223,6 @@ testpaths = [
   "playwright-to-md/tests",
   "db-to-md/tests",
   "graph-to-md/tests",
+  "openapi-to-md/tests",
 ]
 markers = ["integration: optional dependency or slower checks"]

{mdengine-0.5.0 → mdengine-0.6.0}/src/md_generator/__init__.py

@@ -1,5 +1,5 @@
 """md_generator: PDF, Office, image, text, and ZIP to Markdown conversion."""
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"
 
 __all__ = ["__version__"]

{mdengine-0.5.0 → mdengine-0.6.0}/src/md_generator/db/adapters/factory.py

@@ -8,6 +8,7 @@ from md_generator.db.adapters.mongo_adapter import MongoAdapter
 from md_generator.db.adapters.mysql_adapter import MysqlAdapter
 from md_generator.db.adapters.oracle_adapter import OracleAdapter
 from md_generator.db.adapters.postgres_adapter import PostgresAdapter
+from md_generator.db.adapters.sqlite_adapter import SqliteAdapter
 from md_generator.db.core.base_adapter import BaseAdapter
 
 
@@ -37,4 +38,9 @@ def create_adapter(
         if not database:
             raise ValueError("MongoDB requires database name in config or --database")
         return MongoAdapter(uri, database, lim)
+    if t in ("sqlite",):
+        sch = (schema or "main").strip()
+        if sch.lower() == "public":
+            sch = "main"
+        return SqliteAdapter(uri, sch, lim)
     raise ValueError(f"Unsupported database type: {db_type!r}")

mdengine-0.6.0/src/md_generator/db/adapters/sqlite_adapter.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+import re
+from typing import Any
+
+from sqlalchemy import create_engine, text
+from sqlalchemy.pool import NullPool
+
+from md_generator.db.adapters.sql_common import SqlAlchemyAdapter, indexes_from_inspector, table_detail_from_inspector
+from md_generator.db.core.models import IndexInfo, TableDetail, TableInfo, TriggerInfo, ViewInfo
+
+_ATTACH_NAME = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
+
+
+def _normalize_sqlite_uri(uri: str) -> str:
+    u = uri.strip()
+    if u.startswith("sqlite://") and "+pysqlite" not in u and "+aiosqlite" not in u:
+        return u.replace("sqlite://", "sqlite+pysqlite://", 1)
+    return u
+
+
+def _sqlite_master_expr(schema: str) -> str:
+    """Return SQL fragment for sqlite_master of the given catalog (``main`` or attach name)."""
+    s = (schema or "main").strip()
+    if s.lower() == "main":
+        return "sqlite_master"
+    if not _ATTACH_NAME.fullmatch(s):
+        raise ValueError(f"Invalid SQLite catalog/schema name: {schema!r} (use main or an attach alias)")
+    return f'"{s}".sqlite_master'
+
+
+class SqliteAdapter(SqlAlchemyAdapter):
+    db_type = "sqlite"
+
+    def __init__(self, uri: str, schema: str, limits: dict[str, Any]) -> None:
+        eng = create_engine(
+            _normalize_sqlite_uri(uri),
+            poolclass=NullPool,
+            pool_pre_ping=True,
+            connect_args={"check_same_thread": False},
+            future=True,
+        )
+        super().__init__(eng, schema, limits)
+
+    def validate_connection(self) -> None:
+        with self._engine.connect() as conn:
+            conn.execute(text("SELECT 1"))
+
+    def get_tables(self) -> list[TableInfo]:
+        insp = self._inspector()
+        sch = self._schema or "main"
+        names = insp.get_table_names(schema=sch)
+        max_t = int(self._limits.get("max_tables", 10_000))
+        out = [TableInfo(schema=sch, name=n) for n in sorted(names)[:max_t]]
+        return out
+
+    def get_table_detail(self, table: TableInfo) -> TableDetail:
+        return table_detail_from_inspector(self._inspector(), self._schema, table)
+
+    def get_indexes(self, table: TableInfo) -> list[IndexInfo]:
+        return indexes_from_inspector(self._inspector(), self._schema, table)
+
+    def get_views(self) -> list[ViewInfo]:
+        sch = self._schema or "main"
+        master = _sqlite_master_expr(sch)
+        q = text(f"SELECT name, sql FROM {master} WHERE type = 'view' AND sql IS NOT NULL ORDER BY name")
+        out: list[ViewInfo] = []
+        try:
+            with self._engine.connect() as conn:
+                for row in conn.execute(q).mappings():
+                    out.append(
+                        ViewInfo(
+                            schema=sch,
+                            name=str(row["name"]),
+                            definition=str(row["sql"]) if row.get("sql") is not None else None,
+                        )
+                    )
+        except Exception:
+            return []
+        return out
+
+    def get_triggers(self) -> list[TriggerInfo]:
+        sch = self._schema or "main"
+        master = _sqlite_master_expr(sch)
+        q = text(
+            f"SELECT name, tbl_name, sql FROM {master} "
+            "WHERE type = 'trigger' AND sql IS NOT NULL ORDER BY tbl_name, name"
+        )
+        out: list[TriggerInfo] = []
+        try:
+            with self._engine.connect() as conn:
+                for row in conn.execute(q).mappings():
+                    sql = row.get("sql")
+                    out.append(
+                        TriggerInfo(
+                            schema=sch,
+                            name=str(row["name"]),
+                            table_schema=sch,
+                            table_name=str(row["tbl_name"]),
+                            definition=str(sql) if sql is not None else None,
+                            timing=None,
+                            events=None,
+                        )
+                    )
+        except Exception:
+            return []
+        return out

{mdengine-0.5.0 → mdengine-0.6.0}/src/md_generator/db/api/main.py

@@ -1,18 +1,22 @@
 from __future__ import annotations
 
 import asyncio
+import json
 import zipfile
 from contextlib import asynccontextmanager
 from pathlib import Path
 
-from fastapi import FastAPI, HTTPException, Request
+from fastapi import FastAPI, File, Form, HTTPException, Request, UploadFile
+from pydantic import ValidationError
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import FileResponse, Response, StreamingResponse
 from starlette.background import BackgroundTask
 
 from md_generator.db.api.schemas import DbToMdRunBody
 from md_generator.db.api.settings import DbApiSettings, cors_list, sqlite_path_resolved
+from md_generator.db.api.sqlite_upload import parse_sqlite_upload_config_json
 from md_generator.db.core.job_manager import JobManager
+from md_generator.db.core.util import is_sqlite_database_bytes, sqlite_uri_for_path
 from md_generator.db.core.zip_export import build_markdown_zip_bytes
 from md_generator.db.mcp.server import build_mcp_stack
 from md_generator.db.mcp.sse import format_sse
@@ -50,6 +54,90 @@ async def health() -> dict[str, str]:
     return {"status": "ok"}
 
 
+@app.post("/db-to-md/run/sqlite")
+async def db_run_sqlite_upload(
+    request: Request,
+    file: UploadFile = File(..., description="SQLite .db / .sqlite file (SQLite format 3)"),
+    config: str | None = Form(None, description="Optional JSON object: schema, output, features, execution, limits, erd"),
+) -> Response:
+    """Sync export: upload a SQLite file, run db-to-md, return a ZIP (same limits as ``/db-to-md/run``)."""
+    import tempfile
+
+    settings: DbApiSettings = request.app.state.settings
+    max_upload = max(1, settings.max_sqlite_upload_mb) * 1024 * 1024
+    data = await file.read()
+    if len(data) > max_upload:
+        raise HTTPException(
+            status_code=413,
+            detail=f"SQLite upload exceeds DB_TO_MD_MAX_SQLITE_UPLOAD_MB ({settings.max_sqlite_upload_mb})",
+        )
+    if not is_sqlite_database_bytes(data):
+        raise HTTPException(
+            status_code=400,
+            detail="File is not a SQLite database (expected 'SQLite format 3' header)",
+        )
+    try:
+        opts = parse_sqlite_upload_config_json(config)
+    except (ValueError, ValidationError) as e:
+        raise HTTPException(status_code=400, detail=str(e)) from e
+    try:
+        with tempfile.TemporaryDirectory() as td:
+            dbp = Path(td) / "upload.sqlite"
+            dbp.write_bytes(data)
+            uri = sqlite_uri_for_path(dbp)
+            cfg = opts.to_run_config(uri)
+            zip_data = build_markdown_zip_bytes(cfg)
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=400, detail=str(e)) from e
+    max_b = settings.max_sync_zip_mb * 1024 * 1024
+    if len(zip_data) > max_b:
+        raise HTTPException(
+            status_code=413,
+            detail=f"ZIP exceeds DB_TO_MD_MAX_SYNC_ZIP_MB ({settings.max_sync_zip_mb}); use POST /db-to-md/job/sqlite",
+        )
+    return Response(
+        content=zip_data,
+        media_type="application/zip",
+        headers={"Content-Disposition": 'attachment; filename="db-metadata.zip"'},
+    )
+
+
+@app.post("/db-to-md/job/sqlite")
+async def db_job_sqlite_upload(
+    request: Request,
+    file: UploadFile = File(..., description="SQLite .db / .sqlite file (SQLite format 3)"),
+    config: str | None = Form(None, description="Optional JSON object: schema, output, features, execution, limits, erd"),
+) -> dict[str, str]:
+    """Async job: save upload under the job workspace, run export, then ``GET …/download`` for the ZIP."""
+    settings: DbApiSettings = request.app.state.settings
+    jobs: JobManager = request.app.state.jobs
+    max_upload = max(1, settings.max_sqlite_upload_mb) * 1024 * 1024
+    data = await file.read()
+    if len(data) > max_upload:
+        raise HTTPException(
+            status_code=413,
+            detail=f"SQLite upload exceeds DB_TO_MD_MAX_SQLITE_UPLOAD_MB ({settings.max_sqlite_upload_mb})",
+        )
+    if not is_sqlite_database_bytes(data):
+        raise HTTPException(
+            status_code=400,
+            detail="File is not a SQLite database (expected 'SQLite format 3' header)",
+        )
+    try:
+        opts = parse_sqlite_upload_config_json(config)
+    except (ValueError, ValidationError) as e:
+        raise HTTPException(status_code=400, detail=str(e)) from e
+    cfg_template = opts.to_run_config("sqlite:///placeholder")
+    try:
+        rec = jobs.create_sqlite_file_job(data, cfg_template)
+        jobs.run_job_thread(rec.job_id)
+    except Exception as e:
+        raise HTTPException(status_code=400, detail=str(e)) from e
+    return {"job_id": rec.job_id}
+
+
 @app.post("/db-to-md/run")
 async def db_run_sync(request: Request, body: DbToMdRunBody) -> Response:
     settings: DbApiSettings = request.app.state.settings

{mdengine-0.5.0 → mdengine-0.6.0}/src/md_generator/db/api/schemas.py

@@ -10,7 +10,7 @@ from md_generator.db.core.run_config import ErdConfig, RunConfig
 
 
 class DatabaseSection(BaseModel):
-    type: str = Field(..., description="postgres | mysql | oracle | mongo")
+    type: str = Field(..., description="postgres | mysql | oracle | mongo | sqlite")
     uri: str
     schema: str | None = None
     database: str | None = None

{mdengine-0.5.0 → mdengine-0.6.0}/src/md_generator/db/api/settings.py

@@ -16,6 +16,7 @@ class DbApiSettings(BaseSettings):
     job_workspace_root: str | None = None
     cors_origins: str = "*"
     max_sync_zip_mb: int = 80
+    max_sqlite_upload_mb: int = 256
 
 
 def cors_list(settings: DbApiSettings) -> list[str]:

mdengine-0.6.0/src/md_generator/db/api/sqlite_upload.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any, Literal
+
+from pydantic import BaseModel, Field, model_validator
+
+from md_generator.db.core.models import FEATURES
+from md_generator.db.core.run_config import ErdConfig, RunConfig
+
+
+class SqliteUploadOutputSection(BaseModel):
+    path: str = "./docs"
+    split_files: bool = True
+    write_combined_feature_markdown: bool = False
+    readme_feature_merge: Literal["none", "inline", "toc"] = "none"
+
+
+class SqliteUploadFeaturesSection(BaseModel):
+    include: list[str] | None = None
+    exclude: list[str] = Field(default_factory=list)
+
+
+class SqliteUploadExecutionSection(BaseModel):
+    workers: int = Field(default=4, ge=1, le=32)
+
+
+class SqliteUploadErdSection(BaseModel):
+    max_tables: int = Field(default=100, ge=1, le=100_000)
+    scope: Literal["full", "per_schema", "per_table"] = Field(default="full")
+
+
+class SqliteUploadJsonBody(BaseModel):
+    """Same export options as ``DbToMdRunBody`` except the DB file comes from the upload."""
+
+    schema: str | None = Field(default="main", description="SQLite catalog (default main)")
+    output: SqliteUploadOutputSection = Field(default_factory=SqliteUploadOutputSection)
+    features: SqliteUploadFeaturesSection = Field(default_factory=SqliteUploadFeaturesSection)
+    execution: SqliteUploadExecutionSection = Field(default_factory=SqliteUploadExecutionSection)
+    limits: dict[str, Any] = Field(default_factory=dict)
+    erd: SqliteUploadErdSection = Field(default_factory=SqliteUploadErdSection)
+
+    @model_validator(mode="after")
+    def check_features(self) -> SqliteUploadJsonBody:
+        if self.features.include:
+            bad = set(self.features.include) - FEATURES
+            if bad:
+                raise ValueError(f"Unknown features in include: {sorted(bad)}")
+        bad_ex = set(self.features.exclude) - FEATURES
+        if bad_ex:
+            raise ValueError(f"Unknown features in exclude: {sorted(bad_ex)}")
+        return self
+
+    def to_run_config(self, sqlite_uri: str) -> RunConfig:
+        sch = self.schema
+        if sch is None or str(sch).strip() == "" or str(sch).lower() == "public":
+            sch = "main"
+        inc = frozenset(self.features.include) if self.features.include else frozenset(FEATURES)
+        merge = self.output.readme_feature_merge
+        write_combined = self.output.write_combined_feature_markdown
+        if merge != "none" and self.output.split_files:
+            write_combined = True
+        return RunConfig(
+            db_type="sqlite",
+            uri=sqlite_uri,
+            schema=sch,
+            database=None,
+            output_path=Path(self.output.path),
+            split_files=self.output.split_files,
+            write_combined_feature_markdown=write_combined,
+            readme_feature_merge=merge,
+            include=inc,
+            exclude=frozenset(self.features.exclude),
+            workers=self.execution.workers,
+            limits=dict(self.limits),
+            erd=ErdConfig(max_tables=self.erd.max_tables, scope=self.erd.scope).normalized(),
+        )
+
+
+def parse_sqlite_upload_config_json(raw: str | None) -> SqliteUploadJsonBody:
+    if raw is None or not str(raw).strip():
+        return SqliteUploadJsonBody()
+    data = json.loads(raw)
+    if not isinstance(data, dict):
+        raise ValueError("config must be a JSON object")
+    return SqliteUploadJsonBody.model_validate(data)