stml-cli 0.1.6__tar.gz → 0.1.8__tar.gz

{stml_cli-0.1.6 → stml_cli-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stml-cli
-Version: 0.1.6
+Version: 0.1.8
 Summary: The stml partner CLI — pull, edit, push, and publish stml apps and libraries.
 Author: stml
 Project-URL: Homepage, https://stml.io

{stml_cli-0.1.6 → stml_cli-0.1.8}/pyproject.toml

@@ -25,3 +25,8 @@ version = { attr = "stml_cli.__version__" }
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["stml_cli*"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+]

{stml_cli-0.1.6 → stml_cli-0.1.8}/stml_cli/__init__.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 
 import os
 
-__version__ = "0.1.6"
+__version__ = "0.1.8"
 
 # TLS trust: framework/python.org builds have no OpenSSL CA path, so a real
 # https backend fails with "unable to get local issuer certificate". certifi's

{stml_cli-0.1.6 → stml_cli-0.1.8}/stml_cli/commands.py

@@ -152,6 +152,16 @@ def cmd_pull(args) -> None:
     _write_link(dest, args.backend, workspace, app)
     tail = f" (+ {asset_count} asset(s))" if asset_count else ""
     _log(f"✓ Pulled {len(written)} file(s) from {result.get('app', app)} → {dest}{tail}")
+    if result.get("generated_manifest"):
+        # The app's overlay had no manifest — the backend reconstructed one from
+        # the platform's live state (flow rows, dependency pins, provenance).
+        _log("  ℹ pyproject.toml was generated from the app's platform state — "
+             "review it (name/version/issuer-org) before `stml publish`.")
+    if result.get("base_files"):
+        # Attached app: files the app never forked come from its base library
+        # version, so the folder is the complete effective tree.
+        _log(f"  ℹ {result['base_files']} file(s) came from the app's base "
+             "library (never forked in the app).")
 
 
 def cmd_push(args) -> None:
@@ -305,6 +315,7 @@ def cmd_init(args) -> None:
         raise SystemExit(f"{target} exists and is not empty")
     target.mkdir(parents=True, exist_ok=True)
     name = args.name or target.name
+    pkg_name = name.replace("-", "_")
     (target / "pyproject.toml").write_text(
         f'''[project]
 name = "{name}"
@@ -316,15 +327,79 @@ dependencies = []
 [tool.stml]
 requires-runtime = ">=0.1"
 issuer-org = ""  # set to your org slug
-exports-flows = []
+exports-flows = [
+    {{ name = "hello", entrypoint = "{pkg_name}.hello:app" }},
+]
 depends-on = []
+
+[dependency-groups]
+dev = [
+    "pytest",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
 ''',
         encoding="utf-8",
     )
-    pkg = target / name.replace("-", "_")
-    pkg.mkdir()
+    # src layout — the shape `stml pull` writes and deployment-version 2
+    # expects (flows ship under src/); keeps init/pull/push round-trips stable.
+    pkg = target / "src" / pkg_name
+    pkg.mkdir(parents=True)
     (pkg / "__init__.py").write_text('"""Library entry point."""\n', encoding="utf-8")
+    (pkg / "hello.py").write_text(
+        f'''"""A minimal runnable flow — replace its steps with your own and keep
+`exports-flows` in pyproject.toml pointing at each flow's `module:app`."""
+
+from stml.runtime import App
+
+app = App("hello")
+
+
+@app.step(name="Greet", description="Says hello.")
+def greet() -> dict:
+    return {{"message": "Hello from {name}!"}}
+''',
+        encoding="utf-8",
+    )
     (target / "README.md").write_text(f"# {name}\n", encoding="utf-8")
+    (target / "AGENTS.md").write_text(
+        f'''# `{name}` — usage for the assistant
+
+<What this library does, who installs it, and how its flows are meant to be
+run — write it for the AI assistant working on or with this library.>
+
+## Layout
+
+- `src/{pkg_name}/` — the package. Flows live here and are listed in
+  `pyproject.toml` under `[tool.stml] exports-flows` as `module:app`.
+- `tests/` — local-only: `stml push` and `stml publish` both skip it.
+  Run with `uv run pytest`.
+''',
+        encoding="utf-8",
+    )
+    (target / ".gitignore").write_text(
+        ".venv/\n__pycache__/\n*.pyc\n.stml/\n.pytest_cache/\n.ruff_cache/\n",
+        encoding="utf-8",
+    )
+    # tests/ is LOCAL-ONLY by convention: push and publish both skip it
+    # (paths._EXCLUDE_DIRS / packaging.EXCLUDE_DIRS), so scaffold it with a
+    # stub that says so — runnable code belongs in the package, never here.
+    tests_dir = target / "tests"
+    tests_dir.mkdir()
+    (tests_dir / "__init__.py").write_text("", encoding="utf-8")
+    (tests_dir / "test_smoke.py").write_text(
+        f'''"""tests/ is local-only: `stml push` and `stml publish` both skip this
+folder — put runnable code in the package, never in here."""
+
+import {pkg_name}
+
+
+def test_import():
+    assert {pkg_name}.__doc__
+''',
+        encoding="utf-8",
+    )
     _log(f"✓ Scaffolded {target}")
 
 

{stml_cli-0.1.6 → stml_cli-0.1.8}/stml_cli/paths.py

@@ -47,9 +47,10 @@ def _is_packaging_path(rel: str) -> bool:
         return True
     return False
 
-# Local-only artifacts that must never be pushed into the overlay.
+# Local-only artifacts that must never be pushed into the overlay. `tests`
+# matches packaging.EXCLUDE_DIRS: unit tests are test-only, never shipped.
 _EXCLUDE_DIRS = {
-    ".git", "__pycache__", ".venv", "venv", ".stml",
+    ".git", "__pycache__", ".venv", "venv", ".stml", "tests",
     "node_modules", ".mypy_cache", ".ruff_cache", ".pytest_cache",
 }
 _EXCLUDE_NAMES = {".DS_Store"}

{stml_cli-0.1.6 → stml_cli-0.1.8}/stml_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stml-cli
-Version: 0.1.6
+Version: 0.1.8
 Summary: The stml partner CLI — pull, edit, push, and publish stml apps and libraries.
 Author: stml
 Project-URL: Homepage, https://stml.io

{stml_cli-0.1.6 → stml_cli-0.1.8}/stml_cli.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ stml_cli.egg-info/entry_points.txt
 stml_cli.egg-info/requires.txt
 stml_cli.egg-info/top_level.txt
 tests/test_disambiguation.py
+tests/test_init.py
 tests/test_paths.py
 tests/test_refs.py
 tests/test_whoami_expiry.py

stml_cli-0.1.8/tests/test_init.py

@@ -0,0 +1,42 @@
+from pathlib import Path
+from types import SimpleNamespace
+
+from stml_cli import commands, paths
+
+
+def test_init_scaffolds_src_layout_lib(tmp_path: Path):
+    target = tmp_path / "my-lib"
+    commands.cmd_init(SimpleNamespace(dir=str(target), name=None))
+
+    # src layout with a runnable example flow, exported in pyproject.
+    assert (target / "src" / "my_lib" / "__init__.py").is_file()
+    assert (target / "src" / "my_lib" / "hello.py").is_file()
+    pyproject = (target / "pyproject.toml").read_text()
+    assert 'entrypoint = "my_lib.hello:app"' in pyproject
+    # pytest works out of the box: dev dep + src on the test pythonpath.
+    assert "pytest" in pyproject and 'pythonpath = ["src"]' in pyproject
+    assert (target / "AGENTS.md").is_file()
+    assert (target / ".gitignore").is_file()
+
+    # tests/ is scaffolded but local-only: the stub imports the package name
+    # and push (read_tree) must not pick the folder up.
+    stub = (target / "tests" / "test_smoke.py").read_text()
+    assert "import my_lib" in stub
+    keys = {f["path"] for f in paths.read_tree(target)}
+    assert "my_lib/hello.py" in keys  # src/ stripped to flat overlay keys
+    assert not any(k.startswith("tests/") for k in keys)
+
+
+def test_init_scaffolded_smoke_test_passes(tmp_path: Path):
+    """The generated tests/test_smoke.py must actually pass in the scaffold."""
+    import subprocess
+    import sys
+
+    target = tmp_path / "demo-lib"
+    commands.cmd_init(SimpleNamespace(dir=str(target), name=None))
+    res = subprocess.run(
+        [sys.executable, "-m", "pytest", "tests/", "-q", "-p", "no:cacheprovider",
+         "--rootdir", str(target), "-o", 'pythonpath=src'],
+        cwd=target, capture_output=True, text=True,
+    )
+    assert res.returncode == 0, res.stdout + res.stderr

{stml_cli-0.1.6 → stml_cli-0.1.8}/tests/test_paths.py

@@ -114,6 +114,18 @@ def test_local_junk_is_excluded(tmp_path: Path):
     assert keys == {"flows/x.py"}  # .git, __pycache__, .stml, *.pyc all dropped
 
 
+def test_tests_dir_is_never_pushed(tmp_path: Path):
+    """tests/ is test-only and never shipped — push skips it like publish does
+    (packaging.EXCLUDE_DIRS), both top-level and under src/."""
+    paths.write_tree(tmp_path, [{"path": "flows/x.py", "content": "x=1\n"}])
+    (tmp_path / "tests").mkdir()
+    (tmp_path / "tests" / "test_x.py").write_text("def test_x(): pass\n")
+    (tmp_path / "src" / "tests").mkdir()
+    (tmp_path / "src" / "tests" / "test_y.py").write_text("def test_y(): pass\n")
+    keys = {f["path"] for f in paths.read_tree(tmp_path)}
+    assert keys == {"flows/x.py"}
+
+
 def test_assets_dir_is_never_pushed(tmp_path: Path):
     """Top-level assets/ is bucket-backed binary media (written by pull) — push
     must skip it (a .xlsx would crash read_text) but publish ships it from disk."""