prodantix-sdk 0.0.1__tar.gz

prodantix_sdk-0.0.1/.gitignore

@@ -0,0 +1,172 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# git filter-branch / rewrite temp
+.git-rewrite/
+
+#environment files
+/env
+.env
+.env.local
+cypress.env.json
+settings.local.json
+.claude/settings.local.json
+
+# Cross-tool agent-CLI mirrors — redundant with .claude/; do not commit
+.agents/
+.codex/
+# Flutter web env files are generated at build time from environment variables
+# (scripts/vercel/gen-env.sh) — never commit them. Use .env.example as the
+# committed source of keys + dev defaults.
+.env.development
+.env.test
+.env.production
+
+**/snippets/
+
+# dependencies
+node_modules
+.pnp
+.pnp.js
+
+# testing
+coverage
+screenshots
+
+# Re-include intentional marketing screenshots that live under web apps' public dirs
+# Pattern matches both pre-restructure (products/<app>/public/...) and post-restructure
+# (products/<product>/<app>/public/...) layouts.
+!products/*/public/images/screenshots/
+!products/*/public/images/screenshots/**
+!products/*/*/public/images/screenshots/
+!products/*/*/public/images/screenshots/**
+
+# Re-include fastlane screenshot driver scripts (Dart source, not generated image files).
+!**/fastlane/screenshots/
+!**/fastlane/screenshots/*.dart
+!**/fastlane/screenshots/*.txt
+
+# Fastlane supply / deliver – generated screenshots (regenerate with screengrab / your pipeline)
+**/fastlane/metadata/**/images/
+
+# next.js
+.next/
+.next.stale*/
+out/
+build
+dist
+
+# dart
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+/build/
+**/android/local.properties
+
+# python — 48 of these were committed under the prodantix Python SDK and every
+# test run re-dirtied them. .venv and .pytest_cache need no rule: both write a
+# self-ignoring .gitignore into their own directory.
+__pycache__/
+*.pyc
+
+# misc
+.DS_Store
+*.pem
+
+# JetBrains IDE
+.idea/
+
+# superpowers session-scoped working state
+.superpowers/
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+#storybook
+storybook-static
+
+# Flutter
+*.ipa
+*.dSYM.zip
+
+# typescript
+*.tsbuildinfo
+
+# turbo
+.turbo
+
+# Melos
+.melos_tool
+.melos_cache
+
+# AuthKey
+AuthKey_*.p8
+
+.vercel
+.gstack/
+
+# GraphQL auto-generated schemas
+products/clepit-server/products/*/src/schema.gql
+
+# Railway CLI link state (project IDs are kept in project.json instead)
+infra/railway/*/.railway/
+
+# SOPS — never commit unencrypted age private keys
+*.age.key
+*.age
+!*.age.pub
+
+# Tofu — workspaces use GCS state (gs://bomdisoft-tofu-state/<workspace>/).
+# Only tofu-state-bootstrap keeps state local (chicken-and-egg — it creates
+# the bucket). All other workspaces have backend "gcs" in versions.tf so their
+# tfstate never lands on disk.
+#
+# .terraform.lock.hcl is deliberately NOT ignored. CI runs a bare `tofu init`,
+# so without a committed lockfile every apply re-resolves the version
+# constraints against the registry and can pick up a new provider release
+# mid-flight, unreviewed, against live infrastructure. The lockfiles carry
+# hashes for every published platform (CI is linux_amd64, laptops are darwin),
+# so regenerate with `tofu providers lock -platform=...` for ALL platforms.
+# A bare `tofu init -upgrade` records only the current one and breaks CI.
+infra/iac/projects/tofu-state-bootstrap/terraform.tfstate
+infra/iac/projects/tofu-state-bootstrap/terraform.tfstate.backup
+infra/iac/projects/*/.terraform/
+infra/iac/projects/*/*.tfplan
+infra/iac/projects/*/terraform.tfvars
+
+# Local dev stacks (infra/iac/local/*) deliberately keep LOCAL state — they
+# manage per-machine throwaway containers, so state never leaves the laptop.
+infra/iac/local/*/.terraform/
+infra/iac/local/*/terraform.tfstate
+infra/iac/local/*/terraform.tfstate.backup
+infra/iac/local/*/*.tfplan
+products/prodantix/.env.local
+
+CLAUDE.local.md
+
+/target
+
+# Tor hidden-service key material. Tor GENERATES these into HiddenServiceDir on
+# first start; they are per-deployment secrets and must never be committed —
+# anyone holding hs_ed25519_secret_key can impersonate the .onion address.
+# (Three were committed in f392aa205 on 2026-08-03 and have been rotated.)
+**/tor/hidden_service/
+**/dark-web/tor/
+
+# Shell artifact: an unexpanded $LOG once captured a turbo lint run and was
+# committed (74a65bc6c, removed same week). Literal $ names are never source.
+/$LOG
+.claude/context/
+
+# Lane addresses are machine state, not repository state (scripts/lane.ts).
+.claude/lane-registry.json

prodantix_sdk-0.0.1/LICENSE

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

prodantix_sdk-0.0.1/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: prodantix-sdk
+Version: 0.0.1
+Summary: Prodantix server SDK: send events, evaluate feature flags, read the in-app inbox from a Python backend.
+Project-URL: Homepage, https://prodantix.com
+Author: Bomdisoft
+License-Expression: MIT
+License-File: LICENSE
+Keywords: analytics,events,feature-flags,prodantix
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Prodantix Python SDK
+
+The server-side SDK for [Prodantix](https://prodantix.com): send analytics events,
+evaluate feature flags (remote or locally), and read the in-app inbox from a Python
+backend. Zero runtime dependencies: pure standard library.
+
+It speaks the same wire contract as the JS/TS SDK and the server, and its feature-flag
+bucketing is **byte-exact** across all three (proven by the shared `flag-golden.json`
+vectors), so a user lands in the same rollout everywhere.
+
+## Docs
+
+- [Quickstart](https://prodantix.com/en/docs/quickstart): install and send a first event
+- [Get an API key](https://prodantix.com/en/docs/keys): signup, project creation, where the key lives
+- [API reference](https://prodantix.com/en/docs/api): every REST operation, rendered
+
+## Install
+
+```
+pip install prodantix-sdk
+```
+
+Requires Python 3.9+.
+
+## Quickstart
+
+```python
+import os
+from prodantix import Client
+
+client = Client(
+    api_key=os.environ["PRODANTIX_API_KEY"],   # a public pdx_pub_ project key
+    host="https://eu.api.prodantix.com",
+)
+
+# Send events (distinct_id is explicit on every call, since a server serves many users).
+client.capture("user-123", "order.completed", properties={"total": 42, "currency": "USD"})
+client.identify("user-123", set_props={"plan": "pro"})
+client.group("user-123", "company", "acme", properties={"seats": 10})
+
+# Feature flags: remote (authoritative) …
+if client.is_feature_enabled("user-123", "new-checkout"):
+    ...
+
+# … or local (evaluated in-process from a cached snapshot, no per-call round-trip).
+if client.is_feature_enabled_local("user-123", "new-checkout", properties={"plan": "pro"}):
+    ...
+
+# In-app inbox
+for message in client.get_inbox("user-123"):
+    ...
+client.mark_message_read("user-123", "message-id")
+
+# Flush any buffered events and stop the background flusher.
+client.shutdown()
+```
+
+`Client` is also a context manager, which shuts down (and flushes) on exit:
+
+```python
+with Client(api_key=..., host=...) as client:
+    client.capture("user-123", "page.viewed")
+```
+
+## How events are delivered
+
+Events are buffered in a thread-safe queue and delivered in batches by a background
+flusher. A batch is sent when the queue reaches `flush_at` events (default 20) or every
+`flush_interval_s` seconds (default 10), whichever comes first. Delivery retries transient
+failures with exponential backoff and fails fast on a permanent 4xx. Always call
+`shutdown()` (or use the context manager) before your process exits so the final batch
+is flushed.
+
+## Configuration
+
+| Argument | Default | Purpose |
+| --- | --- | --- |
+| `api_key` | required | Public project key (`pdx_pub_…`). Required. |
+| `host` | required | Ingest base URL. Required. |
+| `flags_host` | `host` | Base URL for the flags + inbox endpoints. |
+| `flush_at` | `20` | Queue size that triggers an immediate flush. |
+| `flush_interval_s` | `10.0` | Background flush cadence (`<= 0` disables the timer). |
+| `max_queue_size` | `1000` | Cap; oldest events are dropped on overflow. |
+| `max_retries` | `3` | Delivery retry attempts. |
+| `request_timeout_s` | `10.0` | Per-request timeout. |
+| `default_properties` | `None` | A dict or a callable merged into every event. |
+| `os`, `locale` | `None` | Added to each event's `context`. |
+| `on_error` | no-op | Called with any background/capture error. |
+
+## Development
+
+```
+python -m unittest discover -s tests
+```

prodantix_sdk-0.0.1/README.md

@@ -0,0 +1,94 @@
+# Prodantix Python SDK
+
+The server-side SDK for [Prodantix](https://prodantix.com): send analytics events,
+evaluate feature flags (remote or locally), and read the in-app inbox from a Python
+backend. Zero runtime dependencies: pure standard library.
+
+It speaks the same wire contract as the JS/TS SDK and the server, and its feature-flag
+bucketing is **byte-exact** across all three (proven by the shared `flag-golden.json`
+vectors), so a user lands in the same rollout everywhere.
+
+## Docs
+
+- [Quickstart](https://prodantix.com/en/docs/quickstart): install and send a first event
+- [Get an API key](https://prodantix.com/en/docs/keys): signup, project creation, where the key lives
+- [API reference](https://prodantix.com/en/docs/api): every REST operation, rendered
+
+## Install
+
+```
+pip install prodantix-sdk
+```
+
+Requires Python 3.9+.
+
+## Quickstart
+
+```python
+import os
+from prodantix import Client
+
+client = Client(
+    api_key=os.environ["PRODANTIX_API_KEY"],   # a public pdx_pub_ project key
+    host="https://eu.api.prodantix.com",
+)
+
+# Send events (distinct_id is explicit on every call, since a server serves many users).
+client.capture("user-123", "order.completed", properties={"total": 42, "currency": "USD"})
+client.identify("user-123", set_props={"plan": "pro"})
+client.group("user-123", "company", "acme", properties={"seats": 10})
+
+# Feature flags: remote (authoritative) …
+if client.is_feature_enabled("user-123", "new-checkout"):
+    ...
+
+# … or local (evaluated in-process from a cached snapshot, no per-call round-trip).
+if client.is_feature_enabled_local("user-123", "new-checkout", properties={"plan": "pro"}):
+    ...
+
+# In-app inbox
+for message in client.get_inbox("user-123"):
+    ...
+client.mark_message_read("user-123", "message-id")
+
+# Flush any buffered events and stop the background flusher.
+client.shutdown()
+```
+
+`Client` is also a context manager, which shuts down (and flushes) on exit:
+
+```python
+with Client(api_key=..., host=...) as client:
+    client.capture("user-123", "page.viewed")
+```
+
+## How events are delivered
+
+Events are buffered in a thread-safe queue and delivered in batches by a background
+flusher. A batch is sent when the queue reaches `flush_at` events (default 20) or every
+`flush_interval_s` seconds (default 10), whichever comes first. Delivery retries transient
+failures with exponential backoff and fails fast on a permanent 4xx. Always call
+`shutdown()` (or use the context manager) before your process exits so the final batch
+is flushed.
+
+## Configuration
+
+| Argument | Default | Purpose |
+| --- | --- | --- |
+| `api_key` | required | Public project key (`pdx_pub_…`). Required. |
+| `host` | required | Ingest base URL. Required. |
+| `flags_host` | `host` | Base URL for the flags + inbox endpoints. |
+| `flush_at` | `20` | Queue size that triggers an immediate flush. |
+| `flush_interval_s` | `10.0` | Background flush cadence (`<= 0` disables the timer). |
+| `max_queue_size` | `1000` | Cap; oldest events are dropped on overflow. |
+| `max_retries` | `3` | Delivery retry attempts. |
+| `request_timeout_s` | `10.0` | Per-request timeout. |
+| `default_properties` | `None` | A dict or a callable merged into every event. |
+| `os`, `locale` | `None` | Added to each event's `context`. |
+| `on_error` | no-op | Called with any background/capture error. |
+
+## Development
+
+```
+python -m unittest discover -s tests
+```

prodantix_sdk-0.0.1/prodantix/__init__.py

@@ -0,0 +1,46 @@
+"""Prodantix server SDK.
+
+    import os
+    from prodantix import Client
+
+    client = Client(api_key=os.environ["PRODANTIX_API_KEY"], host="https://eu.api.prodantix.com")
+    client.capture("user-123", "order.completed", properties={"total": 42})
+    if client.is_feature_enabled("user-123", "new-checkout"):
+        ...
+    client.shutdown()
+"""
+
+from prodantix.client import Client, PersonTraits
+from prodantix.errors import (
+    ConfigError,
+    ProdantixError,
+    QueueOverflowError,
+    TransportError,
+    ValidationError,
+)
+from prodantix.flag_eval import FlagDecision, assign_variant, bucket, evaluate_all, evaluate_flag, get_variant
+from prodantix.predicate import FlagEvalContext, matches
+from prodantix.transport import Transport, UrllibTransport
+from prodantix.version import SDK_NAME, SDK_VERSION
+
+__all__ = [
+    "Client",
+    "PersonTraits",
+    "ProdantixError",
+    "ConfigError",
+    "ValidationError",
+    "TransportError",
+    "QueueOverflowError",
+    "FlagDecision",
+    "FlagEvalContext",
+    "bucket",
+    "evaluate_flag",
+    "evaluate_all",
+    "assign_variant",
+    "get_variant",
+    "matches",
+    "Transport",
+    "UrllibTransport",
+    "SDK_NAME",
+    "SDK_VERSION",
+]

prodantix_sdk-0.0.1/prodantix/_http.py

@@ -0,0 +1,37 @@
+"""Minimal request helper for the single-shot read endpoints (flags, inbox). Unlike
+the event transport these do not retry (matching the JS SDK). The ``opener`` seam
+lets a test substitute the network."""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+from typing import Any, Callable, Dict, Optional, Tuple
+
+
+def trim_trailing_slash(value: str) -> str:
+    return value[:-1] if value.endswith("/") else value
+
+
+def request(
+    method: str,
+    url: str,
+    project_key: str,
+    timeout_s: float,
+    *,
+    body: Optional[Dict[str, Any]] = None,
+    opener: Callable[..., Any] = urllib.request.urlopen,
+) -> Tuple[int, str]:
+    headers = {"authorization": f"Bearer {project_key}"}
+    data = None
+    if body is not None:
+        data = json.dumps(body).encode("utf-8")
+        headers["content-type"] = "application/json"
+    req = urllib.request.Request(url, data=data, method=method, headers=headers)
+    try:
+        with opener(req, timeout=timeout_s) as response:
+            status = getattr(response, "status", None) or response.getcode()
+            return status, response.read().decode("utf-8")
+    except urllib.error.HTTPError as error:
+        return error.code, error.read().decode("utf-8", "replace")