RevTurbine SDK — Python
Headless, in-memory entitlement and placement decisioning for Python
services. RevTurbineCustomerSdk (plan 33 TASK-7) decides in-process from a
caller-supplied user context + ExportedConfig snapshot — no network, no
persistence beyond memory. Its decision output is byte-identical to the
canonical TypeScript LocalRuntime (cross-language parity is gate-enforced via
revturbine-sdk-internal/tests/parity/).
Full docs: the published Astro docs site — Getting Started → Python SDK
(source: pages-build/src/content/docs/getting-started/python.mdx).
Install
Published on PyPI as revturbine.
Requires Python ≥ 3.10.
pip install revturbine
Releases are tag-driven and version-locked with @revturbine/sdk — the same
version number always ships for both. (Contributors developing in this repo
use the editable install under Local development
instead. The old GitHub-Release distribution on the now-archived
revt-eng/revturbine-external is retired.)
Quick start
import json
from revturbine import RevTurbineCustomerSdk
with open("playbook.json") as f:
exported_config = json.load(f)
sdk = RevTurbineCustomerSdk(
user_context={"tenant_id": "tenant_abc", "user_id": "user_123", "plan_handle": "pro"},
exported_config=exported_config,
)
if not sdk.check_entitlement("advanced_analytics")["allowed"]:
raise PermissionError("not entitled")
decision = sdk.get_placement_decision(
{"placement_id": "pl_dashboard_upsell", "user_id": "user_123"}
)
Public API
RevTurbineCustomerSdk(*, user_context, exported_config)— keyword-only;user_contextrequirestenant_id+user_id(optionalplan_handle,plan_name,usage). Stateless / in-memory — no storage parameter.check_entitlement(handle, context=None) -> EntitlementCheckResultcan(handle, context=None)— the advertised alias ofcheck_entitlement(same canonical/alias pair as the scaffold SDK function surface and the server-node port)get_placement_decision(input) -> PlacementDecisionget_placement_decisions(inputs) -> list[PlacementDecision]
That is the entire public surface. Browser/full-SDK concerns (React, hooks,
HTTP/dual-mode, decision cache, segment/targeting derivation,
identify/dismiss/snooze/convert/get_trial_status/capture/…) are
intentionally not ported — plan 33 REQ-14 non-goals.
Project layout
server-python/
├── pyproject.toml ← package metadata + tool config (ruff, mypy, pytest)
├── tox.ini ← test/lint/type matrix
├── .pre-commit-config.yaml ← ruff + mypy hooks (scoped to this dir)
├── src/revturbine/ ← the headless SDK (sdk.py + core/ port)
├── revturbine_server/ ← legacy thin-RPC client (see below)
└── tests/ ← pytest suite (incl. tests/test_public_api.py)
Legacy revturbine_server
A historical thin-RPC HTTP client (from revturbine_server import RevTurbineServer) also ships in this package. It is independent of and
unrelated to RevTurbineCustomerSdk — not folded in, not a dual-mode of it.
It currently depends on an unmaintained generated revturbine.types module
(plan REQ-4 / TASK-2) and is not standalone-importable until that
generator lands. Prefer RevTurbineCustomerSdk for all new server
integrations.
Local development
pip install -e ".[dev]"
pytest # unit + smoke + parity-contract tests
mypy # strict type-check of src/ and tests/
ruff check src tests # lint (CI scope)
ruff format --check src tests
tox # full matrix (py310–py313 + lint + type)
Cross-language parity (run from the SDK repo root):
node scripts/run-parity.mjs # TS + Python runners, byte-diff (the gate)
Dependencies
- Runtime:
pydantic>=2.0. - Stdlib only otherwise. The legacy
revturbine_serverclient uses onlyurllib/json/uuid(plus the unmaintained generated-types import noted above).
1 maintainer
Release files for revturbine 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| revturbine-0.8.1.tar.gz | 200.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| revturbine-0.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 356.2 kB
Release files / revturbine-0.8.1.tar.gz
| Download URL | revturbine-0.8.1.tar.gz |
|---|---|
| Size | 200.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6b5b8a46f0b5094a42d884deb4ae198408add8064b264f4616da82d87e165bca
|
|
BLAKE2b-256 checksum How to use checksums |
a7b4a70a51acf6efe2700b780e4bc0df34a7df3edac9d5ccc3187798e09f15cf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.
Transparency logRelease files / revturbine-0.8.1-py3-none-any.whl
| Download URL | revturbine-0.8.1-py3-none-any.whl |
|---|---|
| Size | 155.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
98eb31e11cd142a04f03479ebf5cb9d30cddadf012a4ddc7330ea395c78a6b23
|
|
BLAKE2b-256 checksum How to use checksums |
fc8c01a9c258ac2f36ba6a9e6d81cc4b127eafcad08a6b6b9bc14c6ebf85804e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.
Transparency log
