pythagoras 0.25.3__py3-none-any.whl → 0.25.4__py3-none-any.whl

{pythagoras-0.25.3.dist-info → pythagoras-0.25.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pythagoras
-Version: 0.25.3
+Version: 0.25.4
 Summary: Planet-scale distributed computing in Python.
 Keywords: cloud,ML,AI,serverless,distributed,parallel,machine-learning,deep-learning,pythagoras
 Author: Volodymyr (Vlad) Pavlov
@@ -198,6 +198,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.
@@ -220,25 +231,15 @@ assert is_odd(n=11)
 * **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.
   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.dist-info → pythagoras-0.25.4.dist-info}/RECORD

@@ -62,6 +62,6 @@ pythagoras/_900_project_stats_collector/__init__.py,sha256=Eagt-BhPPtBGgpMywx2lk
 pythagoras/_900_project_stats_collector/project_analyzer.py,sha256=uhycFKjUIXEpYcZYnak3yn4JFhchl-oZ7wt6spFxhoY,3574
 pythagoras/__init__.py,sha256=oA6bi5Ov3Io9Adn8zEmSIMqb2NAJM2MUN5fV1y7bgHA,1312
 pythagoras/core/__init__.py,sha256=yfamQZNt_7FL7vfxSoCTZq2ZL6rupp6qzcp9CHhTj3E,2674
-pythagoras-0.25.3.dist-info/WHEEL,sha256=X16MKk8bp2DRsAuyteHJ-9qOjzmnY0x1aj0P1ftqqWA,78
-pythagoras-0.25.3.dist-info/METADATA,sha256=0gDVXOPe0N5MUec2GLaP2avLwe5sFkU2qFYXIlzJ0u8,12390
-pythagoras-0.25.3.dist-info/RECORD,,
+pythagoras-0.25.4.dist-info/WHEEL,sha256=X16MKk8bp2DRsAuyteHJ-9qOjzmnY0x1aj0P1ftqqWA,78
+pythagoras-0.25.4.dist-info/METADATA,sha256=I25zNNhzraBPPIT-N_m1TzImFCdW-SeZEMSjlbh2w9g,12471
+pythagoras-0.25.4.dist-info/RECORD,,