erioon 0.0.2__tar.gz → 0.0.3__tar.gz

{erioon-0.0.2 → erioon-0.0.3}/PKG-INFO

@@ -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/erioon/client.py

@@ -0,0 +1,194 @@
+import os
+import json
+import requests
+from erioon.database import Database
+
+class ErioonClient:
+    """
+    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
+        self.user_id = None
+        self.error = None
+        self.token_path = os.path.expanduser(f"~/.erioon_token_{self._safe_filename(email)}")
+
+        try:
+            self.user_id = self._load_or_login()
+        except Exception as e:
+            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):
+        """
+        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
+
+        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"}
+
+        response = requests.post(url, json=payload, headers=headers)
+        if response.status_code == 200:
+            return response.text.strip()
+        else:
+            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.")
+    
+        try:
+            return self._get_database_info(db_id)
+        except Exception as e:
+            err_msg = str(e).lower()
+            if f"database with {db_id.lower()}" in err_msg or "database" in err_msg:
+                self._clear_cached_token()
+                try:
+                    self.user_id = self._do_login_and_cache()
+                except Exception:
+                    return "Login error"
+    
+                try:
+                    return self._get_database_info(db_id)
+                except Exception:
+                    return f"❌ Database with _id {db_id} ..."
+            else:
+                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"}
+
+        response = requests.post(f"{self.base_url}/db_info", json=payload, headers=headers)
+
+        if response.status_code == 200:
+            db_info = response.json()
+            return Database(self.user_id, db_info)
+        else:
+            try:
+                error_json = response.json()
+                error_msg = error_json.get("error", response.text)
+            except Exception:
+                error_msg = response.text
+            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-0.0.2 → erioon-0.0.3}/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 → erioon-0.0.3}/erioon.egg-info/PKG-INFO

@@ -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.2 → erioon-0.0.3}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup
 
 setup(
     name='erioon',
-    version='0.0.2',
+    version='0.0.3',
     author='Zyber Pireci',
     author_email='zyber.pireci@erioon.com',
     description='Erioon SDF for Python',

erioon-0.0.2/erioon/client.py

@@ -1,108 +0,0 @@
-import os
-import json
-import requests
-from erioon.database import Database
-
-class ErioonClient:
-    def __init__(self, email, password, base_url="http://127.0.0.1:5000"):
-        self.email = email
-        self.password = password
-        self.base_url = base_url
-        self.user_id = None
-        self.error = None
-        self.token_path = os.path.expanduser(f"~/.erioon_token_{self._safe_filename(email)}")
-
-        try:
-            self.user_id = self._load_or_login()
-        except Exception as e:
-            self.error = str(e)
-
-    def _safe_filename(self, text):
-        return "".join(c if c.isalnum() else "_" for c in text)
-
-    def _load_or_login(self):
-        # Try to load from local cache
-        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
-
-        # Fallback: login and cache
-        return self._do_login_and_cache()
-
-    def _do_login_and_cache(self):
-        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):
-        url = f"{self.base_url}/login_with_credentials"
-        payload = {"email": self.email, "password": self.password}
-        headers = {"Content-Type": "application/json"}
-
-        response = requests.post(url, json=payload, headers=headers)
-        if response.status_code == 200:
-            return response.text.strip()
-        else:
-            raise Exception("Invalid account")
-
-    def _clear_cached_token(self):
-        if os.path.exists(self.token_path):
-            os.remove(self.token_path)
-        self.user_id = None
-
-    def __getitem__(self, db_id):
-        if not self.user_id:
-            raise ValueError("Client not authenticated. Cannot access database.")
-    
-        try:
-            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
-                    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):
-        payload = {"user_id": self.user_id, "db_id": db_id}
-        headers = {"Content-Type": "application/json"}
-
-        response = requests.post(f"{self.base_url}/db_info", json=payload, headers=headers)
-
-        if response.status_code == 200:
-            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)
-            except Exception:
-                error_msg = response.text
-            raise Exception(error_msg)
-
-    def __str__(self):
-        return self.user_id if self.user_id else self.error
-
-    def __repr__(self):
-        return f"<ErioonClient user_id={self.user_id}>" if self.user_id else f"<ErioonClient error='{self.error}'>"