python-mope 0.0.6__tar.gz → 0.3.0__tar.gz

python_mope-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Lemuel Boyce
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_mope-0.3.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: python-mope
+Version: 0.3.0
+Summary: A client library for interacting with the Mopé Web Shop API
+Author-email: Lemuel Boyce <lemuel@vokality.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/rhymiz/python-mope
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Programming Language :: Python :: 3.15
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 6 - Mature
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.34.2
+Dynamic: license-file
+
+![build](https://github.com/rhymiz/python-mope/workflows/build/badge.svg)
+[![downloads](https://pepy.tech/badge/python-mope)](https://pepy.tech/project/python-mope)
+[![Ruff](https://img.shields.io/badge/lint%20and%20format-Ruff-D7FF64.svg)](https://docs.astral.sh/ruff/)
+
+# Python Mopé
+Client library for Mopé by Hakrinbank
+
+### Token acquisition and API Docs
+- [API Docs](https://api.mope.sr/integration/doc)
+- Instructions for [acquiring a token](https://drive.google.com/file/d/10fWqgpl2Ip9JIacl0pwzUDi_HV6WLbCi/view?usp=sharing)
+
+
+### Requirements
+- Python 3.11 or newer
+- Mopé API Token
+
+### Getting Started
+First, install from PyPi by running `pip install python-mope`
+
+Example usage:
+
+```python
+from mope import Mope
+
+mope = Mope(token="test_123")
+mope.shop.get_payment_request(payment_id="123")
+```
+
+### Development
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then run:
+
+```sh
+uv sync --locked
+uv run --locked ruff check .
+uv run --locked ruff format --check .
+uv run --locked ty check
+uv run --locked pytest
+uv build --no-sources
+```
+
+Development uses Python 3.15.2 from `.python-version`; uv installs it when needed.
+The library supports Python 3.11+, and CI tests the built wheel on Python 3.11,
+3.12, 3.13, 3.14, and 3.15. Ruff and ty target Python 3.11 compatibility.
+Run `uv run ruff format .` to format code. Commit `uv.lock` after changing
+dependencies; use `uv lock --upgrade` to refresh their locked versions.
+
+The package includes inline types and a `py.typed` marker. API responses are
+validated before creating models: invalid field types raise `TypeError`, invalid
+status values raise `ValueError`, and missing required fields raise `KeyError`.
+Values are not coerced. Payment metadata remains a list of dictionaries with
+string `key` and `value` fields, as defined by the
+[Mopé API schema](https://api.mope.sr/integration/paths/GetPaymentRequest.yaml).
+
+### Publishing
+
+To release, update `mope/__version__.py`, run `uv lock`, and commit the changes.
+Publish a GitHub release whose tag is the package version or `v` followed by that
+version. The workflow checks the tag, runs lint, formatting and type checks,
+builds the source distribution and wheel, and tests the installed wheel across
+all supported Python versions before uploading those same artifacts to PyPI.
+
+### Resources
+#### shop
+
+*Methods*
+
+##### `shop.create_payment_request`
+
+| Argument   | Type                | Required |
+| ---        |---                  | ---      |
+|amount      | int                 | yes      |
+|description | string              | yes      |
+|order_id    | string              | yes      |
+|currency    | enum (USD, SRD, EUR) | yes      |
+|redirect_url| string              | yes      |
+
+
+return type: `mope.models.payments.CreatePaymentResponse`
+
+##### `shop.get_payment_request`
+
+| Argument  | Type   | Required |
+|---        |---     |---       |
+|payment_id | string | yes      |
+
+
+return type: `mope.models.payments.PaymentRequest`

python_mope-0.3.0/README.md

@@ -0,0 +1,88 @@
+![build](https://github.com/rhymiz/python-mope/workflows/build/badge.svg)
+[![downloads](https://pepy.tech/badge/python-mope)](https://pepy.tech/project/python-mope)
+[![Ruff](https://img.shields.io/badge/lint%20and%20format-Ruff-D7FF64.svg)](https://docs.astral.sh/ruff/)
+
+# Python Mopé
+Client library for Mopé by Hakrinbank
+
+### Token acquisition and API Docs
+- [API Docs](https://api.mope.sr/integration/doc)
+- Instructions for [acquiring a token](https://drive.google.com/file/d/10fWqgpl2Ip9JIacl0pwzUDi_HV6WLbCi/view?usp=sharing)
+
+
+### Requirements
+- Python 3.11 or newer
+- Mopé API Token
+
+### Getting Started
+First, install from PyPi by running `pip install python-mope`
+
+Example usage:
+
+```python
+from mope import Mope
+
+mope = Mope(token="test_123")
+mope.shop.get_payment_request(payment_id="123")
+```
+
+### Development
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then run:
+
+```sh
+uv sync --locked
+uv run --locked ruff check .
+uv run --locked ruff format --check .
+uv run --locked ty check
+uv run --locked pytest
+uv build --no-sources
+```
+
+Development uses Python 3.15.2 from `.python-version`; uv installs it when needed.
+The library supports Python 3.11+, and CI tests the built wheel on Python 3.11,
+3.12, 3.13, 3.14, and 3.15. Ruff and ty target Python 3.11 compatibility.
+Run `uv run ruff format .` to format code. Commit `uv.lock` after changing
+dependencies; use `uv lock --upgrade` to refresh their locked versions.
+
+The package includes inline types and a `py.typed` marker. API responses are
+validated before creating models: invalid field types raise `TypeError`, invalid
+status values raise `ValueError`, and missing required fields raise `KeyError`.
+Values are not coerced. Payment metadata remains a list of dictionaries with
+string `key` and `value` fields, as defined by the
+[Mopé API schema](https://api.mope.sr/integration/paths/GetPaymentRequest.yaml).
+
+### Publishing
+
+To release, update `mope/__version__.py`, run `uv lock`, and commit the changes.
+Publish a GitHub release whose tag is the package version or `v` followed by that
+version. The workflow checks the tag, runs lint, formatting and type checks,
+builds the source distribution and wheel, and tests the installed wheel across
+all supported Python versions before uploading those same artifacts to PyPI.
+
+### Resources
+#### shop
+
+*Methods*
+
+##### `shop.create_payment_request`
+
+| Argument   | Type                | Required |
+| ---        |---                  | ---      |
+|amount      | int                 | yes      |
+|description | string              | yes      |
+|order_id    | string              | yes      |
+|currency    | enum (USD, SRD, EUR) | yes      |
+|redirect_url| string              | yes      |
+
+
+return type: `mope.models.payments.CreatePaymentResponse`
+
+##### `shop.get_payment_request`
+
+| Argument  | Type   | Required |
+|---        |---     |---       |
+|payment_id | string | yes      |
+
+
+return type: `mope.models.payments.PaymentRequest`

{python-mope-0.0.6 → python_mope-0.3.0}/mope/__init__.py

@@ -1,3 +1,3 @@
 from mope.client import Mope
 
-__all__ = ['Mope']
+__all__ = ["Mope"]

python_mope-0.3.0/mope/__version__.py

@@ -0,0 +1,2 @@
+__author__ = "lemuel@vokality.com"
+__version__ = "0.3.0"

python_mope-0.3.0/mope/client.py

@@ -0,0 +1,80 @@
+from collections.abc import Iterable, Mapping, Set
+from typing import IO, Protocol, TypeAlias
+from urllib.parse import urljoin
+
+import requests
+
+from mope.__version__ import __version__
+from mope.json import json_value
+from mope.resources.shop import ShopResource
+
+QueryScalar: TypeAlias = str | bytes | int | float
+QueryValue: TypeAlias = QueryScalar | Iterable[QueryScalar] | None
+
+
+class QueryItems(Protocol):
+    def items(self) -> Set[tuple[QueryScalar, QueryValue]]: ...
+
+
+QueryParams: TypeAlias = (
+    QueryItems | Iterable[tuple[QueryScalar, QueryValue]] | str | bytes
+)
+RequestData: TypeAlias = (
+    Mapping[str, object]
+    | list[tuple[str, object]]
+    | tuple[tuple[str, object], ...]
+    | Iterable[bytes]
+    | IO[str]
+    | IO[bytes]
+    | str
+    | bytes
+)
+
+_user_agent = f"Python Mope {__version__}"
+
+
+class Client:
+    def __init__(self, token: str) -> None:
+        self._token = token
+        self._headers = {
+            "User-Agent": _user_agent,
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {token}",
+        }
+        self._base_url = "https://api.mope.sr/api"
+
+    def call_api(
+        self,
+        method: str,
+        endpoint: str,
+        params: QueryParams | None = None,
+        data: RequestData | None = None,
+        json: object = None,
+    ) -> requests.Response:
+        url = urljoin(self._base_url, endpoint)
+        return requests.request(
+            method=method,
+            url=url,
+            params=params,
+            data=data,
+            json=json_value(json, path="request"),
+            headers=self._headers,
+        )
+
+
+class Mope:
+    def __init__(self, token: str) -> None:
+        self._token = token
+        self._headers = {
+            "User-Agent": _user_agent,
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {token}",
+        }
+        self.base_url = "https://api.mope.sr/api"
+
+        self._client = Client(token)
+
+        self.shop = ShopResource(self._client)
+
+    def __str__(self) -> str:
+        return _user_agent

python_mope-0.3.0/mope/json.py

@@ -0,0 +1,49 @@
+"""JSON types and validation at the API boundary."""
+
+from math import isfinite
+from typing import TypeAlias
+
+JsonValue: TypeAlias = (
+    str | int | float | bool | None | list["JsonValue"] | dict[str, "JsonValue"]
+)
+JsonObject: TypeAlias = dict[str, JsonValue]
+
+
+def json_value(value: object, *, path: str = "response") -> JsonValue:
+    if value is None or isinstance(value, (str, bool, int)):
+        return value
+    if isinstance(value, float):
+        if not isfinite(value):
+            raise ValueError(f"{path} must contain a finite JSON number")
+        return value
+    if isinstance(value, list):
+        return [
+            json_value(item, path=f"{path}[{index}]")
+            for index, item in enumerate(value)
+        ]
+    if isinstance(value, dict):
+        return json_object(value, path=path)
+    raise TypeError(f"{path} must be a JSON value")
+
+
+def json_object(value: object, *, path: str = "response") -> JsonObject:
+    if not isinstance(value, dict):
+        raise TypeError(f"{path} must be a JSON object")
+    result: JsonObject = {}
+    for key, item in value.items():
+        if not isinstance(key, str):
+            raise TypeError(f"{path} must have string keys")
+        result[key] = json_value(item, path=f"{path}.{key}")
+    return result
+
+
+def json_string(value: object, *, path: str) -> str:
+    if not isinstance(value, str):
+        raise TypeError(f"{path} must be a string")
+    return value
+
+
+def json_integer(value: object, *, path: str) -> int:
+    if isinstance(value, bool) or not isinstance(value, int):
+        raise TypeError(f"{path} must be an integer")
+    return value

python_mope-0.3.0/mope/models/payments.py

@@ -0,0 +1,110 @@
+from abc import ABC, abstractmethod
+from dataclasses import asdict, dataclass
+from typing import Literal, Self, TypeAlias, TypedDict
+
+from mope.json import JsonValue, json_integer, json_object, json_string
+
+CurrencyCode: TypeAlias = Literal["SRD", "EUR", "USD"]
+PaymentStatus: TypeAlias = Literal["open", "scanned", "unconfirmed", "paid"]
+
+
+class PaymentMetadata(TypedDict):
+    key: str
+    value: str
+
+
+def _payment_status(value: object) -> PaymentStatus:
+    match value:
+        case "open":
+            return "open"
+        case "scanned":
+            return "scanned"
+        case "unconfirmed":
+            return "unconfirmed"
+        case "paid":
+            return "paid"
+        case _:
+            raise ValueError("status must be open, scanned, unconfirmed, or paid")
+
+
+def _payment_metadata(value: object) -> list[PaymentMetadata]:
+    if not isinstance(value, list):
+        raise TypeError("meta_data must be an array")
+    result: list[PaymentMetadata] = []
+    for index, entry in enumerate(value):
+        path = f"meta_data[{index}]"
+        item = json_object(entry, path=path)
+        result.append(
+            PaymentMetadata(
+                key=json_string(item["key"], path=f"{path}.key"),
+                value=json_string(item["value"], path=f"{path}.value"),
+            )
+        )
+    return result
+
+
+@dataclass
+class BaseModel(ABC):
+    @classmethod
+    @abstractmethod
+    def from_json(cls, data: object) -> Self:
+        pass
+
+    def as_dict(self) -> dict[str, JsonValue]:
+        return json_object(asdict(self))
+
+
+@dataclass
+class CreatePaymentResponse(BaseModel):
+    id: str
+    url: str
+
+    @classmethod
+    def from_json(cls, data: object) -> Self:
+        payload = json_object(data)
+        return cls(
+            id=json_string(payload["id"], path="id"),
+            url=json_string(payload["url"], path="url"),
+        )
+
+
+@dataclass
+class Currency(BaseModel):
+    name: str
+    code: str
+    symbol: str
+
+    @classmethod
+    def from_json(cls, data: object) -> Self:
+        payload = json_object(data, path="currency")
+        return cls(
+            name=json_string(payload["name"], path="currency.name"),
+            code=json_string(payload["code"], path="currency.code"),
+            symbol=json_string(payload["symbol"], path="currency.symbol"),
+        )
+
+
+@dataclass
+class PaymentRequest(BaseModel):
+    id: str
+    amount: int
+    created_at: str
+    description: str
+    expires_at: str
+    currency: Currency
+    status: PaymentStatus
+    meta_data: list[PaymentMetadata]
+
+    @classmethod
+    def from_json(cls, data: object) -> Self:
+        payload = json_object(data)
+        return cls(
+            id=json_string(payload["id"], path="id"),
+            amount=json_integer(payload["amount"], path="amount"),
+            created_at=json_string(payload["created_at"], path="created_at"),
+            description=json_string(payload["description"], path="description"),
+            expires_at=json_string(payload["expires_at"], path="expires_at"),
+            currency=Currency.from_json(payload["currency"]),
+            status=_payment_status(payload["status"]),
+            meta_data=_payment_metadata(payload["meta_data"]),
+        )

python_mope-0.3.0/mope/resources/shop.py

@@ -0,0 +1,44 @@
+from mope.models.payments import CreatePaymentResponse, CurrencyCode, PaymentRequest
+from mope.transport import ApiTransport
+
+
+class ShopResource:
+    def __init__(self, client: ApiTransport) -> None:
+        self._client = client
+
+    def create_payment_request(
+        self,
+        amount: int,
+        description: str,
+        order_id: str,
+        currency: CurrencyCode,
+        redirect_url: str,
+    ) -> CreatePaymentResponse:
+        """
+        makes a payment request
+        """
+
+        endpoint = "shop/payment_request"
+        response = self._client.call_api(
+            "POST",
+            endpoint=endpoint,
+            json={
+                "amount": amount,
+                "order_id": order_id,
+                "currency": currency,
+                "description": description,
+                "redirect_url": redirect_url,
+            },
+        )
+        response.raise_for_status()
+        return CreatePaymentResponse.from_json(response.json())
+
+    def get_payment_request(self, payment_id: str) -> PaymentRequest:
+        """
+        fetches a payment request given a payment ID
+        """
+
+        endpoint = f"shop/payment_request/{payment_id}"
+        response = self._client.call_api("GET", endpoint=endpoint)
+        response.raise_for_status()
+        return PaymentRequest.from_json(response.json())

python_mope-0.3.0/mope/transport.py

@@ -0,0 +1,11 @@
+from typing import Protocol
+
+from requests import Response
+
+
+class ApiTransport(Protocol):
+    """The HTTP operations required by API resources."""
+
+    def call_api(
+        self, method: str, endpoint: str, *, json: object = None
+    ) -> Response: ...

python_mope-0.3.0/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["setuptools==84.2.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-mope"
+dynamic = ["version"]
+description = "A client library for interacting with the Mopé Web Shop API"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Lemuel Boyce", email = "lemuel@vokality.com" }]
+dependencies = ["requests>=2.34.2,<3"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Operating System :: OS Independent",
+    "Development Status :: 6 - Mature",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Topic :: Office/Business :: Financial",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/rhymiz/python-mope"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "ruff>=0.17.5",
+    "ty>=0.0.104",
+    "types-requests>=2.33.0.20261030",
+]
+
+[tool.setuptools.dynamic]
+version = { attr = "mope.__version__.__version__" }
+
+[tool.setuptools.packages.find]
+include = ["mope*"]
+
+[tool.setuptools.package-data]
+mope = ["py.typed"]
+
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { file = "mope/__version__.py" }]
+
+[tool.ruff]
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I", "UP", "ANN"]
+
+[tool.ty.environment]
+python-version = "3.11"
+
+[tool.ty.analysis]
+strict-generic-narrowing = true
+
+[tool.ty.rules]
+missing-type-argument = "error"
+unsound-assignment = "error"
+unsound-return = "error"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--import-mode=importlib"