shadedb-api 0.1.2__py3-none-any.whl

shadedb_api/console/__init__.py

@@ -0,0 +1,33 @@
+#Dua for my late mum
+#O Allah, forgive Latifat Temitope and elevate her station among those who are guided. Send her along the path of those who came before, and forgive us and her, O Lord of the worlds. Enlarge for her her grave and shed light upon her in it.
+
+from shadeDB.core import shadeDB
+import sys
+from pathlib import Path
+
+base_path = Path(__file__).resolve().parents[1]
+
+config_path = f"{base_path}/stored.scdb"
+
+def __saver__():
+  try:
+    url = sys.argv[1]
+    token = sys.argv[2]
+  except IndexError:
+    print("""
+    shadedb-api-init  endpoint  token < missing arguments
+    """)
+    sys.exit()
+    
+  
+  scdb = shadeDB(
+      file = config_path,
+      write = True,
+      id = False,
+      silent = True,
+      backup = False
+  )
+  scdb.update(("shadedb-api" , {"endpoint" : url, "token" : token }))
+
+if __name__ == "__main__":
+  pass

shadedb_api/console/cli.py

@@ -0,0 +1,206 @@
+from console.network.connect import shadeDB_cli
+
+import textwrap,subprocess,json, sys
+from pathlib import Path
+
+banner = """\x1b[1;34m
+           :+*:                                                       
+         .%%%%%%:                                                     
+       .#%%%%%%%%#.                                                   
+     -#%%%%%%%%%%%%*                                                  
+    -%%%%%%%%%%%%%%%%:                                                
+    +%%%%%%%%%%%%%%%%%       .=               =                       
+    +#*%%%%%%%%%%%%* %       -%               %       ++++.  *++*.    
+    +- :%%%%%%%%%#.  %       -%               %       ++-=+= *+:=+    
+    +-   #%%%%%%-    %   ###.-% ##  :###  .##:%  ###  +=   + *+  +-   
+    +-    .+%%:      %  :#:*#-%#:## %::*=.%%:*% *%:*# +=   *+*+==*    
+    +%-            =%%  -#=- -%  *% .-+#%-%  .% %++=%-+=   *+*+:=+.   
+    +#*#-        -%#+%   =+%+-%  *%.%*=#%-#   % %====-+=   +-*+  -+   
+    +=:-*%:    .*#*++%  -# :%-%  *%-%  *%:%: *% %* .%:++..-+ *+ .*+   
+    +=:::*%+  %#+++++%  :#%%=-%  *%.#%%%% %%%#% .%%%+ +++++  *++++    
+    +=:::::+%%#++++++%    ..  .   .  .. .  .. .   ..                  
+    +=:::::::+++++++#*                                                
+     #*::::::++++++*%                                                 
+      +%=::::++++#%+                                                  
+        *%+::++*%*                                                    
+          %%=+%#.                                                     
+           .%%.                                                 
+\x1b[1;0m
+"""
+
+class consoleApi:
+  def __init__(self, url:any= None, token:any=None):
+    self.url = url
+    self.token = token
+    self.db_name = None
+    
+    if not self.url or not self.token:
+      if self.url:
+        print("\x1b[1;31mMissing keyword argument token\x1b[1;0m")
+      
+      print("\x1b[1;31mMissing keyword argument url\x1b[1;0m")
+    
+    self.communicate = shadeDB_cli(url = self.url, token = self.token)
+    
+  def process_it(self,entered):
+    
+    entered = entered.split("::",1)
+    if entered[0].lower() in ["insert"]:
+      e = self.communicate.context_manage_cli(command = entered[0], context = entered[1])
+      if isinstance(e,dict):
+        print(f"Database latency: {e.get("dbLatency","Not provided")}\n")
+        
+        print(f"{e.get("result","Result missing")}")
+      else:
+        print(e)
+    elif entered[0].lower() in ["update"]:
+      s_part = entered[1].split("::")
+      jcd = entered[0] + "::" + s_part[:-1]
+      e = self.communicate.context_manage_cli(command = jcd, context = s_part[-1:])
+      if isinstance(e,dict):
+        print(f"Database latency: {e.get("dbLatency","Not provided")}\n")
+        
+        print(f"{e.get("result","Result missing")}")
+      else:
+        print(e)
+    
+    else:
+      jcd = entered[0] + "::" + entered[1]
+      e = self.communicate.general_cli(command = jcd)
+      if isinstance(e, dict):
+        print(f"Database latency: {e.get("dbLatency","Not provided")}\n")
+        
+        print(f"{e.get("result","Result missing")}")
+      else:
+        print(e)
+        
+  def console(self):
+    props = textwrap.dedent(f"""
+  
+    \x1b[1;33mVersion: 0.1 MVP
+    Developer: shade
+    Github: harkerbyte [ https://github.com/harkerbyte ]
+    shadeDB 0.2.8: [ https://pypi.org/project/shadeDB ]      🥚: 98
+    
+    \x1b[1;37m
+    Big thanks to the early adopters who’ve jumped on board.Our mission is locked in: building a high-velocity, self-managing database engine with a native, low-friction learning curve.\n
+    Forget "database babysitting"—we’re handling the infrastructure so you can get back to building the logic that actually matters.
+    
+    
+    """)
+    print(banner)
+    print(self.communicate.remote_status_cli())
+    print(props)
+    
+    
+    while True:
+      entered = input("\n[\x1b[1;36mAPI\x1b[1;0m] $/ ")
+      if entered.strip() == "98":
+        subprocess.run(["xdg-open", "https://chat.whatsapp.com/IhFoE3IptShAzeCBKAkZNM?mode=gi_t"])
+      elif entered.strip().lower() == "console":
+        self.tweak_instance()
+      elif entered.strip().lower() == "exit":
+        return
+      else:
+        self.process_it(entered)
+      
+      
+  def tweak_instance(self):
+    self.db_name = self.communicate.db_name
+    while True:
+      try:
+        entered = input(f"\x1b[1;32m{"CONSOLE" if self.db_name is None else self.db_name.strip()}\x1b[1;0m $/ ").lower()
+        if entered.strip():
+          if entered == "exit":
+            break
+          if entered == "exit 2":
+            sys.exit()
+          if entered.strip() in ["info","information"]:
+            print(f"\x1b[1;37m{self.communicate.db_info_cli()}\x1b[1;0m")
+          else:
+            try:
+              part, part_ = entered.split("::",1)
+              if part.strip() == "name":
+                print(f"{self.communicate.db_name_change_cli(new_name = part_)}")
+                self.db_name = self.communicate.db_name
+              
+              if part.strip() == "stat":
+                if part_.strip() == "volume":
+                  print(f"{self.communicate.db_stat_volume_cli()}")
+              
+                if "page" in part_.strip():
+                  try:
+                    cmd, paged = part_.split("::", 1)
+                    print(f"\x1b[1;37m{self.communicate.db_pagination_cli(paging = paged)}\x1b[1;0m")
+                  
+                  except (TypeError, ValueError):
+                    print("\x1b[1;33mConsole: missing delimiter page :: (1,20)\x1b[1;0m")
+        
+              
+                if "unique" in part_.strip():
+                  try:
+                    cmd, new_unique = part_.split("::",1)
+                    print(f"{self.communicate.db_unique_set_cli(new_unique)}")
+                
+                  except (TypeError , ValueError):
+                    print(f"{self.communicate.db_uniques_cli()}")
+              
+                if "cache" in part_.strip():
+                  try:
+                    cmd, status = part_.split("::",1)
+                    if status.strip():
+                      print(f"{self.communicate.db_cache_cli(set_to = status.strip())}")
+                    
+                  except (TypeError,ValueError):
+                    print("\x1b[1;33mConsole: missing delimiter cache :: activate / deactivate \x1b[1;0m")
+                    
+                if part_.strip() == "terminate":
+                  stat = self.communicate.db_terminate_cli()
+                  if "Deleted" in stat:
+                    self.db_name = "Deleted"
+                    self.communicate.db_name = "Deleted"
+                  
+                  print(stat)
+                  
+              elif part.strip() == "snl":
+                self.process_it(part_)
+              
+            except (TypeError, ValueError):
+              #print("\x1b[1;33mConsole: delimiter :: appears to be missing\x1b[1;0m")
+              pass
+        
+            except Exception as e:
+              print(f"\x1b[1;31m{e}\x1b[1;0m")
+
+      except Exception as e:
+        print(f"\x1b[1;31m{e}\x1b[1;0m")
+
+def __main__():
+  try:
+    url = sys.argv[1]
+    token = sys.argv[2]
+    client = consoleApi(url = url, token = token)
+    client.console()
+  except IndexError:
+      base_path = Path(__file__).resolve().parents[1]
+
+      config_path = f"{base_path}/stored.scdb"
+
+      from shadeDB.core import shadeDB 
+      
+      memory_resident = shadeDB(file = config_path)
+      config = memory_resident.get_context("shadedb-api")
+      config_url = config.get("endpoint", None)
+      config_token = config.get("token", None)
+      if not config_url:
+        print("shadedb-api-init  endpoint < missing arguments")
+        sys.exit()
+      if not config_token:
+        print("shadedb-api-init  endpoint  token < missing arguments")
+        sys.exit()
+        
+      client = consoleApi(url = config_url, token = config_token)
+      client.console()
+  
+if __name__ == "__main__":
+  pass

shadedb_api/console/network/__init__.py

@@ -0,0 +1,2 @@
+#Dua for my late mum
+#O Allah, forgive Latifat Temitope and elevate her station among those who are guided. Send her along the path of those who came before, and forgive us and her, O Lord of the worlds. Enlarge for her her grave and shed light upon her in it.

shadedb_api/console/network/connect.py

@@ -0,0 +1,168 @@
+import requests,json
+
+class shadeDB_cli:
+  def __init__(self, url:str = None, token:str = None):
+    self.url = url
+    self.token = token
+    self.db_name = None
+      
+  
+  def authenticator(self):
+    return {"dbToken" : self.token}
+    
+  def remote_status_cli(self):
+    config = {"type" : "establish"}
+    config.update(self.authenticator())
+    try:
+      r = requests.post(self.url, json = config)
+      if r.status_code == 200:
+        self.db_name = r.json().get("dbName",None)
+        const = ""
+        for k,v in r.json().items():
+          if k == "Tier" or k == "Broadcast":
+            if v:
+              if  "Reference error" not in v:
+                const += f"{k} : {v}\n"
+              
+        return const
+    
+      return f"[server ~ console]: Status code {r.status_code}"
+    except Exception as e:
+      return f"\x1b[1;31m{e}\x1b[1;0m"
+      
+  def general_cli(self, command:str = None):
+    if command:
+      config = { "type" : "string", "command" : command }
+      auth_token = self.authenticator()
+      config.update(auth_token)
+      
+      r = requests.post(self.url , json = config)
+      if r.status_code == 200:
+        return r.json()
+      
+      elif r.status_code == 400:
+        return r.json().get("message", "Status code [400]: message missing.")
+      
+      else:
+        return "Unexpected error"
+        
+  
+  def context_manage_cli(self, command:str = None, context:str|dict = None):
+    if command and context:
+        try:
+          if not isinstance(context,(str,dict)):
+            return "context must be str/dict"
+          
+          if isinstance(context,str):
+            jsonString = context
+          else:
+            jsonString = json.dumps(context)
+        except json.JSONDecodeError as e:
+          raise e
+        finally:
+          auth_token = self.authenticator()
+          
+          config = { "type" :"string/context", "command" : command, "context" : jsonString }
+          config.update(auth_token)
+          
+          r = requests.post(self.url, json = config)
+          
+          if r.status_code == 200:
+            return r.json()
+          
+          elif r.status_code == 400:
+            return r.json().get("message", "Status code [400]: message missing.")
+          
+          else:
+            return False
+  
+  def db_name_change_cli(self,new_name:str=None):
+    config = {"type" : "nameChange", "name" : new_name}
+    config.update(self.authenticator())
+    
+    re = requests.post(self.url, json = config, timeout = 5)
+    if re.status_code == 200:
+      self.db_name = re.json().get("database name","Not specified")
+      return re.json()
+      
+    return f"[server ~ console]: Status code {re.status_code}"
+  
+  def db_stat_volume_cli(self):
+    config = {"type" : "volume"}
+    config.update(self.authenticator())
+    re = requests.post(self.url, json = config, timeout = 5)
+    if re.status_code:
+      re = re.json()
+      return f"{re.get("volume", "Unable to retrieve volume")}"
+    
+    return f"[server ~ console]: Status code {re.status_code}"
+  
+  def db_pagination_cli(self, paging:str=None):
+    try:
+      start, finish = paging.split(",",1)
+      combp = [int(start),int(finish)]
+      config = {"type" : "pagination",  "pageSize" : combp}
+      config.update(self.authenticator())
+      
+      re = requests.post(self.url, json = config, timeout = 5)
+      if re.status_code == 200:
+        return f"[server ~ console]: {re.json()}"
+        
+      return f"[server ~ console]: Status code {re.status_code}"
+      
+        
+    except (TypeError,ValueError):
+      return f"Console: Missing delimiter `,`"
+  
+  def db_uniques_cli(self):
+    config = {"type" : "unique-get"}
+    config.update(self.authenticator())
+    re = requests.post(self.url, json = config, timeout = 5)
+    
+    if re.status_code == 200:
+      return f"[server ~ console]: {re.json()}"
+      
+    return f"[server ~ console]: Status code {re.status_code}"
+      
+  def db_unique_set_cli(self, new_l:str=None):
+    config = {"type" : "unique-set", "newUniques" : new_l}
+    config.update(self.authenticator())
+    
+    re = requests.post(self.url, json = config, timeout = 5)
+    if re.status_code == 200:
+      return re.json()
+      
+    return f"[server ~ console]: Status code {re.status_code}"
+  
+  def db_info_cli(self):
+    config = {"type" : "info"}
+    config.update(self.authenticator())
+    
+    re = requests.post(self.url, json = config, timeout = 5)
+    if re.status_code == 200:
+      return re.json()
+    return f"[server ~ console]: Status code {re.status_code}"
+  
+  def db_cache_cli(self,set_to:str=None):
+    if set_to:
+      config = {"type" : "cache", "setCache" : set_to.lower()}
+      config.update(self.authenticator())
+      
+      re = requests.post(self.url, json = config, timeout = 5)
+      if re.status_code == 200:
+        return re.json()
+        
+      return f"[server ~ console]: Status code {re.status_code}"
+  
+  def db_terminate_cli(self):
+    config = {"type" : "terminate"}
+    config.update(self.authenticator())
+    
+    re = requests.post(self.url, json = config)
+    if re.status_code == 200:
+      return re.json()
+      
+    return f"[server ~ console]: Status code {re.status_code}"
+    
+if __name__ == "__main__":
+  print("Oops, nah")

shadedb_api/frame/__init__.py

@@ -0,0 +1,2 @@
+#Dua for my late mum
+#O Allah, forgive Latifat Temitope and elevate her station among those who are guided. Send her along the path of those who came before, and forgive us and her, O Lord of the worlds. Enlarge for her her grave and shed light upon her in it.

shadedb_api/frame/excepts.py

@@ -0,0 +1,26 @@
+class URLEndpointMissingError(Exception):
+    """Exception raised when the URL endpoint is missing."""
+    def __init__(self, source):
+        self.message = f"{source} missing endpoint url"
+        super().__init__(self.message)
+
+class TokenMissingError(Exception):
+    """Exception raised when the auth token is missing."""
+    def __init__(self, source):
+        self.message = f"{source} missing token"
+        super().__init__(self.message)
+
+class SNLMissingError(Exception):
+    """Exception raised when command is missing."""
+    def __init__(self, source):
+      self.message = f"command missing : {source}"
+      super().__init__(self.message)
+  
+class SNLContextMissingError(Exception):
+  """Exception raised when dict context is missing."""
+  def __init__(self, source):
+    self.message = f"missing dictionary context : {source}"
+    super().__init__(self.message)
+
+if __name__ == "__main__":
+  pass

shadedb_api/frame/sync.py

@@ -0,0 +1,76 @@
+import requests, json
+from frame.excepts import URLEndpointMissingError, TokenMissingError, SNLMissingError, SNLContextMissingError
+
+
+class syncFrame:
+  def __init__(self, endpoint:str=None, token:str|int=None, inspection:bool=False, query_timeout:int=None):
+    self.endpoint = endpoint
+    self.token = token
+    self.inspection = inspection
+    self.query_timeout = query_timeout
+    
+    if not self.endpoint:
+      raise  URLEndpointMissingError(self.endpoint)
+      
+    if not self.token:
+      raise TokenMissingError(self.token)
+  
+  def authenticator(self):
+    return {"dbToken" : self.token }
+    
+  
+  def snlProcess(self, body):
+    default = {
+      "latency" : body.get("dbLatency",None),
+      "result" : body.get("result", "Result missing")
+    }
+    
+  def snlQuery(self, command:str=None):
+    if not command:
+      raise SNLMissingError(self.snlQuery.__name__)
+    
+    
+    config = { "type" : "string", "command" : command }
+    config.update(self.authenticator())
+    re = requests.post( self.endpoint, json = config, timeout = self.query_timeout if self.query_timeout != None else 20 )
+    if re.status_code == 200:
+      if not self.inspection:
+        return re.json().get("result", "Result missing")
+      else:
+        return self.snlProcess( body = re.json())
+  
+  def processContext(body:dict=None):
+    if body:
+      try:
+        dicts = json.dumps(body)
+        return dicts
+      except Exception as e:
+        raise e
+        
+  def snlComplexQuery(self, command:str=None, context:dict=None):
+    if not command:
+      raise SNLMissingError(self.snlComplexQuery.__name__)
+      
+    if not context:
+      raise SNLContextMissingError(self.snlComplexQuery.__name__)
+      
+    veri = processContext( body = context )
+    config = {
+      "type" : "string/context",
+      "context" : veri,
+    }
+    config.update(self.authenticator())
+        
+    re = requests.post(self.endpoint, json = config, timeout = self.query_timeout if self.query_timeout != None else 20 )
+        
+    if re.status_code == 200:
+      if not self.inspection:
+        return re.json().get("result", "Result missing")
+      else:
+        return self.snlProcess(body = re.json())
+        
+    else:
+      re.status_code
+
+if __name__ == "__main__":
+  pass