mycommerce-platform 0.1.0__tar.gz

mycommerce_platform-0.1.0/.gitignore

@@ -0,0 +1,94 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+.thumbs.db
+
+# Quasar core related directories
+.quasar
+/quasar.config.*.temporary.compiled*
+
+# Cordova related directories and files
+/src-cordova/node_modules
+/src-cordova/platforms
+/src-cordova/plugins
+/src-cordova/www
+
+# Capacitor related directories and files
+/src-capacitor/www
+/src-capacitor/node_modules
+
+# BEX related directories and files
+/src-bex/www
+/src-bex/js/core
+
+# Nuxt dev/build outputs
+.output
+.data
+.nuxt
+.nitro
+.cache
+
+# Local env files
+.env
+.env.*
+.env.local*
+!.env.example
+
+# Misc files
+.fleet
+.tmp
+*.tmp*
+*.sublime-project
+*.sublime-workspace
+UserInterfaceState.xcuserstate
+$RECYCLE.BIN/
+log.txt
+.coverage
+*.sqlite*
+
+# IDE and build directories
+/.ionic
+/.sass-cache
+/.sourcemaps
+/.versions
+/.vscode/*
+!/.vscode/extensions.json
+!/.vscode/settings.json
+/coverage
+/platforms
+/plugins
+/www
+
+# Python
+__pycache__/
+
+# Tests
+*/coverage/
+__snapshots__/
+
+*~
+Thumbs.db
+.pytest_cache

mycommerce_platform-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.5
+Name: mycommerce-platform
+Version: 0.1.0
+Summary: Small, dependency-free Python client for the MyCommerce API gateway
+Project-URL: Homepage, https://github.com/bayzed123/mycommerce
+Project-URL: Repository, https://github.com/bayzed123/mycommerce
+Project-URL: Issues, https://github.com/bayzed123/mycommerce/issues
+Author: MyCommerce Contributors
+License: MIT
+Keywords: api,cart,ecommerce,mycommerce,payments,shop
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# mycommerce-platform
+
+`mycommerce-platform` is the small, dependency-free Python client for the MyCommerce Cloudflare Worker gateway. It gives Python applications one stable base URL while the gateway routes requests to the Shop API, Cart API, and Go Purchase service.
+
+## Install
+
+```bash
+pip install mycommerce-platform
+```
+
+## Usage
+
+```python
+from mycommerce import MyCommerceClient
+
+client = MyCommerceClient(
+    "https://mycommerce-api-gateway.<your-subdomain>.workers.dev",
+    token="optional-jwt-token",
+)
+
+print(client.health())
+products = client.shop("api/v1/shop/")
+cart = client.cart("cart/v1/")
+payment = client.purchase("create", method="POST", payload={"sessionId": "session-123"})
+```
+
+The package only uses Python's standard library. It does not contain Stripe, database, Django, or Cloudflare credentials. Authentication is supplied through the optional bearer token and service authorization remains a gateway/backend responsibility.
+
+## Development
+
+```bash
+cd packages/mycommerce-platform
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -U pip pytest
+pytest
+python -m build
+```
+
+The package is published from GitHub Actions when a `mycommerce-platform-v*` tag is pushed. Configure a PyPI Trusted Publisher for this GitHub repository before creating the first release.

mycommerce_platform-0.1.0/README.md

@@ -0,0 +1,40 @@
+# mycommerce-platform
+
+`mycommerce-platform` is the small, dependency-free Python client for the MyCommerce Cloudflare Worker gateway. It gives Python applications one stable base URL while the gateway routes requests to the Shop API, Cart API, and Go Purchase service.
+
+## Install
+
+```bash
+pip install mycommerce-platform
+```
+
+## Usage
+
+```python
+from mycommerce import MyCommerceClient
+
+client = MyCommerceClient(
+    "https://mycommerce-api-gateway.<your-subdomain>.workers.dev",
+    token="optional-jwt-token",
+)
+
+print(client.health())
+products = client.shop("api/v1/shop/")
+cart = client.cart("cart/v1/")
+payment = client.purchase("create", method="POST", payload={"sessionId": "session-123"})
+```
+
+The package only uses Python's standard library. It does not contain Stripe, database, Django, or Cloudflare credentials. Authentication is supplied through the optional bearer token and service authorization remains a gateway/backend responsibility.
+
+## Development
+
+```bash
+cd packages/mycommerce-platform
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -U pip pytest
+pytest
+python -m build
+```
+
+The package is published from GitHub Actions when a `mycommerce-platform-v*` tag is pushed. Configure a PyPI Trusted Publisher for this GitHub repository before creating the first release.

mycommerce_platform-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mycommerce-platform"
+version = "0.1.0"
+description = "Small, dependency-free Python client for the MyCommerce API gateway"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "MyCommerce Contributors" }]
+keywords = ["mycommerce", "ecommerce", "api", "shop", "cart", "payments"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/bayzed123/mycommerce"
+Repository = "https://github.com/bayzed123/mycommerce"
+Issues = "https://github.com/bayzed123/mycommerce/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mycommerce"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.hatch.version]
+path = "src/mycommerce/__init__.py"

mycommerce_platform-0.1.0/src/mycommerce/__init__.py

@@ -0,0 +1,6 @@
+"""Public API for the mycommerce-platform package."""
+
+from .client import ApiError, MyCommerceClient
+
+__all__ = ["ApiError", "MyCommerceClient"]
+__version__ = "0.1.0"

mycommerce_platform-0.1.0/src/mycommerce/client.py

@@ -0,0 +1,83 @@
+"""Small standard-library-only client for the MyCommerce API gateway."""
+
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
+from typing import Any, Mapping
+from urllib.error import HTTPError, URLError
+from urllib.parse import urljoin
+from urllib.request import Request, urlopen
+
+
+class ApiError(RuntimeError):
+    """Raised when the gateway cannot return a successful JSON response."""
+
+    def __init__(self, status: int, message: str, payload: Any = None) -> None:
+        super().__init__(f"MyCommerce API error {status}: {message}")
+        self.status = status
+        self.payload = payload
+
+
+@dataclass
+class MyCommerceClient:
+    """Client for the Worker gateway and its three backend routes.
+
+    The gateway is expected to expose `/shop/*`, `/cart/*`, and `/purchase/*`.
+    The client does not contain service credentials; authentication is supplied
+    through the optional bearer token at request time or construction time.
+    """
+
+    base_url: str
+    token: str | None = None
+    timeout: float = 15.0
+
+    def _request(
+        self,
+        method: str,
+        route: str,
+        payload: Mapping[str, Any] | list[Any] | None = None,
+        *,
+        token: str | None = None,
+    ) -> Any:
+        url = urljoin(self.base_url.rstrip("/") + "/", route.lstrip("/"))
+        headers = {"Accept": "application/json"}
+        auth_token = token or self.token
+        if auth_token:
+            headers["Authorization"] = f"Bearer {auth_token}"
+        body = None
+        if payload is not None:
+            headers["Content-Type"] = "application/json"
+            body = json.dumps(payload).encode("utf-8")
+        request = Request(url, data=body, headers=headers, method=method.upper())
+        try:
+            with urlopen(request, timeout=self.timeout) as response:
+                raw = response.read()
+                if not raw:
+                    return None
+                return json.loads(raw.decode("utf-8"))
+        except HTTPError as error:
+            raw = error.read().decode("utf-8", errors="replace")
+            try:
+                payload_data = json.loads(raw) if raw else None
+            except json.JSONDecodeError:
+                payload_data = raw
+            raise ApiError(error.code, error.reason, payload_data) from error
+        except URLError as error:
+            raise ApiError(0, str(error.reason)) from error
+
+    def health(self) -> Any:
+        """Return the gateway health response."""
+        return self._request("GET", "/health")
+
+    def shop(self, path: str = "", *, method: str = "GET", payload: Any = None) -> Any:
+        """Call a path proxied to the Shop API."""
+        return self._request(method, f"/shop/{path.lstrip('/')}", payload)
+
+    def cart(self, path: str = "", *, method: str = "GET", payload: Any = None) -> Any:
+        """Call a path proxied to the Cart API."""
+        return self._request(method, f"/cart/{path.lstrip('/')}", payload)
+
+    def purchase(self, path: str = "", *, method: str = "GET", payload: Any = None) -> Any:
+        """Call a path proxied to the Go Purchase service."""
+        return self._request(method, f"/purchase/{path.lstrip('/')}", payload)

mycommerce_platform-0.1.0/tests/test_client.py

@@ -0,0 +1,22 @@
+from unittest.mock import patch
+
+from mycommerce import ApiError, MyCommerceClient
+
+
+def test_route_prefixes_are_forwarded_to_the_gateway():
+    client = MyCommerceClient("https://api.example.test")
+    with patch.object(client, "_request", return_value={"ok": True}) as request:
+        assert client.shop("api/v1/products") == {"ok": True}
+        assert client.cart("cart/v1/items", method="POST", payload={"id": 1}) == {"ok": True}
+        assert client.purchase("create", method="POST", payload={"total": 10}) == {"ok": True}
+
+    assert request.call_count == 3
+    assert request.call_args_list[0].args == ("GET", "/shop/api/v1/products", None)
+    assert request.call_args_list[1].args == ("POST", "/cart/cart/v1/items", {"id": 1})
+    assert request.call_args_list[2].args == ("POST", "/purchase/create", {"total": 10})
+
+
+def test_api_error_exposes_status_and_payload():
+    error = ApiError(401, "Unauthorized", {"detail": "invalid token"})
+    assert error.status == 401
+    assert error.payload["detail"] == "invalid token"