mcruft-deckcraft 0.1.1__py3-none-any.whl

mcruft_deckcraft/__init__.py

@@ -0,0 +1,98 @@
+# this_file: packages/mcruft_deckcraft/src/mcruft_deckcraft/__init__.py
+import json
+import math
+from pathlib import Path
+
+from mcruft.engines.base import Capability
+from mcruft.engines.cli import CliEngine, page_indexes, pixel_scale
+from mcruft.report import Loss, Policy, Report
+
+try:
+    from .__version__ import __version__ as __version__
+except ImportError:
+    from importlib.metadata import version
+
+    __version__ = version("mcruft-deckcraft")
+
+
+CONVERSIONS = [("pptx", "deckcraft"), ("deckcraft", "pptx"), ("pptx", "pdf"), ("pptx", "md")]
+
+
+class DeckcraftEngine(CliEngine):
+    PRODUCT = "deckcraft"
+    MIN_VERSION = "0.10.0"
+
+    def capabilities(self) -> list[Capability]:
+        routes = [("convert", src, dst, "editable") for src, dst in CONVERSIONS]
+        routes += [
+            ("export_pages", src, dst, policy)
+            for src in ("pptx", "deckcraft")
+            for dst, policy in (("pdf", "editable"), ("png", "fidelity"))
+        ]
+        routes += [
+            ("build_deck", "png", "pptx", "fidelity"),
+            ("inspect", "deckcraft", "deckcraft", "editable"),
+        ]
+        return [Capability(*row, f"{self.PRODUCT}-cli {self.MIN_VERSION}") for row in routes]
+
+    def inspect(self, path: Path) -> list[tuple[float, float]]:
+        path = Path(path)
+        if path.suffix.lower() != ".deckcraft":
+            return super().inspect(path)
+        info = json.loads(self.call(["info", path]))
+        return [tuple(map(float, info["slideSize"]))] * len(info["slides"])
+
+    def run(self, op: str, src: Path, dst: Path, *, policy: Policy, **opts) -> Report:
+        src, dst = Path(src), Path(dst)
+        self.check_route(op, src, dst, policy)
+        report = self.report(op, policy, [dst])
+        if op == "build_deck":
+            images = [Path(p).absolute() for p in opts.get("images") or []]
+            if not images:
+                raise ValueError("build_deck requires at least one image")
+            width, height = opts.get("size", (960, 540))
+            if not all(math.isfinite(v) and v > 0 for v in (width, height)):
+                raise ValueError("Slide dimensions must be finite and positive")
+            args = ["run", "--cmd", "design.slideSize=" + json.dumps({"w": width, "h": height})]
+            for image in images:
+                args += [
+                    "--cmd",
+                    'slide.new={"layout":"blank"}',
+                    "--cmd",
+                    "insert.picture="
+                    + json.dumps({"path": str(image), "rect": [0, 0, width, height]}),
+                ]
+            args += ["--cmd", 'slide.delete={"index":0}', "--save", dst]
+            report.losses.append(Loss("raster", "slides are images"))
+        elif op == "export_pages":
+            info = json.loads(self.call(["info", src]))
+            pages = page_indexes(opts.get("pages"), len(info["slides"]))
+            if dst.suffix.lower() == ".png":
+                scale = pixel_scale(opts.get("dpi", 150))
+                report.outputs = []
+                for page in pages:
+                    out = dst.with_name(f"{dst.stem}-{page:04d}.png")
+                    self.call(
+                        ["render", src, "--slide", str(page), "--scale", str(scale), out], report
+                    )
+                    report.outputs.append(out)
+                report.losses.append(Loss("raster", "slides rasterised"))
+                return report
+            args = [
+                "run",
+                "--in",
+                src,
+                "--export",
+                dst,
+                "--export-params",
+                json.dumps({"slides": pages}),
+            ]
+        else:
+            args = ["convert", src, dst]
+        if dst.suffix.lower() == ".pdf":
+            report.losses.append(Loss("raster", "slide art rasterised"))
+        self.call(args, report)
+        return report
+
+
+engine = DeckcraftEngine()

mcruft_deckcraft/__version__.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.1'
+__version_tuple__ = version_tuple = (0, 1, 1)
+
+__commit_id__ = commit_id = None

mcruft_deckcraft-0.1.1.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.5
+Name: mcruft-deckcraft
+Version: 0.1.1
+Summary: DeckCraft engine for mcruft
+License-Expression: Apache-2.0
+Requires-Python: >=3.12
+Requires-Dist: mcruft
+Provides-Extra: bundled
+Requires-Dist: mcruft-deckcraft-bin; extra == 'bundled'

mcruft_deckcraft-0.1.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+mcruft_deckcraft/__init__.py,sha256=zVD4_YZiq9mlZMPttFyLOjCpVTzAvx9E2IHJv-15oXg,3909
+mcruft_deckcraft/__version__.py,sha256=mEr1FdwwZVMovyM6vpPg2W8zwa1u1f4KdymTrLcqf9U,520
+mcruft_deckcraft-0.1.1.dist-info/METADATA,sha256=JxHNnLigBCAVmPKbE0ilhYcVtVNXyBtHr-tupSsIEMs,254
+mcruft_deckcraft-0.1.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+mcruft_deckcraft-0.1.1.dist-info/entry_points.txt,sha256=GjCPxDBaviLZMejAx0ODVhPzSzCv1QbrNZrjOTFFNnU,53
+mcruft_deckcraft-0.1.1.dist-info/RECORD,,

mcruft_deckcraft-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

mcruft_deckcraft-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[mcruft.engines]
+deckcraft = mcruft_deckcraft:engine