neuronum 5.8.4__py3-none-any.whl → 5.9.0__py3-none-any.whl

neuronum/neuronum.py

@@ -82,17 +82,18 @@ class Cell:
 
     async def sync(self, stx: Optional[str] = None) -> AsyncGenerator[str, None]:
         full_url = f"wss://{self.network}/sync/{stx}"
-        
         auth_payload = {
             "host": self.host,
             "password": self.password,
             "synapse": self.synapse,
         }
 
-        try:
-            async with websockets.connect(full_url) as ws:
-                await ws.send(json.dumps(auth_payload))
-                try:
+        while True:
+            try:
+                async with websockets.connect(full_url) as ws:
+                    await ws.send(json.dumps(auth_payload))
+                    print("Connected to WebSocket.")
+
                     while True:
                         try:
                             raw_operation = await ws.recv()
@@ -100,17 +101,20 @@ class Cell:
                             yield operation
 
                         except asyncio.TimeoutError:
-                            print("No initial data received. Continuing to listen...")
-                            continue
-
-                except asyncio.CancelledError:
-                    print("Connection closed.")
-
-        except websockets.exceptions.WebSocketException as e:
-            print(f"WebSocket error occurred: {e}")
+                            print("No data received. Continuing...")
+                        except websockets.exceptions.ConnectionClosedError as e:
+                            print(f"Connection closed with error: {e}. Reconnecting...")
+                            break
+                        except Exception as e:
+                            print(f"Unexpected error in recv loop: {e}")
+                            break
+
+            except websockets.exceptions.WebSocketException as e:
+                print(f"WebSocket error occurred: {e}. Retrying in 5 seconds...")
+            except Exception as e:
+                print(f"General error occurred: {e}. Retrying in 5 seconds...")
 
-        except Exception as e:
-            print(f"An unexpected error occurred: {e}")
+            await asyncio.sleep(3)
            
 
     async def create_tx(self, descr: str, key_values: dict, stx: str, label: str, partners: list):
@@ -486,4 +490,30 @@ class Cell:
                 print(f"Unexpected error: {e}")
 
 
+    async def notify(self, receiver: str, title: str, message: str):
+        full_url = f"https://{self.network}/api/notify"
+
+        notify_payload = {
+            "receiver": receiver,
+            "notification": {
+                "title": title,
+                "message": message
+            },
+            "cell": self.to_dict()
+        }
+
+        async with aiohttp.ClientSession() as session:
+            try:
+                async with session.post(full_url, json=notify_payload) as response:
+                    response.raise_for_status()
+                    data = await response.json()
+                    print(f"Notification sent successfully: {data}")
+                    return data
+
+            except aiohttp.ClientError as e:
+                print(f"HTTP error while sending notification: {e}")
+            except Exception as e:
+                print(f"Unexpected error: {e}")
+
+
 __all__ = ['Cell']

{neuronum-5.8.4.dist-info → neuronum-5.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuronum
-Version: 5.8.4
+Version: 5.9.0
 Summary: Official client library to interact with the Neuronum Network
 Home-page: https://neuronum.net
 Author: Neuronum Cybernetics
@@ -34,7 +34,7 @@ Dynamic: summary
 <h1 align="center">
   <img src="https://neuronum.net/static/neuronum.svg" alt="Neuronum" width="80">
 </h1>
-<h4 align="center">Neuronum: Build Apps that Connect the World</h4>
+<h4 align="center">Neuronum: The Real Time Data Engine</h4>
 
 <p align="center">
   <a href="https://neuronum.net">
@@ -64,12 +64,12 @@ In this brief getting started guide, you will:
 ------------------
 
 ### **About Neuronum**
-Neuronum empowers developers to build & connect apps, services, and devices into serverless networks able to exchange data in real time
+Neuronum is the real-time data engine designed for developers to build event-driven apps and services in minutes using high-level Python
 
 ### **Features**
 **Cell & Nodes**
 - Cell: Account to connect and interact with Neuronum. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/cell)
-- Nodes: Soft- and Hardware components hosting Neuronum data gateways. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/nodes)
+- Nodes (Apps): Soft- and Hardware components hosting Neuronum data gateways. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/nodes)
 
 **Data Gateways**
 - Transmitters (TX): Securely transmit and receive data packages. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/transmitters)
@@ -104,7 +104,7 @@ neuronum connect-cell                   # connect Cell
 
 
 ### **Build On Neuronum** 
-[View Node Examples](https://github.com/neuronumcybernetics/neuronum/tree/main/features/nodes)
+To dive deeper into Neuronum App development, visit & build with [Node Examples](https://github.com/neuronumcybernetics/neuronum/tree/main/features/nodes/examples)
 
 
 Initialize a Node (app template):
@@ -112,6 +112,94 @@ Initialize a Node (app template):
 neuronum init-node --app                # initialize a Node with app template
 ```
 
+This command prompts you to enter a Node description (e.g Getting Started Node) and creates a new directory named node_<node_id> containing the following files:
+
+.env
+```env
+NODE=your_node_id
+HOST=your_cell_id
+PASSWORD=your_password
+NETWORK=neuronum.net
+SYNAPSE=your_synapse                    # auth token
+```
+
+app.py
+```python
+import asyncio
+import neuronum
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+host = os.getenv("HOST")
+password = os.getenv("PASSWORD")
+network = os.getenv("NETWORK")
+synapse = os.getenv("SYNAPSE")
+
+cell = neuronum.Cell(
+    host=host,
+    password=password,
+    network=network,
+    synapse=synapse
+)
+
+async def main():      
+    STX = "id::stx"                                          
+    async for operation in cell.sync(STX):       
+        txID = operation.get("txID")
+        client = operation.get("operator")                    
+                            
+        if txID == "id::tx":             
+            data = {
+                "json": f"Hello {client}",
+                "html": f"""
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <title>Greeting Node</title>
+  </head>
+  <body>
+    <div class="card">
+      <h1>Hello, {client}</h1>
+    </div>
+  </body>
+</html>
+"""
+
+            }
+            await cell.tx_response(txID, client, data)
+
+asyncio.run(main())
+```
+
+NODE.md
+```
+```json
+{
+    "gateways": [
+        {
+            "type": "stream",
+            "id": "id::stx",
+            "link": "https://neuronum.net/stream/id::stx",
+            "info": "stream info"
+        },
+        {
+            "type": "transmitter",
+            "id": "id::tx",
+            "link": "https://neuronum.net/tx/id::tx",
+            "info": "transmitter info"
+        },
+        {
+            "type": "circuit",
+            "id": "id::ctx",
+            "link": "https://neuronum.net/circuit/id::ctx",
+            "info": "circuit info"
+        }
+    ]
+}
+```
+
 Change into Node folder
 ```sh
 cd node_node_id                         # change directory

neuronum-5.9.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/main.py,sha256=Yec9ovjqM6iI6IyUU8nhgrpcd7rIMocSoZI8QWY1KC4,35684
+neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
+neuronum/neuronum.py,sha256=coAcZQFovKZeGVg8qQpfBkp2NdK4MpiIMdg22Vmi7nc,18490
+neuronum-5.9.0.dist-info/licenses/LICENSE.md,sha256=zGst0rjgnp6oFuRVwFwB1Ql4sDXt_nw9xbUR49Gf99A,2008
+neuronum-5.9.0.dist-info/METADATA,sha256=BlBH6oDflT_V2QmOm1JZjYOaONu4QDWto7QJBTGVL2g,7437
+neuronum-5.9.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+neuronum-5.9.0.dist-info/entry_points.txt,sha256=XKYBcRNxGeJpZZkDPsa8HA_RaJ7Km_R_JaUq5T9Nk2U,42
+neuronum-5.9.0.dist-info/top_level.txt,sha256=ru8Fr84cHm6oHr_DcJ8-uaq3RTiuCRFIr6AC8V0zPu4,13
+neuronum-5.9.0.dist-info/RECORD,,

neuronum-5.8.4.dist-info/RECORD

@@ -1,10 +0,0 @@
-cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cli/main.py,sha256=Yec9ovjqM6iI6IyUU8nhgrpcd7rIMocSoZI8QWY1KC4,35684
-neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
-neuronum/neuronum.py,sha256=L8Oz1qcTyOiYMTGfiSKgN5Nu9jcl25jFeJOh0XItPjw,17201
-neuronum-5.8.4.dist-info/licenses/LICENSE.md,sha256=zGst0rjgnp6oFuRVwFwB1Ql4sDXt_nw9xbUR49Gf99A,2008
-neuronum-5.8.4.dist-info/METADATA,sha256=T9p6cUzgU3c2P9uvagnunGkRVrvC7DKAZZV26JdSQlQ,5367
-neuronum-5.8.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-neuronum-5.8.4.dist-info/entry_points.txt,sha256=XKYBcRNxGeJpZZkDPsa8HA_RaJ7Km_R_JaUq5T9Nk2U,42
-neuronum-5.8.4.dist-info/top_level.txt,sha256=ru8Fr84cHm6oHr_DcJ8-uaq3RTiuCRFIr6AC8V0zPu4,13
-neuronum-5.8.4.dist-info/RECORD,,