onepay 0.1.0__tar.gz

onepay-0.1.0/.gitattributes

@@ -0,0 +1,26 @@
+# Auto detect text files and perform LF normalization
+* text=auto eol=lf
+
+# Explicitly declare text files you want to always be normalized and converted
+# to native line endings on checkout.
+*.py text diff=python
+*.md text
+*.txt text
+*.toml text
+*.yaml text
+*.yml text
+*.json text
+
+# Exclude generated and minified files from GitHub language statistics
+docs/site/* linguist-generated=true
+tests/data/* linguist-generated=true
+
+# Keep bash scripts as LF
+*.sh text eol=lf
+
+# Image files are binary
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary

onepay-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,28 @@
+---
+name: Bug report
+about: Create a report to help us improve the SDK
+title: "[BUG] "
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Initialize client with '...'
+2. Call method '...'
+3. See error '...'
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Environment (please complete the following information):**
+ - OS: [e.g. Ubuntu 20.04, macOS 13]
+ - Python Version: [e.g. 3.9.12]
+ - SDK Version: [e.g. 0.1.0]
+
+**Additional context**
+Add any other context about the problem here, such as stack traces.

onepay-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

onepay-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,26 @@
+## Description
+<!-- Please include a summary of the change and which issue is fixed. -->
+<!-- Please also include relevant motivation and context. -->
+
+Fixes # (issue number if applicable)
+
+## Type of change
+<!-- Please delete options that are not relevant. -->
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+
+## How Has This Been Tested?
+<!-- Please describe the tests that you ran to verify your changes. -->
+- [ ] Added/Updated Unit Tests
+- [ ] Tested manually against the API
+
+## Checklist:
+- [ ] My code follows the style guidelines of this project (checked by `ruff`)
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings or type errors (checked by `mypy`)
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes

onepay-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build-and-test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Check code formatting (Ruff)
+      run: ruff format --check .
+
+    - name: Lint code (Ruff)
+      run: ruff check .
+
+    - name: Type check (MyPy)
+      run: mypy src tests
+
+    - name: Run tests (Pytest)
+      run: pytest --cov=src/onepay --cov-report=xml
+
+    - name: Upload coverage reports to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: ./coverage.xml
+        fail_ci_if_error: false

onepay-0.1.0/.gitignore

@@ -0,0 +1,143 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/site/
+site/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo

onepay-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,35 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.6  # Use an older standard compatible with python 3.9 if needed, but ruff is self-contained. 
+    # Will use latest widely supported:
+    # Actually wait, let's use the one configured in pyproject.toml if possible, but v0.1.14 is a safe bet. 
+    # v0.2.0 or v0.3.0 is newer, I'll use a reasonably recent version v0.3.4
+    # Wait, pyproject.toml specifies ruff>=0.1
+    # We will use v0.3.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [ --fix ]
+      # Run the formatter
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.9.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - httpx>=0.27
+          - pydantic>=2.0
+          - pytest>=7.0
+        args: [--strict, --ignore-missing-imports]

onepay-0.1.0/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to the OnePay Python SDK will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-08-30
+
+### Added
+- Initial release of the OnePay Python SDK
+- **Checkout** — `client.checkout.create()` for payment session creation with automatic SHA-256 hash generation
+- **Transaction Status** — `client.transactions.get_status()` for payment verification
+- **Items** — Full CRUD via `client.items.create/list/update/delete()`
+- **Payment Links** — Full CRUD via `client.payment_links.create/get/update/delete()`
+- **Customers** — `client.customers.create/list/get/request_token/list_transactions()`
+- **Cards** — `client.cards.list/get/delete/charge()`
+- **Refunds** — `client.refunds.create()` with full and partial refund support
+- **Payouts** — `client.payouts.get_transaction()` and auto-paginating `list_transactions()`
+- **Subscriptions** — Experimental `client.subscriptions.create()`
+- **Webhooks** — `Webhook.parse()` for framework-agnostic callback handling
+- Sync (`OnePay`) and async (`AsyncOnePay`) clients
+- Full type annotations with PEP 561 `py.typed` marker
+- Pydantic v2 models for all request/response types
+- Exception hierarchy: `OnePayError`, `AuthenticationError`, `InvalidRequestError`, `RateLimitError`, `NetworkError`
+- Automatic retry with exponential backoff for 429 and 5xx errors
+- Environment variable fallback for all credentials
+- Context manager support (`with OnePay(...) as client:`)

onepay-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing to OnePay Python SDK
+
+First off, thank you for considering contributing to OnePay! It's people like you that make this SDK a great tool for the community.
+
+## Development Environment Setup
+
+1. Fork the repository and clone it locally.
+2. Ensure you have Python 3.9+ installed.
+3. Create a virtual environment and activate it:
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
+   ```
+4. Install the package in editable mode with development dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+5. Install `pre-commit` to ensure code quality before pushing:
+   ```bash
+   pip install pre-commit
+   pre-commit install
+   ```
+
+## Development Workflow
+
+- **Code Style**: This project uses `ruff` for both linting and formatting. The pre-commit hooks will automatically format your code.
+- **Type Checking**: We use `mypy` for static type checking. Ensure you add type hints to all new functions.
+- **Testing**: We use `pytest`. All new features should have accompanying tests.
+  ```bash
+  pytest
+  ```
+  To check coverage:
+  ```bash
+  pytest --cov=src/onepay
+  ```
+
+## Pull Request Process
+
+1. Create a new branch from `main` (e.g., `feature/add-new-endpoint` or `fix/handle-timeout`).
+2. Make your changes and commit them with clear, descriptive messages.
+3. Push your branch and open a Pull Request against the `main` branch.
+4. Ensure all CI checks pass (linting, type checking, tests).
+5. A maintainer will review your PR and provide feedback.
+
+## Reporting Issues
+
+If you find a bug or have a feature request, please use the issue templates provided in the `.github/ISSUE_TEMPLATE` directory.

onepay-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OnePay Team
+
+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.