meltify 0.2.2__tar.gz → 0.2.3__tar.gz

{meltify-0.2.2 → meltify-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meltify
-Version: 0.2.2
+Version: 0.2.3
 Summary: Melt files of any format into prompt-ready text where every line cites its source
 Keywords: llm,prompt,ocr,pdf,transcription,claude-code,agent-skills
 Author: jeon-jihyeon
@@ -80,6 +80,18 @@ Command line only:
 uvx meltify read ./inputs
 ```
 
+From Python, after `pip install meltify`:
+
+```python
+import meltify
+
+env = meltify.read("./inputs", out="melted", shallow=True)
+for row in env.results:
+    print(row["cite"], row["out"], row["needs"])
+```
+
+`meltify.read` takes the same flags as the command as keywords and returns the same result envelope that `--json` prints. A string option gets the flag's own type, so `password_file="pw.txt"` arrives as a path and `budget="60"` as a number. For encrypted files, pass `password=`: it outranks `--password-file` and never touches argv. Only the names exported from `meltify` are public. Every other module is internal and can change in any release.
+
 The skills call the `meltify` command. If it isn't installed, the plugin launcher runs it through `uvx`, so [uv](https://docs.astral.sh/uv/) is the only thing you need.
 
 ## What it does

{meltify-0.2.2 → meltify-0.2.3}/README.md

@@ -30,6 +30,18 @@ Command line only:
 uvx meltify read ./inputs
 ```
 
+From Python, after `pip install meltify`:
+
+```python
+import meltify
+
+env = meltify.read("./inputs", out="melted", shallow=True)
+for row in env.results:
+    print(row["cite"], row["out"], row["needs"])
+```
+
+`meltify.read` takes the same flags as the command as keywords and returns the same result envelope that `--json` prints. A string option gets the flag's own type, so `password_file="pw.txt"` arrives as a path and `budget="60"` as a number. For encrypted files, pass `password=`: it outranks `--password-file` and never touches argv. Only the names exported from `meltify` are public. Every other module is internal and can change in any release.
+
 The skills call the `meltify` command. If it isn't installed, the plugin launcher runs it through `uvx`, so [uv](https://docs.astral.sh/uv/) is the only thing you need.
 
 ## What it does

{meltify-0.2.2 → meltify-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "meltify"
-version = "0.2.2"
+version = "0.2.3"
 description = "Melt files of any format into prompt-ready text where every line cites its source"
 readme = "README.md"
 requires-python = ">=3.11.9"

{meltify-0.2.2 → meltify-0.2.3}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "meltify"
-version = "0.2.2"
+version = "0.2.3"
 description = "Melt files of any format into prompt-ready text where every line cites its source"
 readme = "README.md"
 requires-python = ">=3.11.9"

meltify-0.2.3/src/meltify/__init__.py

@@ -0,0 +1,69 @@
+"""Melt files of any format into prompt-ready text where every line cites its source
+
+Only the names in `__all__` are public. Every other module is internal and can change
+in any release
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+from meltify.safe import MissingTool
+
+if TYPE_CHECKING:
+    from meltify.evidence import Envelope
+
+try:
+    __version__ = version("meltify")
+except PackageNotFoundError:
+    __version__ = "0.0.0"
+
+__all__ = ["Envelope", "MissingTool", "__version__", "read"]
+
+
+def read(
+    *paths: str | Path,
+    out: str | Path | None = None,
+    config_file: str | Path | None = None,
+    password: str | None = None,
+    **options: Any,
+) -> Envelope:
+    """Melt files, folders and URLs the way `meltify read` does
+
+    `options` takes the command's flags as keywords, like `shallow=True` or `budget=60`.
+    Each result row cites its source and points at the markdown it wrote under `out`.
+    Raises MissingTool when a needed engine or extra isn't installed
+    """
+    import argparse
+
+    from meltify import config
+    from meltify.commands import read as command
+
+    if not paths:
+        raise TypeError("read() needs at least one path")
+    parser = argparse.ArgumentParser()
+    actions = command.add_arguments(parser)
+    args = parser.parse_args(["-"])
+    args.paths = [str(p) for p in paths]
+    for name, value in options.items():
+        # password stays a keyword of its own, so it never looks like a command line flag
+        if name in ("paths", "password") or name not in actions:
+            raise TypeError(f"read() got an unexpected keyword argument {name!r}")
+        convert = actions[name].type
+        # A string gets the flag's own type, as argparse would give it, so
+        # password_file="pw.txt" arrives as the Path the command reads
+        setattr(args, name, convert(value) if isinstance(value, str) and convert else value)
+    overrides = {"out_dir": str(out)} if out is not None else None
+    settings = config.load(overrides, project=Path(config_file) if config_file else None)
+    return command.run(args, settings, password)
+
+
+def __getattr__(name: str) -> Any:
+    # Envelope loads lazily, so `meltify --help` doesn't pay for the import
+    if name == "Envelope":
+        from meltify.evidence import Envelope
+
+        return Envelope
+    raise AttributeError(f"module 'meltify' has no attribute {name!r}")

meltify-0.2.2/src/meltify/__init__.py

@@ -1,6 +0,0 @@
-from importlib.metadata import PackageNotFoundError, version
-
-try:
-    __version__ = version("meltify")
-except PackageNotFoundError:
-    __version__ = "0.0.0"