mdengine 0.13.3__tar.gz → 0.13.4__tar.gz

{mdengine-0.13.3 → mdengine-0.13.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mdengine
-Version: 0.13.3
+Version: 0.13.4
 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
@@ -182,7 +182,7 @@ Requires-Dist: python-multipart>=0.0.12; extra == "api"
 Requires-Dist: httpx>=0.27.0; extra == "api"
 Requires-Dist: pydantic-settings>=2.0.0; extra == "api"
 Provides-Extra: mcp
-Requires-Dist: mcp>=1.2.0; extra == "mcp"
+Requires-Dist: mcp<2.0.0,>=1.2.0; extra == "mcp"
 Requires-Dist: fastmcp>=2.3.0; extra == "mcp"
 Provides-Extra: docs
 Requires-Dist: mkdocs-material; extra == "docs"
@@ -233,7 +233,7 @@ Requires-Dist: uvicorn[standard]>=0.32.0; extra == "all"
 Requires-Dist: python-multipart>=0.0.12; extra == "all"
 Requires-Dist: httpx>=0.27.0; extra == "all"
 Requires-Dist: pydantic-settings>=2.0.0; extra == "all"
-Requires-Dist: mcp>=1.2.0; extra == "all"
+Requires-Dist: mcp<2.0.0,>=1.2.0; extra == "all"
 Requires-Dist: fastmcp>=2.3.0; extra == "all"
 Requires-Dist: beautifulsoup4>=4.12.0; extra == "all"
 Requires-Dist: lxml_html_clean>=0.4.0; extra == "all"

{mdengine-0.13.3 → mdengine-0.13.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mdengine"
-version = "0.13.3"
+version = "0.13.4"
 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"
@@ -203,7 +203,7 @@ api = [
   "httpx>=0.27.0",
   "pydantic-settings>=2.0.0",
 ]
-mcp = ["mcp>=1.2.0", "fastmcp>=2.3.0"]
+mcp = ["mcp>=1.2.0,<2.0.0", "fastmcp>=2.3.0"]
 docs = [
   "mkdocs-material",
   "mkdocstrings",
@@ -254,7 +254,7 @@ all = [
   "python-multipart>=0.0.12",
   "httpx>=0.27.0",
   "pydantic-settings>=2.0.0",
-  "mcp>=1.2.0",
+  "mcp>=1.2.0,<2.0.0",
   "fastmcp>=2.3.0",
   "beautifulsoup4>=4.12.0",
   "lxml_html_clean>=0.4.0",
@@ -353,3 +353,11 @@ testpaths = [
   "sap-to-md/tests",
 ]
 markers = ["integration: optional dependency or slower checks"]
+
+[tool.coverage.run]
+source = ["src/md_generator/sap", "src/md_generator/odata"]
+omit = ["*/tests/*"]
+
+[tool.coverage.report]
+fail_under = 75
+show_missing = true

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/__init__.py

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

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/archive/api/mcp_setup.py

@@ -5,7 +5,13 @@ import re
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.archive.api.convert_runner import build_artifact_zip_bytes
 from md_generator.archive.api.query_options import convert_options_from_query

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/codeflow/mcp/server.py

@@ -4,7 +4,13 @@ from __future__ import annotations
 
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.codeflow.api.schemas import AnalyzeOptions, merge_upload_options_json, options_to_scan_config
 from md_generator.codeflow.core.extractor import build_output_zip

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/db/mcp/server.py

@@ -4,7 +4,13 @@ import base64
 import json
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.db.api.schemas import DbToMdRunBody
 from md_generator.db.core.zip_export import build_markdown_zip_bytes

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/graph/mcp/server.py

@@ -4,7 +4,13 @@ import base64
 import json
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.graph.api.schemas import GraphToMdRunBody
 from md_generator.graph.core.markdown_writer import format_node_markdown, format_relationship_markdown

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/image/api/mcp_server.py

@@ -15,7 +15,13 @@ _API_ROOT = Path(__file__).resolve().parents[1]
 if str(_API_ROOT) not in sys.path:
     sys.path.insert(0, str(_API_ROOT))
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.image.api.query_options import convert_options_from_query
 from md_generator.image.api.settings import max_upload_mb

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/log/mcp/server.py

@@ -4,7 +4,13 @@ import base64
 import json
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.log.api.schemas import LogToMdRunBody
 from md_generator.log.core.zip_export import build_log_markdown_zip_bytes

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/media/audio/api/mcp_setup.py

@@ -6,7 +6,13 @@ import re
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.media.audio.api.settings import AudioApiSettings
 from md_generator.media.audio.service import AudioToMarkdownService

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/media/video/api/mcp_setup.py

@@ -6,7 +6,13 @@ import re
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.media.video.api.settings import VideoApiSettings
 from md_generator.media.video.service import VideoToMarkdownService

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/media/youtube/api/mcp_setup.py

@@ -4,7 +4,13 @@ import os
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.media.youtube.service import YouTubeToMarkdownService
 

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/odata/mcp/server.py

@@ -4,7 +4,13 @@ import base64
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.odata.core.extractor import extract_to_markdown
 from md_generator.odata.core.run_config import OdataRunConfig

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/openapi/mcp/server.py

@@ -1,10 +1,16 @@
-from __future__ import annotations
+from __future__ import annotations
 
 import base64
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.openapi.core.extractor import extract_to_markdown
 from md_generator.openapi.core.run_config import ApiRunConfig

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/pdf/api/mcp_server.py

@@ -9,7 +9,13 @@ import tempfile
 import uuid
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.pdf.api.settings import max_upload_mb
 from md_generator.pdf.api.zip_bundle import zip_artifact_dir

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/playwright/api/mcp_setup.py

@@ -3,7 +3,13 @@ from __future__ import annotations
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.playwright.api.convert_runner import build_artifact_zip_bytes
 from md_generator.playwright.options import PlaywrightOptions, WaitUntil

{mdengine-0.13.3 → mdengine-0.13.4}/src/md_generator/ppt/api/mcp_setup.py

@@ -5,7 +5,13 @@ import re
 import tempfile
 from pathlib import Path
 
-from mcp.server.fastmcp import FastMCP
+try:
+    from mcp.server.fastmcp import FastMCP
+except (ImportError, ModuleNotFoundError):
+    try:
+        from fastmcp import FastMCP
+    except (ImportError, ModuleNotFoundError):
+        from mcp.server import FastMCP
 
 from md_generator.ppt.api.convert_runner import build_artifact_zip_bytes
 from md_generator.ppt.api.settings import ApiSettings

mdengine-0.13.4/src/md_generator/sap/abap_journey/__init__.py

@@ -0,0 +1,2 @@
+# ABAP Journey & Call Graph Subsystem
+from __future__ import annotations

mdengine-0.13.4/src/md_generator/sap/abap_journey/cache.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import hashlib
+import json
+from pathlib import Path
+from md_generator.sap.abap_journey.models import CallGraph, Node, Edge, RelationshipType
+
+class IncrementalCache:
+    def __init__(self, cache_dir: Path) -> None:
+        self.cache_dir = cache_dir
+        self.cache_dir.mkdir(parents=True, exist_ok=True)
+
+    def get_hash(self, path: Path) -> str:
+        if not path.exists():
+            return ""
+        try:
+            content = path.read_bytes()
+            # Combine content hash with structural schema versions to prevent stale cache hits
+            version_suffix = b"parser:1.0;schema:1.0;framework:1.0"
+            hasher = hashlib.sha256()
+            hasher.update(content)
+            hasher.update(version_suffix)
+            return hasher.hexdigest()
+        except Exception:
+            return ""
+
+    def get(self, source_path: Path) -> CallGraph | None:
+        file_hash = self.get_hash(source_path)
+        if not file_hash:
+            return None
+
+        cache_file = self.cache_dir / f"{file_hash}.json"
+        if cache_file.exists():
+            try:
+                from md_generator.sap.abap_journey.models import GraphSerializer
+                return GraphSerializer.from_json(cache_file.read_text(encoding="utf-8"))
+            except Exception:
+                pass
+        return None
+
+    def put(self, source_path: Path, graph: CallGraph) -> None:
+        file_hash = self.get_hash(source_path)
+        if not file_hash:
+            return
+
+        cache_file = self.cache_dir / f"{file_hash}.json"
+        try:
+            from md_generator.sap.abap_journey.models import GraphSerializer
+            cache_file.write_text(GraphSerializer.to_json(graph), encoding="utf-8")
+        except Exception:
+            pass

mdengine-0.13.4/src/md_generator/sap/abap_journey/engine.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+from pathlib import Path
+from md_generator.sap.canonical.base import CanonicalArtifact
+from md_generator.sap.markdown.builders.renderer_context import RendererContext
+from md_generator.sap.abap_journey.loaders import SourceLoader, StatementCache
+from md_generator.sap.abap_journey.resolver import SymbolRepository
+from md_generator.sap.abap_journey.graph_builder import CallGraphBuilder
+from md_generator.sap.abap_journey.journey_builder import JourneyBuilder
+from md_generator.sap.abap_journey.cache import IncrementalCache
+from md_generator.sap.abap_journey.models import GraphSerializer
+from md_generator.sap.abap_journey.renderers.markdown import MarkdownRenderer
+from md_generator.sap.abap_journey.renderers.mermaid import MermaidRenderer
+from md_generator.sap.abap_journey.renderers.graphviz import GraphvizRenderer
+from md_generator.sap.core.run_config import AbapJourneySection
+
+def build_journey_and_call_graph(artifact: CanonicalArtifact, ctx: RendererContext) -> str:
+    cfg = getattr(ctx, "config", None)
+    config = getattr(cfg, "abap_journey", None) if cfg else None
+    if not config:
+        config = AbapJourneySection()
+
+    artifacts_dict = {}
+    if ctx.cross_link_registry:
+        artifacts_dict = ctx.cross_link_registry.artifact_by_name
+
+    loader = SourceLoader(artifacts_dict)
+    cache = StatementCache()
+    repo = SymbolRepository(loader, cache)
+
+    # 1. Resolve paths
+    source_path = Path(artifact.source_path) if artifact.source_path else None
+    if not source_path or not source_path.exists():
+        res = loader.load_source(artifact.name)
+        if res:
+            _, source_path = res
+
+    # 2. Check incremental cache if enabled
+    graph = None
+    output_dir = getattr(ctx, "output_dir", None) or Path("output/sap-md")
+    
+    if config.cache.enabled:
+        cache_dir_str = config.cache.cache_dir or str(output_dir / ".journey-cache")
+        cache_dir = Path(cache_dir_str)
+        inc_cache = IncrementalCache(cache_dir)
+        if source_path:
+            graph = inc_cache.get(source_path)
+
+    # 3. Build graph if cache miss
+    if not graph:
+        graph = CallGraphBuilder.build_graph_for_program(
+            artifact.name, repo, config, source_path
+        )
+        if config.cache.enabled and source_path and graph.nodes:
+            inc_cache.put(source_path, graph)
+
+    # 4. Save optional graph exports
+    slug = artifact.name.lower().replace(" ", "-").replace("/", "-").replace("::", "-")
+    graphs_dir = output_dir / "abap" / "graphs"
+    graphs_dir.mkdir(parents=True, exist_ok=True)
+
+    try:
+        if config.renderers.json:
+            (graphs_dir / f"{slug}.json").write_text(GraphSerializer.to_json(graph), encoding="utf-8")
+        if config.renderers.mermaid:
+            (graphs_dir / f"{slug}.mmd").write_text(MermaidRenderer.render(graph), encoding="utf-8")
+        if config.renderers.graphviz:
+            (graphs_dir / f"{slug}.dot").write_text(GraphvizRenderer.render(graph), encoding="utf-8")
+    except Exception:
+        pass
+
+    # 5. Build phases and render Markdown if configured
+    if config.renderers.markdown:
+        phases = JourneyBuilder.build_phases(graph)
+        return MarkdownRenderer.render(artifact.name, graph, phases)
+        
+    return ""