persql 0.1.0__py3-none-any.whl

persql/__init__.py

@@ -0,0 +1,195 @@
+"""PerSQL — SQLite databases on the edge for AI agents.
+
+Quick start::
+
+    import os
+    from persql import PerSQL
+
+    persql = PerSQL(token=os.environ["PERSQL_TOKEN"])
+    db = persql.database("acme/orders")
+    result = db.query("SELECT id, email FROM customers WHERE id = ?", [42])
+    for row in result["data"]:
+        print(row["email"])
+
+Async variant::
+
+    import asyncio
+    from persql import AsyncPerSQL
+
+    async def main():
+        async with AsyncPerSQL(token="...") as persql:
+            db = persql.database("acme/orders")
+            result = await db.query("SELECT 1 AS one")
+            print(result["data"])
+
+    asyncio.run(main())
+
+Local mode (tests, no network)::
+
+    persql = PerSQL(local=":memory:")
+    db = persql.database("test/db")
+    db.query("CREATE TABLE t (id INTEGER)")
+    db.query("INSERT INTO t (id) VALUES (?)", [1])
+    print(db.query("SELECT * FROM t")["data"])  # [{"id": 1}]
+
+Agent tools — one Anthropic + OpenAI + LangChain bundle covering the
+whole database::
+
+    tools = db.as_tools()
+    # tools["anthropic"]  — pass to anthropic.messages.create
+    # tools["openai"]     — pass to openai.chat.completions.create
+    # tools["langchain"]  — convert with DynamicStructuredTool
+    # tools["run"]        — dispatcher to execute model-emitted calls
+
+Errors::
+
+    from persql import ApprovalRequiredError, PerSQLError, RateLimitError
+
+    try:
+        db.query("UPDATE orders SET status='shipped'")
+    except ApprovalRequiredError as e:
+        print(f"Approval needed: {e.approval_url}")
+    except RateLimitError as e:
+        time.sleep(e.retry_after_seconds)
+    except PerSQLError as e:
+        # `.detail["kind"]` is set on /v1/query and /v1/batch SQL errors
+        print(e.status, e.args[0], getattr(e, "detail", None))
+"""
+
+from __future__ import annotations
+
+from ._async_database import (
+    AsyncPerSQLApprovals,
+    AsyncPerSQLBlob,
+    AsyncPerSQLBranches,
+    AsyncPerSQLDatabase,
+    AsyncPerSQLProposals,
+    AsyncPerSQLVectors,
+)
+from ._client import AsyncPerSQL, PerSQL
+from ._database import (
+    PerSQLApprovals,
+    PerSQLBlob,
+    PerSQLBranches,
+    PerSQLDatabase,
+    PerSQLProposals,
+    PerSQLVectors,
+)
+from ._errors import (
+    ApprovalRequiredError,
+    ApprovalRuleHit,
+    PerSQLError,
+    RateLimitError,
+    SqlErrorDetail,
+    SqlErrorKind,
+)
+from ._tools import DatabaseToolBundle
+from ._types import (
+    AnthropicTool,
+    BlobListItem,
+    BlobListResponse,
+    BlobPutResult,
+    BranchInfo,
+    BranchListPage,
+    BranchMergeMode,
+    BranchMergePlanStep,
+    BranchMergeResult,
+    BranchMergeSummary,
+    BranchMigration,
+    ClaimedBranch,
+    ColumnDescription,
+    DatabaseSchema,
+    DescribeBundle,
+    ForeignKeyDescription,
+    ForkedFrom,
+    HandoffClaim,
+    LangChainTool,
+    OpenAiTool,
+    OpenAiToolFunction,
+    PinnedHandoff,
+    ProposalPlan,
+    QueryLogEntry,
+    QueryLogPage,
+    QueryResult,
+    Role,
+    SchemaColumn,
+    SchemaDoctorFinding,
+    SchemaDoctorReport,
+    SchemaSearchHit,
+    SchemaSearchResponse,
+    SchemaTable,
+    Statement,
+    SubscribeChange,
+    SubscribeChangeKind,
+    TableDescription,
+    TableInfo,
+    VectorMatch,
+    VectorUpsertItem,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AnthropicTool",
+    "ApprovalRequiredError",
+    "ApprovalRuleHit",
+    "AsyncPerSQL",
+    "AsyncPerSQLApprovals",
+    "AsyncPerSQLBlob",
+    "AsyncPerSQLBranches",
+    "AsyncPerSQLDatabase",
+    "AsyncPerSQLProposals",
+    "AsyncPerSQLVectors",
+    "BlobListItem",
+    "BlobListResponse",
+    "BlobPutResult",
+    "BranchInfo",
+    "BranchListPage",
+    "BranchMergeMode",
+    "BranchMergePlanStep",
+    "BranchMergeResult",
+    "BranchMergeSummary",
+    "BranchMigration",
+    "ClaimedBranch",
+    "ColumnDescription",
+    "DatabaseSchema",
+    "DatabaseToolBundle",
+    "DescribeBundle",
+    "ForeignKeyDescription",
+    "ForkedFrom",
+    "HandoffClaim",
+    "LangChainTool",
+    "OpenAiTool",
+    "OpenAiToolFunction",
+    "PerSQL",
+    "PerSQLApprovals",
+    "PerSQLBlob",
+    "PerSQLBranches",
+    "PerSQLDatabase",
+    "PerSQLError",
+    "PerSQLProposals",
+    "PerSQLVectors",
+    "PinnedHandoff",
+    "ProposalPlan",
+    "QueryLogEntry",
+    "QueryLogPage",
+    "QueryResult",
+    "RateLimitError",
+    "Role",
+    "SchemaColumn",
+    "SchemaDoctorFinding",
+    "SchemaDoctorReport",
+    "SchemaSearchHit",
+    "SchemaSearchResponse",
+    "SchemaTable",
+    "SqlErrorDetail",
+    "SqlErrorKind",
+    "Statement",
+    "SubscribeChange",
+    "SubscribeChangeKind",
+    "TableDescription",
+    "TableInfo",
+    "VectorMatch",
+    "VectorUpsertItem",
+    "__version__",
+]