erioon 0.0.1__tar.gz → 0.0.3__tar.gz

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

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

erioon-0.0.3/README.md

@@ -0,0 +1,2 @@
+# erioon-python-sdk
+# erioon-python-sdk

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.3/erioon/collection.py

@@ -0,0 +1,191 @@
+import json
+import requests
+from colorama import Fore, Style, init
+
+init(autoreset=True)
+
+class Collection:
+    def __init__(
+        self,
+        user_id,
+        db_id,
+        coll_id,
+        metadata,
+        base_url: str = "https://sdk.erioon.com",
+    ):
+        """
+        Initialize a Collection instance.
+
+        Args:
+            user_id (str): Authenticated user ID.
+            db_id   (str): Database ID.
+            coll_id (str): Collection ID.
+            metadata (dict): Collection metadata.
+            base_url (str): Base URL of the Erioon API.
+        """
+        self.user_id = user_id
+        self.db_id = db_id
+        self.coll_id = coll_id
+        self.metadata = metadata
+        self.base_url = base_url.rstrip("/")
+
+    def _print_loading(self) -> None:
+        """Print a green loading message to the terminal."""
+        print(Fore.CYAN + "Erioon is loading..." + Style.RESET_ALL)
+
+    # ---------- READ ---------- #
+    def get_all(self):
+        """
+        Retrieve all documents from this collection.
+
+        Usage:
+            result = collection.get_all()
+        """
+        self._print_loading()
+        url = f"{self.base_url}/{self.user_id}/{self.db_id}/{self.coll_id}/get_all"
+        response = requests.get(url)
+        try:
+            response.raise_for_status()
+            return response.json()
+        except requests.HTTPError as e:
+            return {"status": "KO", "error": str(e), "response": response.json() if response.content else {}}
+
+    def get_specific(self, filters: dict | None = None, limit: int = 1000):
+        """
+        Retrieve documents matching filters.
+
+        Args:
+            filters (dict): Field/value pairs for filtering.
+            limit (int): Max number of docs to retrieve (max 500,000).
+
+        Usage:
+            result = collection.get_specific(filters={"name": "John"}, limit=100)
+        """
+        if limit > 500_000:
+            raise ValueError("Limit of 500,000 exceeded")
+        self._print_loading()
+
+        if filters is None:
+            filters = {}
+
+        url = f"{self.base_url}/{self.user_id}/{self.db_id}/{self.coll_id}/get_specific"
+        params = {**filters, "limit": limit}
+        response = requests.get(url, params=params)
+        try:
+            response.raise_for_status()
+            return response.json()
+        except requests.HTTPError as e:
+            return {"status": "KO", "error": str(e), "response": response.json() if response.content else {}}
+
+    # ---------- CREATE ---------- #
+    def insert_one(self, document: dict):
+        """
+        Insert a single document.
+
+        Args:
+            document (dict): The document to insert.
+
+        Usage:
+            new_doc = {"name": "Alice", "age": 25}
+            result = collection.insert_one(new_doc)
+        """
+        self._print_loading()
+        url = f"{self.base_url}/{self.user_id}/{self.db_id}/{self.coll_id}/insert_one"
+        response = requests.post(url, json=document, headers={"Content-Type": "application/json"})
+        try:
+            response.raise_for_status()
+            return response.json()
+        except requests.HTTPError as e:
+            return {"status": "KO", "error": str(e), "response": response.json() if response.content else {}}
+
+    def insert_many(self, documents: list):
+        """
+        Insert multiple documents at once.
+
+        Args:
+            documents (list): List of dicts representing documents.
+
+        Usage:
+            docs = [{"name": "A"}, {"name": "B"}]
+            result = collection.insert_many(docs)
+        """
+        self._print_loading()
+        url = f"{self.base_url}/{self.user_id}/{self.db_id}/{self.coll_id}/insert_many"
+        response = requests.post(url, json={"records": documents})
+        try:
+            response.raise_for_status()
+            return response.json()
+        except requests.HTTPError as e:
+            return {"status": "KO", "error": str(e), "response": response.json() if response.content else {}}
+
+    # ---------- DELETE ---------- #
+    def delete_one(self, filter_query: dict):
+        """
+        Delete a single document matching the query.
+
+        Args:
+            filter_query (dict): A query to match one document.
+
+        Usage:
+            result = collection.delete_one({"name": "John"})
+        """
+        self._print_loading()
+        url = f"{self.base_url}/{self.user_id}/{self.db_id}/{self.coll_id}/delete_one"
+        response = requests.delete(url, json=filter_query)
+        try:
+            response.raise_for_status()
+            return response.json()
+        except requests.HTTPError as e:
+            return {"status": "KO", "error": str(e), "response": response.json() if response.content else {}}
+
+    def delete_many(self, filter_query: dict):
+        """
+        Delete all documents matching the query.
+
+        Args:
+            filter_query (dict): A query to match multiple documents.
+
+        Usage:
+            result = collection.delete_many({"status": "inactive"})
+        """
+        self._print_loading()
+        url = f"{self.base_url}/{self.user_id}/{self.db_id}/{self.coll_id}/delete_many"
+        response = requests.delete(url, json=filter_query)
+        try:
+            response.raise_for_status()
+            return response.json()
+        except requests.HTTPError as e:
+            return {"status": "KO", "error": str(e), "response": response.json() if response.content else {}}
+
+    # ---------- UPDATE ---------- #
+    def update_query(self, filter_query: dict, update_query: dict):
+        """
+        Update documents matching a filter query.
+
+        Args:
+            filter_query (dict): Query to find documents.
+            update_query (dict): Update operations to apply.
+
+        Usage:
+            result = collection.update_query(
+                {"age": {"$gt": 30}},
+                {"$set": {"status": "senior"}}
+            )
+        """
+        self._print_loading()
+        url = f"{self.base_url}/{self.user_id}/{self.db_id}/{self.coll_id}/update_query"
+        response = requests.patch(url, json={"filter_query": filter_query, "update_query": update_query})
+        try:
+            response.raise_for_status()
+            return response.json()
+        except requests.HTTPError as e:
+            return {"status": "KO", "error": str(e), "response": response.json() if response.content else {}}
+
+    # ---------- dunder helpers ---------- #
+    def __str__(self) -> str:
+        """Return a human-readable JSON string of collection metadata."""
+        return json.dumps(self.metadata, indent=4)
+
+    def __repr__(self) -> str:
+        """Return a developer-friendly representation of the object."""
+        return f"<Collection coll_id={self.coll_id}>"

erioon-0.0.3/erioon/database.py

@@ -0,0 +1,31 @@
+import json
+from erioon.collection import Collection
+
+class Database:
+    def __init__(self, user_id, metadata):
+        self.user_id = user_id
+        self.metadata = metadata
+        self.db_id = metadata.get("database_info", {}).get("_id")
+
+    def __getitem__(self, collection_id):
+        try:
+            collections = self.metadata.get("database_info", {}).get("collections", {})
+            coll_meta = collections.get(collection_id)
+
+            if not coll_meta:
+                return "No collection found"
+
+            return Collection(
+                user_id=self.user_id,
+                db_id=self.db_id,
+                coll_id=collection_id,
+                metadata=coll_meta
+            )
+        except Exception:
+            return "Connection error"
+
+    def __str__(self):
+        return json.dumps(self.metadata, indent=4)
+
+    def __repr__(self):
+        return f"<Database db_id={self.db_id}>"

{erioon-0.0.1 → erioon-0.0.3}/erioon.egg-info/PKG-INFO

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

{erioon-0.0.1 → erioon-0.0.3}/erioon.egg-info/SOURCES.txt

@@ -1,7 +1,9 @@
 LICENSE
+README.md
 setup.py
 erioon/auth.py
 erioon/client.py
+erioon/collection.py
 erioon/database.py
 erioon.egg-info/PKG-INFO
 erioon.egg-info/SOURCES.txt

{erioon-0.0.1 → erioon-0.0.3}/setup.py

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

erioon-0.0.1/erioon/client.py

@@ -1,106 +0,0 @@
-import requests
-from erioon.database import Database
-
-class ErioonClient:
-    """
-    Represents an authenticated Erioon client session.
-
-    Handles user login via email and password, and stores either the user's ID 
-    on success or an error message on failure.
-
-    Usage:
-    >>> client = ErioonClient("<EMAIL>:<PASSWORD>")
-    """
-
-    def __init__(self, email, password, base_url="https://sdk.erioon.com"):
-        """
-        Initializes the client and attempts login.
-
-        Args:
-            email (str): User email address.
-            password (str): User password.
-            base_url (str): The base URL of the Erioon API.
-        """
-        self.email = email
-        self.password = password
-        self.base_url = base_url
-        self.user_id = None
-        self.error = None 
-
-        try:
-            self.user_id = self.login()
-        except Exception as e:
-            self.error = str(e)
-
-    def login(self):
-        """
-        Sends a login request to the Erioon API.
-
-        Returns:
-            str: User ID on successful login.
-
-        Raises:
-            Exception: If the login fails, with the error message from the server.
-        """
-        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(response.text.strip())
-
-    def __str__(self):
-        """
-        Called when print() or str() is used on the object.
-
-        Returns:
-            str: User ID if authenticated, or error message if not.
-        """
-        return self.user_id if self.user_id else self.error
-
-    def __repr__(self):
-        """
-        Called in developer tools or when inspecting the object.
-
-        Returns:
-            str: Formatted string showing either user ID or error.
-        """
-        if self.user_id:
-            return f"<ErioonClient user_id={self.user_id}>"
-        else:
-            return f"<ErioonClient error='{self.error}'>"
-
-    def __getitem__(self, db_id):
-        """
-        Get a Database object by its ID.
-
-        Calls the API to retrieve DB metadata and initializes a Database instance.
-        """
-        if not self.user_id:
-            raise ValueError("Client not authenticated. Cannot access database.")
-        
-        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_error = response.json()
-            return db_error["error"]
-
-        db_info = response.json()
-        return Database(db_info)
-
-    def __str__(self):
-        return self.user_id if self.user_id else self.error
-
-    def __repr__(self):
-        if self.user_id:
-            return f"<ErioonClient user_id={self.user_id}>"
-        else:
-            return f"<ErioonClient error='{self.error}'>"

erioon-0.0.1/erioon/database.py

@@ -1,17 +0,0 @@
-import json
-
-class Database:
-    def __init__(self, metadata):
-        self.metadata = metadata
-
-    def __getitem__(self, collection_id):
-        """
-        Will return a Collection object (to be implemented in next steps).
-        """
-        raise NotImplementedError("Collection access not implemented yet.")
-
-    def __str__(self):
-        return json.dumps(self.metadata, indent=4)
-
-    def __repr__(self):
-        return f"{self.metadata}"