palqee-prisma-client 0.4.0__tar.gz

palqee_prisma_client-0.4.0/.coveragerc

@@ -0,0 +1,19 @@
+[run]
+source = src
+branch = true
+
+[report]
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    raise NotImplementedError
+    if __name__ == .__main__.:
+    ^\s*pass\s*$
+    raise ImportError
+    @abstractmethod
+
+[html]
+directory = coverage_html
+
+[xml]
+output = coverage.xml

palqee_prisma_client-0.4.0/.gitignore

@@ -0,0 +1,69 @@
+# IDE - only ignore temporary/local files
+.cursor/logs/
+.cursor/cache/
+.cursor/.local/
+.vscode/.history/
+.idea
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Package manager lock files
+packages/*/uv.lock
+
+# Virtual Environment
+.env
+.venv
+env/
+venv/
+ENV/
+
+# Coverage
+.coverage
+coverage.xml
+htmlcov/
+
+# Worktrees
+.worktrees/
+
+# Patch files
+*.patch
+
+# Misc
+.DS_Store
+
+# Testing
+.pytest_cache/
+.mypy_cache/
+
+# Distribution
+*.tar.gz
+*.zip
+*.rar
+*.7z
+
+# Logs
+*.log
+logs/
+
+.secrets
+src/prisma_ai/tests/e2e/

palqee_prisma_client-0.4.0/CHANGELOG.md

@@ -0,0 +1,91 @@
+# Changelog
+
+## [0.4.0](https://github.com/Palqee/prisma-ai/compare/palqee-prisma-client-v0.3.1...palqee-prisma-client-v0.4.0) (2026-05-25)
+
+
+### ⚠ BREAKING CHANGES
+
+* PyPI distribution names changed. Users must pip install palqee-prisma-client (was pq-prisma-client) and pip install palqee-prisma-otel (was pq-prisma-otel). Imports also change: from palqee_prisma_client import ... (was pq_prisma_client) and import palqee_prisma_otel (was prisma_otel).
+
+### Features
+
+* rename subpackages to palqee-prisma-* namespace ([d7f9e07](https://github.com/Palqee/prisma-ai/commit/d7f9e072702fc671af68999fb08d5cbed77a3470))
+
+## [0.3.1](https://github.com/Palqee/prisma-ai/compare/pq-prisma-client-v0.3.0...pq-prisma-client-v0.3.1) (2026-05-25)
+
+
+### Features
+
+* **sdk:** PM-1948 fixed renaming ([b3bbb8f](https://github.com/Palqee/prisma-ai/commit/b3bbb8f5c9b363d36fbae8cef0856835d8fb32ab))
+* **sdk:** PM-1948 renamed env variables ([770154f](https://github.com/Palqee/prisma-ai/commit/770154f4d9e2ebd9ac0db91944cd24c697f53f21))
+* **sdk:** PM-1948 renamed variables ([ffb966e](https://github.com/Palqee/prisma-ai/commit/ffb966e8279609cfd36a8a97f2bd7062e0f42e5a))
+
+## [0.3.0](https://github.com/Palqee/prisma-ai/compare/pq-prisma-client-v0.2.3...pq-prisma-client-v0.3.0) (2026-05-22)
+
+
+### ⚠ BREAKING CHANGES
+
+* PyPI distribution names changed. Users must run `pip install pq-prisma-ai` (was `prisma-ai`) and `pip install pq-prisma-otel` (was `prisma-otel`). Imports unchanged.
+
+### Features
+
+* rename PyPI packages to pq-* namespace ([cf9e653](https://github.com/Palqee/prisma-ai/commit/cf9e653371f2d261dc34e984e06b9a9237327c76))
+
+## [0.2.3](https://github.com/Palqee/prisma-ai/compare/pq-prisma-client-v0.2.2...pq-prisma-client-v0.2.3) (2026-05-07)
+
+
+### Features
+
+* **sdk:** PM-1149 aligned ai with backend ([55af7c7](https://github.com/Palqee/prisma-ai/commit/55af7c7085d77468ddffa37cdeb5e13b157ff9d8))
+* **sdk:** PM-1149 finalized new methods ([57332db](https://github.com/Palqee/prisma-ai/commit/57332db0e602e107efc8325e7fef09f98cdd66a8))
+* **sdk:** PM-1149 fixed ci-cd issues ([3ea8937](https://github.com/Palqee/prisma-ai/commit/3ea89379a93a375946c731c27913a90abc0874dd))
+* **sdk:** PM-1149 fixed mypy ([2ea4c64](https://github.com/Palqee/prisma-ai/commit/2ea4c64e99b270a1486bf474a72a6680530558c1))
+* **sdk:** PM-1149 fixed pr feedback ([cf4e6c8](https://github.com/Palqee/prisma-ai/commit/cf4e6c8d5f985270afd6ea38b610a74e182b151e))
+* **sdk:** PM-1149 fixed ruff ([24f096c](https://github.com/Palqee/prisma-ai/commit/24f096c937e3a9a1ba87480e665a7a5e11c7731b))
+* **sdk:** PM-1149 fixed ruff and tests ([1609bea](https://github.com/Palqee/prisma-ai/commit/1609beaad5e2c0671878aaffeaf5747030306d1b))
+* **sdk:** PM-1149 new sdk methods ([774c93d](https://github.com/Palqee/prisma-ai/commit/774c93d8162deb0da43085e4228a45ec16819b86))
+* **sdk:** PM-1149 new sdk methods ([5e3c2d9](https://github.com/Palqee/prisma-ai/commit/5e3c2d97f2c65cd97eaf4ace3bbb216703d7df75))
+* **sdk:** PM-1149 PR review resolved ([78e23ba](https://github.com/Palqee/prisma-ai/commit/78e23bafc392c732954401bcbb9ea25155948202))
+* **sdk:** PM-1343 Remove workspace_id from client (resolved server-side from API key) ([2296084](https://github.com/Palqee/prisma-ai/commit/2296084b780e14d4fa06ae5b7cda1968821cbdd1))
+* **sdk:** PM-1343 Remove workspace_id from client (resolved server-side from API key) ([1eea0a0](https://github.com/Palqee/prisma-ai/commit/1eea0a09279d8430cc4c688903f7f106424d8beb))
+
+
+### Bug Fixes
+
+* **sdk:** PM-1149 fix mypy type errors in sdk_live_check ([c4113aa](https://github.com/Palqee/prisma-ai/commit/c4113aa9e6a801b01339eb68b59256db9187ecff))
+
+## [0.2.2](https://github.com/Palqee/prisma-ai/compare/pq-prisma-client-v0.2.1...pq-prisma-client-v0.2.2) (2026-03-23)
+
+
+### Bug Fixes
+
+* **prisma-client:** PM-831 split client/server exception hierarchy ([af9c20c](https://github.com/Palqee/prisma-ai/commit/af9c20cd65544b526f46b81a155f4d02461e4a73))
+
+## [0.2.1](https://github.com/Palqee/prisma-ai/compare/pq-prisma-client-v0.2.0...pq-prisma-client-v0.2.1) (2026-03-19)
+
+
+### Features
+
+* **pq-prisma-client:** add evaluation config classes ([e61c5c1](https://github.com/Palqee/prisma-ai/commit/e61c5c13adf3b47739696f32e26b819f6ef6ef12))
+
+
+### Bug Fixes
+
+* **pq-prisma-client:** import Self from typing_extensions for 3.10 ([9bcf968](https://github.com/Palqee/prisma-ai/commit/9bcf968aaa4dcec5abe293c567051924de1684a0))
+* **pq-prisma-client:** PM-830 fix regex and validation bugs ([3a0e599](https://github.com/Palqee/prisma-ai/commit/3a0e599a0d3f810bb1d1ea354b27ced87a906ab4))
+* **pq-prisma-client:** PM-833 json-mode dump and tags test ([d16751d](https://github.com/Palqee/prisma-ai/commit/d16751dca43c9dcf235108b2642b1b6353afaa7d))
+* **pq-prisma-client:** predefined option validation parity ([d972a91](https://github.com/Palqee/prisma-ai/commit/d972a91936fd82c3a7cedddaadbfb0ca3eb6f6cf))
+* **pq-prisma-client:** version test validates format not value ([b8c39c7](https://github.com/Palqee/prisma-ai/commit/b8c39c7167651b2d6b16baec8050122432726255))
+
+## [0.2.0](https://github.com/Palqee/prisma-ai/compare/pq-prisma-client-v0.1.0...pq-prisma-client-v0.2.0) (2026-03-06)
+
+
+### Features
+
+* **pq-prisma-client:** PM-618 scaffold pq-prisma-client package ([cbb928b](https://github.com/Palqee/prisma-ai/commit/cbb928b41c715af6d1d343dde31795a994608e9a))
+* **pq-prisma-client:** PM-618 scaffold pq-prisma-client package ([5632ed2](https://github.com/Palqee/prisma-ai/commit/5632ed2bd027896aaa07d0719d1c96b7fae7a394))
+
+
+### Bug Fixes
+
+* **sdk:** PM-618 remove dead pytest config, anchor pass regex ([8d6ebe6](https://github.com/Palqee/prisma-ai/commit/8d6ebe6e06cdcde2e5334d201532b80ff7a25280))

palqee_prisma_client-0.4.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: palqee-prisma-client
+Version: 0.4.0
+Summary: Prisma AI platform client for evaluations, datasets, and jobs
+Author-email: Hartley Jean-Aime <hartley@palqee.com>
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# palqee-prisma-client
+
+Python client for the Prisma AI platform. Provides async access to projects, runs, analytics, and evaluations through a typed API.
+
+## Prerequisites
+
+- Python 3.10 or later
+- A Prisma AI API key
+
+## Installation
+
+```bash
+pip install palqee-prisma-client
+```
+
+## Quick start
+
+```python
+from palqee_prisma_client import PrismaClient
+
+async with PrismaClient(
+    api_key="pq_prisma_sk_...",
+    workspace_id="<workspace-uuid>",
+    base_url="https://your-prisma-host",
+) as client:
+    # Create a project and a run
+    project = await client.projects.get_or_create("my-app")
+    run = await client.runs.create(project.id)
+```
+
+## Projects
+
+```python
+# List all projects in the workspace
+page = await client.projects.list()
+for project in page.items:
+    print(project.id, project.name)
+
+# Get a single project
+project = await client.projects.get(project_id)
+
+# Update a project
+project = await client.projects.update(project_id, name="new-name", description="...")
+
+# Get aggregate stats
+stats = await client.projects.stats(project_id)
+print(stats.total_runs, stats.total_traces)
+
+# Delete a project
+await client.projects.delete(project_id)
+```
+
+## Runs
+
+```python
+# List runs in a project (with optional filters)
+page = await client.runs.list(project_id, status="completed", limit=50)
+for run in page.items:
+    print(run.id, run.status)
+
+# Get a single run
+run = await client.runs.get(run_id)
+
+# Update a run
+run = await client.runs.update(run_id, status="completed")
+
+# Get stats and evaluation metrics
+stats = await client.runs.stats(run_id)
+metrics = await client.runs.metrics(run_id)
+print(metrics.metrics)  # {"correctness": 0.88, ...}
+
+# Delete a run
+await client.runs.delete(run_id)
+```
+
+## Analytics
+
+```python
+# Structured query
+result = await client.analytics.query(
+    dimensions=["model_name"],
+    measures=["trace_count", "avg_latency_ms"],
+    filters=[{"field": "project_id", "op": "eq", "value": project_id}],
+)
+for row in result.rows:
+    print(row.dimensions, row.measures)
+
+# Project overview
+overview = await client.analytics.overview(project_id, period="7d")
+print(overview.total_traces, overview.total_cost_usd)
+
+# Cost breakdown
+costs = await client.analytics.costs(project_id, period="30d")
+for item in costs.breakdown:
+    print(item.label, item.cost_usd)
+
+# Export data
+export = await client.analytics.export("csv", project_id=project_id)
+print(export.download_url)
+```
+
+## Evaluations
+
+```python
+# Trigger evaluations on a run
+result = await client.evaluations.run(run_id, evaluators=["correctness", "hallucination"])
+print(result.status, result.total_evaluated)
+
+# Get evaluation summary for a project
+summary = await client.evaluations.summary(project_id, period="7d")
+print(summary.avg_score, summary.scores_by_evaluator)
+
+# List evaluators configured for a project
+evaluators = await client.evaluations.evaluators(project_id)
+for ev in evaluators:
+    print(ev.type, ev.name)
+```
+
+## Pagination
+
+List methods return a `Page[T]` object:
+
+```python
+page = await client.projects.list(limit=20, offset=0)
+print(page.total, page.has_more)
+projects = page.items  # list[Project]
+```
+
+## Configuration
+
+| Parameter | Environment variable | Description |
+|-----------|---------------------|-------------|
+| `api_key` | `PALQEE_PRISMA_API_KEY` | API key (`pq_prisma_sk_...`) |
+| `workspace_id` | `PALQEE_PRISMA_WORKSPACE_ID` | Workspace UUID |
+| `base_url` | `PALQEE_PRISMA_BASE_URL` | API gateway base URL |
+| `timeout` | — | Request timeout in seconds (default 30) |
+| `max_retries` | — | Max retries for transient errors (default 2) |
+
+## Error handling
+
+All exceptions inherit from `PrismaError`:
+
+```python
+from palqee_prisma_client import PrismaNotFoundError, PrismaAPIError, PrismaError
+
+try:
+    project = await client.projects.get(project_id)
+except PrismaNotFoundError:
+    print("Project not found")
+except PrismaAPIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+except PrismaError:
+    print("SDK error")
+```
+
+| Exception | HTTP status | Description |
+|-----------|-------------|-------------|
+| `PrismaAuthenticationError` | — | Invalid or missing API key (client-side) |
+| `PrismaAuthorizationError` | 401, 403 | Server rejected the credentials |
+| `PrismaNotFoundError` | 404 | Resource does not exist |
+| `PrismaConflictError` | 409 | Conflict with existing state |
+| `PrismaUnprocessableEntityError` | 422 | Server-side validation failure |
+| `PrismaAPIError` | other | Any other HTTP error |
+| `PrismaTimeoutError` | — | Request timed out |
+| `PrismaNetworkError` | — | Connection or transport failure |
+| `PrismaValidationError` | — | Client-side input validation failure |
+
+## Version
+
+```python
+from palqee_prisma_client import __version__
+```
+
+## License
+
+MIT

palqee_prisma_client-0.4.0/README.md

@@ -0,0 +1,176 @@
+# palqee-prisma-client
+
+Python client for the Prisma AI platform. Provides async access to projects, runs, analytics, and evaluations through a typed API.
+
+## Prerequisites
+
+- Python 3.10 or later
+- A Prisma AI API key
+
+## Installation
+
+```bash
+pip install palqee-prisma-client
+```
+
+## Quick start
+
+```python
+from palqee_prisma_client import PrismaClient
+
+async with PrismaClient(
+    api_key="pq_prisma_sk_...",
+    workspace_id="<workspace-uuid>",
+    base_url="https://your-prisma-host",
+) as client:
+    # Create a project and a run
+    project = await client.projects.get_or_create("my-app")
+    run = await client.runs.create(project.id)
+```
+
+## Projects
+
+```python
+# List all projects in the workspace
+page = await client.projects.list()
+for project in page.items:
+    print(project.id, project.name)
+
+# Get a single project
+project = await client.projects.get(project_id)
+
+# Update a project
+project = await client.projects.update(project_id, name="new-name", description="...")
+
+# Get aggregate stats
+stats = await client.projects.stats(project_id)
+print(stats.total_runs, stats.total_traces)
+
+# Delete a project
+await client.projects.delete(project_id)
+```
+
+## Runs
+
+```python
+# List runs in a project (with optional filters)
+page = await client.runs.list(project_id, status="completed", limit=50)
+for run in page.items:
+    print(run.id, run.status)
+
+# Get a single run
+run = await client.runs.get(run_id)
+
+# Update a run
+run = await client.runs.update(run_id, status="completed")
+
+# Get stats and evaluation metrics
+stats = await client.runs.stats(run_id)
+metrics = await client.runs.metrics(run_id)
+print(metrics.metrics)  # {"correctness": 0.88, ...}
+
+# Delete a run
+await client.runs.delete(run_id)
+```
+
+## Analytics
+
+```python
+# Structured query
+result = await client.analytics.query(
+    dimensions=["model_name"],
+    measures=["trace_count", "avg_latency_ms"],
+    filters=[{"field": "project_id", "op": "eq", "value": project_id}],
+)
+for row in result.rows:
+    print(row.dimensions, row.measures)
+
+# Project overview
+overview = await client.analytics.overview(project_id, period="7d")
+print(overview.total_traces, overview.total_cost_usd)
+
+# Cost breakdown
+costs = await client.analytics.costs(project_id, period="30d")
+for item in costs.breakdown:
+    print(item.label, item.cost_usd)
+
+# Export data
+export = await client.analytics.export("csv", project_id=project_id)
+print(export.download_url)
+```
+
+## Evaluations
+
+```python
+# Trigger evaluations on a run
+result = await client.evaluations.run(run_id, evaluators=["correctness", "hallucination"])
+print(result.status, result.total_evaluated)
+
+# Get evaluation summary for a project
+summary = await client.evaluations.summary(project_id, period="7d")
+print(summary.avg_score, summary.scores_by_evaluator)
+
+# List evaluators configured for a project
+evaluators = await client.evaluations.evaluators(project_id)
+for ev in evaluators:
+    print(ev.type, ev.name)
+```
+
+## Pagination
+
+List methods return a `Page[T]` object:
+
+```python
+page = await client.projects.list(limit=20, offset=0)
+print(page.total, page.has_more)
+projects = page.items  # list[Project]
+```
+
+## Configuration
+
+| Parameter | Environment variable | Description |
+|-----------|---------------------|-------------|
+| `api_key` | `PALQEE_PRISMA_API_KEY` | API key (`pq_prisma_sk_...`) |
+| `workspace_id` | `PALQEE_PRISMA_WORKSPACE_ID` | Workspace UUID |
+| `base_url` | `PALQEE_PRISMA_BASE_URL` | API gateway base URL |
+| `timeout` | — | Request timeout in seconds (default 30) |
+| `max_retries` | — | Max retries for transient errors (default 2) |
+
+## Error handling
+
+All exceptions inherit from `PrismaError`:
+
+```python
+from palqee_prisma_client import PrismaNotFoundError, PrismaAPIError, PrismaError
+
+try:
+    project = await client.projects.get(project_id)
+except PrismaNotFoundError:
+    print("Project not found")
+except PrismaAPIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+except PrismaError:
+    print("SDK error")
+```
+
+| Exception | HTTP status | Description |
+|-----------|-------------|-------------|
+| `PrismaAuthenticationError` | — | Invalid or missing API key (client-side) |
+| `PrismaAuthorizationError` | 401, 403 | Server rejected the credentials |
+| `PrismaNotFoundError` | 404 | Resource does not exist |
+| `PrismaConflictError` | 409 | Conflict with existing state |
+| `PrismaUnprocessableEntityError` | 422 | Server-side validation failure |
+| `PrismaAPIError` | other | Any other HTTP error |
+| `PrismaTimeoutError` | — | Request timed out |
+| `PrismaNetworkError` | — | Connection or transport failure |
+| `PrismaValidationError` | — | Client-side input validation failure |
+
+## Version
+
+```python
+from palqee_prisma_client import __version__
+```
+
+## License
+
+MIT

palqee_prisma_client-0.4.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[project]
+authors = [
+  {name = "Hartley Jean-Aime", email = "hartley@palqee.com"},
+]
+dependencies = [
+  "httpx>=0.27",
+  "pydantic>=2.0",
+]
+description = "Prisma AI platform client for evaluations, datasets, and jobs"
+license = "MIT"
+name = "palqee-prisma-client"
+readme = "README.md"
+requires-python = ">=3.10"
+dynamic = ["version"]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+  "pytest-asyncio>=0.23",
+  "pytest-cov>=5.0",
+  "respx>=0.21",
+  "ruff>=0.4",
+  "mypy>=1.0.0",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.hatch.version]
+path = "src/palqee_prisma_client/version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/palqee_prisma_client"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "B", "W", "C4", "UP", "RUF"]

palqee_prisma_client-0.4.0/pytest.ini

@@ -0,0 +1,35 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+
+# Test discovery
+norecursedirs = .* build dist CVS _darcs {arch} *.egg venv env
+
+# Test execution
+addopts =
+    --verbose
+    --tb=short
+    --strict-markers
+    --cov=palqee_prisma_client
+    --cov-report=term-missing
+    --cov-report=html
+    --cov-report=xml
+    --cov-config=.coveragerc
+    --cov-fail-under=60
+    --no-cov-on-fail
+
+# Markers
+markers =
+    unit: Unit tests
+    integration: Integration tests
+
+# Async
+asyncio_mode = auto
+
+# Logging
+log_cli = true
+log_cli_level = INFO
+log_cli_format = %(asctime)s [%(levelname)s] %(message)s (%(filename)s:%(lineno)s)
+log_cli_date_format = %Y-%m-%d %H:%M:%S