pythagoras 0.25.3__tar.gz → 0.25.5__tar.gz

{pythagoras-0.25.3 → pythagoras-0.25.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pythagoras
-Version: 0.25.3
+Version: 0.25.5
 Summary: Planet-scale distributed computing in Python.
 Keywords: cloud,ML,AI,serverless,distributed,parallel,machine-learning,deep-learning,pythagoras
 Author: Volodymyr (Vlad) Pavlov
@@ -52,6 +52,12 @@ Description-Content-Type: text/markdown
 
 # Pythagoras
 
+[![PyPI version](https://img.shields.io/pypi/v/Pythagoras.svg)](https://pypi.org/project/Pythagoras/)
+[![Python versions](https://img.shields.io/pypi/pyversions/Pythagoras.svg)](https://pypi.org/project/Pythagoras/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Downloads](https://static.pepy.tech/badge/Pythagoras)](https://pepy.tech/project/Pythagoras)
+
+
 Planet-scale distributed computing in Python.
 
 **!!! RESEARCH PREVIEW !!!**
@@ -198,6 +204,17 @@ assert is_odd(n=11)
 
 ## Core Concepts
 
+ * **Portal**: An application's "window" into the non-ephemeral world outside the current application
+  execution session. It's a connector that enables a link between a runtime-only ephemeral state and
+  a persistent state that can be saved and loaded across multiple runs of the application and across
+  multiple computers. Portals provide a unified interface for data persistence, caching, and state
+  management across distributed systems. They abstract away the complexities of storage backends
+  (local filesystem, cloud storage, etc.) and handle serialization/deserialization transparently.
+  This allows applications to seamlessly work with persistent data while maintaining isolation between
+  runtime and storage concerns. A program can use multiple portals, each with its own storage backend, and
+  each portal can be used by multiple applications. A portal defines a context for the execution of
+  pure functions, which is used to cache and retrieve results. 
+
 * **Autonomous Function**: A self-contained function that does not depend on external
   imports or definitions. All necessary imports must be done inside the function body.
   These functions cannot use global objects (except built-ins), yield statements, or nonlocal variables.
@@ -217,28 +234,18 @@ assert is_odd(n=11)
   works seamlessly across different machines in a distributed system, enabling significant performance
   improvements for computationally intensive workflows.
 
-* **Validator**: A function that checks if certain conditions are met before or after the execution
-  of a pure function. Pre-validators run before the function, and post-validators run after.
+* **Validator**: An autonomous function that checks if certain conditions are met before or after 
+  the execution of a pure function. Pre-validators run before the function, and post-validators run after.
   They can be passive (e.g., check for available RAM) or active (e.g., install a missing library).
-  For example, `unused_ram(Gb=5)` ensures 5GB of free memory before execution, while `installed_packages("numpy")`
-  verifies or installs required dependencies. Validators help ensure reliable execution across distributed
-  systems by validating requirements and system state. Multiple validators can be combined using the
-  standard decorator syntax to create comprehensive validation chains.
-
-* **Portal**: An application's "window" into the non-ephemeral world outside the current application
-  execution session. It's a connector that enables a link between a runtime-only ephemeral state and
-  a persistent state that can be saved and loaded across multiple runs of the application and across
-  multiple computers. Portals provide a unified interface for data persistence, caching, and state
-  management across distributed systems. They abstract away the complexities of storage backends
-  (local filesystem, cloud storage, etc.) and handle serialization/deserialization transparently.
-  This allows applications to seamlessly work with persistent data while maintaining isolation between
-  runtime and storage concerns.
+  Validators help ensure reliable execution across distributed systems by validating requirements 
+  and system state. Multiple validators can be combined using the standard decorator syntax 
+  to create comprehensive validation chains.
 
-* **Value Address**: A globally unique address of an **immutable value**, derived from its content
+* **Value Address**: A globally unique address of an ***immutable value***, derived from its content
   (type and value). It consists of a human-readable descriptor (often based on the object's type
   and shape/length) and a hash signature (SHA-256, encoded) split into parts for filesystem/storage
   efficiency. Creating a ValueAddr(data) computes the content hash of data and stores the value
-  in the active DataPortal's storage (if not already stored), allowing that value to be retrieved later
+  in the active portal's storage (if not already stored), allowing that value to be retrieved later
   via the address. These addresses are used extensively by the portal to identify stored results
   and to reference inputs/outputs across distributed systems.
 

{pythagoras-0.25.3 → pythagoras-0.25.5}/README.md

@@ -1,5 +1,11 @@
 # Pythagoras
 
+[![PyPI version](https://img.shields.io/pypi/v/Pythagoras.svg)](https://pypi.org/project/Pythagoras/)
+[![Python versions](https://img.shields.io/pypi/pyversions/Pythagoras.svg)](https://pypi.org/project/Pythagoras/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Downloads](https://static.pepy.tech/badge/Pythagoras)](https://pepy.tech/project/Pythagoras)
+
+
 Planet-scale distributed computing in Python.
 
 **!!! RESEARCH PREVIEW !!!**
@@ -146,6 +152,17 @@ assert is_odd(n=11)
 
 ## Core Concepts
 
+ * **Portal**: An application's "window" into the non-ephemeral world outside the current application
+  execution session. It's a connector that enables a link between a runtime-only ephemeral state and
+  a persistent state that can be saved and loaded across multiple runs of the application and across
+  multiple computers. Portals provide a unified interface for data persistence, caching, and state
+  management across distributed systems. They abstract away the complexities of storage backends
+  (local filesystem, cloud storage, etc.) and handle serialization/deserialization transparently.
+  This allows applications to seamlessly work with persistent data while maintaining isolation between
+  runtime and storage concerns. A program can use multiple portals, each with its own storage backend, and
+  each portal can be used by multiple applications. A portal defines a context for the execution of
+  pure functions, which is used to cache and retrieve results. 
+
 * **Autonomous Function**: A self-contained function that does not depend on external
   imports or definitions. All necessary imports must be done inside the function body.
   These functions cannot use global objects (except built-ins), yield statements, or nonlocal variables.
@@ -165,28 +182,18 @@ assert is_odd(n=11)
   works seamlessly across different machines in a distributed system, enabling significant performance
   improvements for computationally intensive workflows.
 
-* **Validator**: A function that checks if certain conditions are met before or after the execution
-  of a pure function. Pre-validators run before the function, and post-validators run after.
+* **Validator**: An autonomous function that checks if certain conditions are met before or after 
+  the execution of a pure function. Pre-validators run before the function, and post-validators run after.
   They can be passive (e.g., check for available RAM) or active (e.g., install a missing library).
-  For example, `unused_ram(Gb=5)` ensures 5GB of free memory before execution, while `installed_packages("numpy")`
-  verifies or installs required dependencies. Validators help ensure reliable execution across distributed
-  systems by validating requirements and system state. Multiple validators can be combined using the
-  standard decorator syntax to create comprehensive validation chains.
-
-* **Portal**: An application's "window" into the non-ephemeral world outside the current application
-  execution session. It's a connector that enables a link between a runtime-only ephemeral state and
-  a persistent state that can be saved and loaded across multiple runs of the application and across
-  multiple computers. Portals provide a unified interface for data persistence, caching, and state
-  management across distributed systems. They abstract away the complexities of storage backends
-  (local filesystem, cloud storage, etc.) and handle serialization/deserialization transparently.
-  This allows applications to seamlessly work with persistent data while maintaining isolation between
-  runtime and storage concerns.
+  Validators help ensure reliable execution across distributed systems by validating requirements 
+  and system state. Multiple validators can be combined using the standard decorator syntax 
+  to create comprehensive validation chains.
 
-* **Value Address**: A globally unique address of an **immutable value**, derived from its content
+* **Value Address**: A globally unique address of an ***immutable value***, derived from its content
   (type and value). It consists of a human-readable descriptor (often based on the object's type
   and shape/length) and a hash signature (SHA-256, encoded) split into parts for filesystem/storage
   efficiency. Creating a ValueAddr(data) computes the content hash of data and stores the value
-  in the active DataPortal's storage (if not already stored), allowing that value to be retrieved later
+  in the active portal's storage (if not already stored), allowing that value to be retrieved later
   via the address. These addresses are used extensively by the portal to identify stored results
   and to reference inputs/outputs across distributed systems.
 

{pythagoras-0.25.3 → pythagoras-0.25.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "pythagoras"
-version = "0.25.3"
+version = "0.25.5"
 authors = [
     {name = "Volodymyr (Vlad) Pavlov", email = "vlpavlov@ieee.org"},
 ]

{pythagoras-0.25.3 → pythagoras-0.25.5}/src/pythagoras/_080_pure_code_portals/recursion_pre_validator.py

@@ -50,12 +50,17 @@ def _recursion_pre_validator(
         raise TypeError(f"Parameter '{param_name}' must be int, got {type(param_value).__name__}")
     if param_value < 0:
         raise ValueError(f"Parameter '{param_name}' must be non-negative, got {param_value}")
-    if param_value in {0,1}:
+    if param_value in {0,1,2,3,4}:
         return pth.VALIDATION_SUCCESSFUL
-    
+    unpacked_kwargs[param_name] = param_value - 1
+    result_addr = pth.PureFnExecutionResultAddr(
+        fn=fn, arguments=unpacked_kwargs)
+    if result_addr.ready:
+        return pth.VALIDATION_SUCCESSFUL
+    result = result_addr.call_signature
+
     # Binary search to find the smallest n where result_addr.ready is not True
-    left, right = 2, param_value - 1
-    result = pth.VALIDATION_SUCCESSFUL  # Default result if all are ready
+    left, right = 2, param_value - 2
     
     while left <= right:
         mid = (left + right) // 2
@@ -72,7 +77,6 @@ def _recursion_pre_validator(
             # Result is ready, search in the right half
             left = mid + 1
 
-    
     return result