fragment-python 1.3.0__tar.gz → 1.4.1__tar.gz

{fragment_python-1.3.0 → fragment_python-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fragment-python
-Version: 1.3.0
+Version: 1.4.1
 Summary: Python SDK for https://fragment.dev/
 License: Apache 2.0
 License-File: LICENSE
@@ -15,7 +15,6 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
 Requires-Dist: ariadne-codegen (>=0.17.2,<0.18.0)
-Requires-Dist: authlib (>=1.6.12,<2.0.0)
 Requires-Dist: click (>=8.1.7,<9.0.0)
 Requires-Dist: graphql-core (>=3.2.3,<4.0.0)
 Requires-Dist: httpx (>=0.28.1,<0.29.0)

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/client/async_client.py

@@ -1,5 +1,3 @@
-# Ignore untyped authlib
-# mypy: disable-error-code="import-untyped"
 import time
 from typing import Any, Dict, Optional
 
@@ -7,8 +5,8 @@ import httpx
 from ariadne_codegen.client_generators.dependencies.async_base_client import (
     AsyncBaseClient,
 )
-from authlib.integrations.httpx_client import AsyncOAuth2Client
 
+from fragment.client.oauth import fetch_token_async
 from fragment.exceptions import MissingArgumentException, MissingTokenException
 
 
@@ -37,16 +35,18 @@ class AsyncFragmentClient(AsyncBaseClient):
         self.auth_url = auth_url
         self.expiration_time: Optional[float] = None
         self.token: Optional[Dict[str, Any]] = None
-        self.oauth2_client = AsyncOAuth2Client(
-            client_id, client_secret, scope=auth_scope
-        )
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.auth_scope = auth_scope
 
     async def refresh_token(self) -> None:
         now = time.time()
         if self.expiration_time is None or self.expiration_time <= now:
             # Held in a local because `self.token` is declared `dict | None`,
             # so reading the attribute back is not narrowed by the assignment.
-            token = await self.oauth2_client.fetch_token(self.auth_url)
+            token = await fetch_token_async(
+                self.auth_url, self.client_id, self.client_secret, self.auth_scope
+            )
             self.token = token
             self.expiration_time = now + token["expires_in"]
 

fragment_python-1.4.1/fragment/client/oauth.py

@@ -0,0 +1,75 @@
+"""OAuth2 client-credentials token request against the Fragment auth endpoint.
+
+The SDK needs exactly one OAuth2 call: exchange a client ID and secret for an
+access token. That is a single form POST, so it is made with httpx directly
+rather than through an OAuth library, whose much larger surface (JOSE, OIDC,
+server-side grants) customers would otherwise inherit, along with its
+advisories.
+
+The request matches what authlib's httpx `OAuth2Client.fetch_token` sent:
+HTTP Basic client authentication (`client_secret_basic`) and a form body of
+`grant_type=client_credentials` and `scope`.
+"""
+
+from typing import Any, Dict
+
+import httpx
+
+from fragment.exceptions import TokenRequestException
+
+_HEADERS = {
+    "Accept": "application/json",
+    "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+}
+
+
+def _token_request_kwargs(
+    client_id: str, client_secret: str, scope: str
+) -> Dict[str, Any]:
+    return dict(
+        data={"grant_type": "client_credentials", "scope": scope},
+        auth=httpx.BasicAuth(client_id, client_secret),
+        headers=_HEADERS,
+    )
+
+
+def _parse_token_response(response: httpx.Response) -> Dict[str, Any]:
+    if response.status_code >= 500:
+        response.raise_for_status()
+    try:
+        token = response.json()
+    except ValueError as e:
+        raise TokenRequestException(
+            f"token endpoint returned a non-JSON response "
+            f"(HTTP {response.status_code})"
+        ) from e
+    if not isinstance(token, dict):
+        raise TokenRequestException("token endpoint returned a non-object response")
+    if "error" in token:
+        raise TokenRequestException(token["error"], token.get("error_description"))
+    if "access_token" not in token or "expires_in" not in token:
+        raise TokenRequestException(
+            f"token endpoint response is missing access_token or expires_in "
+            f"(HTTP {response.status_code})"
+        )
+    return token
+
+
+def fetch_token(
+    auth_url: str, client_id: str, client_secret: str, scope: str
+) -> Dict[str, Any]:
+    with httpx.Client() as client:
+        response = client.post(
+            auth_url, **_token_request_kwargs(client_id, client_secret, scope)
+        )
+    return _parse_token_response(response)
+
+
+async def fetch_token_async(
+    auth_url: str, client_id: str, client_secret: str, scope: str
+) -> Dict[str, Any]:
+    async with httpx.AsyncClient() as client:
+        response = await client.post(
+            auth_url, **_token_request_kwargs(client_id, client_secret, scope)
+        )
+    return _parse_token_response(response)

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/client/sync_client.py

@@ -1,12 +1,10 @@
-# Ignore untyped authlib
-# mypy: disable-error-code="import-untyped"
 import time
 from typing import Any, Dict, Optional
 
 import httpx
 from ariadne_codegen.client_generators.dependencies.base_client import BaseClient
-from authlib.integrations.httpx_client import OAuth2Client
 
+from fragment.client.oauth import fetch_token
 from fragment.exceptions import MissingArgumentException, MissingTokenException
 
 
@@ -35,14 +33,18 @@ class SyncFragmentClient(BaseClient):
         self.auth_url = auth_url
         self.expiration_time: Optional[float] = None
         self.token: Optional[Dict[str, Any]] = None
-        self.oauth2_client = OAuth2Client(client_id, client_secret, scope=auth_scope)
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.auth_scope = auth_scope
 
     def refresh_token(self) -> None:
         now = time.time()
         if self.expiration_time is None or self.expiration_time <= now:
             # Held in a local because `self.token` is declared `dict | None`,
             # so reading the attribute back is not narrowed by the assignment.
-            token = self.oauth2_client.fetch_token(self.auth_url)
+            token = fetch_token(
+                self.auth_url, self.client_id, self.client_secret, self.auth_scope
+            )
             self.token = token
             self.expiration_time = now + token["expires_in"]
 

fragment_python-1.4.1/fragment/exceptions.py

@@ -0,0 +1,24 @@
+from typing import Optional
+
+
+class MissingTokenException(ValueError):
+    """Token not found."""
+
+    def __init__(self) -> None:
+        super().__init__("Token is None")
+
+
+class MissingArgumentException(ValueError):
+    """Argument not present."""
+
+    def __init__(self, argument: str) -> None:
+        super().__init__(f"{argument} must be provided")
+
+
+class TokenRequestException(Exception):
+    """The auth endpoint did not return an access token."""
+
+    def __init__(self, error: str, description: Optional[str] = None) -> None:
+        self.error = error
+        self.description = description
+        super().__init__(f"{error}: {description}" if description else error)

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sdk/__init__.py

@@ -60,6 +60,7 @@ from .create_payment import (
     CreatePaymentCreatePaymentBadRequestError,
     CreatePaymentCreatePaymentCreatePaymentResult,
     CreatePaymentCreatePaymentCreatePaymentResultPayment,
+    CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency,
     CreatePaymentCreatePaymentInternalError,
 )
 from .delete_custom_txs import (
@@ -498,6 +499,7 @@ __all__ = [
     "CreatePaymentCreatePaymentBadRequestError",
     "CreatePaymentCreatePaymentCreatePaymentResult",
     "CreatePaymentCreatePaymentCreatePaymentResultPayment",
+    "CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency",
     "CreatePaymentCreatePaymentInternalError",
     "CreatePaymentInput",
     "CurrencyCode",

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sdk/async_client.py

@@ -1,7 +1,5 @@
 # Generated by fragment (with the help of ariadne-codegen)
 
-# Ignore untyped authlib
-# mypy: disable-error-code="import-untyped"
 import time
 from typing import Any, Dict, Optional
 
@@ -9,8 +7,8 @@ import httpx
 from ariadne_codegen.client_generators.dependencies.async_base_client import (
     AsyncBaseClient,
 )
-from authlib.integrations.httpx_client import AsyncOAuth2Client
 
+from fragment.client.oauth import fetch_token_async
 from fragment.exceptions import MissingArgumentException, MissingTokenException
 
 
@@ -39,16 +37,18 @@ class AsyncFragmentClient(AsyncBaseClient):
         self.auth_url = auth_url
         self.expiration_time: Optional[float] = None
         self.token: Optional[Dict[str, Any]] = None
-        self.oauth2_client = AsyncOAuth2Client(
-            client_id, client_secret, scope=auth_scope
-        )
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.auth_scope = auth_scope
 
     async def refresh_token(self) -> None:
         now = time.time()
         if self.expiration_time is None or self.expiration_time <= now:
             # Held in a local because `self.token` is declared `dict | None`,
             # so reading the attribute back is not narrowed by the assignment.
-            token = await self.oauth2_client.fetch_token(self.auth_url)
+            token = await fetch_token_async(
+                self.auth_url, self.client_id, self.client_secret, self.auth_scope
+            )
             self.token = token
             self.expiration_time = now + token["expires_in"]
 

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sdk/client.py

@@ -1858,8 +1858,15 @@ class Client(AsyncFragmentClient):
                 __typename
                 ... on CreatePaymentResult {
                   payment {
+                    id
+                    ik
                     clientSecret
                     status
+                    amount
+                    mode
+                    currency {
+                      code
+                    }
                   }
                 }
                 ... on BadRequestError {

{fragment_python-1.3.0/fragment/sync_sdk → fragment_python-1.4.1/fragment/sdk}/create_payment.py

@@ -1,12 +1,12 @@
 # Generated by fragment (with the help of ariadne-codegen)
 # Source: queries/
 
-from typing import Literal, Union
+from typing import Any, Literal, Union
 
 from pydantic import Field
 
 from .base_model import BaseModel
-from .enums import PaymentStatus
+from .enums import PaymentCurrencyCode, PaymentMode, PaymentStatus
 
 
 class CreatePayment(BaseModel):
@@ -30,8 +30,17 @@ class CreatePaymentCreatePaymentCreatePaymentResult(BaseModel):
 
 
 class CreatePaymentCreatePaymentCreatePaymentResultPayment(BaseModel):
+    id: str
+    ik: Any
     client_secret: str = Field(alias="clientSecret")
     status: PaymentStatus
+    amount: Any
+    mode: PaymentMode
+    currency: "CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency"
+
+
+class CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency(BaseModel):
+    code: PaymentCurrencyCode
 
 
 class CreatePaymentCreatePaymentInternalError(BaseModel):
@@ -43,3 +52,4 @@ class CreatePaymentCreatePaymentInternalError(BaseModel):
 
 CreatePayment.model_rebuild()
 CreatePaymentCreatePaymentCreatePaymentResult.model_rebuild()
+CreatePaymentCreatePaymentCreatePaymentResultPayment.model_rebuild()

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sdk/enums.py

@@ -271,7 +271,7 @@ class PaymentMode(str, Enum):
 
 
 class PaymentStatus(str, Enum):
-    approved = "approved"
+    accepted = "accepted"
     needs_payment_method = "needs_payment_method"
     processing = "processing"
     settled = "settled"

{fragment_python-1.3.0/fragment/sync_sdk → fragment_python-1.4.1/fragment/sdk}/input_types.py

@@ -606,6 +606,8 @@ class LedgerLinesFilterSet(BaseModel):
     "Filter by the currency of the Ledger Line."
     date: Optional["DateFilter"] = None
     "Use this filter to filter Ledger Lines by their `posted` date."
+    external_tx_ids: Optional[list[str]] = Field(alias="externalTxIds", default=None)
+    "Filter Ledger Lines by the external IDs of their linked transactions. Only supported on `LedgerAccount.lines` for a linked Ledger Account."
     is_reversal: Optional[bool] = Field(alias="isReversal", default=None)
     "Use this to filter Ledger Lines that were posted to this Ledger Account, using `reverseLedgerEntry`."
     is_reversed: Optional[bool] = Field(alias="isReversed", default=None)
@@ -648,7 +650,11 @@ class LedgersFilterSet(BaseModel):
 
 
 class LinkMatchInput(BaseModel):
-    id: str
+    """Specify a Link by ID, or a Custom Link by its creation IK."""
+
+    id: Optional[str] = None
+    ik: Optional[Any] = None
+    "The IK passed to createCustomLink. If id is also provided, both must identify the same Link."
 
 
 class MigrateLedgerEntryInput(BaseModel):
@@ -965,7 +971,7 @@ class SchemaPaymentAccountingInput(BaseModel):
     through its lifecycle, keyed by lifecycle transition."""
 
     initiated: Optional["SchemaPaymentEntryInput"] = None
-    "Posted when the payment is approved. Optional."
+    "Posted when the payment is captured. Optional."
     settled: "SchemaPaymentEntryInput"
     "Posted when the payment settles. Every Payment Type must define it."
 

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/std_queries/queries.graphql

@@ -1291,8 +1291,15 @@ mutation createPayment(
     __typename
     ... on CreatePaymentResult {
       payment {
+        id
+        ik
         clientSecret
         status
+        amount
+        mode
+        currency {
+          code
+        }
       }
     }
     ... on BadRequestError {

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sync_sdk/__init__.py

@@ -59,6 +59,7 @@ from .create_payment import (
     CreatePaymentCreatePaymentBadRequestError,
     CreatePaymentCreatePaymentCreatePaymentResult,
     CreatePaymentCreatePaymentCreatePaymentResultPayment,
+    CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency,
     CreatePaymentCreatePaymentInternalError,
 )
 from .delete_custom_txs import (
@@ -497,6 +498,7 @@ __all__ = [
     "CreatePaymentCreatePaymentBadRequestError",
     "CreatePaymentCreatePaymentCreatePaymentResult",
     "CreatePaymentCreatePaymentCreatePaymentResultPayment",
+    "CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency",
     "CreatePaymentCreatePaymentInternalError",
     "CreatePaymentInput",
     "CurrencyCode",

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sync_sdk/async_client.py

@@ -1,7 +1,5 @@
 # Generated by fragment (with the help of ariadne-codegen)
 
-# Ignore untyped authlib
-# mypy: disable-error-code="import-untyped"
 import time
 from typing import Any, Dict, Optional
 
@@ -9,8 +7,8 @@ import httpx
 from ariadne_codegen.client_generators.dependencies.async_base_client import (
     AsyncBaseClient,
 )
-from authlib.integrations.httpx_client import AsyncOAuth2Client
 
+from fragment.client.oauth import fetch_token_async
 from fragment.exceptions import MissingArgumentException, MissingTokenException
 
 
@@ -39,16 +37,18 @@ class AsyncFragmentClient(AsyncBaseClient):
         self.auth_url = auth_url
         self.expiration_time: Optional[float] = None
         self.token: Optional[Dict[str, Any]] = None
-        self.oauth2_client = AsyncOAuth2Client(
-            client_id, client_secret, scope=auth_scope
-        )
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.auth_scope = auth_scope
 
     async def refresh_token(self) -> None:
         now = time.time()
         if self.expiration_time is None or self.expiration_time <= now:
             # Held in a local because `self.token` is declared `dict | None`,
             # so reading the attribute back is not narrowed by the assignment.
-            token = await self.oauth2_client.fetch_token(self.auth_url)
+            token = await fetch_token_async(
+                self.auth_url, self.client_id, self.client_secret, self.auth_scope
+            )
             self.token = token
             self.expiration_time = now + token["expires_in"]
 

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sync_sdk/client.py

@@ -1852,8 +1852,15 @@ class Client(SyncFragmentClient):
                 __typename
                 ... on CreatePaymentResult {
                   payment {
+                    id
+                    ik
                     clientSecret
                     status
+                    amount
+                    mode
+                    currency {
+                      code
+                    }
                   }
                 }
                 ... on BadRequestError {

{fragment_python-1.3.0/fragment/sdk → fragment_python-1.4.1/fragment/sync_sdk}/create_payment.py

@@ -1,12 +1,12 @@
 # Generated by fragment (with the help of ariadne-codegen)
 # Source: queries/
 
-from typing import Literal, Union
+from typing import Any, Literal, Union
 
 from pydantic import Field
 
 from .base_model import BaseModel
-from .enums import PaymentStatus
+from .enums import PaymentCurrencyCode, PaymentMode, PaymentStatus
 
 
 class CreatePayment(BaseModel):
@@ -30,8 +30,17 @@ class CreatePaymentCreatePaymentCreatePaymentResult(BaseModel):
 
 
 class CreatePaymentCreatePaymentCreatePaymentResultPayment(BaseModel):
+    id: str
+    ik: Any
     client_secret: str = Field(alias="clientSecret")
     status: PaymentStatus
+    amount: Any
+    mode: PaymentMode
+    currency: "CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency"
+
+
+class CreatePaymentCreatePaymentCreatePaymentResultPaymentCurrency(BaseModel):
+    code: PaymentCurrencyCode
 
 
 class CreatePaymentCreatePaymentInternalError(BaseModel):
@@ -43,3 +52,4 @@ class CreatePaymentCreatePaymentInternalError(BaseModel):
 
 CreatePayment.model_rebuild()
 CreatePaymentCreatePaymentCreatePaymentResult.model_rebuild()
+CreatePaymentCreatePaymentCreatePaymentResultPayment.model_rebuild()

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sync_sdk/enums.py

@@ -271,7 +271,7 @@ class PaymentMode(str, Enum):
 
 
 class PaymentStatus(str, Enum):
-    approved = "approved"
+    accepted = "accepted"
     needs_payment_method = "needs_payment_method"
     processing = "processing"
     settled = "settled"

{fragment_python-1.3.0/fragment/sdk → fragment_python-1.4.1/fragment/sync_sdk}/input_types.py

@@ -606,6 +606,8 @@ class LedgerLinesFilterSet(BaseModel):
     "Filter by the currency of the Ledger Line."
     date: Optional["DateFilter"] = None
     "Use this filter to filter Ledger Lines by their `posted` date."
+    external_tx_ids: Optional[list[str]] = Field(alias="externalTxIds", default=None)
+    "Filter Ledger Lines by the external IDs of their linked transactions. Only supported on `LedgerAccount.lines` for a linked Ledger Account."
     is_reversal: Optional[bool] = Field(alias="isReversal", default=None)
     "Use this to filter Ledger Lines that were posted to this Ledger Account, using `reverseLedgerEntry`."
     is_reversed: Optional[bool] = Field(alias="isReversed", default=None)
@@ -648,7 +650,11 @@ class LedgersFilterSet(BaseModel):
 
 
 class LinkMatchInput(BaseModel):
-    id: str
+    """Specify a Link by ID, or a Custom Link by its creation IK."""
+
+    id: Optional[str] = None
+    ik: Optional[Any] = None
+    "The IK passed to createCustomLink. If id is also provided, both must identify the same Link."
 
 
 class MigrateLedgerEntryInput(BaseModel):
@@ -965,7 +971,7 @@ class SchemaPaymentAccountingInput(BaseModel):
     through its lifecycle, keyed by lifecycle transition."""
 
     initiated: Optional["SchemaPaymentEntryInput"] = None
-    "Posted when the payment is approved. Optional."
+    "Posted when the payment is captured. Optional."
     settled: "SchemaPaymentEntryInput"
     "Posted when the payment settles. Every Payment Type must define it."
 

{fragment_python-1.3.0 → fragment_python-1.4.1}/fragment/sync_sdk/sync_client.py

@@ -1,14 +1,12 @@
 # Generated by fragment (with the help of ariadne-codegen)
 
-# Ignore untyped authlib
-# mypy: disable-error-code="import-untyped"
 import time
 from typing import Any, Dict, Optional
 
 import httpx
 from ariadne_codegen.client_generators.dependencies.base_client import BaseClient
-from authlib.integrations.httpx_client import OAuth2Client
 
+from fragment.client.oauth import fetch_token
 from fragment.exceptions import MissingArgumentException, MissingTokenException
 
 
@@ -37,14 +35,18 @@ class SyncFragmentClient(BaseClient):
         self.auth_url = auth_url
         self.expiration_time: Optional[float] = None
         self.token: Optional[Dict[str, Any]] = None
-        self.oauth2_client = OAuth2Client(client_id, client_secret, scope=auth_scope)
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.auth_scope = auth_scope
 
     def refresh_token(self) -> None:
         now = time.time()
         if self.expiration_time is None or self.expiration_time <= now:
             # Held in a local because `self.token` is declared `dict | None`,
             # so reading the attribute back is not narrowed by the assignment.
-            token = self.oauth2_client.fetch_token(self.auth_url)
+            token = fetch_token(
+                self.auth_url, self.client_id, self.client_secret, self.auth_scope
+            )
             self.token = token
             self.expiration_time = now + token["expires_in"]
 

{fragment_python-1.3.0 → fragment_python-1.4.1}/pyproject.toml

@@ -5,7 +5,7 @@ target_package_name = "fragment_graphql_client"
 
 [tool.poetry]
 name = "fragment-python"
-version = "1.3.0"
+version = "1.4.1"
 description = "Python SDK for https://fragment.dev/"
 authors = ["Fragment Foundries Inc"]
 license = "Apache 2.0"
@@ -18,7 +18,6 @@ ariadne-codegen = "^0.17.2"
 requests-oauth2client = "^1.6.0"
 pydantic = "^2.8.0"
 httpx = "^0.28.1"
-authlib = "^1.6.12"
 graphql-core = "^3.2.3"
 click = "^8.1.7"
 
@@ -27,8 +26,8 @@ pylint = "^3.2.6"
 black = "^26.3.1"
 isort = "^5.13.2"
 mypy = "^1.11.2"
-pytest = "^8.3.2"
-pytest-asyncio = "^0.24.0"
+pytest = "^9.0.3"
+pytest-asyncio = "^1.4.0"
 
 [build-system]
 requires = ["poetry-core"]

fragment_python-1.3.0/fragment/exceptions.py

@@ -1,12 +0,0 @@
-class MissingTokenException(ValueError):
-    """Token not found."""
-
-    def __init__(self) -> None:
-        super().__init__("Token is None")
-
-
-class MissingArgumentException(ValueError):
-    """Argument not present."""
-
-    def __init__(self, argument: str) -> None:
-        super().__init__(f"{argument} must be provided")