furu 0.0.2__tar.gz → 0.0.3__tar.gz

{furu-0.0.2 → furu-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: furu
-Version: 0.0.2
+Version: 0.0.3
 Summary: Cacheable, nested pipelines for Python. Define computations as configs; furu handles caching, state tracking, and result reuse across runs.
 Author: Herman Brunborg
 Author-email: Herman Brunborg <herman@brunborg.com>
@@ -336,6 +336,17 @@ except FuruLockNotAcquired:
     print("Could not acquire lock")
 ```
 
+By default, failed artifacts are retried on the next `load_or_create()` call. Set
+`FURU_RETRY_FAILED=0` or pass `retry_failed=False` to keep failures sticky.
+
+`FURU_MAX_WAIT_SECS` overrides the per-class `_max_wait_time_sec` (default 600s)
+timeout used when waiting for compute locks before raising `FuruWaitTimeout`.
+
+Failures during metadata collection or signal handler setup (before `_create()`
+runs) raise `FuruComputeError` with the original exception attached. These
+failures still mark the attempt as failed and record details in `state.json`
+and `furu.log`.
+
 ## Submitit Integration
 
 Run computations on SLURM clusters via [submitit](https://github.com/facebookincubator/submitit):
@@ -415,7 +426,9 @@ The `/api/experiments` endpoint supports:
 | `FURU_LOG_LEVEL` | `INFO` | Console verbosity (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |
 | `FURU_IGNORE_DIFF` | `false` | Skip embedding git diff in metadata |
 | `FURU_ALWAYS_RERUN` | `""` | Comma-separated class qualnames to always rerun (use `ALL` to bypass cache globally; cannot combine with other entries; entries must be importable) |
+| `FURU_RETRY_FAILED` | `true` | Retry failed artifacts by default (set to `0` to keep failures sticky) |
 | `FURU_POLL_INTERVAL_SECS` | `10` | Polling interval for queued/running jobs |
+| `FURU_MAX_WAIT_SECS` | unset | Override wait timeout (falls back to `_max_wait_time_sec`, default 600s) |
 | `FURU_WAIT_LOG_EVERY_SECS` | `10` | Interval between "waiting" log messages |
 | `FURU_STALE_AFTER_SECS` | `1800` | Consider running jobs stale after this duration |
 | `FURU_LEASE_SECS` | `120` | Compute lock lease duration |

{furu-0.0.2 → furu-0.0.3}/README.md

@@ -317,6 +317,17 @@ except FuruLockNotAcquired:
     print("Could not acquire lock")
 ```
 
+By default, failed artifacts are retried on the next `load_or_create()` call. Set
+`FURU_RETRY_FAILED=0` or pass `retry_failed=False` to keep failures sticky.
+
+`FURU_MAX_WAIT_SECS` overrides the per-class `_max_wait_time_sec` (default 600s)
+timeout used when waiting for compute locks before raising `FuruWaitTimeout`.
+
+Failures during metadata collection or signal handler setup (before `_create()`
+runs) raise `FuruComputeError` with the original exception attached. These
+failures still mark the attempt as failed and record details in `state.json`
+and `furu.log`.
+
 ## Submitit Integration
 
 Run computations on SLURM clusters via [submitit](https://github.com/facebookincubator/submitit):
@@ -396,7 +407,9 @@ The `/api/experiments` endpoint supports:
 | `FURU_LOG_LEVEL` | `INFO` | Console verbosity (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |
 | `FURU_IGNORE_DIFF` | `false` | Skip embedding git diff in metadata |
 | `FURU_ALWAYS_RERUN` | `""` | Comma-separated class qualnames to always rerun (use `ALL` to bypass cache globally; cannot combine with other entries; entries must be importable) |
+| `FURU_RETRY_FAILED` | `true` | Retry failed artifacts by default (set to `0` to keep failures sticky) |
 | `FURU_POLL_INTERVAL_SECS` | `10` | Polling interval for queued/running jobs |
+| `FURU_MAX_WAIT_SECS` | unset | Override wait timeout (falls back to `_max_wait_time_sec`, default 600s) |
 | `FURU_WAIT_LOG_EVERY_SECS` | `10` | Interval between "waiting" log messages |
 | `FURU_STALE_AFTER_SECS` | `1800` | Consider running jobs stale after this duration |
 | `FURU_LEASE_SECS` | `120` | Compute lock lease duration |

{furu-0.0.2 → furu-0.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "furu"
-version = "0.0.2"
+version = "0.0.3"
 description = "Cacheable, nested pipelines for Python. Define computations as configs; furu handles caching, state tracking, and result reuse across runs."
 readme = "README.md"
 authors = [

{furu-0.0.2 → furu-0.0.3}/src/furu/__init__.py

@@ -13,7 +13,7 @@ __version__ = version("furu")
 
 from .config import FURU_CONFIG, FuruConfig, get_furu_root, set_furu_root
 from .adapters import SubmititAdapter
-from .core import Furu, FuruList
+from .core import DependencyChzSpec, DependencySpec, Furu, FuruList
 from .errors import (
     FuruComputeError,
     FuruError,
@@ -56,6 +56,8 @@ __all__ = [
     "FuruMigrationRequired",
     "FuruSerializer",
     "FuruWaitTimeout",
+    "DependencyChzSpec",
+    "DependencySpec",
     "MISSING",
     "migrate",
     "NamespacePair",

{furu-0.0.2 → furu-0.0.3}/src/furu/config.py

@@ -22,12 +22,19 @@ class FuruConfig:
         self.poll_interval = float(os.getenv("FURU_POLL_INTERVAL_SECS", "10"))
         self.wait_log_every_sec = float(os.getenv("FURU_WAIT_LOG_EVERY_SECS", "10"))
         self.stale_timeout = float(os.getenv("FURU_STALE_AFTER_SECS", str(30 * 60)))
+        max_wait_env = os.getenv("FURU_MAX_WAIT_SECS")
+        self.max_wait_time_sec = float(max_wait_env) if max_wait_env else None
         self.lease_duration_sec = float(os.getenv("FURU_LEASE_SECS", "120"))
         hb = os.getenv("FURU_HEARTBEAT_SECS")
         self.heartbeat_interval_sec = (
             float(hb) if hb is not None else max(1.0, self.lease_duration_sec / 3.0)
         )
         self.max_requeues = int(os.getenv("FURU_PREEMPT_MAX", "5"))
+        self.retry_failed = os.getenv("FURU_RETRY_FAILED", "1").lower() in {
+            "1",
+            "true",
+            "yes",
+        }
         self.ignore_git_diff = os.getenv("FURU_IGNORE_DIFF", "0").lower() in {
             "1",
             "true",
@@ -151,8 +158,7 @@ class FuruConfig:
                 value = getattr(target, attr, missing_sentinel)
                 if value is missing_sentinel:
                     raise ValueError(
-                        "FURU_ALWAYS_RERUN entry does not exist: "
-                        f"{namespace!r}"
+                        f"FURU_ALWAYS_RERUN entry does not exist: {namespace!r}"
                     )
                 target = value
 

furu-0.0.3/src/furu/core/__init__.py

@@ -0,0 +1,4 @@
+from .furu import DependencyChzSpec, DependencySpec, Furu
+from .list import FuruList
+
+__all__ = ["DependencyChzSpec", "DependencySpec", "Furu", "FuruList"]