python-getpaid-payu 0.1.0__tar.gz → 3.0.0__tar.gz

python_getpaid_payu-3.0.0/.github/release-drafter.yml

@@ -0,0 +1,31 @@
+name-template: 'v$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+categories:
+  - title: ':boom: Breaking Changes'
+    label: 'breaking'
+  - title: ':rocket: Features'
+    label: 'enhancement'
+  - title: ':fire: Removals and Deprecations'
+    label: 'removal'
+  - title: ':beetle: Fixes'
+    label: 'bug'
+  - title: ':racehorse: Performance'
+    label: 'performance'
+  - title: ':rotating_light: Testing'
+    label: 'testing'
+  - title: ':construction_worker: Continuous Integration'
+    label: 'ci'
+  - title: ':books: Documentation'
+    label: 'documentation'
+  - title: ':hammer: Refactoring'
+    label: 'refactoring'
+  - title: ':lipstick: Style'
+    label: 'style'
+  - title: ':package: Dependencies'
+    labels:
+      - 'dependencies'
+      - 'build'
+template: |
+  ## Changes
+
+  $CHANGES

python_getpaid_payu-3.0.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint with ruff
+        run: uv run ruff check .
+
+      - name: Audit dependencies
+        run: uv run pip-audit --strict
+
+      - name: Run tests
+        run: uv run pytest --tb=short

python_getpaid_payu-3.0.0/.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+      - master
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history needed for version detection
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        run: pip install uv
+
+      # Version is read from __init__.py (dynamic via hatch)
+      - name: Detect version from __init__.py
+        id: get-version
+        run: |
+          init_py=$(grep -A2 '\[tool\.hatch\.version\]' pyproject.toml | grep '^path\s*=' | head -1 | sed -E "s/path\s*=\s*['\"]([^'\"]+)['\"].*/\1/")
+          version=$(grep '__version__' "$init_py" | head -1 | sed -E "s/.*= ['\"]([^'\"]+)['\"].*/\1/")
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag already exists
+        id: check-tag
+        run: |
+          tag="v${{ steps.get-version.outputs.version }}"
+          if git rev-parse "$tag" >/dev/null 2>&1; then
+            echo "already_tagged=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "already_tagged=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Tag new version
+        if: steps.check-tag.outputs.already_tagged == 'false'
+        run: |
+          tag="v${{ steps.get-version.outputs.version }}"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "$tag" -m "Release $tag"
+          git push origin "$tag"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish package on PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_TOKEN }}

python_getpaid_payu-3.0.0/.sisyphus/evidence/task-26-readme-payu.txt

@@ -0,0 +1,3 @@
+86 README.md
+1
+8

python_getpaid_payu-3.0.0/.sisyphus/evidence/task-5-baseline-payu.txt

@@ -0,0 +1,200 @@
+================================================================================
+TASK 5 BASELINE: python-getpaid-payu
+Executed: 2026-02-18
+================================================================================
+
+DIRECTORY: /home/minder/projekty/python-getpaid/getpaid-payu/
+
+================================================================================
+1. PYTEST RESULTS
+================================================================================
+
+Command: uv run pytest
+
+Output:
+============================= test session starts ==============================
+platform linux -- Python 3.12.10, pytest-9.0.2, pluggy-1.6.0
+rootdir: /home/minder/projekty/python-getpaid/getpaid-payu
+configfile: pyproject.toml
+testpaths: tests
+plugins: asyncio-1.3.0, cov-7.0.0, anyio-4.12.1, respx-0.22.0
+asyncio: mode=Mode.AUTO, debug=False, asyncio_default_fixture_loop_scope=None, asyncio_default_test_fixture_scope=function
+collected 115 items
+
+tests/test_callback.py ...................               [ 16%]
+tests/test_client.py ................................................... [ 60%]
+.........                                                                [ 68%]
+tests/test_processor.py .........................        [ 90%]
+tests/test_types.py ...........                          [100%]
+
+============================= 115 passed in 2.57s ==============================
+
+STATUS: ✓ ALL TESTS PASSED
+
+================================================================================
+2. BUILD RESULTS
+================================================================================
+
+Command: uv build
+
+Output:
+Building source distribution...
+Building wheel from source distribution...
+Successfully built dist/python_getpaid_payu-0.1.1.tar.gz
+Successfully built dist/python_getpaid_payu-0.1.1-py3-none-any.whl
+
+STATUS: ✓ BUILD SUCCESSFUL
+
+Artifacts:
+  - dist/python_getpaid_payu-0.1.1.tar.gz (source distribution)
+  - dist/python_getpaid_payu-0.1.1-py3-none-any.whl (wheel)
+
+================================================================================
+3. PACKAGE METADATA INVENTORY
+================================================================================
+
+Project Name:           python-getpaid-payu
+Version:                0.1.1
+Python Requirement:     >= 3.12
+License:                MIT (text format)
+Authors:                Dominik Kozaczko <dominik@kozaczko.info>
+
+Description:            PayU payment gateway integration for python-getpaid ecosystem.
+
+Dependencies:
+  - python-getpaid-core >= 0.1.0
+  - httpx >= 0.27.0
+
+Development Dependencies:
+  - pytest >= 8.0
+  - pytest-asyncio >= 0.24.0
+  - pytest-cov >= 5.0
+  - respx >= 0.22.0
+  - ruff >= 0.9.0
+  - pre-commit >= 4.0
+  - ty >= 0.0.16
+
+Documentation Dependencies:
+  - furo >= 2024.8.6
+  - sphinx >= 8.0
+  - myst-parser >= 4.0
+
+URLs:
+  - Homepage: https://github.com/django-getpaid/python-getpaid-payu
+  - Repository: https://github.com/django-getpaid/python-getpaid-payu
+  - Documentation: https://getpaid-payu.readthedocs.io/
+  - Changelog: https://github.com/django-getpaid/python-getpaid-payu/releases
+
+Build System:           hatchling
+
+Classifiers:
+  - Development Status :: 3 - Alpha
+  - Intended Audience :: Developers
+  - License :: OSI Approved :: MIT License
+  - Programming Language :: Python :: 3.12
+  - Programming Language :: Python :: 3.13
+  - Topic :: Office/Business :: Financial
+  - Topic :: Office/Business :: Financial :: Point-Of-Sale
+  - Typing :: Typed
+
+================================================================================
+4. LICENSE CHECK
+================================================================================
+
+LICENSE File Status:    ✓ PRESENT
+Format:                 MIT License
+Copyright:              2022-2026 Dominik Kozaczko
+Consistency:            ✓ Matches pyproject.toml declaration (MIT)
+
+================================================================================
+5. README.MD CHECK
+================================================================================
+
+README File Status:     ✓ PRESENT
+Size:                   ~4.5 KB (129 lines)
+Content Verification:
+  ✓ Project description (PayU payment gateway plugin)
+  ✓ Architecture section (PayUClient + PayUProcessor)
+  ✓ Key features listed
+  ✓ Quick usage examples (async context manager)
+  ✓ Configuration table with all parameters
+  ✓ Supported currencies listed
+  ✓ Requirements section
+  ✓ Related projects links
+  ✓ License information
+  ✓ Disclaimer section
+  ✓ Credits
+
+================================================================================
+6. GITHUB WORKFLOWS (.github/workflows/)
+================================================================================
+
+Status:                 ✗ NOT PRESENT
+
+No .github/workflows/ directory found in the repository.
+Note: Project is part of the python-getpaid umbrella but does not have its own CI configuration.
+
+================================================================================
+7. ENTRY-POINTS ANALYSIS [CRITICAL]
+================================================================================
+
+Section Name:           [project.entry-points."getpaid.backends"]
+Status:                 ✗ ENTRY-POINTS NOT DEFINED
+
+Current State:
+  - pyproject.toml does NOT contain any [project.entry-points] section
+  - grep search: "No entry-points found in pyproject.toml"
+
+Impact Analysis:
+  The PayUProcessor is the main integration point with getpaid-core.
+  Entry-points are REQUIRED for plugin auto-discovery by framework adapters
+  (e.g., django-getpaid).
+
+Expected Entry-Point (if needed):
+  [project.entry-points."getpaid.backends"]
+  payu = "getpaid_payu.processor:PayUProcessor"
+
+  OR (if supporting multiple backends):
+  [project.entry-points."getpaid.backends"]
+  payu = "getpaid_payu.processor:PayUProcessor"
+
+Recommendation:
+  TASK 10 (Add entry-points configuration) IS REQUIRED
+  Current state prevents framework adapters from auto-discovering PayUProcessor.
+
+================================================================================
+8. PYPROJECT.TOML STRUCTURE
+================================================================================
+
+Build Section:          ✓ Present (hatchling)
+Test Configuration:     ✓ Present (pytest)
+Coverage Config:        ✓ Present
+Linter Config (ruff):   ✓ Present
+Type Checker (ty):      ✓ Present
+Project Metadata:       ✓ Complete
+
+Entry-Points Section:   ✗ MISSING (BLOCKING FOR TASK 10)
+
+================================================================================
+SUMMARY
+================================================================================
+
+✓ Pytest: 115 passed (2.57s)
+✓ Build: Successful (tarball + wheel)
+✓ License: MIT, properly formatted
+✓ README: Comprehensive documentation
+✓ Version: 0.1.1 (consistent across build artifacts)
+✓ Metadata: Complete and correct
+
+✗ Entry-Points: NOT DEFINED
+  → PayUProcessor cannot be auto-discovered by framework adapters
+  → Task 10 required to add: [project.entry-points."getpaid.backends"]
+
+BLOCKERS: Entry-points missing (expected, noted in Metis feedback)
+
+NEXT STEPS:
+  - Task 10: Add entry-points configuration
+  - Ensure PayUProcessor class is properly exported for discovery
+
+================================================================================
+EOF

python_getpaid_payu-3.0.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: python-getpaid-payu
+Version: 3.0.0
+Summary: PayU payment gateway integration for python-getpaid ecosystem.
+Project-URL: Homepage, https://github.com/django-getpaid/python-getpaid-payu
+Project-URL: Repository, https://github.com/django-getpaid/python-getpaid-payu
+Project-URL: Documentation, https://getpaid-payu.readthedocs.io/
+Project-URL: Changelog, https://github.com/django-getpaid/python-getpaid-payu/releases
+Author-email: Dominik Kozaczko <dominik@kozaczko.info>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Office/Business :: Financial :: Point-Of-Sale
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: python-getpaid-core>=3.0.0
+Provides-Extra: simulator
+Requires-Dist: litestar>=2.0; extra == 'simulator'
+Requires-Dist: python-getpaid-simulator>=3.0.0; extra == 'simulator'
+Description-Content-Type: text/markdown
+
+# python-getpaid-payu
+
+[![PyPI version](https://img.shields.io/pypi/v/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![Python versions](https://img.shields.io/pypi/pyversions/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+PayU payment processor plugin for the [python-getpaid](https://github.com/django-getpaid/python-getpaid-core) ecosystem.
+
+Provides a fully async HTTP client (`PayUClient`) and a payment processor (`PayUProcessor`) implementing the [getpaid-core](https://github.com/django-getpaid/python-getpaid-core) `BaseProcessor` interface. Communicates with PayU via their REST API v2.1 using OAuth2 authentication.
+
+## Features
+
+- **Full Payment Lifecycle**: Supports prepared, locked, paid, failed, and refunded states.
+- **Pre-authorization**: Reserve funds on customer's card (lock) and capture them later (charge).
+- **Refunds**: Full and partial refund support via API.
+- **Multiple Currencies**: Support for 15 currencies across Europe and beyond.
+- **Asynchronous**: Built with `httpx` for non-blocking API communication.
+- **Security**: Robust callback signature verification (SHA-256 and MD5).
+- **Comprehensive API**: Wraps every PayU REST API v2.1 endpoint.
+
+## Supported Currencies
+
+The following 15 currencies are supported:
+BGN, CHF, CZK, DKK, EUR, GBP, HRK, HUF, NOK, PLN, RON, RUB, SEK, UAH, USD.
+
+## Installation
+
+```bash
+pip install python-getpaid-payu
+```
+
+Install simulator support only when you want this package to register its local
+simulator plugin with `python-getpaid-simulator`:
+
+```bash
+pip install python-getpaid-payu[simulator]
+```
+
+This extra installs the simulator host and Litestar dependencies, then exposes
+the `payu` plugin through the `getpaid.simulator.providers` entry point.
+
+## Simulator Plugin
+
+When `python-getpaid-payu[simulator]` is installed alongside
+`python-getpaid-simulator`, the simulator host auto-discovers the PayU plugin.
+
+Typical local setup:
+
+```bash
+pip install python-getpaid-simulator python-getpaid-payu[simulator]
+getpaid-simulator
+```
+
+The plugin contributes:
+
+- PayU OAuth and order/refund simulator API routes
+- PayU authorization UI at `/sim/payu/authorize/{order_id}`
+- PayU-specific webhook signing and state transitions
+
+Useful simulator environment variables:
+
+- `SIMULATOR_PAYU_SECOND_KEY`
+- `SIMULATOR_PLUGIN_FAILURE_MODE` (`warn` or `strict`)
+
+## Configuration
+
+To use the PayU backend, register it in your `getpaid` configuration and provide the following settings:
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `pos_id` | `int` | — | PayU POS (point of sale) identifier |
+| `second_key` | `str` | — | Second key (MD5) from PayU panel, used for signature verification |
+| `oauth_id` | `int` | — | OAuth client ID from PayU panel |
+| `oauth_secret` | `str` | — | OAuth client secret from PayU panel |
+| `sandbox` | `bool` | `True` | Use sandbox (`secure.snd.payu.com`) or production (`secure.payu.com`) |
+| `notify_url` | `str` | `None` | Notification callback URL template, e.g. `https://example.com/payments/{payment_id}/notify` |
+| `continue_url` | `str` | `None` | Redirect URL template after payment, e.g. `https://example.com/payments/{payment_id}/continue` |
+
+Example configuration:
+
+```python
+GETPAID_BACKENDS = {
+    "payu": {
+        "pos_id": "300746",
+        "second_key": "b6ca15b0d1020e8094d9b5f8d163db54",
+        "oauth_id": "300746",
+        "oauth_secret": "2ee86a66e5d97e3fadc400c9f19b065d",
+        "notify_url": "https://your-domain.com/payments/payu/callback/",
+        "continue_url": "https://your-domain.com/payments/payu/success/",
+        "sandbox": True,
+    }
+}
+```
+
+### Sandbox Mode
+
+PayU provides a sandbox environment for testing. You can use the example keys provided above for testing in PLN.
+
+## Ecosystem
+
+`python-getpaid-payu` is part of the larger `python-getpaid` ecosystem. Use it with one of our web framework wrappers:
+
+- [django-getpaid](https://github.com/django-getpaid/django-getpaid)
+- [litestar-getpaid](https://github.com/django-getpaid/litestar-getpaid)
+- [fastapi-getpaid](https://github.com/django-getpaid/fastapi-getpaid)
+
+## Requirements
+
+- Python 3.12+
+- `python-getpaid-core >= 3.0.0`
+- `httpx >= 0.27.0`
+
+## License
+
+MIT
+
+## Credits
+
+Created by [Dominik Kozaczko](https://github.com/dekoza).

python_getpaid_payu-3.0.0/README.md

@@ -0,0 +1,119 @@
+# python-getpaid-payu
+
+[![PyPI version](https://img.shields.io/pypi/v/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![Python versions](https://img.shields.io/pypi/pyversions/python-getpaid-payu.svg)](https://pypi.org/project/python-getpaid-payu/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+PayU payment processor plugin for the [python-getpaid](https://github.com/django-getpaid/python-getpaid-core) ecosystem.
+
+Provides a fully async HTTP client (`PayUClient`) and a payment processor (`PayUProcessor`) implementing the [getpaid-core](https://github.com/django-getpaid/python-getpaid-core) `BaseProcessor` interface. Communicates with PayU via their REST API v2.1 using OAuth2 authentication.
+
+## Features
+
+- **Full Payment Lifecycle**: Supports prepared, locked, paid, failed, and refunded states.
+- **Pre-authorization**: Reserve funds on customer's card (lock) and capture them later (charge).
+- **Refunds**: Full and partial refund support via API.
+- **Multiple Currencies**: Support for 15 currencies across Europe and beyond.
+- **Asynchronous**: Built with `httpx` for non-blocking API communication.
+- **Security**: Robust callback signature verification (SHA-256 and MD5).
+- **Comprehensive API**: Wraps every PayU REST API v2.1 endpoint.
+
+## Supported Currencies
+
+The following 15 currencies are supported:
+BGN, CHF, CZK, DKK, EUR, GBP, HRK, HUF, NOK, PLN, RON, RUB, SEK, UAH, USD.
+
+## Installation
+
+```bash
+pip install python-getpaid-payu
+```
+
+Install simulator support only when you want this package to register its local
+simulator plugin with `python-getpaid-simulator`:
+
+```bash
+pip install python-getpaid-payu[simulator]
+```
+
+This extra installs the simulator host and Litestar dependencies, then exposes
+the `payu` plugin through the `getpaid.simulator.providers` entry point.
+
+## Simulator Plugin
+
+When `python-getpaid-payu[simulator]` is installed alongside
+`python-getpaid-simulator`, the simulator host auto-discovers the PayU plugin.
+
+Typical local setup:
+
+```bash
+pip install python-getpaid-simulator python-getpaid-payu[simulator]
+getpaid-simulator
+```
+
+The plugin contributes:
+
+- PayU OAuth and order/refund simulator API routes
+- PayU authorization UI at `/sim/payu/authorize/{order_id}`
+- PayU-specific webhook signing and state transitions
+
+Useful simulator environment variables:
+
+- `SIMULATOR_PAYU_SECOND_KEY`
+- `SIMULATOR_PLUGIN_FAILURE_MODE` (`warn` or `strict`)
+
+## Configuration
+
+To use the PayU backend, register it in your `getpaid` configuration and provide the following settings:
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `pos_id` | `int` | — | PayU POS (point of sale) identifier |
+| `second_key` | `str` | — | Second key (MD5) from PayU panel, used for signature verification |
+| `oauth_id` | `int` | — | OAuth client ID from PayU panel |
+| `oauth_secret` | `str` | — | OAuth client secret from PayU panel |
+| `sandbox` | `bool` | `True` | Use sandbox (`secure.snd.payu.com`) or production (`secure.payu.com`) |
+| `notify_url` | `str` | `None` | Notification callback URL template, e.g. `https://example.com/payments/{payment_id}/notify` |
+| `continue_url` | `str` | `None` | Redirect URL template after payment, e.g. `https://example.com/payments/{payment_id}/continue` |
+
+Example configuration:
+
+```python
+GETPAID_BACKENDS = {
+    "payu": {
+        "pos_id": "300746",
+        "second_key": "b6ca15b0d1020e8094d9b5f8d163db54",
+        "oauth_id": "300746",
+        "oauth_secret": "2ee86a66e5d97e3fadc400c9f19b065d",
+        "notify_url": "https://your-domain.com/payments/payu/callback/",
+        "continue_url": "https://your-domain.com/payments/payu/success/",
+        "sandbox": True,
+    }
+}
+```
+
+### Sandbox Mode
+
+PayU provides a sandbox environment for testing. You can use the example keys provided above for testing in PLN.
+
+## Ecosystem
+
+`python-getpaid-payu` is part of the larger `python-getpaid` ecosystem. Use it with one of our web framework wrappers:
+
+- [django-getpaid](https://github.com/django-getpaid/django-getpaid)
+- [litestar-getpaid](https://github.com/django-getpaid/litestar-getpaid)
+- [fastapi-getpaid](https://github.com/django-getpaid/fastapi-getpaid)
+
+## Requirements
+
+- Python 3.12+
+- `python-getpaid-core >= 3.0.0`
+- `httpx >= 0.27.0`
+
+## License
+
+MIT
+
+## Credits
+
+Created by [Dominik Kozaczko](https://github.com/dekoza).

python_getpaid_payu-3.0.0/docs/changelog.md

@@ -0,0 +1,51 @@
+# Changelog
+
+## v3.0.0 (2026-06-04)
+
+Major stable release — PayU payment gateway integration for the python-getpaid ecosystem.
+
+### Breaking Changes
+
+- Complete rewrite as a framework-agnostic plugin for `python-getpaid-core` v3
+- Requires Python 3.12+
+- Now depends on `python-getpaid-core>=3.0.0` instead of standalone django-getpaid
+
+### Features
+
+- Full PayU REST API v2.1 coverage
+- Async HTTP client (`PayUClient`) with OAuth2 token management
+- Payment processor (`PayUProcessor`) implementing `BaseProcessor`
+- All order operations: create, cancel, capture, retrieve
+- Refund operations: create, retrieve single/all
+- Payment methods retrieval
+- Transaction details retrieval
+- Shop info and payout operations
+- Token deletion
+- Automatic amount centification/normalization
+- Signature verification (MD5 and SHA-256)
+- PUSH callback handling with semantic payment updates
+- PULL status polling
+- Full pre-authorization support (lock, charge, release)
+
+---
+
+## v0.1.0 (2026-02-14)
+
+Initial release.
+
+### Features
+
+- Full PayU REST API v2.1 coverage
+- Async HTTP client (`PayUClient`) with OAuth2 token management
+- Payment processor (`PayUProcessor`) implementing `BaseProcessor`
+- All order operations: create, cancel, capture, retrieve
+- Refund operations: create, retrieve single/all
+- Payment methods retrieval
+- Transaction details retrieval
+- Shop info and payout operations
+- Token deletion
+- Automatic amount centification/normalization
+- Signature verification (MD5 and SHA-256)
+- PUSH callback handling with semantic payment updates
+- PULL status polling
+- Full pre-authorization support (lock, charge, release)