BasisTheoryClient 0.1.1__tar.gz

basistheoryclient-0.1.1/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.1
+Name: BasisTheoryClient
+Version: 0.1.1
+Summary: 
+Requires-Python: >=3.8,<4.0
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: httpx (>=0.21.2)
+Requires-Dist: pydantic (>=1.9.2)
+Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
+Requires-Dist: typing_extensions (>=4.0.0)
+Description-Content-Type: text/markdown
+
+# BasisTheory Python Library
+
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2FBasis-Theory%2Fpython-sdk)
+[![pypi](https://img.shields.io/pypi/v/BasisTheoryClient)](https://pypi.python.org/pypi/BasisTheoryClient)
+
+The BasisTheory Python library provides convenient access to the BasisTheory API from Python.
+
+## Documentation
+
+API reference documentation is available [here](https://api.basistheory.com).
+
+## Installation
+
+```sh
+pip install BasisTheoryClient
+```
+
+## Usage
+
+Instantiate and use the client with the following:
+
+```python
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    api_key="YOUR_API_KEY",
+)
+client.tenants.self_.get()
+```
+
+## Async Client
+
+The SDK also exports an `async` client so that you can make non-blocking calls to our API.
+
+```python
+import asyncio
+
+from basis_theory import AsyncBasisTheory
+
+client = AsyncBasisTheory(
+    api_key="YOUR_API_KEY",
+)
+
+
+async def main() -> None:
+    await client.tenants.self_.get()
+
+
+asyncio.run(main())
+```
+
+## Exception Handling
+
+When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
+will be thrown.
+
+```python
+from basis_theory.core.api_error import ApiError
+
+try:
+    client.tenants.self_.get(...)
+except ApiError as e:
+    print(e.status_code)
+    print(e.body)
+```
+
+## Pagination
+
+Paginated requests will return a `SyncPager` or `AsyncPager`, which can be used as generators for the underlying object.
+
+```python
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    api_key="YOUR_API_KEY",
+)
+response = client.applications.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
+```
+
+## Advanced
+
+### Retries
+
+The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
+as the request is deemed retriable and the number of retry attempts has not grown larger than the configured
+retry limit (default: 2).
+
+A request is deemed retriable when any of the following HTTP status codes is returned:
+
+- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
+- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
+- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
+
+Use the `max_retries` request option to configure this behavior.
+
+```python
+client.tenants.self_.get(..., {
+    "max_retries": 1
+})
+```
+
+### Timeouts
+
+The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
+
+```python
+
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    ...,
+    timeout=20.0,
+)
+
+
+# Override timeout for a specific method
+client.tenants.self_.get(..., {
+    "timeout_in_seconds": 1
+})
+```
+
+### Custom Client
+
+You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
+and transports.
+```python
+import httpx
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    ...,
+    httpx_client=httpx.Client(
+        proxies="http://my.test.proxy.example.com",
+        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
+    ),
+)
+```
+
+## Contributing
+
+While we value open-source contributions to this SDK, this library is generated programmatically.
+Additions made directly to this library would have to be moved over to our generation code,
+otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
+a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
+an issue first to discuss with us!
+
+On the other hand, contributions to the README are always very welcome!
+

basistheoryclient-0.1.1/README.md

@@ -0,0 +1,152 @@
+# BasisTheory Python Library
+
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2FBasis-Theory%2Fpython-sdk)
+[![pypi](https://img.shields.io/pypi/v/BasisTheoryClient)](https://pypi.python.org/pypi/BasisTheoryClient)
+
+The BasisTheory Python library provides convenient access to the BasisTheory API from Python.
+
+## Documentation
+
+API reference documentation is available [here](https://api.basistheory.com).
+
+## Installation
+
+```sh
+pip install BasisTheoryClient
+```
+
+## Usage
+
+Instantiate and use the client with the following:
+
+```python
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    api_key="YOUR_API_KEY",
+)
+client.tenants.self_.get()
+```
+
+## Async Client
+
+The SDK also exports an `async` client so that you can make non-blocking calls to our API.
+
+```python
+import asyncio
+
+from basis_theory import AsyncBasisTheory
+
+client = AsyncBasisTheory(
+    api_key="YOUR_API_KEY",
+)
+
+
+async def main() -> None:
+    await client.tenants.self_.get()
+
+
+asyncio.run(main())
+```
+
+## Exception Handling
+
+When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
+will be thrown.
+
+```python
+from basis_theory.core.api_error import ApiError
+
+try:
+    client.tenants.self_.get(...)
+except ApiError as e:
+    print(e.status_code)
+    print(e.body)
+```
+
+## Pagination
+
+Paginated requests will return a `SyncPager` or `AsyncPager`, which can be used as generators for the underlying object.
+
+```python
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    api_key="YOUR_API_KEY",
+)
+response = client.applications.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
+```
+
+## Advanced
+
+### Retries
+
+The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
+as the request is deemed retriable and the number of retry attempts has not grown larger than the configured
+retry limit (default: 2).
+
+A request is deemed retriable when any of the following HTTP status codes is returned:
+
+- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
+- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
+- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
+
+Use the `max_retries` request option to configure this behavior.
+
+```python
+client.tenants.self_.get(..., {
+    "max_retries": 1
+})
+```
+
+### Timeouts
+
+The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
+
+```python
+
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    ...,
+    timeout=20.0,
+)
+
+
+# Override timeout for a specific method
+client.tenants.self_.get(..., {
+    "timeout_in_seconds": 1
+})
+```
+
+### Custom Client
+
+You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
+and transports.
+```python
+import httpx
+from basis_theory import BasisTheory
+
+client = BasisTheory(
+    ...,
+    httpx_client=httpx.Client(
+        proxies="http://my.test.proxy.example.com",
+        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
+    ),
+)
+```
+
+## Contributing
+
+While we value open-source contributions to this SDK, this library is generated programmatically.
+Additions made directly to this library would have to be moved over to our generation code,
+otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
+a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
+an issue first to discuss with us!
+
+On the other hand, contributions to the README are always very welcome!

basistheoryclient-0.1.1/pyproject.toml

@@ -0,0 +1,61 @@
+[tool.poetry]
+name = "BasisTheoryClient"
+version = "0.1.1"
+description = ""
+readme = "README.md"
+authors = []
+keywords = []
+
+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",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Operating System :: POSIX",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed"
+]
+packages = [
+    { include = "basis_theory", from = "src"}
+]
+
+[project.urls]
+Repository = 'https://github.com/Basis-Theory/python-sdk'
+
+[tool.poetry.dependencies]
+python = "^3.8"
+httpx = ">=0.21.2"
+pydantic = ">= 1.9.2"
+pydantic-core = "^2.18.2"
+typing_extensions = ">= 4.0.0"
+
+[tool.poetry.dev-dependencies]
+mypy = "1.0.1"
+pytest = "^7.4.0"
+pytest-asyncio = "^0.23.5"
+python-dateutil = "^2.9.0"
+types-python-dateutil = "^2.9.0.20240316"
+ruff = "^0.5.6"
+
+[tool.pytest.ini_options]
+testpaths = [ "tests" ]
+asyncio_mode = "auto"
+
+[tool.mypy]
+plugins = ["pydantic.mypy"]
+
+[tool.ruff]
+line-length = 120
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

basistheoryclient-0.1.1/src/basis_theory/__init__.py

@@ -0,0 +1,226 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import (
+    AccessRule,
+    Application,
+    ApplicationKey,
+    ApplicationPaginatedList,
+    ApplicationTemplate,
+    BinDetails,
+    BinDetailsBank,
+    BinDetailsCountry,
+    BinDetailsProduct,
+    CardDetails,
+    Condition,
+    CreateSessionResponse,
+    CreateTenantConnectionResponse,
+    CursorPagination,
+    EventTypes,
+    GetApplications,
+    GetLogs,
+    GetPermissions,
+    GetProxies,
+    GetReactorFormulas,
+    GetReactors,
+    GetTenantInvitations,
+    GetTenantMembers,
+    GetTokens,
+    GetTokensV2,
+    Log,
+    LogEntityType,
+    LogPaginatedList,
+    Pagination,
+    Permission,
+    Privacy,
+    ProblemDetails,
+    Proxy,
+    ProxyPaginatedList,
+    ProxyTransform,
+    PublicKey,
+    ReactResponse,
+    Reactor,
+    ReactorFormula,
+    ReactorFormulaConfiguration,
+    ReactorFormulaPaginatedList,
+    ReactorFormulaRequestParameter,
+    ReactorPaginatedList,
+    Role,
+    StringStringKeyValuePair,
+    Tenant,
+    TenantConnectionOptions,
+    TenantInvitationResponse,
+    TenantInvitationResponsePaginatedList,
+    TenantInvitationStatus,
+    TenantMemberResponse,
+    TenantMemberResponsePaginatedList,
+    TenantUsageReport,
+    ThreeDsAcsRenderingType,
+    ThreeDsAddress,
+    ThreeDsAuthentication,
+    ThreeDsCardholderAccountInfo,
+    ThreeDsCardholderAuthenticationInfo,
+    ThreeDsCardholderInfo,
+    ThreeDsCardholderPhoneNumber,
+    ThreeDsDeviceInfo,
+    ThreeDsMerchantInfo,
+    ThreeDsMerchantRiskInfo,
+    ThreeDsMessageExtension,
+    ThreeDsMethod,
+    ThreeDsMobileSdkRenderOptions,
+    ThreeDsPriorAuthenticationInfo,
+    ThreeDsPurchaseInfo,
+    ThreeDsRequestorInfo,
+    ThreeDsSession,
+    ThreeDsVersion,
+    Token,
+    TokenCursorPaginatedList,
+    TokenEnrichments,
+    TokenMetrics,
+    TokenPaginatedList,
+    TokenReport,
+    UpdatePrivacy,
+    User,
+    ValidationProblemDetails,
+    Webhook,
+    WebhookList,
+    WebhookListPagination,
+    WebhookStatus,
+)
+from .errors import (
+    BadRequestError,
+    ConflictError,
+    ForbiddenError,
+    NotFoundError,
+    UnauthorizedError,
+    UnprocessableEntityError,
+)
+from . import (
+    application_keys,
+    application_templates,
+    applications,
+    logs,
+    permissions,
+    proxies,
+    reactorformulas,
+    reactors,
+    roles,
+    sessions,
+    tenants,
+    threeds,
+    tokens,
+    webhooks,
+)
+from .client import AsyncBasisTheory, BasisTheory
+from .environment import BasisTheoryEnvironment
+from .version import __version__
+
+__all__ = [
+    "AccessRule",
+    "Application",
+    "ApplicationKey",
+    "ApplicationPaginatedList",
+    "ApplicationTemplate",
+    "AsyncBasisTheory",
+    "BadRequestError",
+    "BasisTheory",
+    "BasisTheoryEnvironment",
+    "BinDetails",
+    "BinDetailsBank",
+    "BinDetailsCountry",
+    "BinDetailsProduct",
+    "CardDetails",
+    "Condition",
+    "ConflictError",
+    "CreateSessionResponse",
+    "CreateTenantConnectionResponse",
+    "CursorPagination",
+    "EventTypes",
+    "ForbiddenError",
+    "GetApplications",
+    "GetLogs",
+    "GetPermissions",
+    "GetProxies",
+    "GetReactorFormulas",
+    "GetReactors",
+    "GetTenantInvitations",
+    "GetTenantMembers",
+    "GetTokens",
+    "GetTokensV2",
+    "Log",
+    "LogEntityType",
+    "LogPaginatedList",
+    "NotFoundError",
+    "Pagination",
+    "Permission",
+    "Privacy",
+    "ProblemDetails",
+    "Proxy",
+    "ProxyPaginatedList",
+    "ProxyTransform",
+    "PublicKey",
+    "ReactResponse",
+    "Reactor",
+    "ReactorFormula",
+    "ReactorFormulaConfiguration",
+    "ReactorFormulaPaginatedList",
+    "ReactorFormulaRequestParameter",
+    "ReactorPaginatedList",
+    "Role",
+    "StringStringKeyValuePair",
+    "Tenant",
+    "TenantConnectionOptions",
+    "TenantInvitationResponse",
+    "TenantInvitationResponsePaginatedList",
+    "TenantInvitationStatus",
+    "TenantMemberResponse",
+    "TenantMemberResponsePaginatedList",
+    "TenantUsageReport",
+    "ThreeDsAcsRenderingType",
+    "ThreeDsAddress",
+    "ThreeDsAuthentication",
+    "ThreeDsCardholderAccountInfo",
+    "ThreeDsCardholderAuthenticationInfo",
+    "ThreeDsCardholderInfo",
+    "ThreeDsCardholderPhoneNumber",
+    "ThreeDsDeviceInfo",
+    "ThreeDsMerchantInfo",
+    "ThreeDsMerchantRiskInfo",
+    "ThreeDsMessageExtension",
+    "ThreeDsMethod",
+    "ThreeDsMobileSdkRenderOptions",
+    "ThreeDsPriorAuthenticationInfo",
+    "ThreeDsPurchaseInfo",
+    "ThreeDsRequestorInfo",
+    "ThreeDsSession",
+    "ThreeDsVersion",
+    "Token",
+    "TokenCursorPaginatedList",
+    "TokenEnrichments",
+    "TokenMetrics",
+    "TokenPaginatedList",
+    "TokenReport",
+    "UnauthorizedError",
+    "UnprocessableEntityError",
+    "UpdatePrivacy",
+    "User",
+    "ValidationProblemDetails",
+    "Webhook",
+    "WebhookList",
+    "WebhookListPagination",
+    "WebhookStatus",
+    "__version__",
+    "application_keys",
+    "application_templates",
+    "applications",
+    "logs",
+    "permissions",
+    "proxies",
+    "reactorformulas",
+    "reactors",
+    "roles",
+    "sessions",
+    "tenants",
+    "threeds",
+    "tokens",
+    "webhooks",
+]

basistheoryclient-0.1.1/src/basis_theory/application_keys/__init__.py

@@ -0,0 +1,2 @@
+# This file was auto-generated by Fern from our API Definition.
+