paid-python 1.0.0a0__tar.gz → 1.0.0a2__tar.gz

{paid_python-1.0.0a0 → paid_python-1.0.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: paid-python
-Version: 1.0.0a0
+Version: 1.0.0a2
 Summary: 
 Requires-Python: >=3.9,<3.14
 Classifier: Intended Audience :: Developers
@@ -22,6 +22,7 @@ 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-agents (>=1.0.0)
 Requires-Dist: opentelemetry-api (>=1.23.0)
@@ -78,7 +79,7 @@ from paid import Paid
 
 client = Paid(token="API_KEY")
 
-client.customers.create(
+client.customers.create_a_new_customer(
     name="name"
 )
 ```
@@ -89,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_a_new_customer(
     name="John Doe",
 )
 
@@ -103,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_a_new_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
@@ -154,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
@@ -215,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
 
@@ -302,6 +314,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
 
     process_event(incoming_event)
     ```
+
   </Tab>
 
   <Tab title="Python - Context Manager">
@@ -336,6 +349,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
     ):
         process_event(incoming_event)
     ```
+
   </Tab>
 
   <Tab title="Node.js">
@@ -772,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-1.0.0a0 → paid_python-1.0.0a2}/README.md

@@ -41,7 +41,7 @@ from paid import Paid
 
 client = Paid(token="API_KEY")
 
-client.customers.create(
+client.customers.create_a_new_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_a_new_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_a_new_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
 
@@ -265,6 +276,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 +311,7 @@ You can attach custom metadata to your traces by passing a `metadata` dictionary
     ):
         process_event(incoming_event)
     ```
+
   </Tab>
 
   <Tab title="Node.js">
@@ -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-1.0.0a0 → paid_python-1.0.0a2}/pyproject.toml

@@ -3,7 +3,7 @@ name = "paid-python"
 
 [tool.poetry]
 name = "paid-python"
-version = "1.0.0-alpha0"
+version = "1.0.0-alpha2"
 description = ""
 readme = "README.md"
 authors = []
@@ -39,6 +39,7 @@ httpx = ">=0.21.2"
 mutagen = ">=1.47.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-agents = ">=1.0.0"
 opentelemetry-api = ">=1.23.0"
@@ -59,6 +60,7 @@ python-dateutil = "^2.9.0"
 types-python-dateutil = "^2.9.0.20240316"
 anthropic = ">=0.57.0"
 google-genai = ">=1.19.0"
+instructor = ">=1.0.0"
 langchain-core = ">=0.1.0"
 llama-index-core = ">=0.13.0"
 llama-index-llms-openai = ">=0.5.0"

paid_python-1.0.0a2/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",
+]

{paid_python-1.0.0a0 → paid_python-1.0.0a2}/src/paid/client.py

@@ -3,16 +3,14 @@
 import typing
 
 import httpx
-from .agents.client import AgentsClient, AsyncAgentsClient
 from .contacts.client import AsyncContactsClient, ContactsClient
 from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from .customers.client import AsyncCustomersClient, CustomersClient
 from .environment import PaidEnvironment
+from .invoices.client import AsyncInvoicesClient, InvoicesClient
 from .orders.client import AsyncOrdersClient, OrdersClient
-from .plans.client import AsyncPlansClient, PlansClient
 from .products.client import AsyncProductsClient, ProductsClient
-from .traces.client import AsyncTracesClient, TracesClient
-from .usage.client import AsyncUsageClient, UsageClient
+from .signals.client import AsyncSignalsClient, SignalsClient
 
 
 class Paid:
@@ -29,11 +27,11 @@ class Paid:
 
 
 
-        Defaults to PaidEnvironment.PRODUCTION
+        Defaults to PaidEnvironment.DEFAULT
 
 
 
-    token : typing.Optional[typing.Union[str, typing.Callable[[], str]]]
+    token : typing.Union[str, typing.Callable[[], str]]
     timeout : typing.Optional[float]
         The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
 
@@ -56,8 +54,8 @@ class Paid:
         self,
         *,
         base_url: typing.Optional[str] = None,
-        environment: PaidEnvironment = PaidEnvironment.PRODUCTION,
-        token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,
+        environment: PaidEnvironment = PaidEnvironment.DEFAULT,
+        token: typing.Union[str, typing.Callable[[], str]],
         timeout: typing.Optional[float] = None,
         follow_redirects: typing.Optional[bool] = True,
         httpx_client: typing.Optional[httpx.Client] = None,
@@ -75,14 +73,12 @@ class Paid:
             else httpx.Client(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
-        self.customers = CustomersClient(client_wrapper=self._client_wrapper)
-        self.agents = AgentsClient(client_wrapper=self._client_wrapper)
         self.products = ProductsClient(client_wrapper=self._client_wrapper)
+        self.customers = CustomersClient(client_wrapper=self._client_wrapper)
         self.contacts = ContactsClient(client_wrapper=self._client_wrapper)
         self.orders = OrdersClient(client_wrapper=self._client_wrapper)
-        self.plans = PlansClient(client_wrapper=self._client_wrapper)
-        self.usage = UsageClient(client_wrapper=self._client_wrapper)
-        self.traces = TracesClient(client_wrapper=self._client_wrapper)
+        self.invoices = InvoicesClient(client_wrapper=self._client_wrapper)
+        self.signals = SignalsClient(client_wrapper=self._client_wrapper)
 
 
 class AsyncPaid:
@@ -99,11 +95,11 @@ class AsyncPaid:
 
 
 
-        Defaults to PaidEnvironment.PRODUCTION
+        Defaults to PaidEnvironment.DEFAULT
 
 
 
-    token : typing.Optional[typing.Union[str, typing.Callable[[], str]]]
+    token : typing.Union[str, typing.Callable[[], str]]
     timeout : typing.Optional[float]
         The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
 
@@ -126,8 +122,8 @@ class AsyncPaid:
         self,
         *,
         base_url: typing.Optional[str] = None,
-        environment: PaidEnvironment = PaidEnvironment.PRODUCTION,
-        token: typing.Optional[typing.Union[str, typing.Callable[[], str]]] = None,
+        environment: PaidEnvironment = PaidEnvironment.DEFAULT,
+        token: typing.Union[str, typing.Callable[[], str]],
         timeout: typing.Optional[float] = None,
         follow_redirects: typing.Optional[bool] = True,
         httpx_client: typing.Optional[httpx.AsyncClient] = None,
@@ -145,14 +141,12 @@ class AsyncPaid:
             else httpx.AsyncClient(timeout=_defaulted_timeout),
             timeout=_defaulted_timeout,
         )
-        self.customers = AsyncCustomersClient(client_wrapper=self._client_wrapper)
-        self.agents = AsyncAgentsClient(client_wrapper=self._client_wrapper)
         self.products = AsyncProductsClient(client_wrapper=self._client_wrapper)
+        self.customers = AsyncCustomersClient(client_wrapper=self._client_wrapper)
         self.contacts = AsyncContactsClient(client_wrapper=self._client_wrapper)
         self.orders = AsyncOrdersClient(client_wrapper=self._client_wrapper)
-        self.plans = AsyncPlansClient(client_wrapper=self._client_wrapper)
-        self.usage = AsyncUsageClient(client_wrapper=self._client_wrapper)
-        self.traces = AsyncTracesClient(client_wrapper=self._client_wrapper)
+        self.invoices = AsyncInvoicesClient(client_wrapper=self._client_wrapper)
+        self.signals = AsyncSignalsClient(client_wrapper=self._client_wrapper)
 
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: PaidEnvironment) -> str: