erioon 0.0.2__py3-none-any.whl → 0.0.3__py3-none-any.whl

erioon/client.py

@@ -4,7 +4,29 @@ import requests
 from erioon.database import Database
 
 class ErioonClient:
-    def __init__(self, email, password, base_url="http://127.0.0.1:5000"):
+    """
+    Client SDK for interacting with the Erioon API.
+
+    Handles user authentication, token caching, and accessing user databases.
+
+    Attributes:
+        email (str): User email for login.
+        password (str): User password for login.
+        base_url (str): Base URL of the Erioon API.
+        user_id (str | None): Authenticated user ID.
+        error (str | None): Stores error messages if login fails.
+        token_path (str): Local path to cached authentication token.
+    """
+
+    def __init__(self, email, password, base_url="https://sdk.erioon.com"):
+        """
+        Initialize ErioonClient instance, attempts to load cached token or perform login.
+
+        Args:
+            email (str): User email for authentication.
+            password (str): User password for authentication.
+            base_url (str, optional): Base API URL. Defaults to "https://sdk.erioon.com".
+        """
         self.email = email
         self.password = password
         self.base_url = base_url
@@ -18,27 +40,61 @@ class ErioonClient:
             self.error = str(e)
 
     def _safe_filename(self, text):
+        """
+        Converts a string into a safe filename by replacing non-alphanumeric chars with underscores.
+
+        Args:
+            text (str): Input string to convert.
+
+        Returns:
+            str: Sanitized filename-safe string.
+        """
         return "".join(c if c.isalnum() else "_" for c in text)
 
     def _load_or_login(self):
-        # Try to load from local cache
+        """
+        Load cached user_id token from local storage or perform login if not cached.
+
+        Returns:
+            str: User ID from token or fresh login.
+
+        Raises:
+            Exception: If login fails.
+        """
         if os.path.exists(self.token_path):
             with open(self.token_path, "r") as f:
                 token_data = json.load(f)
                 user_id = token_data.get("user_id")
                 if user_id:
-                    return user_id  # ✅ Use cached value without API call
+                    return user_id
 
-        # Fallback: login and cache
         return self._do_login_and_cache()
 
     def _do_login_and_cache(self):
+        """
+        Perform login to API and cache the user_id token locally.
+
+        Returns:
+            str: User ID from successful login.
+
+        Raises:
+            Exception: If login fails.
+        """
         user_id = self._login()
         with open(self.token_path, "w") as f:
             json.dump({"user_id": user_id}, f)
         return user_id
 
     def _login(self):
+        """
+        Authenticate with Erioon API using email and password.
+
+        Returns:
+            str: User ID on successful authentication.
+
+        Raises:
+            Exception: If credentials are invalid.
+        """
         url = f"{self.base_url}/login_with_credentials"
         payload = {"email": self.email, "password": self.password}
         headers = {"Content-Type": "application/json"}
@@ -50,11 +106,31 @@ class ErioonClient:
             raise Exception("Invalid account")
 
     def _clear_cached_token(self):
+        """
+        Remove cached token file and reset user_id to None.
+        """
         if os.path.exists(self.token_path):
             os.remove(self.token_path)
         self.user_id = None
 
     def __getitem__(self, db_id):
+        """
+        Access a Database object by database ID.
+
+        Args:
+            db_id (str): The ID of the database to access.
+
+        Returns:
+            Database: An instance representing the database.
+
+        Raises:
+            ValueError: If client is not authenticated.
+            Exception: For other API errors not related to database existence.
+
+        Handles:
+            On database-related errors, tries to relogin once. If relogin fails, returns "Login error".
+            If database still not found after relogin, returns a formatted error message.
+        """
         if not self.user_id:
             raise ValueError("Client not authenticated. Cannot access database.")
     
@@ -62,28 +138,33 @@ class ErioonClient:
             return self._get_database_info(db_id)
         except Exception as e:
             err_msg = str(e).lower()
-            # Check if error is a database error mentioning the db_id
             if f"database with {db_id.lower()}" in err_msg or "database" in err_msg:
-                # Try relogin once
                 self._clear_cached_token()
                 try:
                     self.user_id = self._do_login_and_cache()
                 except Exception:
                     return "Login error"
     
-                # Retry fetching database info
                 try:
                     return self._get_database_info(db_id)
-                except Exception as e2:
-                    print(f"❌ Database with _id {db_id} ...")
-                    # Optionally you could also return or raise the error here
+                except Exception:
                     return f"❌ Database with _id {db_id} ..."
             else:
-                # Not a DB-related error, just propagate or raise
                 raise e
     
-
     def _get_database_info(self, db_id):
+        """
+        Helper method to fetch database info from API and instantiate a Database object.
+
+        Args:
+            db_id (str): The database ID to fetch.
+
+        Returns:
+            Database: Database instance with the fetched info.
+
+        Raises:
+            Exception: If API returns an error.
+        """
         payload = {"user_id": self.user_id, "db_id": db_id}
         headers = {"Content-Type": "application/json"}
 
@@ -93,7 +174,6 @@ class ErioonClient:
             db_info = response.json()
             return Database(self.user_id, db_info)
         else:
-            # Try parse error json
             try:
                 error_json = response.json()
                 error_msg = error_json.get("error", response.text)
@@ -102,7 +182,13 @@ class ErioonClient:
             raise Exception(error_msg)
 
     def __str__(self):
+        """
+        String representation: returns user_id if authenticated, else the error message.
+        """
         return self.user_id if self.user_id else self.error
 
     def __repr__(self):
+        """
+        Developer-friendly string representation of the client instance.
+        """
         return f"<ErioonClient user_id={self.user_id}>" if self.user_id else f"<ErioonClient error='{self.error}'>"

erioon/collection.py

@@ -11,7 +11,7 @@ class Collection:
         db_id,
         coll_id,
         metadata,
-        base_url: str = "http://127.0.0.1:5000",
+        base_url: str = "https://sdk.erioon.com",
     ):
         """
         Initialize a Collection instance.

{erioon-0.0.2.dist-info → erioon-0.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: erioon
-Version: 0.0.2
+Version: 0.0.3
 Summary: Erioon SDF for Python
 Author: Zyber Pireci
 Author-email: zyber.pireci@erioon.com

erioon-0.0.3.dist-info/RECORD

@@ -0,0 +1,9 @@
+erioon/auth.py,sha256=-a8g7JZKsQ_yir_iZMYbfhiBJT0hYDmfJSj6B1u3M84,704
+erioon/client.py,sha256=5VKxfHUdChwFRA1bRWCt6p10y1SF7XR1PWp6wt7qQgg,6532
+erioon/collection.py,sha256=AiL035fGt-SQ_MovqEDSo1M9cz20xKYutfLEq74GYGM,6924
+erioon/database.py,sha256=n3arbUCYzJ1WAIh_1hgjJjUuCpyRVRP1quXGkTVgrsQ,953
+erioon-0.0.3.dist-info/LICENSE,sha256=xwnq3DNlZpQyteOK9HvtHRhMdYviXTTaCDljEodFRnQ,569
+erioon-0.0.3.dist-info/METADATA,sha256=ERc8TC1vVGzp2vNuvZQzrr89jApRhIV2oHnqGNrA67k,715
+erioon-0.0.3.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+erioon-0.0.3.dist-info/top_level.txt,sha256=yjKEg85X5Q5ot46IMML_xukvIGG5YfdrLWcemjalItc,7
+erioon-0.0.3.dist-info/RECORD,,

erioon-0.0.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-erioon/auth.py,sha256=-a8g7JZKsQ_yir_iZMYbfhiBJT0hYDmfJSj6B1u3M84,704
-erioon/client.py,sha256=D5QHIdEL-13-dAoT5CITqbW9RqKUGEfswtTY8kTZH8w,3990
-erioon/collection.py,sha256=55CXEdB7ZmuqyHzHa39-SVRk2WJN-n_Yovb9rSlL-fg,6923
-erioon/database.py,sha256=n3arbUCYzJ1WAIh_1hgjJjUuCpyRVRP1quXGkTVgrsQ,953
-erioon-0.0.2.dist-info/LICENSE,sha256=xwnq3DNlZpQyteOK9HvtHRhMdYviXTTaCDljEodFRnQ,569
-erioon-0.0.2.dist-info/METADATA,sha256=0KLMfL0VvGu3Z9igmof68t5jip8CRyUi2zOVmlqLF9Q,715
-erioon-0.0.2.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-erioon-0.0.2.dist-info/top_level.txt,sha256=yjKEg85X5Q5ot46IMML_xukvIGG5YfdrLWcemjalItc,7
-erioon-0.0.2.dist-info/RECORD,,