chamapay 1.0.0__tar.gz

chamapay-1.0.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: chamapay
+Version: 1.0.0
+Summary: Official Python SDK for ChamaPay API — Financial Infrastructure for African Savings Groups
+Author-email: ChamaPay <api-support@chamapay.co.ke>
+License: MIT
+Project-URL: Homepage, https://chamapay.co.ke
+Project-URL: Documentation, https://api.chamapay.co.ke/docs
+Project-URL: Source, https://github.com/chamapay/chamapay-python
+Keywords: chamapay,sacco,savings,mpesa,africa,fintech
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# ChamaPay Python SDK
+
+Official Python SDK for the ChamaPay API.
+
+## Installation
+
+```bash
+pip install chamapay
+```
+
+## Usage
+
+```python
+from chamapay import ChamaPay
+
+api = ChamaPay('cpk_live_your_api_key', 'your_api_secret')
+
+# List members
+members = api.members.list(status='Active', page=1, limit=20)
+
+# Create a contribution (idempotent)
+contribution = api.contributions.create(
+    {'member_id': 'MFT001', 'amount': 5000},
+    idempotency_key='550e8400-e29b-41d4-a716-446655440000'
+)
+
+# Get loan details
+loan = api.loans.get('LN001')
+```
+
+## API Reference
+
+| Resource           | Methods                                    |
+|--------------------|--------------------------------------------|
+| members            | list, get, create, update, delete          |
+| contributions      | list, get, create (with idempotency key)   |
+| loans              | list, get, create                          |
+| fines              | list, create                               |
+| meetings           | list, create                               |
+| projects           | list, create                               |
+| accounts           | list, get                                  |
+| welfare            | list                                       |
+| dividends          | list                                       |
+| documents          | list                                       |
+| election_notices   | list                                       |
+| document_reminders | list                                       |
+| audit              | list                                       |
+| liabilities        | list, create                               |
+| reports            | get                                        |
+
+## Error Handling
+
+```python
+from chamapay import ChamaPayError, ValidationError, RateLimitError
+
+try:
+    api.members.create({...})
+except ValidationError as e:
+    print(f"Validation failed: {e.details}")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except ChamaPayError as e:
+    print(f"API Error [{e.code}]: {e.message}")
+```
+
+## Publishing
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+Requires a PyPI account with access to the `chamapay` package.

chamapay-1.0.0/README.md

@@ -0,0 +1,74 @@
+# ChamaPay Python SDK
+
+Official Python SDK for the ChamaPay API.
+
+## Installation
+
+```bash
+pip install chamapay
+```
+
+## Usage
+
+```python
+from chamapay import ChamaPay
+
+api = ChamaPay('cpk_live_your_api_key', 'your_api_secret')
+
+# List members
+members = api.members.list(status='Active', page=1, limit=20)
+
+# Create a contribution (idempotent)
+contribution = api.contributions.create(
+    {'member_id': 'MFT001', 'amount': 5000},
+    idempotency_key='550e8400-e29b-41d4-a716-446655440000'
+)
+
+# Get loan details
+loan = api.loans.get('LN001')
+```
+
+## API Reference
+
+| Resource           | Methods                                    |
+|--------------------|--------------------------------------------|
+| members            | list, get, create, update, delete          |
+| contributions      | list, get, create (with idempotency key)   |
+| loans              | list, get, create                          |
+| fines              | list, create                               |
+| meetings           | list, create                               |
+| projects           | list, create                               |
+| accounts           | list, get                                  |
+| welfare            | list                                       |
+| dividends          | list                                       |
+| documents          | list                                       |
+| election_notices   | list                                       |
+| document_reminders | list                                       |
+| audit              | list                                       |
+| liabilities        | list, create                               |
+| reports            | get                                        |
+
+## Error Handling
+
+```python
+from chamapay import ChamaPayError, ValidationError, RateLimitError
+
+try:
+    api.members.create({...})
+except ValidationError as e:
+    print(f"Validation failed: {e.details}")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except ChamaPayError as e:
+    print(f"API Error [{e.code}]: {e.message}")
+```
+
+## Publishing
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+Requires a PyPI account with access to the `chamapay` package.

chamapay-1.0.0/chamapay/__init__.py

@@ -0,0 +1,12 @@
+from .client import ChamaPay
+from .errors import ChamaPayError, AuthenticationError, RateLimitError, ValidationError, NotFoundError, ServerError
+
+__all__ = [
+    "ChamaPay",
+    "ChamaPayError",
+    "AuthenticationError",
+    "RateLimitError",
+    "ValidationError",
+    "NotFoundError",
+    "ServerError",
+]

chamapay-1.0.0/chamapay/client.py

@@ -0,0 +1,36 @@
+from .http_client import ChamaPayClient
+from .resources.members import MembersResource
+from .resources.contributions import ContributionsResource
+from .resources.loans import LoansResource
+from .resources.fines import FinesResource
+from .resources.meetings import MeetingsResource
+from .resources.projects import ProjectsResource
+from .resources.accounts import AccountsResource
+from .resources.welfare import WelfareResource
+from .resources.dividends import DividendsResource
+from .resources.documents import DocumentsResource
+from .resources.election_notices import ElectionNoticesResource
+from .resources.document_reminders import DocumentRemindersResource
+from .resources.audit import AuditResource
+from .resources.liabilities import LiabilitiesResource
+from .resources.reports import ReportsResource
+
+
+class ChamaPay:
+    def __init__(self, api_key, api_secret, base_url=None, timeout=None):
+        client = ChamaPayClient(api_key, api_secret, base_url, timeout)
+        self.members = MembersResource(client)
+        self.contributions = ContributionsResource(client)
+        self.loans = LoansResource(client)
+        self.fines = FinesResource(client)
+        self.meetings = MeetingsResource(client)
+        self.projects = ProjectsResource(client)
+        self.accounts = AccountsResource(client)
+        self.welfare = WelfareResource(client)
+        self.dividends = DividendsResource(client)
+        self.documents = DocumentsResource(client)
+        self.election_notices = ElectionNoticesResource(client)
+        self.document_reminders = DocumentRemindersResource(client)
+        self.audit = AuditResource(client)
+        self.liabilities = LiabilitiesResource(client)
+        self.reports = ReportsResource(client)

chamapay-1.0.0/chamapay/errors.py

@@ -0,0 +1,27 @@
+class ChamaPayError(Exception):
+    def __init__(self, message, status=0, code=None, details=None):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+        self.details = details or {}
+
+class AuthenticationError(ChamaPayError):
+    def __init__(self, message, details=None):
+        super().__init__(message, 401, "authentication_error", details)
+
+class RateLimitError(ChamaPayError):
+    def __init__(self, message, retry_after=30, details=None):
+        super().__init__(message, 429, "rate_limit_error", details)
+        self.retry_after = retry_after
+
+class ValidationError(ChamaPayError):
+    def __init__(self, message, details=None):
+        super().__init__(message, 422, "validation_error", details)
+
+class NotFoundError(ChamaPayError):
+    def __init__(self, message, details=None):
+        super().__init__(message, 404, "not_found", details)
+
+class ServerError(ChamaPayError):
+    def __init__(self, message, details=None):
+        super().__init__(message, 500, "server_error", details)

chamapay-1.0.0/chamapay/http_client.py

@@ -0,0 +1,85 @@
+import requests
+
+from .errors import (
+    ChamaPayError,
+    AuthenticationError,
+    RateLimitError,
+    ValidationError,
+    NotFoundError,
+    ServerError,
+)
+
+BASE_URL = "https://api.chamapay.co.ke/v1"
+DEFAULT_TIMEOUT = 30
+
+_ERROR_MAP = {
+    401: AuthenticationError,
+    404: NotFoundError,
+    422: ValidationError,
+    429: RateLimitError,
+    500: ServerError,
+}
+
+
+class ChamaPayClient:
+    def __init__(self, api_key, api_secret, base_url=None, timeout=None):
+        if not api_key or not api_secret:
+            raise ChamaPayError("API key and secret are required")
+        self.api_key = api_key
+        self.api_secret = api_secret
+        self.base_url = (base_url or BASE_URL).rstrip("/")
+        self.timeout = timeout or DEFAULT_TIMEOUT
+        self._session = requests.Session()
+        self._session.headers.update({
+            "Authorization": f"Bearer {self.api_key}:{self.api_secret}",
+            "Content-Type": "application/json",
+            "User-Agent": "chamapay-python/1.0.0",
+        })
+
+    def _request(self, method, path, **kwargs):
+        url = f"{self.base_url}/{path.lstrip('/')}"
+        params = kwargs.get("query")
+        body = kwargs.get("body")
+        extra_headers = kwargs.get("headers", {})
+
+        try:
+            res = self._session.request(
+                method=method,
+                url=url,
+                params=params,
+                json=body,
+                headers=extra_headers or None,
+                timeout=self.timeout,
+            )
+        except requests.exceptions.Timeout:
+            raise ChamaPayError("Request timed out", 0, "timeout")
+        except requests.exceptions.ConnectionError as e:
+            raise ChamaPayError(f"Connection error: {e}", 0, "connection_error")
+
+        try:
+            data = res.json()
+        except ValueError:
+            data = {"error": {"message": res.text}}
+
+        if not res.ok:
+            err = data.get("error", data)
+            msg = err.get("message", f"Request failed with status {res.status_code}")
+            err_cls = _ERROR_MAP.get(res.status_code, ChamaPayError)
+            raise err_cls(msg, err.get("details"))
+
+        return data
+
+    def get(self, path, **opts):
+        return self._request("GET", path, **opts)
+
+    def post(self, path, **opts):
+        return self._request("POST", path, **opts)
+
+    def put(self, path, **opts):
+        return self._request("PUT", path, **opts)
+
+    def patch(self, path, **opts):
+        return self._request("PATCH", path, **opts)
+
+    def delete(self, path, **opts):
+        return self._request("DELETE", path, **opts)

chamapay-1.0.0/chamapay/resources/__init__.py

@@ -0,0 +1,33 @@
+from .members import MembersResource
+from .contributions import ContributionsResource
+from .loans import LoansResource
+from .fines import FinesResource
+from .meetings import MeetingsResource
+from .projects import ProjectsResource
+from .accounts import AccountsResource
+from .welfare import WelfareResource
+from .dividends import DividendsResource
+from .documents import DocumentsResource
+from .election_notices import ElectionNoticesResource
+from .document_reminders import DocumentRemindersResource
+from .audit import AuditResource
+from .liabilities import LiabilitiesResource
+from .reports import ReportsResource
+
+__all__ = [
+    "MembersResource",
+    "ContributionsResource",
+    "LoansResource",
+    "FinesResource",
+    "MeetingsResource",
+    "ProjectsResource",
+    "AccountsResource",
+    "WelfareResource",
+    "DividendsResource",
+    "DocumentsResource",
+    "ElectionNoticesResource",
+    "DocumentRemindersResource",
+    "AuditResource",
+    "LiabilitiesResource",
+    "ReportsResource",
+]

chamapay-1.0.0/chamapay/resources/accounts.py

@@ -0,0 +1,4 @@
+class AccountsResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/accounts", query=q)
+    def get(self, id): return self._c.get(f"/accounts/{id}")

chamapay-1.0.0/chamapay/resources/audit.py

@@ -0,0 +1,3 @@
+class AuditResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/audit", query=q)

chamapay-1.0.0/chamapay/resources/contributions.py

@@ -0,0 +1,7 @@
+class ContributionsResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/contributions", query=q)
+    def get(self, id): return self._c.get(f"/contributions/{id}")
+    def create(self, body, idempotency_key=None):
+        h = {"Idempotency-Key": idempotency_key} if idempotency_key else {}
+        return self._c.post("/contributions", body=body, headers=h)

chamapay-1.0.0/chamapay/resources/dividends.py

@@ -0,0 +1,3 @@
+class DividendsResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/dividends", query=q)

chamapay-1.0.0/chamapay/resources/document_reminders.py

@@ -0,0 +1,3 @@
+class DocumentRemindersResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/document_reminders", query=q)

chamapay-1.0.0/chamapay/resources/documents.py

@@ -0,0 +1,3 @@
+class DocumentsResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/documents", query=q)

chamapay-1.0.0/chamapay/resources/election_notices.py

@@ -0,0 +1,3 @@
+class ElectionNoticesResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/election_notices", query=q)

chamapay-1.0.0/chamapay/resources/fines.py

@@ -0,0 +1,4 @@
+class FinesResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/fines", query=q)
+    def create(self, **b): return self._c.post("/fines", body=b)

chamapay-1.0.0/chamapay/resources/liabilities.py

@@ -0,0 +1,4 @@
+class LiabilitiesResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/liabilities", query=q)
+    def create(self, **b): return self._c.post("/liabilities", body=b)

chamapay-1.0.0/chamapay/resources/loans.py

@@ -0,0 +1,5 @@
+class LoansResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/loans", query=q)
+    def get(self, id): return self._c.get(f"/loans/{id}")
+    def create(self, **b): return self._c.post("/loans", body=b)

chamapay-1.0.0/chamapay/resources/meetings.py

@@ -0,0 +1,4 @@
+class MeetingsResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/meetings", query=q)
+    def create(self, **b): return self._c.post("/meetings", body=b)

chamapay-1.0.0/chamapay/resources/members.py

@@ -0,0 +1,7 @@
+class MembersResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/members", query=q)
+    def get(self, id): return self._c.get(f"/members/{id}")
+    def create(self, **b): return self._c.post("/members", body=b)
+    def update(self, id, **b): return self._c.put(f"/members/{id}", body=b)
+    def delete(self, id): return self._c.delete(f"/members/{id}")

chamapay-1.0.0/chamapay/resources/projects.py

@@ -0,0 +1,4 @@
+class ProjectsResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/projects", query=q)
+    def create(self, **b): return self._c.post("/projects", body=b)

chamapay-1.0.0/chamapay/resources/reports.py

@@ -0,0 +1,3 @@
+class ReportsResource:
+    def __init__(self, client): self._c = client
+    def get(self, **q): return self._c.get("/reports", query=q)

chamapay-1.0.0/chamapay/resources/welfare.py

@@ -0,0 +1,3 @@
+class WelfareResource:
+    def __init__(self, client): self._c = client
+    def list(self, **q): return self._c.get("/welfare", query=q)

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

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: chamapay
+Version: 1.0.0
+Summary: Official Python SDK for ChamaPay API — Financial Infrastructure for African Savings Groups
+Author-email: ChamaPay <api-support@chamapay.co.ke>
+License: MIT
+Project-URL: Homepage, https://chamapay.co.ke
+Project-URL: Documentation, https://api.chamapay.co.ke/docs
+Project-URL: Source, https://github.com/chamapay/chamapay-python
+Keywords: chamapay,sacco,savings,mpesa,africa,fintech
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# ChamaPay Python SDK
+
+Official Python SDK for the ChamaPay API.
+
+## Installation
+
+```bash
+pip install chamapay
+```
+
+## Usage
+
+```python
+from chamapay import ChamaPay
+
+api = ChamaPay('cpk_live_your_api_key', 'your_api_secret')
+
+# List members
+members = api.members.list(status='Active', page=1, limit=20)
+
+# Create a contribution (idempotent)
+contribution = api.contributions.create(
+    {'member_id': 'MFT001', 'amount': 5000},
+    idempotency_key='550e8400-e29b-41d4-a716-446655440000'
+)
+
+# Get loan details
+loan = api.loans.get('LN001')
+```
+
+## API Reference
+
+| Resource           | Methods                                    |
+|--------------------|--------------------------------------------|
+| members            | list, get, create, update, delete          |
+| contributions      | list, get, create (with idempotency key)   |
+| loans              | list, get, create                          |
+| fines              | list, create                               |
+| meetings           | list, create                               |
+| projects           | list, create                               |
+| accounts           | list, get                                  |
+| welfare            | list                                       |
+| dividends          | list                                       |
+| documents          | list                                       |
+| election_notices   | list                                       |
+| document_reminders | list                                       |
+| audit              | list                                       |
+| liabilities        | list, create                               |
+| reports            | get                                        |
+
+## Error Handling
+
+```python
+from chamapay import ChamaPayError, ValidationError, RateLimitError
+
+try:
+    api.members.create({...})
+except ValidationError as e:
+    print(f"Validation failed: {e.details}")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except ChamaPayError as e:
+    print(f"API Error [{e.code}]: {e.message}")
+```
+
+## Publishing
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+Requires a PyPI account with access to the `chamapay` package.

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

@@ -0,0 +1,27 @@
+README.md
+pyproject.toml
+chamapay/__init__.py
+chamapay/client.py
+chamapay/errors.py
+chamapay/http_client.py
+chamapay.egg-info/PKG-INFO
+chamapay.egg-info/SOURCES.txt
+chamapay.egg-info/dependency_links.txt
+chamapay.egg-info/requires.txt
+chamapay.egg-info/top_level.txt
+chamapay/resources/__init__.py
+chamapay/resources/accounts.py
+chamapay/resources/audit.py
+chamapay/resources/contributions.py
+chamapay/resources/dividends.py
+chamapay/resources/document_reminders.py
+chamapay/resources/documents.py
+chamapay/resources/election_notices.py
+chamapay/resources/fines.py
+chamapay/resources/liabilities.py
+chamapay/resources/loans.py
+chamapay/resources/meetings.py
+chamapay/resources/members.py
+chamapay/resources/projects.py
+chamapay/resources/reports.py
+chamapay/resources/welfare.py

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+chamapay

chamapay-1.0.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "chamapay"
+version = "1.0.0"
+description = "Official Python SDK for ChamaPay API — Financial Infrastructure for African Savings Groups"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "ChamaPay", email = "api-support@chamapay.co.ke"}
+]
+keywords = ["chamapay", "sacco", "savings", "mpesa", "africa", "fintech"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.urls]
+Homepage = "https://chamapay.co.ke"
+Documentation = "https://api.chamapay.co.ke/docs"
+Source = "https://github.com/chamapay/chamapay-python"

chamapay-1.0.0/setup.cfg

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