naeural-client 2.5.22__tar.gz → 2.5.24__tar.gz

{naeural_client-2.5.22 → naeural_client-2.5.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: naeural_client
-Version: 2.5.22
+Version: 2.5.24
 Summary: `naeural_client` is the Python SDK required for client app development for the Naeural Edge Protocol Edge Protocol framework
 Project-URL: Homepage, https://github.com/NaeuralEdgeProtocol/naeural_client
 Project-URL: Bug Tracker, https://github.com/NaeuralEdgeProtocol/naeural_client/issues

{naeural_client-2.5.22 → naeural_client-2.5.24}/naeural_client/_ver.py

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

{naeural_client-2.5.22 → naeural_client-2.5.24}/naeural_client/base/generic_session.py

@@ -14,7 +14,7 @@ from ..bc import DefaultBlockEngine, _DotDict
 from ..const import (
   COMMANDS, ENVIRONMENT, HB, PAYLOAD_DATA, STATUS_TYPE, 
   PLUGIN_SIGNATURES, DEFAULT_PIPELINES,
-  BLOCKCHAIN_CONFIG
+  BLOCKCHAIN_CONFIG, SESSION_CT
 )
 from ..const import comms as comm_ct
 from ..io_formatter import IOFormatterWrapper
@@ -2255,6 +2255,7 @@ class GenericSession(BaseDecentrAIObject):
       min_supervisors=2,
       allowed_only=False,
       supervisor=None,
+      df_only=False,
     ):
       """
       This function will return a Pandas dataframe  known nodes in the network based on
@@ -2282,6 +2283,9 @@ class GenericSession(BaseDecentrAIObject):
       supervisor : str, optional  
           The supervisor to wait for. Defaults to None.
           
+      df_only : bool, optional
+          If True, will return only the Pandas dataframe. Defaults to False.
+          
       Returns
       -------
       
@@ -2324,10 +2328,11 @@ class GenericSession(BaseDecentrAIObject):
       elapsed = tm() - start
       # end while
       # done waiting for supervisors
+      best_super = 'ERROR'
+      best_super_alias = 'ERROR'
       
       if len(self.__current_network_statuses) > 0:
         best_info = {}
-        best_super = None
         for supervisor, net_info in self.__current_network_statuses.items():
           if len(net_info) > len(best_info):
             best_info = net_info
@@ -2368,10 +2373,12 @@ class GenericSession(BaseDecentrAIObject):
       # end if
       pd.options.display.float_format = '{:.1f}'.format
       dct_result = _DotDict({
-        'report' : pd.DataFrame(res),
-        'reporter' : best_super,
-        'reporter_alias' : best_super_alias,
-        'nr_super' : len(self.__current_network_statuses),
-        'elapsed' : elapsed,
+        SESSION_CT.NETSTATS_REPORT : pd.DataFrame(res),
+        SESSION_CT.NETSTATS_REPORTER : best_super,
+        SESSION_CT.NETSTATS_REPORTER_ALIAS : best_super_alias,
+        SESSION_CT.NETSTATS_NR_SUPERVISORS : len(self.__current_network_statuses),
+        SESSION_CT.NETSTATS_ELAPSED : elapsed,
       })
+      if df_only:
+        return dct_result[SESSION_CT.NETSTATS_REPORT]
       return dct_result

{naeural_client-2.5.22 → naeural_client-2.5.24}/naeural_client/cli/cli.py

@@ -98,17 +98,18 @@ def main():
   """
   try:
     # Initialize configuration if necessary
-    maybe_init_config()
-
-    # Build the CLI parser
-    parser = build_parser()
-    args = parser.parse_args()
-
-    # Check if a command function is provided
-    if hasattr(args, "func"):
-      args.func(args)  # Pass parsed arguments to the command function
-    else:
-      parser.print_help()
+    initialized = maybe_init_config()
+    
+    if initialized:
+      # Build the CLI parser
+      parser = build_parser()
+      args = parser.parse_args()
+
+      # Check if a command function is provided
+      if hasattr(args, "func"):
+        args.func(args)  # Pass parsed arguments to the command function
+      else:
+        parser.print_help()
 
   except Exception as e:
     # Handle unexpected errors gracefully

naeural_client-2.5.24/naeural_client/cli/nodes.py

@@ -0,0 +1,103 @@
+from time import time
+from naeural_client.utils.config import log_with_color
+from naeural_client.const import SESSION_CT
+
+
+def _get_netstats(
+  silent=True,
+  online_only=False, 
+  allowed_only=False, 
+  supervisor=None,
+  supervisors_only=False,
+):
+  t1 = time()
+  from naeural_client import Session
+  sess = Session(silent=silent)
+  dct_info = sess.get_network_known_nodes(
+    online_only=online_only, allowed_only=allowed_only, supervisor=supervisor,
+    supervisors_only=supervisors_only,
+  )
+  df = dct_info[SESSION_CT.NETSTATS_REPORT]
+  supervisor = dct_info[SESSION_CT.NETSTATS_REPORTER]
+  super_alias = dct_info[SESSION_CT.NETSTATS_REPORTER_ALIAS]
+  nr_supers = dct_info[SESSION_CT.NETSTATS_NR_SUPERVISORS]
+  _elapsed = dct_info[SESSION_CT.NETSTATS_ELAPSED] # computed on call
+  elapsed = time() - t1 # elapsed=_elapsed
+  return df, supervisor, super_alias, nr_supers, elapsed
+
+def get_nodes(args):
+  """
+  This function is used to get the information about the nodes and it will perform the following:
+  
+  1. Create a Session object.
+  2. Wait for the first net mon message via Session and show progress. 
+  3. Wait for the second net mon message via Session and show progress.  
+  4. Get the active nodes union via Session and display the nodes marking those peered vs non-peered.
+  """
+  supervisor_addr = args.supervisor  
+  if args.verbose:
+    log_with_color(f"Getting nodes from supervisor <{supervisor_addr}>...", color='b')
+
+  res = _get_netstats(
+    silent=not args.verbose,
+    online_only=args.online or args.peered,
+    allowed_only=args.peered,
+    supervisor=supervisor_addr,
+  )
+  df, supervisor, super_alias, nr_supers, elapsed = res
+
+  prefix = "Online n" if (args.online or args.peered) else "N"
+  if supervisor == "ERROR":
+    log_with_color(f"No supervisors or no comms available in {elapsed:.1f}s. Please check your settings.", color='r')
+  else:
+    log_with_color(f"{prefix}odes reported by <{supervisor}> '{super_alias}' in {elapsed:.1f}s ({nr_supers} supervisors seen):", color='b')
+    log_with_color(f"{df}")    
+  return
+  
+  
+def get_supervisors(args):
+  """
+  This function is used to get the information about the supervisors.
+  """
+  if args.verbose:
+    log_with_color("Getting supervisors...", color='b')
+
+  res = _get_netstats(
+    silent=not args.verbose,
+    online_only=True,
+    supervisors_only=True,
+  )
+  df, supervisor, super_alias, nr_supers, elapsed = res
+  
+  if supervisor == "ERROR":
+    log_with_color(f"No supervisors or no comms available in {elapsed:.1f}s. Please check your settings.", color='r')
+  else:
+    log_with_color(f"Supervisors reported by <{supervisor}> '{super_alias}' in {elapsed:.1f}s", color='b')
+    log_with_color(f"{df}")
+  return
+
+
+def restart_node(args):
+  """
+  This function is used to restart the node.
+  
+  Parameters
+  ----------
+  args : argparse.Namespace
+      Arguments passed to the function.
+  """
+  log_with_color(f"Restarting node {args.node} NOT IMPLEMENTED", color='r')
+  return
+
+
+def shutdown_node(args):
+  """
+  This function is used to shutdown the node.
+  
+  Parameters
+  ----------
+  args : argparse.Namespace
+      Arguments passed to the function.
+  """
+  log_with_color(f"Shutting down node {args.node} NOT IMPLEMENTED", color='r')
+  return

{naeural_client-2.5.22 → naeural_client-2.5.24}/naeural_client/const/__init__.py

@@ -1,4 +1,4 @@
-from .misc import COLORS, WEEKDAYS_SHORT
+from .misc import COLORS, WEEKDAYS_SHORT, SESSION_CT
 from . import comms as COMMS
 from . import base as BASE_CT
 from . import payload as PAYLOAD_CT

{naeural_client-2.5.22 → naeural_client-2.5.24}/naeural_client/const/misc.py

@@ -18,3 +18,13 @@ WEEKDAYS_SHORT = [
   'SAT',
   'SUN'
 ]
+
+
+class SESSION_CT:
+  NETSTATS_REPORT = 'report'
+  NETSTATS_REPORTER = 'reporter'
+  NETSTATS_REPORTER_ALIAS = 'reporter_alias'
+  NETSTATS_NR_SUPERVISORS = 'nr_super'
+  NETSTATS_ELAPSED = 'elapsed'
+  
+  

{naeural_client-2.5.22 → naeural_client-2.5.24}/naeural_client/utils/config.py

@@ -181,10 +181,12 @@ def load_user_defined_config(verbose=False):
 def maybe_init_config():
   """
   Initializes the configuration if it doesn't exist yet.
+  
+  TODO: in v3+ this will be migrated to a online authentication process.
   """
   config_file = get_user_config_file()
-
   if not config_file.exists():
     log_with_color(f"No configuration file found at {config_file}. Initializing configuration...", color="y") 
     reset_config()
-  load_user_defined_config()
+    return False
+  return load_user_defined_config()

{naeural_client-2.5.22 → naeural_client-2.5.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "naeural_client"
-version = "2.5.22"
+version = "2.5.24"
 authors = [
   { name="Andrei Ionut Damian", email="andrei.damian@me.com" },
   { name="Cristan Bleotiu", email="cristibleotiu@gmail.com" },

naeural_client-2.5.24/xperimental/multi-enc-dec/multi_test2.py

@@ -0,0 +1,44 @@
+import json
+
+from naeural_client import Logger, const
+from naeural_client.bc import DefaultBlockEngine
+
+
+
+if __name__ == '__main__' :
+  l = Logger("ENC", base_folder=".", app_folder="_local_cache")
+  
+  
+  data = {
+  "EE_IS_ENCRYPTED": True,
+  "EE_ENCRYPTED_DATA": "fwcctxETcji64z/KAYFmyWE8RDrJwm2BToMMZD9uesGtWatmDA1nadqpaAwlQajJg9SYb6jeadwxeIqg15VlDmNO9X2dxSiu151Dos900kx2Y8dM3q/S7A==",
+  "EE_ID": "0xai_A9gulGoLPxo7hOo05GIeSvfld_IF_CucTnP00CznjmJN",
+  "SESSION_ID": "SolisClient_bf2d",
+  "INITIATOR_ID": "SolisClient_bf2d",
+  "EE_SENDER": "0xai_Ag28FO6Yg254w-RHsBtODc_WLq7jz4SwfUAW7S7zP0U1",
+  "TIME": "2025-01-07 00:37:16.291005",
+  "EE_SIGN": "MEQCIH9T4_zB4v8cgjhUAwOvELrthGCUZ4v87LR-5DnFetkuAiAm2nOoZIitma10skQbuf12Yp9l_M7zyAcG9mWScuPZGw==",
+  "EE_HASH": "7d7d49f39d1f870af74bece27262d9b050b5358a15c71b249150d04a712ce72c"
+  }
+  
+  
+  eng1 = DefaultBlockEngine(
+    log=l, name="test1", 
+    config={
+        "PEM_FILE"     : "stg-0.pem",
+        "PASSWORD"     : None,      
+        "PEM_LOCATION" : "data"
+      }
+  )
+  
+  
+  ver = eng1.verify(data)
+  
+  eng1.P(f"Signature: {'OK' if ver.valid else 'ERROR'}, {ver}", color='g' if ver.valid else 'r')
+  
+  decr = eng1.decrypt(
+    encrypted_data_b64=data["EE_ENCRYPTED_DATA"],
+    sender_address=data["EE_SENDER"],
+    debug=True,
+  )
+  eng1.P(f"Decrypted: {decr}")

naeural_client-2.5.22/naeural_client/cli/nodes.py

@@ -1,76 +0,0 @@
-from naeural_client.utils.config import log_with_color
-
-
-def get_nodes(args):
-  """
-  This function is used to get the information about the nodes and it will perform the following:
-  
-  1. Create a Session object.
-  2. Wait for the first net mon message via Session and show progress. 
-  3. Wait for the second net mon message via Session and show progress.  
-  4. Get the active nodes union via Session and display the nodes marking those peered vs non-peered.
-  """
-  supervisor_addr = args.supervisor  
-  if args.verbose:
-    log_with_color(f"Getting nodes from supervisor <{supervisor_addr}>...", color='b')
-  from naeural_client import Session
-  sess = Session(silent=not args.verbose)
-  online_only = args.online or args.peered
-  allowed_only = args.peered
-  
-  dct_info = sess.get_network_known_nodes(
-    online_only=online_only, allowed_only=allowed_only, supervisor=supervisor_addr
-  )
-  df = dct_info['report']
-  supervisor = dct_info['reporter']
-  super_alias = dct_info['reporter_alias']
-  nr_supers = dct_info['nr_super']
-  elapsed = dct_info['elapsed']
-  prefix = "Online n" if online_only else "N"
-  log_with_color(f"{prefix}odes reported by <{supervisor}> '{super_alias}' in {elapsed:.1f}s ({nr_supers} supervisors seen):", color='b')
-  log_with_color(f"{df}")    
-  return
-  
-  
-def get_supervisors(args):
-  """
-  This function is used to get the information about the supervisors.
-  """
-  if args.verbose:
-    log_with_color("Getting supervisors...", color='b')
-  from naeural_client import Session  
-  sess = Session(silent=not args.verbose)
-  dct_info = sess.get_network_known_nodes(online_only=True, supervisors_only=True)
-  df = dct_info['report']
-  supervisor = dct_info['reporter']
-  super_alias = dct_info['reporter_alias']
-  elapsed = dct_info['elapsed']  
-  log_with_color(f"Supervisors reported by <{supervisor}> '{super_alias}' in {elapsed:.1f}s", color='b')
-  log_with_color(f"{df}")
-  return
-
-
-def restart_node(args):
-  """
-  This function is used to restart the node.
-  
-  Parameters
-  ----------
-  args : argparse.Namespace
-      Arguments passed to the function.
-  """
-  log_with_color(f"Restarting node {args.node} NOT IMPLEMENTED", color='r')
-  return
-
-
-def shutdown_node(args):
-  """
-  This function is used to shutdown the node.
-  
-  Parameters
-  ----------
-  args : argparse.Namespace
-      Arguments passed to the function.
-  """
-  log_with_color(f"Shutting down node {args.node} NOT IMPLEMENTED", color='r')
-  return