python-getpaid-simulator 3.0.0a3__py3-none-any.whl

getpaid_simulator/ui/templates/dashboard.html

@@ -0,0 +1,45 @@
+{% extends "base.html" %}
+
+{% block title %}Dashboard{% endblock %}
+
+{% block content %}
+<div class="dashboard-header">
+    <h2>Payments Dashboard</h2>
+    {% if failed_plugins %}
+    <div class="empty-state" style="text-align: left; padding: 1.5rem; margin-bottom: 1.5rem; background-color: #2f1818; border: 1px solid #b45309; border-radius: var(--border-radius);">
+        <h3 style="margin-top: 0;">Plugin warnings</h3>
+        <p style="margin-bottom: 0.75rem; color: var(--text-muted);">The simulator started in degraded mode. Some provider plugins failed to initialize.</p>
+        <ul style="margin: 0; padding-left: 1.2rem;">
+            {% for failure in failed_plugins %}
+            <li><strong>{{ failure.slug }}</strong> ({{ failure.stage }}): {{ failure.error }}</li>
+            {% endfor %}
+        </ul>
+    </div>
+    {% endif %}
+    <div class="provider-filters" style="margin-bottom: 2rem;">
+        <span>Filter by provider:</span>
+        <a href="/sim/dashboard" class="btn {% if not current_provider %}btn-neutral{% endif %}">All</a>
+        {% for provider_filter in provider_filters %}
+        <a href="/sim/dashboard?provider={{ provider_filter.slug }}" class="btn {% if current_provider == provider_filter.slug %}btn-neutral{% endif %}">{{ provider_filter.display_name }}</a>
+        {% endfor %}
+    </div>
+</div>
+
+<div class="payments-list">
+    {% if orders %}
+        {% for order in orders %}
+            {% set amount = order.formatted_amount %}
+            {% set status = order.status %}
+            {% set order_id = order.id %}
+            {% set provider = order.provider_display_name %}
+            {% set authorize_url = order.authorize_url %}
+            {% include "components/dashboard_payment_card.html" %}
+        {% endfor %}
+    {% else %}
+        <div class="empty-state" style="text-align: center; padding: 3rem; background-color: var(--bg-card); border: 1px dashed var(--text-muted); border-radius: var(--border-radius);">
+            <h3>No payments yet</h3>
+            <p style="color: var(--text-muted);">Create a payment via your application to see it here.</p>
+        </div>
+    {% endif %}
+</div>
+{% endblock %}

python_getpaid_simulator-3.0.0a3.dist-info/METADATA

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: python-getpaid-simulator
+Version: 3.0.0a3
+Summary: Payment gateway simulator for testing the python-getpaid ecosystem.
+Project-URL: Homepage, https://github.com/django-getpaid/python-getpaid-simulator
+Project-URL: Repository, https://github.com/django-getpaid/python-getpaid-simulator
+Author-email: Dominik Kozaczko <dominik@kozaczko.info>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+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: jinja2>=3.0
+Requires-Dist: litestar>=2.0
+Requires-Dist: uvicorn[standard]>=0.30.0
+Description-Content-Type: text/markdown
+
+# python-getpaid-simulator
+
+Payment gateway simulator host for testing the python-getpaid ecosystem.
+
+The simulator no longer owns provider implementations directly. It starts a
+generic Litestar host, discovers provider plugins from installed packages, and
+mounts each provider's API routes and UI flows through entry points.
+
+## Installation
+
+```bash
+pip install python-getpaid-simulator
+```
+
+The host only becomes useful when at least one provider package exposing the
+simulator plugin entry point is installed in the same environment.
+
+## Plugin Model
+
+Provider packages must expose an entry point in the
+`getpaid.simulator.providers` group.
+
+Example from a provider package:
+
+```toml
+[project.entry-points."getpaid.simulator.providers"]
+payu = "getpaid_payu.simulator:get_plugin"
+```
+
+The entry point must resolve to a factory returning a
+`getpaid_simulator.spi.SimulatorProviderPlugin`.
+
+The current stable plugin contract requires:
+
+- `api_version`
+- `slug`
+- `display_name`
+- `api_handlers`
+- `ui_handlers`
+- `transitions`
+- `load_config(env)`
+- optional `authorize_path_template`
+
+The host validates the plugin slug against the entry point name and rejects
+plugins that do not match `getpaid_simulator.spi.SIMULATOR_PLUGIN_API_VERSION`.
+
+## Startup Failure Modes
+
+Plugin loading is controlled by `SIMULATOR_PLUGIN_FAILURE_MODE` or the CLI flag
+`--plugin-failure-mode`.
+
+- `warn` (default): broken plugins are skipped, the simulator starts in
+  degraded mode, and failed providers appear in logs, `/`, `/sim/status`, and
+  the dashboard.
+- `strict`: the first plugin import, factory, compatibility, or config failure
+  aborts startup with `PluginLoadError`.
+
+Examples:
+
+```bash
+getpaid-simulator --plugin-failure-mode strict
+SIMULATOR_PLUGIN_FAILURE_MODE=warn getpaid-simulator
+```
+
+## Provider Packaging
+
+Provider packages should keep simulator support in an optional dependency group
+such as `simulator`, rather than forcing simulator host and Litestar
+dependencies into normal runtime installs.
+
+Example:
+
+```toml
+[project.optional-dependencies]
+simulator = [
+    "python-getpaid-simulator>=3.0.0a3",
+    "litestar>=2.0",
+]
+```
+
+## Development Notes
+
+- Wave 1 storage remains in-memory behind the host storage interface.
+- Provider-local simulator code lives in provider repositories, not under
+  `getpaid_simulator.providers`.
+
+## License
+
+MIT

python_getpaid_simulator-3.0.0a3.dist-info/RECORD

@@ -0,0 +1,26 @@
+getpaid_simulator/__init__.py,sha256=6bBWm3oGxThDXXtVoT8gTaG5JqMnBamOEFq0OI0opRo,99
+getpaid_simulator/__main__.py,sha256=smgjFzHIOTj9Q_L3OyT9GphTWpi9VoiB8ywCmvf19Lw,3359
+getpaid_simulator/app.py,sha256=O4O1m0S3-uX2bdiZV8IajLQX7DJWo0No7cVH30avskQ,4200
+getpaid_simulator/plugins.py,sha256=68fc_QWvNWelf-zqOAy3plKZkR9jPF_UGbGFdBITbVM,6496
+getpaid_simulator/spi.py,sha256=QQ7qgOdqIJOhInV7XiQQP5p1QDusOGoIv6erOlEuW_w,947
+getpaid_simulator/core/__init__.py,sha256=taAfqQWD3Isj57iqCQmLK7hfixH4kkkIehPYzu6sF0c,33
+getpaid_simulator/core/config.py,sha256=ZpQ3JYAtmQoogzo-jdfWKIVYa4vSRGXd62k6Q751XbY,1747
+getpaid_simulator/core/discovery.py,sha256=nwANWI7kg4P7GhLkOOF2mYDVU7RzFpCp6hKYuiw6mXI,362
+getpaid_simulator/core/state.py,sha256=TBKzZtwms2JMPMX_Z45Y5ADkQ9MjygbFXeFStI929V8,1883
+getpaid_simulator/core/storage.py,sha256=0AWUiWTxVp9zQo-7OqO_f8_Z5aJI1B8zfeNh6jv6yI8,5316
+getpaid_simulator/core/webhooks.py,sha256=1L7vf6m3MxjVesYOfqE81pOy6MiawuqO9kXGSMG0WM8,1788
+getpaid_simulator/ui/__init__.py,sha256=sRAPeVu_KYQc0_xMEtjUMQ_w6pFdsLClDciZBcnAO3k,21
+getpaid_simulator/ui/routes.py,sha256=mOTuXmGWR0q3y5AD0y_FaUgyCy1WSIEXTx6OcAl5FWo,2305
+getpaid_simulator/ui/static/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+getpaid_simulator/ui/static/style.css,sha256=A_iej863-UTkiMxoGjbLUzZHX1j-yEv4689BGvnyTRw,5157
+getpaid_simulator/ui/templates/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+getpaid_simulator/ui/templates/authorize.html,sha256=5jI0EbmS7CmYQOmWcxGsUO8qxpQ0h0MyWcNKmER5Uz0,770
+getpaid_simulator/ui/templates/base.html,sha256=ENmY74iTSys-nqKWoUNYOZiejDjb2RaAsAAINfEEtt8,917
+getpaid_simulator/ui/templates/dashboard.html,sha256=bDLE6gjF9_JCobJPj91QaKmX1-o15rc_lCchnhPuMys,2171
+getpaid_simulator/ui/templates/components/dashboard_payment_card.html,sha256=nBHqdWxIlwdFhdXBwkO5lDdajXqcJdcNhNgAisrsexA,258
+getpaid_simulator/ui/templates/components/payment_card.html,sha256=AqK3ef2SjO2sLeHaW4xwGMedG5edgTqS0WJhtiSQfSw,560
+getpaid_simulator/ui/templates/components/status_badge.html,sha256=fWOEtUrycdG1G3hWoukW3xdByl75C9npRAr0t-vvC08,80
+python_getpaid_simulator-3.0.0a3.dist-info/METADATA,sha256=jNzDkxAz00yars_IfjYbjhWO6SPQO4Wvvz7aZtPnKus,3313
+python_getpaid_simulator-3.0.0a3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_getpaid_simulator-3.0.0a3.dist-info/entry_points.txt,sha256=EKlga2W7QZ4qoB0SkMzPgceuRoyV8_uh7GIDJ4Qq0Zg,70
+python_getpaid_simulator-3.0.0a3.dist-info/RECORD,,

python_getpaid_simulator-3.0.0a3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

python_getpaid_simulator-3.0.0a3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+getpaid-simulator = getpaid_simulator.__main__:main