revturbine 0.2.13__tar.gz

revturbine-0.2.13/.gitignore

@@ -0,0 +1,28 @@
+# Python virtualenvs
+.venv/
+venv/
+env/
+
+# Bytecode and caches
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Tool caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+
+# Build / packaging artifacts
+build/
+dist/
+*.egg-info/
+*.egg
+.eggs/
+
+# Coverage
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml

revturbine-0.2.13/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+# Python-side pre-commit hooks for the revturbine package.
+# Scoped to server-python/; install from this directory with `pre-commit install`.
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        additional_dependencies: [pydantic>=2.0]
+        files: ^server-python/src/
+        args: [--config-file=server-python/pyproject.toml]

revturbine-0.2.13/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: revturbine
+Version: 0.2.13
+Summary: RevTurbine SDK for Python — local-mode and HTTP-mode placement and entitlement decisioning
+Author: RevTurbine
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: pydantic[email]>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 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 as a GitHub **Release on `revt-eng/revturbine-external`** (the
+customer-accessible repo — there is no PyPI). Requires Python ≥ 3.10.
+`revturbine-external` is private, so fetch the wheel authenticated, then
+install the file:
+
+```bash
+gh release download python-v0.1.0 \
+  --repo revt-eng/revturbine-external \
+  --pattern "revturbine-*.whl"
+pip install ./revturbine-*.whl
+```
+
+A plain `pip install <url>` will not work — private-repo release assets
+require authentication. (Contributors developing in this repo use the
+editable install under [Local development](#local-development) instead.)
+
+## Quick start
+
+```python
+import json
+from revturbine import RevTurbineCustomerSdk
+
+with open("exported_config.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_context` requires `tenant_id` + `user_id` (optional `plan_handle`,
+  `plan_name`, `usage`). Stateless / in-memory — no storage parameter.
+- `check_entitlement(handle, context=None) -> EntitlementCheckResult`
+- `get_placement_decision(input) -> PlacementDecision`
+- `get_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
+
+```bash
+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):
+
+```bash
+node scripts/run-parity.mjs   # TS + Python runners, byte-diff (the gate)
+```
+
+## Dependencies
+
+- Runtime: `pydantic>=2.0`.
+- Stdlib only otherwise. The legacy `revturbine_server` client uses only
+  `urllib` / `json` / `uuid` (plus the unmaintained generated-types import
+  noted above).

revturbine-0.2.13/README.md

@@ -0,0 +1,111 @@
+# 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 as a GitHub **Release on `revt-eng/revturbine-external`** (the
+customer-accessible repo — there is no PyPI). Requires Python ≥ 3.10.
+`revturbine-external` is private, so fetch the wheel authenticated, then
+install the file:
+
+```bash
+gh release download python-v0.1.0 \
+  --repo revt-eng/revturbine-external \
+  --pattern "revturbine-*.whl"
+pip install ./revturbine-*.whl
+```
+
+A plain `pip install <url>` will not work — private-repo release assets
+require authentication. (Contributors developing in this repo use the
+editable install under [Local development](#local-development) instead.)
+
+## Quick start
+
+```python
+import json
+from revturbine import RevTurbineCustomerSdk
+
+with open("exported_config.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_context` requires `tenant_id` + `user_id` (optional `plan_handle`,
+  `plan_name`, `usage`). Stateless / in-memory — no storage parameter.
+- `check_entitlement(handle, context=None) -> EntitlementCheckResult`
+- `get_placement_decision(input) -> PlacementDecision`
+- `get_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
+
+```bash
+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):
+
+```bash
+node scripts/run-parity.mjs   # TS + Python runners, byte-diff (the gate)
+```
+
+## Dependencies
+
+- Runtime: `pydantic>=2.0`.
+- Stdlib only otherwise. The legacy `revturbine_server` client uses only
+  `urllib` / `json` / `uuid` (plus the unmaintained generated-types import
+  noted above).

revturbine-0.2.13/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "revturbine"
+version = "0.2.13"
+description = "RevTurbine SDK for Python — local-mode and HTTP-mode placement and entitlement decisioning"
+requires-python = ">=3.10"
+license = "MIT"
+readme = "README.md"
+authors = [{ name = "RevTurbine" }]
+dependencies = [
+    # `pydantic[email]` (not bare pydantic): the vendored generated
+    # `revturbine.types` models (plan 33 REQ-4) declare EmailStr fields,
+    # which import `email-validator` at model-build time — required for
+    # `import revturbine.types` / `revturbine_server` to load. (REQ-12
+    # justification: it is a hard import-time dep of the required
+    # generated-types artifact, not an optional add.)
+    "pydantic[email]>=2.0",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "mypy>=1.10",
+    "ruff>=0.6",
+    "pre-commit>=3.7",
+]
+
+# The typed `revturbine` package (src-layout, the headless in-memory SDK —
+# plan 33 TASK-7's `RevTurbineCustomerSdk`) ships alongside the legacy
+# `revturbine_server` thin-RPC HTTP client. They are independent and
+# composable: the headless-server scope decision keeps `revturbine_server`
+# unchanged rather than folding it into a dual-mode dispatch (the original
+# plan's `runtime_mode` framing is superseded).
+[tool.hatch.build.targets.wheel]
+packages = ["src/revturbine", "revturbine_server"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+# `src/revturbine/types.py` is the vendored datamodel-codegen artifact
+# (plan 33 REQ-4) — generated, never hand-edited, not lint-owned here.
+extend-exclude = ["src/revturbine/types.py"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "B", "UP", "SIM"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["E501"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+files = ["src/revturbine", "tests"]
+# `src/revturbine/types.py` is the vendored datamodel-codegen artifact
+# (plan 33 REQ-4) — generated, never hand-edited, not strict-typed here.
+# `revturbine_server` now imports that vendored `revturbine.types` fine,
+# but its legacy typing stays out of mypy --strict by deliberate scope
+# decision (independent legacy surface; not retyped here).
+exclude = ["revturbine_server/", "build/", "src/revturbine/types\\.py"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = ["-ra", "--strict-markers"]