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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: paid-python
-Version: 0.6.0
+Version: 1.0.0a1
 Summary: 
 Requires-Python: >=3.9,<3.14
 Classifier: Intended Audience :: Developers
@@ -15,9 +15,10 @@ 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)
@@ -26,9 +27,10 @@ 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-instrumentation-openai (>=0.50.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 +78,7 @@ from paid import Paid
 
 client = Paid(token="API_KEY")
 
-client.customers.create(
+client.customers.create_a_new_customer(
     name="name"
 )
 ```
@@ -87,7 +89,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",
 )
 
@@ -101,13 +103,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
@@ -152,6 +162,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 +224,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
 
@@ -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">
@@ -770,6 +785,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.0a1}/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-0.6.0 → paid_python-1.0.0a1}/pyproject.toml

@@ -3,7 +3,7 @@ name = "paid-python"
 
 [tool.poetry]
 name = "paid-python"
-version = "0.6.0"
+version = "1.0.0-alpha1"
 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,21 @@ 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-langchain = ">=0.1.55"
+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-instrumentation-openai = ">=0.50.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 +57,22 @@ 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"
 langchain-core = ">=0.1.0"
+llama-index-core = ">=0.13.0"
+llama-index-llms-openai = ">=0.5.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.0a1/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.0a1/src/paid/client.py

@@ -0,0 +1,158 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import httpx
+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 .products.client import AsyncProductsClient, ProductsClient
+from .signals.client import AsyncSignalsClient, SignalsClient
+
+
+class Paid:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : PaidEnvironment
+        The environment to use for requests from the client. from .environment import PaidEnvironment
+
+
+
+        Defaults to PaidEnvironment.DEFAULT
+
+
+
+    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.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.Client]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    Examples
+    --------
+    from paid import Paid
+
+    client = Paid(
+        token="YOUR_TOKEN",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[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,
+    ):
+        _defaulted_timeout = (
+            timeout if timeout is not None else 60 if httpx_client is None else httpx_client.timeout.read
+        )
+        self._client_wrapper = SyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            token=token,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else httpx.Client(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
+            if follow_redirects is not None
+            else httpx.Client(timeout=_defaulted_timeout),
+            timeout=_defaulted_timeout,
+        )
+        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.invoices = InvoicesClient(client_wrapper=self._client_wrapper)
+        self.signals = SignalsClient(client_wrapper=self._client_wrapper)
+
+
+class AsyncPaid:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : PaidEnvironment
+        The environment to use for requests from the client. from .environment import PaidEnvironment
+
+
+
+        Defaults to PaidEnvironment.DEFAULT
+
+
+
+    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.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.AsyncClient]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    Examples
+    --------
+    from paid import AsyncPaid
+
+    client = AsyncPaid(
+        token="YOUR_TOKEN",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[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,
+    ):
+        _defaulted_timeout = (
+            timeout if timeout is not None else 60 if httpx_client is None else httpx_client.timeout.read
+        )
+        self._client_wrapper = AsyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            token=token,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else httpx.AsyncClient(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
+            if follow_redirects is not None
+            else httpx.AsyncClient(timeout=_defaulted_timeout),
+            timeout=_defaulted_timeout,
+        )
+        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.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:
+    if base_url is not None:
+        return base_url
+    elif environment is not None:
+        return environment.value
+    else:
+        raise Exception("Please pass in either base_url or environment to construct the client")