starforge-kernel 0.1.0__tar.gz → 0.1.2__tar.gz

{starforge_kernel-0.1.0 → starforge_kernel-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starforge-kernel
-Version: 0.1.0
+Version: 0.1.2
 Summary: *Forge — pipeline canvas, checkpointing, and stale/hydrate execution for the repo you already have open
 Author: Jonathan Potter
 License-Expression: Apache-2.0

{starforge_kernel-0.1.0 → starforge_kernel-0.1.2}/pyproject.toml

@@ -1,31 +1,31 @@
-[build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-# PyPI name `starforge` is squatted by a dormant Galaxy tool (see DESIGN.md §4);
-# the import name is still `starforge`.
-name = "starforge-kernel"
-version = "0.1.0"
-description = "*Forge — pipeline canvas, checkpointing, and stale/hydrate execution for the repo you already have open"
-readme = "README.md"
-authors = [{ name = "Jonathan Potter" }]
-license = "Apache-2.0"
-requires-python = ">=3.10"
-# Intentionally empty: the decorator must import in microseconds inside user
-# production code, and the kernel runs stdlib-only. pandas/numpy/pyarrow are
-# probed lazily in workers and used only if the workspace env provides them.
-dependencies = []
-
-[project.urls]
-Homepage = "https://github.com/Jonpot/forge"
-
-[project.optional-dependencies]
-dev = ["pytest>=8.0", "pandas>=2.0", "pyarrow>=15.0", "numpy>=1.26"]
-mcp = ["mcp>=1.8"]
-
-[tool.setuptools.packages.find]
-where = ["src"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# PyPI name `starforge` is squatted by a dormant Galaxy tool (see DESIGN.md §4);
+# the import name is still `starforge`.
+name = "starforge-kernel"
+version = "0.1.2"
+description = "*Forge — pipeline canvas, checkpointing, and stale/hydrate execution for the repo you already have open"
+readme = "README.md"
+authors = [{ name = "Jonathan Potter" }]
+license = "Apache-2.0"
+requires-python = ">=3.10"
+# Intentionally empty: the decorator must import in microseconds inside user
+# production code, and the kernel runs stdlib-only. pandas/numpy/pyarrow are
+# probed lazily in workers and used only if the workspace env provides them.
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/Jonpot/forge"
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pandas>=2.0", "pyarrow>=15.0", "numpy>=1.26"]
+mcp = ["mcp>=1.8"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

{starforge_kernel-0.1.0 → starforge_kernel-0.1.2}/src/starforge/__init__.py

@@ -1,86 +1,86 @@
-"""*Forge — pipeline canvas for the repo you already have open.
-
-This top-level module is the entire public surface that user code touches.
-It must import in microseconds and depend on nothing: the decorator lives in
-production codebases and has to be free. Everything heavy (indexer, engine,
-kernel) lives in submodules that only *Forge itself* imports.
-"""
-
-from __future__ import annotations
-
-__version__ = "0.1.0"
-
-__all__ = ["block", "progress", "BLOCK_ATTR"]
-
-#: Attribute set on decorated functions. The AST indexer matches the decorator
-#: syntactically and never imports user code; this runtime tag exists so user
-#: code and future runtime introspection can also recognize blocks.
-BLOCK_ATTR = "__starforge_block__"
-
-
-def block(fn=None, *, label=None, category=None, outputs=None):
-    """Register a function as a *Forge block.
-
-    Usable bare or with keyword arguments::
-
-        @block
-        def clean(raw: pd.DataFrame) -> pd.DataFrame: ...
-
-        @block(label="Clean AUC Matrix", category="QC", outputs=("clean", "stats"))
-        def clean_auc(raw, min_coverage: float = 0.8): ...
-
-    The decorated function is returned unchanged — behavior under pytest, in
-    CI, or in production is identical whether or not *Forge is anywhere near.
-
-    Args:
-        label: Palette display name. Defaults to the function name, title-cased.
-        category: Palette grouping. Defaults to the defining module's path.
-        outputs: Names for multiple return values (function must return a tuple
-            of the same length). Defaults to a single output named "output".
-
-    Note for palette metadata: the indexer reads ``label``/``category``/
-    ``outputs`` from the *source*, so they must be literals at the decoration
-    site to appear in the palette.
-    """
-
-    def apply(f):
-        setattr(
-            f,
-            BLOCK_ATTR,
-            {
-                "label": label,
-                "category": category,
-                "outputs": tuple(outputs) if outputs is not None else None,
-            },
-        )
-        return f
-
-    if fn is not None:
-        return apply(fn)
-    return apply
-
-
-#: Installed by the *Forge run worker around each block call; None everywhere
-#: else, which keeps progress() a guaranteed no-op in pytest/CI/production.
-_progress_hook = None
-
-
-def progress(current=None, total=None, label=None):
-    """Report block progress to the *Forge canvas.
-
-    Call freely inside a block::
-
-        for i, chunk in enumerate(chunks):
-            progress(i + 1, len(chunks), "fitting folds")
-            ...
-
-    Outside a *Forge run this does nothing and costs one attribute read —
-    safe to leave in production code. Any combination of arguments works:
-    (current, total) renders a determinate bar, label alone updates the text.
-    """
-    hook = _progress_hook
-    if hook is not None:
-        try:
-            hook(current, total, label)
-        except Exception:
-            pass  # progress must never break user code
+"""*Forge — pipeline canvas for the repo you already have open.
+
+This top-level module is the entire public surface that user code touches.
+It must import in microseconds and depend on nothing: the decorator lives in
+production codebases and has to be free. Everything heavy (indexer, engine,
+kernel) lives in submodules that only *Forge itself* imports.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.2"
+
+__all__ = ["block", "progress", "BLOCK_ATTR"]
+
+#: Attribute set on decorated functions. The AST indexer matches the decorator
+#: syntactically and never imports user code; this runtime tag exists so user
+#: code and future runtime introspection can also recognize blocks.
+BLOCK_ATTR = "__starforge_block__"
+
+
+def block(fn=None, *, label=None, category=None, outputs=None):
+    """Register a function as a *Forge block.
+
+    Usable bare or with keyword arguments::
+
+        @block
+        def clean(raw: pd.DataFrame) -> pd.DataFrame: ...
+
+        @block(label="Clean AUC Matrix", category="QC", outputs=("clean", "stats"))
+        def clean_auc(raw, min_coverage: float = 0.8): ...
+
+    The decorated function is returned unchanged — behavior under pytest, in
+    CI, or in production is identical whether or not *Forge is anywhere near.
+
+    Args:
+        label: Palette display name. Defaults to the function name, title-cased.
+        category: Palette grouping. Defaults to the defining module's path.
+        outputs: Names for multiple return values (function must return a tuple
+            of the same length). Defaults to a single output named "output".
+
+    Note for palette metadata: the indexer reads ``label``/``category``/
+    ``outputs`` from the *source*, so they must be literals at the decoration
+    site to appear in the palette.
+    """
+
+    def apply(f):
+        setattr(
+            f,
+            BLOCK_ATTR,
+            {
+                "label": label,
+                "category": category,
+                "outputs": tuple(outputs) if outputs is not None else None,
+            },
+        )
+        return f
+
+    if fn is not None:
+        return apply(fn)
+    return apply
+
+
+#: Installed by the *Forge run worker around each block call; None everywhere
+#: else, which keeps progress() a guaranteed no-op in pytest/CI/production.
+_progress_hook = None
+
+
+def progress(current=None, total=None, label=None):
+    """Report block progress to the *Forge canvas.
+
+    Call freely inside a block::
+
+        for i, chunk in enumerate(chunks):
+            progress(i + 1, len(chunks), "fitting folds")
+            ...
+
+    Outside a *Forge run this does nothing and costs one attribute read —
+    safe to leave in production code. Any combination of arguments works:
+    (current, total) renders a determinate bar, label alone updates the text.
+    """
+    hook = _progress_hook
+    if hook is not None:
+        try:
+            hook(current, total, label)
+        except Exception:
+            pass  # progress must never break user code

{starforge_kernel-0.1.0 → starforge_kernel-0.1.2}/src/starforge_kernel.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starforge-kernel
-Version: 0.1.0
+Version: 0.1.2
 Summary: *Forge — pipeline canvas, checkpointing, and stale/hydrate execution for the repo you already have open
 Author: Jonathan Potter
 License-Expression: Apache-2.0