Initial commit

Author: DannyUzo

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements-dev.txt
+      - name: Run tests
+        run: |
+          pytest -q || true
+      - name: Run mock smoke scripts
+        run: |
+          python -c "import os,runpy; os.environ['ZENDFI_RUN_MOCK']='1'; runpy.run_path('tests/test_customers_unit.py')"
+          python -c "import os,runpy; os.environ['ZENDFI_RUN_MOCK']='1'; runpy.run_path('tests/test_payments_splits.py')"
+          python -c "import os,runpy; os.environ['ZENDFI_RUN_MOCK']='1'; runpy.run_path('tests/test_invoices_unit.py')"

.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip build twine
+      - name: Build
+        run: python -m build
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          python -m twine upload --non-interactive dist/*

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+    "python.testing.unittestArgs": [
+        "-v",
+        "-s",
+        "./tests",
+        "-p",
+        "*test.py"
+    ],
+    "python.testing.pytestEnabled": false,
+    "python.testing.unittestEnabled": true
+}

CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2025-12-02
+- Initial SDK scaffold: payments, customers, invoices, webhooks
+- Added split payments, subscriptions, payment links, installment plans, escrows
+- Test scripts (mock and integration guards)
+- Retry logic for 5xx responses

LICENSE

@@ -0,0 +1,12 @@
+MIT License
+
+Copyright (c) 2025 ZendFi
+
+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:
+
+[...standard MIT text...]

MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+recursive-include zendfi *.py

README.md

@@ -0,0 +1,50 @@
+# zendfi-python-sdk
+
+This is a Python SDK port of zendfi-toolkit. It provides simple sync clients for Payments, Customers, Invoices and Webhooks verification.
+
+## Quickstart
+
+```py
+from zendfi import from_env
+client = from_env()
+
+payment = client.payments.create(amount=50.0, currency="USD", description="Test")
+print(payment.get("checkout_url"))
+```
+
+## Tests
+
+Run:
+
+```
+pip install -r requirements-dev.txt
+pytest -q
+```
+
+Integration tests
+
+To run tests against the real ZendFi API (BE CAREFUL — these perform real requests):
+
+1. Set your API key and enable integration runs:
+
+```powershell
+$env:ZENDFI_API_KEY = "sk_live_..."
+$env:ZENDFI_RUN_INTEGRATION = "1"
+# Optional: override base URL (e.g. staging)
+$env:ZENDFI_BASE_URL = "https://api.zendfi.tech/"
+pytest -q -k integration
+```
+
+The integration test is guarded so it only runs when `ZENDFI_RUN_INTEGRATION` and
+`ZENDFI_API_KEY` are present in the environment.
+
+## Publishing
+
+This repository provides a `pyproject.toml` and `MANIFEST.in` ready for building source and wheel distributions. Quick steps to publish:
+
+- Build distributions locally: `python -m build`
+- Upload to PyPI (use a PyPI API token): `python -m twine upload dist/*`
+
+A GitHub Actions workflow (`.github/workflows/publish.yml`) is included to publish on tagged releases. Configure the `PYPI_API_TOKEN` secret in the repository settings before pushing a `vX.Y.Z` tag.
+
+Security note: Never commit real API keys or PyPI tokens to the repository. Use environment variables or CI secrets.

dist/zendfi_sdk-0.1.0-py3-none-any.whl

@@ -0,0 +1,23 @@
+[project]
+name = "zendfi-sdk"
+version = "0.1.0"
+description = "Python SDK for ZendFi (payments, customers, invoices, webhooks)"
+authors = [{name = "ZendFi"}]
+readme = "README.md"
+license = {text = "MIT"}
+keywords = ["payments", "sdk", "zendfi"]
+requires-python = ">=3.8"
+dependencies = [
+  "requests>=2.28",
+]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+
+[project.optional-dependencies]
+retry = ["tenacity>=8.0"]
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"