paid-python 0.6.0__tar.gz → 1.0.0__tar.gz

{paid_python-0.6.0 → paid_python-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: paid-python
-Version: 0.6.0
+Version: 1.0.0
 Summary: 
 Requires-Python: >=3.9,<3.14
 Classifier: Intended Audience :: Developers
@@ -15,20 +15,23 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.8
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Dist: httpx (>=0.21.0)
+Requires-Dist: httpx (>=0.21.2)
 Requires-Dist: mutagen (>=1.47.0)
 Requires-Dist: openinference-instrumentation-bedrock (>=0.1.0)
 Requires-Dist: openinference-instrumentation-google-genai (>=0.1.8)
+Requires-Dist: openinference-instrumentation-instructor (>=0.1.0)
 Requires-Dist: openinference-instrumentation-langchain (>=0.1.55)
+Requires-Dist: openinference-instrumentation-openai (>=0.1.40)
 Requires-Dist: openinference-instrumentation-openai-agents (>=1.0.0)
 Requires-Dist: opentelemetry-api (>=1.23.0)
 Requires-Dist: opentelemetry-exporter-otlp-proto-http (>=1.23.0)
 Requires-Dist: opentelemetry-instrumentation-anthropic (>=0.47.0)
 Requires-Dist: opentelemetry-sdk (>=1.23.0)
-Requires-Dist: pydantic (>=1.9.0)
-Requires-Dist: pydantic-core (>=2.18.0)
+Requires-Dist: pydantic (>=1.9.2)
+Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
 Requires-Dist: python-dotenv (>=0.15.0)
 Requires-Dist: typing_extensions (>=4.0.0)
 Description-Content-Type: text/markdown
@@ -76,7 +79,7 @@ from paid import Paid
 
 client = Paid(token="API_KEY")
 
-client.customers.create(
+client.customers.create_customer(
     name="name"
 )
 ```
@@ -87,7 +90,7 @@ The SDK provides Python classes for all request and response types. These are au
 
 ```python
 # Example of creating a customer
-response = client.customers.create(
+response = client.customers.create_customer(
     name="John Doe",
 )
 
@@ -101,13 +104,21 @@ print(response.email)
 When the API returns a non-success status code (4xx or 5xx response), the SDK will raise an appropriate error.
 
 ```python
+from paid import BadRequestError, NotFoundError
+from paid.core.api_error import ApiError
+
 try:
-    client.customers.create(...)
-except paid.Error as e:
+    client.customers.create_customer(name="John Doe")
+except BadRequestError as e:
+    print(e.status_code)  # 400
+    print(e.body)         # ErrorResponse with error details
+except NotFoundError as e:
+    print(e.status_code)  # 404
+    print(e.body)
+except ApiError as e:
+    # Catch-all for other API errors
     print(e.status_code)
-    print(e.message)
     print(e.body)
-    print(e.raw_response)
 ```
 
 ## Logging
@@ -152,6 +163,7 @@ export PAID_ENABLED=false
 ```
 
 This is useful for:
+
 - Development/testing environments where tracing isn't needed
 - Temporarily disabling tracing without modifying code
 - Feature flagging in different deployment environments
@@ -213,11 +225,13 @@ Both approaches:
 - Support the same parameters: `external_customer_id`, `external_product_id`, `tracing_token`, `store_prompt`, `metadata`
 
 * Note - if it happens that you're calling `paid_tracing` from non-main thread, then it's advised to initialize from main thread:
+
 ```python
 from paid.tracing import initialize_tracing
 initialize_tracing()
 ```
-* `initialize_tracing` also accepts optional arguments like OTEL collector endpoint and api key if you want to reroute your tracing somewhere else :)
+
+- `initialize_tracing` also accepts optional arguments like OTEL collector endpoint and api key if you want to reroute your tracing somewhere else :)
 
 ### Using the Paid wrappers
 
@@ -229,7 +243,6 @@ openai
 openai-agents (as a hook)
 anthropic
 langchain (as a hook)
-llamaindex
 bedrock (boto3)
 mistral
 gemini (google-genai)
@@ -300,6 +313,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
 
     process_event(incoming_event)
     ```
+
   </Tab>
 
   <Tab title="Python - Context Manager">
@@ -334,6 +348,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
     ):
         process_event(incoming_event)
     ```
+
   </Tab>
 
   <Tab title="Node.js">
@@ -375,7 +390,7 @@ from openai import OpenAI
 client = Paid(token="PAID_API_KEY")
 initialize_tracing()
 
-paid_autoinstrument()  # instruments all available: anthropic, gemini, openai, openai-agents, bedrock, langchain
+paid_autoinstrument()  # instruments all available: anthropic, gemini, openai, openai-agents, bedrock, langchain, instructor
 
 # Now all OpenAI calls will be automatically traced
 openai_client = OpenAI(api_key="<OPENAI_API_KEY>")
@@ -402,6 +417,7 @@ openai             - OpenAI Python SDK
 openai-agents      - OpenAI Agents SDK
 bedrock            - AWS Bedrock (boto3)
 langchain          - LangChain framework
+instructor         - Instructor
 ```
 
 #### Selective Instrumentation
@@ -585,17 +601,17 @@ If you would prefer to not use Paid to track your costs automatically but you wa
 then you can use manual cost tracking mechanism. Just attach the cost information in the following format to a signal payload:
 
 ```python
-from paid import Paid, Signal
+from paid import Paid, Signal, CustomerByExternalId, ProductByExternalId
 
 client = Paid(token="<PAID_API_KEY>")
 
 signal = Signal(
     event_name="<your_signal_name>",
-    agent_id="<your_agent_id>",
-    external_customer_id="<your_external_customer_id>",
-    data = {
+    customer=CustomerByExternalId(external_customer_id="<your_external_customer_id>"),
+    attribution=ProductByExternalId(external_product_id="<your_external_product_id>"),
+    data={
         "costData": {
-            "vendor": "<any_vendor_name>", # can be anything, traces are grouped by vendors in the UI
+            "vendor": "<any_vendor_name>",  # can be anything, traces are grouped by vendors in the UI
             "cost": {
                 "amount": 0.002,
                 "currency": "USD"
@@ -605,7 +621,7 @@ signal = Signal(
     }
 )
 
-client.usage.record_bulk(signals=[signal])
+client.signals.create_signals(signals=[signal])
 ```
 
 Alternatively the same `costData` payload can be passed to OTLP signaling mechanism:
@@ -638,17 +654,17 @@ do_work()
 If you would prefer to send us raw usage manually (without wrappers) and have us compute the cost, you can attach usage data in the following format:
 
 ```python
-from paid import Paid, Signal
+from paid import Paid, Signal, CustomerByExternalId, ProductByExternalId
 
 client = Paid(token="<PAID_API_KEY>")
 
 signal = Signal(
     event_name="<your_signal_name>",
-    agent_id="<your_agent_id>",
-    external_customer_id="<your_external_customer_id>",
-    data = {
+    customer=CustomerByExternalId(external_customer_id="<your_external_customer_id>"),
+    attribution=ProductByExternalId(external_product_id="<your_external_product_id>"),
+    data={
         "costData": {
-            "vendor": "<any_vendor_name>", # can be anything, traces are grouped by vendors in the UI
+            "vendor": "<any_vendor_name>",  # can be anything, traces are grouped by vendors in the UI
             "attributes": {
                 "gen_ai.response.model": "gpt-4.1-mini",
                 "gen_ai.usage.input_tokens": 100,
@@ -659,7 +675,7 @@ signal = Signal(
     }
 )
 
-client.usage.record_bulk(signals=[signal])
+client.signals.create_signals(signals=[signal])
 ```
 
 Same but via OTEL signaling:
@@ -702,7 +718,7 @@ from paid import AsyncPaid
 client = AsyncPaid(token="API_KEY")
 
 # Async API calls
-customer = await client.customers.create(name="John Doe")
+customer = await client.customers.create_customer(name="John Doe")
 ```
 
 ### Async Cost Tracking with Decorator
@@ -770,6 +786,7 @@ await do_work()
 ### Paid OTEL Tracer Provider
 
 If you would like to use the Paid OTEL tracer provider:
+
 ```python
 from paid.tracing import get_paid_tracer_provider
 paid_tracer_provider = get_paid_tracer_provider()

{paid_python-0.6.0 → paid_python-1.0.0}/README.md

@@ -41,7 +41,7 @@ from paid import Paid
 
 client = Paid(token="API_KEY")
 
-client.customers.create(
+client.customers.create_customer(
     name="name"
 )
 ```
@@ -52,7 +52,7 @@ The SDK provides Python classes for all request and response types. These are au
 
 ```python
 # Example of creating a customer
-response = client.customers.create(
+response = client.customers.create_customer(
     name="John Doe",
 )
 
@@ -66,13 +66,21 @@ print(response.email)
 When the API returns a non-success status code (4xx or 5xx response), the SDK will raise an appropriate error.
 
 ```python
+from paid import BadRequestError, NotFoundError
+from paid.core.api_error import ApiError
+
 try:
-    client.customers.create(...)
-except paid.Error as e:
+    client.customers.create_customer(name="John Doe")
+except BadRequestError as e:
+    print(e.status_code)  # 400
+    print(e.body)         # ErrorResponse with error details
+except NotFoundError as e:
+    print(e.status_code)  # 404
+    print(e.body)
+except ApiError as e:
+    # Catch-all for other API errors
     print(e.status_code)
-    print(e.message)
     print(e.body)
-    print(e.raw_response)
 ```
 
 ## Logging
@@ -117,6 +125,7 @@ export PAID_ENABLED=false
 ```
 
 This is useful for:
+
 - Development/testing environments where tracing isn't needed
 - Temporarily disabling tracing without modifying code
 - Feature flagging in different deployment environments
@@ -178,11 +187,13 @@ Both approaches:
 - Support the same parameters: `external_customer_id`, `external_product_id`, `tracing_token`, `store_prompt`, `metadata`
 
 * Note - if it happens that you're calling `paid_tracing` from non-main thread, then it's advised to initialize from main thread:
+
 ```python
 from paid.tracing import initialize_tracing
 initialize_tracing()
 ```
-* `initialize_tracing` also accepts optional arguments like OTEL collector endpoint and api key if you want to reroute your tracing somewhere else :)
+
+- `initialize_tracing` also accepts optional arguments like OTEL collector endpoint and api key if you want to reroute your tracing somewhere else :)
 
 ### Using the Paid wrappers
 
@@ -194,7 +205,6 @@ openai
 openai-agents (as a hook)
 anthropic
 langchain (as a hook)
-llamaindex
 bedrock (boto3)
 mistral
 gemini (google-genai)
@@ -265,6 +275,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
 
     process_event(incoming_event)
     ```
+
   </Tab>
 
   <Tab title="Python - Context Manager">
@@ -299,6 +310,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
     ):
         process_event(incoming_event)
     ```
+
   </Tab>
 
   <Tab title="Node.js">
@@ -340,7 +352,7 @@ from openai import OpenAI
 client = Paid(token="PAID_API_KEY")
 initialize_tracing()
 
-paid_autoinstrument()  # instruments all available: anthropic, gemini, openai, openai-agents, bedrock, langchain
+paid_autoinstrument()  # instruments all available: anthropic, gemini, openai, openai-agents, bedrock, langchain, instructor
 
 # Now all OpenAI calls will be automatically traced
 openai_client = OpenAI(api_key="<OPENAI_API_KEY>")
@@ -367,6 +379,7 @@ openai             - OpenAI Python SDK
 openai-agents      - OpenAI Agents SDK
 bedrock            - AWS Bedrock (boto3)
 langchain          - LangChain framework
+instructor         - Instructor
 ```
 
 #### Selective Instrumentation
@@ -550,17 +563,17 @@ If you would prefer to not use Paid to track your costs automatically but you wa
 then you can use manual cost tracking mechanism. Just attach the cost information in the following format to a signal payload:
 
 ```python
-from paid import Paid, Signal
+from paid import Paid, Signal, CustomerByExternalId, ProductByExternalId
 
 client = Paid(token="<PAID_API_KEY>")
 
 signal = Signal(
     event_name="<your_signal_name>",
-    agent_id="<your_agent_id>",
-    external_customer_id="<your_external_customer_id>",
-    data = {
+    customer=CustomerByExternalId(external_customer_id="<your_external_customer_id>"),
+    attribution=ProductByExternalId(external_product_id="<your_external_product_id>"),
+    data={
         "costData": {
-            "vendor": "<any_vendor_name>", # can be anything, traces are grouped by vendors in the UI
+            "vendor": "<any_vendor_name>",  # can be anything, traces are grouped by vendors in the UI
             "cost": {
                 "amount": 0.002,
                 "currency": "USD"
@@ -570,7 +583,7 @@ signal = Signal(
     }
 )
 
-client.usage.record_bulk(signals=[signal])
+client.signals.create_signals(signals=[signal])
 ```
 
 Alternatively the same `costData` payload can be passed to OTLP signaling mechanism:
@@ -603,17 +616,17 @@ do_work()
 If you would prefer to send us raw usage manually (without wrappers) and have us compute the cost, you can attach usage data in the following format:
 
 ```python
-from paid import Paid, Signal
+from paid import Paid, Signal, CustomerByExternalId, ProductByExternalId
 
 client = Paid(token="<PAID_API_KEY>")
 
 signal = Signal(
     event_name="<your_signal_name>",
-    agent_id="<your_agent_id>",
-    external_customer_id="<your_external_customer_id>",
-    data = {
+    customer=CustomerByExternalId(external_customer_id="<your_external_customer_id>"),
+    attribution=ProductByExternalId(external_product_id="<your_external_product_id>"),
+    data={
         "costData": {
-            "vendor": "<any_vendor_name>", # can be anything, traces are grouped by vendors in the UI
+            "vendor": "<any_vendor_name>",  # can be anything, traces are grouped by vendors in the UI
             "attributes": {
                 "gen_ai.response.model": "gpt-4.1-mini",
                 "gen_ai.usage.input_tokens": 100,
@@ -624,7 +637,7 @@ signal = Signal(
     }
 )
 
-client.usage.record_bulk(signals=[signal])
+client.signals.create_signals(signals=[signal])
 ```
 
 Same but via OTEL signaling:
@@ -667,7 +680,7 @@ from paid import AsyncPaid
 client = AsyncPaid(token="API_KEY")
 
 # Async API calls
-customer = await client.customers.create(name="John Doe")
+customer = await client.customers.create_customer(name="John Doe")
 ```
 
 ### Async Cost Tracking with Decorator
@@ -735,6 +748,7 @@ await do_work()
 ### Paid OTEL Tracer Provider
 
 If you would like to use the Paid OTEL tracer provider:
+
 ```python
 from paid.tracing import get_paid_tracer_provider
 paid_tracer_provider = get_paid_tracer_provider()

{paid_python-0.6.0 → paid_python-1.0.0}/pyproject.toml

@@ -3,7 +3,7 @@ name = "paid-python"
 
 [tool.poetry]
 name = "paid-python"
-version = "0.6.0"
+version = "1.0.0"
 description = ""
 readme = "README.md"
 authors = []
@@ -13,6 +13,7 @@ classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -26,8 +27,7 @@ classifiers = [
     "Typing :: Typed"
 ]
 packages = [
-    { include = "paid", from = "src"},
-    { include = "opentelemetry", from = "vendor/patched-instrumentation-openllmetry/packages/opentelemetry-instrumentation-openai" },
+    { include = "paid", from = "src"}
 ]
 
 [project.urls]
@@ -35,21 +35,22 @@ Repository = 'https://github.com/paid-ai/paid-python'
 
 [tool.poetry.dependencies]
 python = ">=3.9,<3.14"
-httpx = ">=0.21.0"
-pydantic = ">=1.9.0"
-pydantic-core = ">=2.18.0"
-typing_extensions = ">= 4.0.0"
-opentelemetry-api = ">=1.23.0"
-opentelemetry-sdk = ">=1.23.0"
-opentelemetry-exporter-otlp-proto-http = ">=1.23.0"
+httpx = ">=0.21.2"
 mutagen = ">=1.47.0"
-python-dotenv = ">=0.15.0"
-opentelemetry-instrumentation-anthropic = ">=0.47.0"
-# opentelemetry-instrumentation-openai is vendored from git a submodule under vendor/patched-instrumentation-openllmetry
-openinference-instrumentation-langchain = ">=0.1.55"
-openinference-instrumentation-openai-agents = ">=1.0.0"
 openinference-instrumentation-bedrock = ">=0.1.0"
 openinference-instrumentation-google-genai = ">=0.1.8"
+openinference-instrumentation-instructor = ">=0.1.0"
+openinference-instrumentation-langchain = ">=0.1.55"
+openinference-instrumentation-openai = ">=0.1.40"
+openinference-instrumentation-openai-agents = ">=1.0.0"
+opentelemetry-api = ">=1.23.0"
+opentelemetry-exporter-otlp-proto-http = ">=1.23.0"
+opentelemetry-instrumentation-anthropic = ">=0.47.0"
+opentelemetry-sdk = ">=1.23.0"
+pydantic = ">= 1.9.2"
+pydantic-core = "^2.18.2"
+python-dotenv = ">=0.15.0"
+typing_extensions = ">= 4.0.0"
 
 [tool.poetry.group.dev.dependencies]
 mypy = "==1.13.0"
@@ -57,48 +58,21 @@ pytest = "^7.4.0"
 pytest-asyncio = "^0.23.5"
 python-dateutil = "^2.9.0"
 types-python-dateutil = "^2.9.0.20240316"
-ruff = "==0.11.5"
-
-# Peer-dependencies, but useful to have for development
-mistralai = ">=1.9.0"
 anthropic = ">=0.57.0"
-llama-index-core = ">=0.13.0"
-llama-index-llms-openai = ">=0.5.0"
 google-genai = ">=1.19.0"
-openai-agents = ">=0.2.0"
+instructor = ">=1.0.0"
 langchain-core = ">=0.1.0"
+mistralai = ">=1.9.0"
 openai = ">=1.12.0"
+openai-agents = ">=0.2.0"
+ruff = "==0.11.5"
 
 [tool.pytest.ini_options]
 testpaths = [ "tests" ]
 asyncio_mode = "auto"
-# TODO(Ata): remove this once the openai instrumentation isn't vendored anymore
-norecursedirs = ["vendor/patched-instrumentation-openllmetry"]
 
 [tool.mypy]
 plugins = ["pydantic.mypy"]
-exclude = [
-    # TODO(Ata): remove this once the openai instrumentation isn't vendored anymore
-    "^vendor/patched-instrumentation-openllmetry/",
-]
-
-[[tool.mypy.overrides]]
-module = [
-    "anthropic",
-    "anthropic.*",
-    "openai",
-    "mistralai",
-    "mistralai.*",
-    "llama_index.*",
-    "google.*",
-    "agents",
-    "agents.*",
-    "langchain_core.*",
-    "opentelemetry.instrumentation.openai",  # TODO(Ata): remove this once the openai instrumentation isn't vendored anymore
-    "opentelemetry.instrumentation.openai.*",
-]
-ignore_missing_imports = true
-ignore_errors = true # remove once openai instrumentor is upstream
 
 [tool.ruff]
 line-length = 120

paid_python-1.0.0/src/paid/__init__.py

@@ -0,0 +1,102 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .types import (
+    Attribution,
+    BulkSignalsResponse,
+    Contact,
+    ContactBillingAddress,
+    ContactListResponse,
+    Customer,
+    CustomerAttribution,
+    CustomerBillingAddress,
+    CustomerByExternalId,
+    CustomerById,
+    CustomerCreationState,
+    CustomerListResponse,
+    EmptyResponse,
+    ErrorResponse,
+    Invoice,
+    InvoiceLine,
+    InvoiceLinePaymentStatus,
+    InvoiceLinesResponse,
+    InvoiceListResponse,
+    InvoicePaymentStatus,
+    InvoiceSource,
+    InvoiceStatus,
+    InvoiceTaxStatus,
+    Order,
+    OrderCreationState,
+    OrderLine,
+    OrderLinesResponse,
+    OrderListResponse,
+    Pagination,
+    Product,
+    ProductByExternalId,
+    ProductById,
+    ProductListResponse,
+    Signal,
+    UpdateContactRequest,
+    UpdateCustomerRequest,
+    UpdateProductRequest,
+)
+from .errors import BadRequestError, ForbiddenError, InternalServerError, NotFoundError
+from . import contacts, customers, invoices, orders, products, signals
+from .client import AsyncPaid, Paid
+from .environment import PaidEnvironment
+from .version import __version__
+
+__all__ = [
+    "AsyncPaid",
+    "Attribution",
+    "BadRequestError",
+    "BulkSignalsResponse",
+    "Contact",
+    "ContactBillingAddress",
+    "ContactListResponse",
+    "Customer",
+    "CustomerAttribution",
+    "CustomerBillingAddress",
+    "CustomerByExternalId",
+    "CustomerById",
+    "CustomerCreationState",
+    "CustomerListResponse",
+    "EmptyResponse",
+    "ErrorResponse",
+    "ForbiddenError",
+    "InternalServerError",
+    "Invoice",
+    "InvoiceLine",
+    "InvoiceLinePaymentStatus",
+    "InvoiceLinesResponse",
+    "InvoiceListResponse",
+    "InvoicePaymentStatus",
+    "InvoiceSource",
+    "InvoiceStatus",
+    "InvoiceTaxStatus",
+    "NotFoundError",
+    "Order",
+    "OrderCreationState",
+    "OrderLine",
+    "OrderLinesResponse",
+    "OrderListResponse",
+    "Pagination",
+    "Paid",
+    "PaidEnvironment",
+    "Product",
+    "ProductByExternalId",
+    "ProductById",
+    "ProductListResponse",
+    "Signal",
+    "UpdateContactRequest",
+    "UpdateCustomerRequest",
+    "UpdateProductRequest",
+    "__version__",
+    "contacts",
+    "customers",
+    "invoices",
+    "orders",
+    "products",
+    "signals",
+]