ratio1 3.4.120__tar.gz → 3.4.122__tar.gz

ratio1-3.4.122/AGENTS.md

@@ -0,0 +1,45 @@
+# AGENTS
+
+## Objectives
+- Provide a Python SDK for the Ratio1 network so clients can build and deploy low-code job/pipeline workloads to Ratio1 Edge Nodes.
+- Offer tooling for node discovery, auth (dAuth), and cooperative execution across nodes.
+- Ship a CLI for interacting with the network and node management workflows.
+
+## Repository Structure
+- `ratio1/`: main Python package
+- `ratio1/base/`: core session/pipeline/instance abstractions and plugin templates
+- `ratio1/bc/`: blockchain, dAuth, and EVM-related logic
+- `ratio1/default/`: default implementations (MQTT session and instance defaults)
+- `ratio1/cli/`: CLI implementation (entrypoint for `r1ctl`)
+- `ratio1/ipfs/`: IPFS/R1FS helpers and integrations
+- `ratio1/logging/`: logging mixins and upload/download helpers
+- `ratio1/const/`: constants and shared enums
+- `ratio1/utils/`: utility helpers (env loading, tooling, oracles)
+- `tutorials/`: runnable examples and usage patterns
+- `README.md`: high-level overview and quick start
+- `r1ctl.MD`: CLI manual (nepctl/r1ctl usage)
+- `pyproject.toml`: packaging metadata and CLI script entrypoint
+
+## Module Responsibilities
+- `ratio1/base/generic_session.py`: session lifecycle, node discovery, request/response flow
+- `ratio1/base/pipeline.py`: pipeline definitions, command sending, and transaction tracking
+- `ratio1/base/instance.py`: instance-level control and command orchestration
+- `ratio1/base/plugin_template.py`: remote execution template and plugin API surface
+- `ratio1/bc/base.py`: signing/verification utilities and dAuth autoconfiguration
+- `ratio1/bc/evm.py`: EVM interactions and transaction wait utilities
+- `ratio1/ipfs/r1fs.py`: IPFS/R1FS client utilities and request wrappers
+- `ratio1/cli/`: `r1ctl` command implementations and user-facing CLI flows
+
+## Key Entry Points
+- `ratio1/__init__.py`: exports `Session`, `Pipeline`, `Instance`, `CustomPluginTemplate`, presets, and helpers.
+- CLI: `r1ctl` -> `ratio1.cli.cli:main` (see `r1ctl.MD` for commands).
+
+## Development Notes
+- dAuth is used for auto-configuration; network calls should set explicit timeouts.
+- `template.env` and `.env` are used for local config and secrets.
+- Docs mention `nepctl` while packaging registers `r1ctl`; confirm expected CLI naming when updating docs.
+
+## Update Log (append-only)
+- 2025-12-22: Added `request_timeout` to `dauth_autocomplete` to prevent hanging HTTP requests.
+- 2025-12-22: Expanded AGENTS repo structure notes and flagged `nepctl`/`r1ctl` naming mismatch.
+- (add new entries here)

{ratio1-3.4.120 → ratio1-3.4.122}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ratio1
-Version: 3.4.120
+Version: 3.4.122
 Summary: `ratio1` or Ration1 SDK is the Python SDK required for client app development for the Ratio1 ecosystem
 Project-URL: Homepage, https://github.com/Ratio1/ratio1_sdk
 Project-URL: Bug Tracker, https://github.com/Ratio1/ratio1_sdk/issues

{ratio1-3.4.120 → ratio1-3.4.122}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ratio1"
-version = "3.4.120"
+version = "3.4.122"
 authors = [
   { name="Andrei Ionut Damian", email="andrei.damian@ratio1.ai" },
   { name="Cristan Bleotiu", email="cristian.bleotiu@ratio1.ai" },

{ratio1-3.4.120 → ratio1-3.4.122}/ratio1/_ver.py

@@ -1,4 +1,4 @@
-__VER__ = "3.4.120"
+__VER__ = "3.4.122"
 
 if __name__ == "__main__":
   with open("pyproject.toml", "rt") as fd:

{ratio1-3.4.120 → ratio1-3.4.122}/ratio1/bc/base.py

@@ -1444,6 +1444,7 @@ class BaseBlockEngine(
     network=None,
     return_full_data=False,
     debug_data=False,
+    request_timeout=(3.05, 27),
     **kwargs
   ):
     """
@@ -1455,6 +1456,7 @@ class BaseBlockEngine(
     debug
     max_tries
     network
+    request_timeout
     kwargs
 
     Returns
@@ -1533,8 +1535,8 @@ class BaseBlockEngine(
           self.sign(to_send)    
           json_to_send = {'body' : to_send}
           if debug:
-            self.P(f"Sending to dAuth URL: {url}\n{json.dumps(json_to_send, indent=2)}")   
-          response = requests.post(url, json=json_to_send)
+            self.P(f"Requesting dAuth (timeout={request_timeout}): {url}\n{json.dumps(json_to_send, indent=2)}")   
+          response = requests.post(url, json=json_to_send, timeout=request_timeout)
           if debug:
             self.P(f"Received response (status {response.status_code}).")
           if response.status_code == 200:

{ratio1-3.4.120 → ratio1-3.4.122}/ratio1/logging/logger_mixins/json_serialization_mixin.py

@@ -346,12 +346,13 @@ class _JSONSerializationMixin(object):
 
     with self.managed_lock_resource(path, condition=locking):
       try:
+        indent = 4 * ' ' if indent else None
         with open(path, 'w') as fp:
           json.dump(
             data_json, 
             fp, 
             sort_keys=True, 
-            indent=4 if indent else None, 
+            indent=indent,
             cls=NPJson
           )    
       except Exception as e: