neuronum 5.4.3__py3-none-any.whl → 5.6.0__py3-none-any.whl

cli/main.py

@@ -319,6 +319,13 @@ async def async_init_node(sync, stream, app):
     gitignore_path = project_path / ".gitignore"
     await asyncio.to_thread(gitignore_path.write_text, ".env\n")
 
+    requirements_path = project_path / "requirements.txt"
+    requirements_content = """\
+# Please add additional packages below if your Node uses more
+neuronum
+"""
+    await asyncio.to_thread(requirements_path.write_text, requirements_content)
+
     nodemd_path = project_path / "NODE.md"
     await asyncio.to_thread(nodemd_path.write_text, """### NODE.md: How to interact with this Node
 
@@ -487,7 +494,7 @@ asyncio.run(main())
     if app and nodeID:
 
         descr = f"{nodeID} App"                                                  
-        partners = ["public"]                                      
+        partners = ["private"]                                      
         stxID = await cell.create_stx(descr, partners)  
 
 
@@ -497,7 +504,7 @@ asyncio.run(main())
         }
         STX = stxID                                                     
         label = "say:hello"                                                                                                                                                         
-        partners = ["public"]                                                   
+        partners = ["private"]                                                   
         txID = await cell.create_tx(descr, key_values, STX, label, partners)
 
 
@@ -872,6 +879,87 @@ async def async_delete_node():
     click.echo(f"Neuronum Node '{nodeID}' deleted!")
 
 
+@click.command()
+@click.option('--tx', required=True, help="Transmitter ID")
+@click.argument('kvpairs', nargs=-1)
+def activate(tx, kvpairs):
+    try:
+        data = dict(pair.split(':', 1) for pair in kvpairs)
+    except ValueError:
+        click.echo("Invalid input. Use key:value pairs.")
+        return
+
+    asyncio.run(async_activate(tx, data))
+
+async def async_activate(tx, data):
+    credentials_folder_path = Path.home() / ".neuronum"
+    env_path = credentials_folder_path / ".env"
+    env_data = {}
+
+    try:
+        with open(env_path, "r") as f:
+            for line in f:
+                key, value = line.strip().split("=")
+                env_data[key] = value
+    except FileNotFoundError:
+        click.echo("No cell connected. Try: neuronum connect-cell")
+        return
+    except Exception as e:
+        click.echo(f"Error reading .env: {e}")
+        return
+
+    cell = neuronum.Cell(
+        host=env_data.get("HOST", ""),
+        password=env_data.get("PASSWORD", ""),
+        network=env_data.get("NETWORK", ""),
+        synapse=env_data.get("SYNAPSE", "")
+    )
+
+    tx_response = await cell.activate_tx(tx, data)
+    click.echo(tx_response)
+
+
+@click.command()
+@click.option('--ctx', required=True, help="Circuit ID")
+@click.argument('label', nargs=-1)
+def load(ctx, label):
+    if len(label) > 1 and all(Path(x).exists() for x in label):
+        label = "*"
+    else:
+        label = " ".join(label)
+
+    asyncio.run(async_load(ctx, label))
+
+
+async def async_load(ctx, label):
+    credentials_folder_path = Path.home() / ".neuronum"
+    env_path = credentials_folder_path / ".env"
+    env_data = {}
+
+    try:
+        with open(env_path, "r") as f:
+            for line in f:
+                key, value = line.strip().split("=")
+                env_data[key] = value
+    except FileNotFoundError:
+        click.echo("No cell connected. Try: neuronum connect-cell")
+        return
+    except Exception as e:
+        click.echo(f"Error reading .env: {e}")
+        return
+
+    cell = neuronum.Cell(
+        host=env_data.get("HOST", ""),
+        password=env_data.get("PASSWORD", ""),
+        network=env_data.get("NETWORK", ""),
+        synapse=env_data.get("SYNAPSE", "")
+    )
+
+    print(label, ctx)
+    data = await cell.load(label, ctx)
+    click.echo(data)
+
+
 cli.add_command(create_cell)
 cli.add_command(connect_cell)
 cli.add_command(view_cell)
@@ -884,6 +972,8 @@ cli.add_command(connect_node)
 cli.add_command(update_node)
 cli.add_command(disconnect_node)
 cli.add_command(delete_node)
+cli.add_command(activate)
+cli.add_command(load)
 
 
 if __name__ == "__main__":

{neuronum-5.4.3.dist-info → neuronum-5.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuronum
-Version: 5.4.3
+Version: 5.6.0
 Summary: Official client library to interact with the Neuronum Network
 Home-page: https://neuronum.net
 Author: Neuronum Cybernetics
@@ -33,7 +33,7 @@ Dynamic: summary
 <h1 align="center">
   <img src="https://neuronum.net/static/neuronum.svg" alt="Neuronum" width="80">
 </h1>
-<h4 align="center">Build, connect, and automate serverless data infrastructures with Neuronum</h4>
+<h4 align="center">Neuronum: A Serverless Data Network in Pure Python</h4>
 
 <p align="center">
   <a href="https://neuronum.net">
@@ -44,7 +44,7 @@ Dynamic: summary
   </a>
   <a href="https://pypi.org/project/neuronum/">
     <img src="https://img.shields.io/pypi/v/neuronum.svg" alt="PyPI Version">
-  </a>
+  </a><br>
   <img src="https://img.shields.io/badge/Python-3.8%2B-yellow" alt="Python Version">
   <a href="https://github.com/neuronumcybernetics/neuronum/blob/main/LICENSE.md">
     <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License">
@@ -54,22 +54,22 @@ Dynamic: summary
 ---
 
 ### **About Neuronum**
-Neuronum is a python framework to build serverless connected app & data gateways automating the processing and distribution of real-time data transmission, storage, and streaming.
+Neuronum empowers developers to build & connect apps, services, and devices into serverless networks able to exchange data in real time
 
 
 ### **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 gateways. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/nodes)
+- Nodes: Soft- and Hardware components hosting Neuronum data gateways. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/nodes)
 
-**Gateways**
+**Data Gateways**
 - Transmitters (TX): Securely transmit and receive data packages. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/transmitters)
 - Circuits (CTX): Store data in cloud-based key-value-label databases. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/circuits)
 - Streams (STX): Stream, synchronize, and control data in real time. [Learn More](https://github.com/neuronumcybernetics/neuronum/tree/main/features/streams)
 
 ### Requirements
 - Python >= 3.8
-- neuronum >= 5.4.0
+- neuronum >= 5.5.0
 
 ------------------
 
@@ -97,7 +97,7 @@ neuronum connect-cell                   # connect Cell
 ### **Build On Neuronum** **[(Build with Node Examples)](https://github.com/neuronumcybernetics/neuronum/tree/main/features/nodes)**
 Initialize a Node (app template):
 ```sh
-neuronum init-node --app                # initialize a Node with app template
+neuronum init-node --app                # initialize a Node with app template -> creates a folder named node_<node_id> containing all relevant files
 ```
 
 Change into Node folder
@@ -120,7 +120,6 @@ neuronum start-node                     # start Node
 4. Activate Transmitters
 
 #### **Code-based**
-Activate Transmitters (TX) to send requests and receive responses
 ```python
 import asyncio
 import neuronum
@@ -134,13 +133,16 @@ cell = neuronum.Cell(                                   # set Cell connection
 
 async def main():
                                                             
-    TX = txID                                           # select the Transmitter TX
-    data = {
-        "say": "hello",
-    }
+    TX = "id::tx"                                       # select the Transmitter TX
+    data = {"say": "hello"}
     tx_response = await cell.activate_tx(TX, data)      # activate TX - > get response back
-    print(tx_response)                                  # print Cell list
+    print(tx_response)                                  # print tx response
                                       
 asyncio.run(main())
 ```
 
+#### **CLI-based**
+```sh
+neuronum activate --tx id::tx 'say:hello'
+```
+

neuronum-5.6.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/main.py,sha256=WIU5suB-SFPzLswA0i6UyDuNhdevl3vWRAbuh0v4QQY,29888
+neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
+neuronum/neuronum.py,sha256=L8Oz1qcTyOiYMTGfiSKgN5Nu9jcl25jFeJOh0XItPjw,17201
+neuronum-5.6.0.dist-info/licenses/LICENSE.md,sha256=zGst0rjgnp6oFuRVwFwB1Ql4sDXt_nw9xbUR49Gf99A,2008
+neuronum-5.6.0.dist-info/METADATA,sha256=OyxgpKzGQNooCDdXYmOSb58cS18w-Zo3axD9WgPjSwQ,5096
+neuronum-5.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+neuronum-5.6.0.dist-info/entry_points.txt,sha256=XKYBcRNxGeJpZZkDPsa8HA_RaJ7Km_R_JaUq5T9Nk2U,42
+neuronum-5.6.0.dist-info/top_level.txt,sha256=ru8Fr84cHm6oHr_DcJ8-uaq3RTiuCRFIr6AC8V0zPu4,13
+neuronum-5.6.0.dist-info/RECORD,,

neuronum-5.4.3.dist-info/RECORD

@@ -1,10 +0,0 @@
-cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cli/main.py,sha256=v16Fmnv6z3lTv0rn5NUXAOIrYIHTdiLa9Pky71TsaIA,27217
-neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
-neuronum/neuronum.py,sha256=L8Oz1qcTyOiYMTGfiSKgN5Nu9jcl25jFeJOh0XItPjw,17201
-neuronum-5.4.3.dist-info/licenses/LICENSE.md,sha256=zGst0rjgnp6oFuRVwFwB1Ql4sDXt_nw9xbUR49Gf99A,2008
-neuronum-5.4.3.dist-info/METADATA,sha256=go_X7AqeUzjQvD48wPA2qwKk-4i6Sv3KEHigNH_bJBs,5075
-neuronum-5.4.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-neuronum-5.4.3.dist-info/entry_points.txt,sha256=XKYBcRNxGeJpZZkDPsa8HA_RaJ7Km_R_JaUq5T9Nk2U,42
-neuronum-5.4.3.dist-info/top_level.txt,sha256=ru8Fr84cHm6oHr_DcJ8-uaq3RTiuCRFIr6AC8V0zPu4,13
-neuronum-5.4.3.dist-info/RECORD,,