mm-mobile-sdk 0.1.0__tar.gz

mm_mobile_sdk-0.1.0/.gitignore

@@ -0,0 +1 @@
+venv/

mm_mobile_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.5
+Name: mm-mobile-sdk
+Version: 0.1.0
+Summary: Python SDK for the Marketplace Mobile API
+Author-email: Manali Rathod <manali.empiric98@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.31.0

mm_mobile_sdk-0.1.0/manual_test.py

@@ -0,0 +1,32 @@
+from mm_mobile_sdk.http import HTTPClient
+from mm_mobile_sdk.auth import AuthManager
+
+
+http = HTTPClient(base_url="https://marketplacemoniter-staging.azurewebsites.net/")
+auth = AuthManager(http)
+
+# Step 1: login - should populate auth.access_token and attach the header
+login_response = auth.login("niralempiric6@gmail.com", "Test@123")
+print("Logged in. is_authenticated =", auth.is_authenticated)
+print("Authorization header set to:", http.session.headers.get("Authorization")[:30], "...")
+
+# Step 2: make an authenticated call WITHOUT manually passing a token- 
+# this proves the header attached in step 1 is actually being reused
+user_details = http.post("users-details/")
+print("Authenticated call result:", user_details)
+
+# Step 3: logout - should clear the token and remove the header
+auth.logout()
+print("After logout, is_authenticated = ", auth.is_authenticated)
+print("Authorization header now:", http.session.headers.get("Authorization"))
+
+# try: 
+#     result = client.post("login/", json={
+#         "username" : "Aniralempiric6@gmail.com",
+#         "password" : "Test@123",
+#     })
+#     print("Sucess", result)
+# except AuthenticationError as e:
+#     print("Correctly raised AuthenticationError:", e.status_code, e.message)
+# except MarketplaceAPIError as e:
+    # print("Raised a different MarketplaceAPIError subtype:", type(e).__name__, e.status_code,  e.message)

mm_mobile_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+[project]
+name = "mm-mobile-sdk"
+version = "0.1.0"
+description = "Python SDK for the Marketplace Mobile API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    { name = "Manali Rathod", email = "manali.empiric98@gmail.com" }
+]
+dependencies = [
+    "requests>=2.31.0"
+]
+[tool.hatch.build.targets.wheel]
+packages = ["src/mm_mobile_sdk"]

mm_mobile_sdk-0.1.0/src/mm_mobile_sdk/auth.py

@@ -0,0 +1,36 @@
+from .http import HTTPClient
+from .exceptions import AuthenticationError
+
+
+class AuthManager:
+    """Owns the current auth token and attaches it to the shared HTTP session."""
+
+    def __init__(self, http_client:HTTPClient):
+        self._http = http_client
+        self.access_token = None
+        self.refresh_token = None
+
+    def login(self, username, password):
+        response = self._http.post("login/", json={
+            "username": username, 
+            "password": password,
+        })
+
+        token_data = response.get("token") if response else None
+        if not token_data or "access" not in token_data:
+            raise AuthenticationError("Login response did not contain a token", response_body=response)
+
+        self.access_token = token_data["access"]
+        self.refresh_token = token_data.get("refresh")
+        self._http.session.headers["Authorization"] = self.access_token
+        return response
+
+
+    def logout(self):
+        self.access_token = None
+        self.refresh_token = None
+        self._http.session.headers.pop("Authorization", None)
+
+    @property
+    def is_authenticated(self):
+        return self.access_token is not None

mm_mobile_sdk-0.1.0/src/mm_mobile_sdk/client.py

@@ -0,0 +1,10 @@
+from .http import HTTPClient
+from .auth import AuthManager
+
+
+class MarketplaceClient:
+    """Single entry point to the Marketplace Mobile API."""
+
+    def __init__(self, base_url, timeout=10):
+        self._http = HTTPClient(base_url, timeout=timeout)
+        self.auth = AuthManager(self._http)

mm_mobile_sdk-0.1.0/src/mm_mobile_sdk/exceptions.py

@@ -0,0 +1,32 @@
+class MarketplaceAPIError(Exception):
+    """Base exception for all SDK errors."""
+
+    def __init__(self, message, status_code=None, response_body=None):
+        super().__init__(message)
+        self.message = message
+        self.status_code = status_code
+        self.response_body = response_body
+
+
+class AuthenticationError(MarketplaceAPIError):
+    """Raised on 401 - invalid/expired/blacklisted token, or bad login credentials."""
+
+
+class ValidationError(MarketplaceAPIError):
+    """Raised on 400/422 - the server rejected the request payload."""
+
+
+class NotFoundError(MarketplaceAPIError):
+    """Raised on 404 - resource does not exist."""
+
+
+class RateLimitError(MarketplaceAPIError):
+    """Raised on 429 - request was throttled"""
+
+
+class ServerError(MarketplaceAPIError):
+    """Raised on 5xx — something failed on the server side."""
+
+
+class NetworkError(MarketplaceAPIError):
+    """Raised when the request never reached the server (timeout, DNS, connection refused)."""

mm_mobile_sdk-0.1.0/src/mm_mobile_sdk/http.py

@@ -0,0 +1,62 @@
+import requests
+from . import exceptions
+
+
+class HTTPClient:
+    """Low-level request/response layer. knows nothing about auth, token, or specific endpoints."""
+
+    def __init__(self, base_url, timeout=10):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.session = requests.Session()
+        self.session.headers.update({"Content-Type": "application/json"})
+
+
+    def request(self, method, path, **kwargs):
+        url = f"{self.base_url}/{path.lstrip('/')}"
+        try:
+            response = self.session.request(method, url, timeout=self.timeout, **kwargs)
+        except requests.exceptions.RequestException as exc:
+            raise exceptions.NetworkError(str(exc)) from exc
+        return self._handle_response(response)
+
+
+    def get(self, path, **kwargs):
+        return self.request("GET", path, **kwargs)
+
+
+    def post(self, path, **kwargs):
+        return self.request("POST", path, **kwargs)
+
+
+    def patch(self, path, **kwargs):
+        return self.request("PATCH", path, **kwargs)
+    
+
+    def delete(self, path, **kwargs):
+        return self.request("DELETE", path, **kwargs)
+
+
+    def _handle_response(self, response):
+        try:
+            body = response.json()
+        except ValueError:
+            body = None
+
+        if response.status_code < 400:
+            return body
+
+        message = (body or {}).get("message") or (body or {}).get("error") or response.text
+
+        if response.status_code == 401:
+            raise exceptions.AuthenticationError(message, response.status_code, body)
+        if response.status_code in (400, 422):
+            raise exceptions.ValidationError(message, response.status_code, body)
+        if response.status_code == 404:
+            raise exceptions.NotFoundError(message, response.status_code, body)
+        if response.status_code == 429:
+            raise exceptions.RateLimitError(message, response.status_code, body)
+        if response.status_code >= 500:
+            raise exceptions.ServerError(message, response.status_code, body)
+
+        raise exceptions.MarketplaceAPIError(message, response.status_code, body)

mm_mobile_sdk-0.1.0/test.py

@@ -0,0 +1,12 @@
+from mm_mobile_sdk.client import MarketplaceClient
+
+client = MarketplaceClient(base_url="https://marketplacemoniter-staging.azurewebsites.net/")
+
+client.auth.login("niralempiric6@gmail.com", "Test@123")
+print("is_authenticated:", client.auth.is_authenticated)
+
+keywords = client._http.get("keywords/")
+print("Authenticated call result:", keywords)
+
+client.auth.logout()
+print("is_authenticated after logout:", client.auth.is_authenticated)