aeglis 1.0.0__tar.gz

aeglis-1.0.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.1
+Name: aeglis
+Version: 1.0.0
+Summary: Official Python SDK for the Aeglis Security API
+Home-page: https://developer.aeglis.com
+Author: Aeglis Systems
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown

aeglis-1.0.0/aeglis/__init__.py

@@ -0,0 +1,98 @@
+import os
+import json
+import hmac
+import hashlib
+import requests
+
+class AeglisError(Exception):
+    """Custom exception for Aeglis API errors"""
+    pass
+
+class Aeglis:
+    def __init__(self, api_key: str):
+        """
+        Initialize the Aeglis SDK.
+        :param api_key: Your B2B API Key from the Aeglis Dashboard.
+        """
+        if not api_key:
+            raise ValueError("Aeglis Initialization Error: API key is required.")
+            
+        self.api_key = api_key
+        self.base_url = "https://api.aeglis.com/v3/api"
+        
+        # Use a session for connection pooling (faster subsequent requests)
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {self.api_key}"
+        })
+
+    def scan(self, input_text: str, end_user_id: str = "anonymous") -> dict:
+        """
+        🛡️ QUICK SCAN (Synchronous)
+        Best for short text, URLs, and chat moderation.
+        """
+        if not input_text:
+            raise ValueError("Aeglis Error: input_text is required for Quick Scan.")
+            
+        payload = {
+            "input_text": input_text,
+            "end_user_id": end_user_id
+        }
+        
+        response = self.session.post(f"{self.base_url}/scan", json=payload)
+        
+        if not response.ok:
+            raise AeglisError(f"API Error: {response.text}")
+            
+        return response.json()
+
+    def deep_scan(self, file_path: str, input_text: str = "", end_user_id: str = "anonymous") -> dict:
+        """
+        🔍 DEEP SCAN (Asynchronous File Scanning)
+        Triggers your configured Webhook upon completion.
+        """
+        if not os.path.exists(file_path):
+            raise FileNotFoundError(f"Aeglis Error: File not found at {file_path}")
+            
+        # Using context manager to safely open and read the file
+        with open(file_path, "rb") as f:
+            files = {"file": f}
+            
+            # Form data matches FastAPI Form(...) requirements
+            data = {}
+            if input_text:
+                data["input_text"] = input_text
+            if end_user_id:
+                data["end_user_id"] = end_user_id
+                
+            response = self.session.post(f"{self.base_url}/deep-scan", files=files, data=data)
+            
+        if not response.ok:
+            raise AeglisError(f"API Error: {response.text}")
+            
+        return response.json()
+
+    def verify_webhook(self, raw_payload: bytes, signature_header: str, webhook_secret: str) -> dict:
+        """
+        ⚡ WEBHOOK VERIFICATION (Security)
+        Verifies the incoming HMAC SHA-256 signature to prevent spoofing.
+        """
+        if not raw_payload or not signature_header or not webhook_secret:
+            raise ValueError("Aeglis Webhook Error: Missing payload, signature, or secret.")
+            
+        # Ensure payload is bytes (raw) for accurate hashing
+        if isinstance(raw_payload, str):
+            raw_payload = raw_payload.encode('utf-8')
+            
+        secret_bytes = webhook_secret.encode('utf-8')
+        
+        # Generate the signature using your 'v1=' standard
+        expected_hash = hmac.new(secret_bytes, raw_payload, hashlib.sha256).hexdigest()
+        expected_signature = f"v1={expected_hash}"
+        
+        # Prevent Timing Attacks using compare_digest
+        if not hmac.compare_digest(expected_signature, signature_header):
+            raise AeglisError("Signature Mismatch: Possible spoofing attack blocked.")
+            
+        # If safe, decode and return as a Python dictionary
+        return json.loads(raw_payload.decode('utf-8'))

aeglis-1.0.0/aeglis.egg-info/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.1
+Name: aeglis
+Version: 1.0.0
+Summary: Official Python SDK for the Aeglis Security API
+Home-page: https://developer.aeglis.com
+Author: Aeglis Systems
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown

aeglis-1.0.0/aeglis.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+aeglis/__init__.py
+aeglis.egg-info/PKG-INFO
+aeglis.egg-info/SOURCES.txt
+aeglis.egg-info/dependency_links.txt
+aeglis.egg-info/requires.txt
+aeglis.egg-info/top_level.txt

aeglis-1.0.0/aeglis.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aeglis-1.0.0/aeglis.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.1

aeglis-1.0.0/aeglis.egg-info/top_level.txt

@@ -0,0 +1 @@
+aeglis

aeglis-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

aeglis-1.0.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="aeglis", # Ya "aeglis-sdk" agar naam taken ho
+    version="1.0.0",
+    author="Aeglis Systems",
+    description="Official Python SDK for the Aeglis Security API",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://developer.aeglis.com",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.25.1"
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.7',
+)