sufleur-cli 0.1.0__py3-none-win_arm64.whl

sufleur_cli/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from ._find_sufleur import SufleurNotFound, find_sufleur_bin
+
+__version__ = "0.1.0"
+
+__all__ = ["SufleurNotFound", "find_sufleur_bin"]

sufleur_cli/__main__.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+import os
+import sys
+
+from sufleur_cli import find_sufleur_bin
+
+
+def main() -> None:
+    binary = find_sufleur_bin()
+    if sys.platform == "win32":
+        import subprocess
+
+        try:
+            result = subprocess.run([binary, *sys.argv[1:]])
+        except KeyboardInterrupt:
+            sys.exit(2)
+        sys.exit(result.returncode)
+    else:
+        os.execvp(binary, [binary, *sys.argv[1:]])
+
+
+if __name__ == "__main__":
+    main()

sufleur_cli/_find_sufleur.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+import os
+import sys
+import sysconfig
+from fnmatch import fnmatch
+
+
+class SufleurNotFound(FileNotFoundError):
+    """Raised when the sufleur binary cannot be located on disk."""
+
+
+def find_sufleur_bin() -> str:
+    """Return the absolute path to the bundled `sufleur` binary.
+
+    Mirrors astral-sh/uv's `find_uv_bin` search order so the same set of
+    install layouts works: ordinary venv, system pip, `pip install --prefix`,
+    `pip install --target`, and `pip install --user`.
+    """
+    binary_name = "sufleur" + (sysconfig.get_config_var("EXE") or "")
+
+    targets: list[str | None] = [
+        sysconfig.get_path("scripts"),
+        sysconfig.get_path("scripts", vars={"base": sys.base_prefix}),
+        _join(_matching_parents(_module_path(), _site_packages_match()), _scripts_subdir()),
+        _join(_matching_parents(_module_path(), "sufleur_cli"), "bin"),
+        sysconfig.get_path("scripts", scheme=_user_scheme()),
+    ]
+
+    seen: list[str] = []
+    for target in targets:
+        if not target or target in seen:
+            continue
+        seen.append(target)
+        candidate = os.path.join(target, binary_name)
+        if os.path.isfile(candidate):
+            return candidate
+
+    locations = "\n".join(f" - {t}" for t in seen)
+    raise SufleurNotFound(
+        f"Could not find the sufleur binary in any of the following locations:\n{locations}\n"
+    )
+
+
+def _site_packages_match() -> str:
+    if sys.platform == "win32":
+        return "Lib/site-packages/sufleur_cli"
+    return "lib/python*/site-packages/sufleur_cli"
+
+
+def _scripts_subdir() -> str:
+    return "Scripts" if sys.platform == "win32" else "bin"
+
+
+def _module_path() -> str:
+    return os.path.dirname(__file__)
+
+
+def _matching_parents(path: str | None, match: str) -> str | None:
+    if not path:
+        return None
+    parts = path.split(os.sep)
+    match_parts = match.split("/")
+    if len(parts) < len(match_parts):
+        return None
+    if not all(
+        fnmatch(part, match_part)
+        for part, match_part in zip(reversed(parts), reversed(match_parts))
+    ):
+        return None
+    return os.sep.join(parts[: -len(match_parts)])
+
+
+def _join(path: str | None, *parts: str) -> str | None:
+    if not path:
+        return None
+    return os.path.join(path, *parts)
+
+
+def _user_scheme() -> str:
+    if sys.version_info >= (3, 10):
+        return sysconfig.get_preferred_scheme("user")
+    if os.name == "nt":
+        return "nt_user"
+    if sys.platform == "darwin" and getattr(sys, "_framework", ""):
+        return "osx_framework_user"
+    return "posix_user"

sufleur_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: sufleur-cli
+Version: 0.1.0
+Summary: CLI for sufleur — type-safe codegen for versioned LLM prompts.
+Project-URL: Homepage, https://github.com/sufleur/cli
+Project-URL: Issues, https://github.com/sufleur/cli/issues
+Project-URL: Repository, https://github.com/sufleur/cli
+Author: Tamás Vajda
+License-Expression: MIT
+Keywords: cli,codegen,llm,prompts,python,sufleur
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Go
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Provides-Extra: generated
+Requires-Dist: chevron; extra == 'generated'
+Requires-Dist: pydantic; extra == 'generated'
+Description-Content-Type: text/markdown
+
+# sufleur-cli
+
+The CLI for [**Sufleur**](https://sufleur.com) — the registry where you author, version, and publish LLM prompts. This is the consumer side: it installs prompts from your Sufleur workspace into your project the way `pip` installs packages — declared in `sufleur.yaml`, locked to `sufleur-lock.yaml`, generated into one Python module with full types and runtime helpers.
+
+Create a workspace and start authoring prompts at <https://sufleur.com>.
+
+## What you call from your code
+
+```python
+from generated.prompts import get_prompt
+
+review = get_prompt("@my-workspace/code-review")
+
+rendered = review.render("en", {"diff": "...", "language": "go"})
+prompt: str = rendered["prompt"]  # ready-to-send prompt string
+
+result = review.parse_output(llm_response_text)
+if result["success"]:
+    result["data"]  # Pydantic model, validated against the prompt's output schema
+else:
+    result["error"]
+```
+
+`"@my-workspace/code-review"` is checked at type-check time (mypy / pyright): typos fail, the entrypoint name `"en"` is narrowed against the prompt's available entrypoints (via `@overload`), and the input is a `TypedDict` derived from the JSON Schema declared on that entrypoint. The version that resolves at codegen time is pinned in `sufleur-lock.yaml`.
+
+## Install
+
+```bash
+pip install sufleur-cli
+sufleur --help
+```
+
+Or with [pipx](https://pipx.pypa.io/) for an isolated install:
+
+```bash
+pipx install sufleur-cli
+```
+
+The wrapper ships the prebuilt binary inside a per-platform wheel — pip selects the right one via PEP 425 platform tags. There's no Python interpreter in the invocation hot path; `sufleur` is the native binary on your `PATH`.
+
+## Quick start
+
+```bash
+mkdir my-app && cd my-app
+sufleur init                                  # creates sufleur.yaml interactively
+sufleur add @my-workspace/code-review ^1.0.0  # add + fetch + lock
+sufleur generate                              # writes ./generated/prompts.py
+```
+
+The generated module imports two runtime peers. Install them with the `[generated]` extra:
+
+```bash
+pip install 'sufleur-cli[generated]'
+```
+
+…or add `chevron` (Mustache templating) and `pydantic` (output-schema validation, only needed when prompts have output schemas) directly to your project's dependencies. The CLI itself has no Python runtime deps; the `[generated]` extra exists so users who run `init`/`add`/`install` but never `generate` aren't forced to install code they don't use.
+
+The generated code targets **Python 3.10+** (PEP 604 union syntax).
+
+## What `sufleur generate` emits
+
+A single `.py` module containing every prompt inlined (no runtime fetches). The public API is `get_prompt(name)`, which returns a result object with:
+
+- **`render(entrypoint, input)` → `{"prompt": str}`** — Chevron renders the entrypoint template against `input`. The signature is narrowed via `@overload` per entrypoint, so type checkers reject the wrong input shape.
+- **`metadata`** — a `TypedDict` containing `version`, your workspace's custom metadata, and (when applicable) `output_schema`.
+- **`parse_output(raw)`** *(only present if the prompt has an output schema)* — strips ``` fences, JSON-parses, and validates with a Pydantic model generated from the prompt's JSON Schema. Returns `{"success": True, "data": <Model>}` or `{"success": False, "error": str}`.
+
+Plus generated `TypedDict`s per entrypoint, with field docstrings for any schema property that has a `description`:
+
+```python
+class CodeReview_EnInput(TypedDict):
+    diff: str
+    """The unified diff to review."""
+    language: str
+```
+
+Prompts published with `DRAFT` status emit a `warnings.warn(...)` when their `get_prompt` is called.
+
+## sufleur.yaml
+
+The manifest. Looks like:
+
+```yaml
+api_keys:
+  my-workspace: ${MY_WORKSPACE_API_KEY}
+
+prompts:
+  '@my-workspace/greeting': '*'
+  '@my-workspace/code-review': '^2.0.0'
+  # alias: keep two pinned versions side-by-side under different names
+  '@my-workspace/code-review-strict': '@my-workspace/code-review@~1.4.0'
+
+output:
+  language: python
+  file: ./generated/prompts.py
+```
+
+Constraints are npm-style semver ranges (`^`, `~`, `>=`, exact, `*`). The resolution is recorded in `sufleur-lock.yaml`. **Commit both files** — `sufleur.yaml` is the source of truth, `sufleur-lock.yaml` is the receipt.
+
+## CI usage
+
+```bash
+sufleur install --frozen   # fail if lockfile is stale
+sufleur generate
+```
+
+`--frozen` is the `pip-compile`-equivalent: refuses to update the lockfile, hard-errors if the manifest and lockfile disagree.
+
+## Commands
+
+| Command | Description |
+| ------- | ----------- |
+| `sufleur init` | Interactive scaffolding for `sufleur.yaml`. |
+| `sufleur add @ws/name [range]` | Add a prompt, fetch it, update the lockfile. `--alias <name>` keeps multiple versions; `--force` overwrites an existing entry. |
+| `sufleur remove @ws/name` | Remove a prompt from the manifest and prune its cache (kept if another alias still resolves to the same version). |
+| `sufleur install` | Resolve the manifest, fetch what's missing, refresh the lockfile. `--frozen` for CI. |
+| `sufleur update [@ws/name]` | Re-resolve constraints — one prompt or all. |
+| `sufleur generate` | Regenerate the output file from the lockfile + cache. |
+
+`-v` / `--verbose` enables HTTP request/response logs on any command. Variables in `.env` are loaded automatically; per-workspace API keys can be referenced as `${ENV_VAR_NAME}` in `sufleur.yaml`.
+
+## Invocation modes
+
+The `sufleur` command on your `PATH` is the Go binary itself. For tools that prefer module-style invocation:
+
+```bash
+python -m sufleur_cli --help
+```
+
+This goes through a tiny Python wrapper that locates the binary and `os.execvp`s it (POSIX) or `subprocess.run`s it (Windows). Slightly slower because Python boots first, but useful when invoking the CLI programmatically from a Python tool that wants to be sure it's calling the binary in the active environment.
+
+The `find_sufleur_bin()` helper is also importable:
+
+```python
+from sufleur_cli import find_sufleur_bin
+print(find_sufleur_bin())  # absolute path to the binary
+```
+
+## Supported platforms
+
+| OS      | Architectures                                  |
+| ------- | ---------------------------------------------- |
+| macOS   | x86_64, arm64                                  |
+| Linux   | x86_64, aarch64 (manylinux 2.17 / glibc 2.17+) |
+| Windows | x86_64, arm64                                  |
+
+Alpine / musl libc is currently unsupported (no musllinux wheel) — pip will refuse with "no matching distribution" rather than silently producing a broken install. There is no source distribution.
+
+## Links
+
+- **Sufleur platform** — author and manage prompts: <https://sufleur.com>
+- **Source code, issues, release notes**: <https://github.com/sufleur/cli>
+
+## License
+
+MIT.

sufleur_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+sufleur_cli/__init__.py,sha256=uyZziI8rHkx3ekXq5X0wqdrIhzt94JQ8Mp2oroJmUbk,171
+sufleur_cli/__main__.py,sha256=stdEvPSb2do6t0MwTn8BsRsaiPvZvCMTVWTrQfSl2bk,481
+sufleur_cli/_find_sufleur.py,sha256=Ci2QiKRlgA_eUM15kpiFSTgXU0LQ-g6wwa07MJLgkyM,2605
+sufleur_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sufleur_cli-0.1.0.data/scripts/sufleur.exe,sha256=N56Vr-oMCLnAie0H6-b1xG74_NJCLR4nKwLjZC9a7lI,11681280
+sufleur_cli-0.1.0.dist-info/METADATA,sha256=PTi9cnyoL9O7q6cWJrgbsFn0PzBRv4BAJPl3ftryTZU,8014
+sufleur_cli-0.1.0.dist-info/WHEEL,sha256=w7VOCnMnx9r5-lu2GjBVd6BdGrPc0Fm_UFMvUozKtTg,94
+sufleur_cli-0.1.0.dist-info/RECORD,,

sufleur_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: false
+Tag: py3-none-win_arm64