finance_dev 0.9.0__py3-none-any.whl

finance_dev/errors/__init__.py

@@ -0,0 +1,94 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 86b4b90e1b9a
+
+from .financedevapierror import FinanceDevAPIError
+from typing import Any, TYPE_CHECKING
+
+from finance_dev.utils.dynamic_imports import lazy_getattr, lazy_dir
+
+if TYPE_CHECKING:
+    from .apierror import APIError
+    from .authenticationerrorenvelope import (
+        AuthenticationErrorEnvelope,
+        AuthenticationErrorEnvelopeData,
+    )
+    from .badrequest import BadRequest, BadRequestUnion
+    from .errorenvelope import ErrorEnvelope, ErrorEnvelopeData
+    from .errorresponse import ErrorResponse, ErrorResponseData
+    from .forbidden import Forbidden, ForbiddenUnion
+    from .internalservererror import InternalServerError, InternalServerErrorUnion
+    from .no_response_error import NoResponseError
+    from .notfound import NotFound, NotFoundUnion
+    from .orderhistorybadrequest import (
+        OrderHistoryBadRequest,
+        OrderHistoryBadRequestUnion,
+    )
+    from .predorderserrorenvelope import (
+        PredOrdersErrorEnvelope,
+        PredOrdersErrorEnvelopeData,
+    )
+    from .responsevalidationerror import ResponseValidationError
+    from .unauthorized import Unauthorized, UnauthorizedUnion
+
+__all__ = [
+    "APIError",
+    "AuthenticationErrorEnvelope",
+    "AuthenticationErrorEnvelopeData",
+    "BadRequest",
+    "BadRequestUnion",
+    "ErrorEnvelope",
+    "ErrorEnvelopeData",
+    "ErrorResponse",
+    "ErrorResponseData",
+    "FinanceDevAPIError",
+    "Forbidden",
+    "ForbiddenUnion",
+    "InternalServerError",
+    "InternalServerErrorUnion",
+    "NoResponseError",
+    "NotFound",
+    "NotFoundUnion",
+    "OrderHistoryBadRequest",
+    "OrderHistoryBadRequestUnion",
+    "PredOrdersErrorEnvelope",
+    "PredOrdersErrorEnvelopeData",
+    "ResponseValidationError",
+    "Unauthorized",
+    "UnauthorizedUnion",
+]
+
+_dynamic_imports: dict[str, str] = {
+    "APIError": ".apierror",
+    "AuthenticationErrorEnvelope": ".authenticationerrorenvelope",
+    "AuthenticationErrorEnvelopeData": ".authenticationerrorenvelope",
+    "BadRequest": ".badrequest",
+    "BadRequestUnion": ".badrequest",
+    "ErrorEnvelope": ".errorenvelope",
+    "ErrorEnvelopeData": ".errorenvelope",
+    "ErrorResponse": ".errorresponse",
+    "ErrorResponseData": ".errorresponse",
+    "Forbidden": ".forbidden",
+    "ForbiddenUnion": ".forbidden",
+    "InternalServerError": ".internalservererror",
+    "InternalServerErrorUnion": ".internalservererror",
+    "NoResponseError": ".no_response_error",
+    "NotFound": ".notfound",
+    "NotFoundUnion": ".notfound",
+    "OrderHistoryBadRequest": ".orderhistorybadrequest",
+    "OrderHistoryBadRequestUnion": ".orderhistorybadrequest",
+    "PredOrdersErrorEnvelope": ".predorderserrorenvelope",
+    "PredOrdersErrorEnvelopeData": ".predorderserrorenvelope",
+    "ResponseValidationError": ".responsevalidationerror",
+    "Unauthorized": ".unauthorized",
+    "UnauthorizedUnion": ".unauthorized",
+}
+
+
+def __getattr__(attr_name: str) -> Any:
+    return lazy_getattr(
+        attr_name, package=__package__, dynamic_imports=_dynamic_imports
+    )
+
+
+def __dir__():
+    return lazy_dir(dynamic_imports=_dynamic_imports)

finance_dev/errors/apierror.py

@@ -0,0 +1,41 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 4ac18a85ec3d
+
+import httpx
+from typing import Optional
+from dataclasses import dataclass
+
+from finance_dev.errors import FinanceDevAPIError
+
+MAX_MESSAGE_LEN = 10_000
+
+
+@dataclass(unsafe_hash=True)
+class APIError(FinanceDevAPIError):
+    """The fallback error class if no more specific error class is matched."""
+
+    def __init__(
+        self, message: str, raw_response: httpx.Response, body: Optional[str] = None
+    ):
+        body_display = body or raw_response.text or '""'
+
+        if message:
+            message += ": "
+        message += f"Status {raw_response.status_code}"
+
+        headers = raw_response.headers
+        content_type = headers.get("content-type", '""')
+        if content_type != "application/json":
+            if " " in content_type:
+                content_type = f'"{content_type}"'
+            message += f" Content-Type {content_type}"
+
+        if len(body_display) > MAX_MESSAGE_LEN:
+            truncated = body_display[:MAX_MESSAGE_LEN]
+            remaining = len(body_display) - MAX_MESSAGE_LEN
+            body_display = f"{truncated}...and {remaining} more chars"
+
+        message += f". Body: {body_display}"
+        message = message.strip()
+
+        super().__init__(message, raw_response, body)

finance_dev/errors/authenticationerrorenvelope.py

@@ -0,0 +1,43 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: c2eada24e575
+
+from __future__ import annotations
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+from finance_dev.models import (
+    authenticationerrordetail as models_authenticationerrordetail,
+    httpmetadata as models_httpmetadata,
+)
+from finance_dev.types import BaseModel
+import httpx
+import pydantic
+from typing import Any, Dict, Optional
+from typing_extensions import Annotated
+
+
+class AuthenticationErrorEnvelopeData(BaseModel):
+    http_meta: Annotated[
+        Optional[models_httpmetadata.HTTPMetadata], pydantic.Field(exclude=True)
+    ] = None
+    error: Optional[models_authenticationerrordetail.AuthenticationErrorDetail] = None
+    r"""Structured payload for the nested `error` object. Services using the shared Go error writer emit uppercase `type` values aligned with error categories (for example `VALIDATION`, `BAD_REQUEST`, `AUTHENTICATION`, `AUTHORIZATION`, `NOT_FOUND`, `RATE_LIMIT`, `INTERNAL`)."""
+    meta: Optional[Dict[str, Any]] = None
+    r"""Optional metadata"""
+
+
+@dataclass(unsafe_hash=True)
+class AuthenticationErrorEnvelope(FinanceDevAPIError):
+    r"""JSON envelope where `error` is a nested object (`type`, `code`, `message`, …). Many services use this shape for 400, 401, 403, 404, and 5xx when using the shared HTTP error format."""
+
+    data: AuthenticationErrorEnvelopeData = field(hash=False)
+
+    def __init__(
+        self,
+        data: AuthenticationErrorEnvelopeData,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        fallback = body or raw_response.text
+        message = str(data.error.message) if data.error else fallback
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/badrequest.py

@@ -0,0 +1,34 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: b1aa53599740
+
+from __future__ import annotations
+from .authenticationerrorenvelope import AuthenticationErrorEnvelopeData
+from .errorresponse import ErrorResponseData
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+import httpx
+from typing import Optional, Union
+from typing_extensions import TypeAliasType
+
+
+BadRequestUnion = TypeAliasType(
+    "BadRequestUnion", Union[AuthenticationErrorEnvelopeData, ErrorResponseData]
+)
+r"""400 responses commonly use a nested `error` object (`type`, `code`, `message`, optional `details`). Some services still return flat `ErrorResponse` (`error` string, optional `codes`)."""
+
+
+@dataclass(unsafe_hash=True)
+class BadRequest(FinanceDevAPIError):
+    r"""400 responses commonly use a nested `error` object (`type`, `code`, `message`, optional `details`). Some services still return flat `ErrorResponse` (`error` string, optional `codes`)."""
+
+    data: BadRequestUnion = field(hash=False)
+
+    def __init__(
+        self,
+        data: BadRequestUnion,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        message = body or raw_response.text
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/errorenvelope.py

@@ -0,0 +1,42 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 9fb3d883c9fb
+
+from __future__ import annotations
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+from finance_dev.models import (
+    apperror as models_apperror,
+    httpmetadata as models_httpmetadata,
+)
+from finance_dev.types import BaseModel
+import httpx
+import pydantic
+from typing import Optional
+from typing_extensions import Annotated
+
+
+class ErrorEnvelopeData(BaseModel):
+    error: models_apperror.AppError
+    r"""Structured application error returned inside an `ErrorEnvelope`."""
+    success: bool
+    http_meta: Annotated[
+        Optional[models_httpmetadata.HTTPMetadata], pydantic.Field(exclude=True)
+    ] = None
+
+
+@dataclass(unsafe_hash=True)
+class ErrorEnvelope(FinanceDevAPIError):
+    r"""Prediction-market error envelope. Returned by historical-data and prediction-market reference endpoints on 400/404/500/502."""
+
+    data: ErrorEnvelopeData = field(hash=False)
+
+    def __init__(
+        self,
+        data: ErrorEnvelopeData,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        fallback = body or raw_response.text
+        message = str(data.error.message) or fallback
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/errorresponse.py

@@ -0,0 +1,45 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: ffc5d56f8ff7
+
+from __future__ import annotations
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+from finance_dev.models import (
+    errorcode as models_errorcode,
+    httpmetadata as models_httpmetadata,
+)
+from finance_dev.types import BaseModel
+import httpx
+import pydantic
+from typing import Any, Dict, List, Optional
+from typing_extensions import Annotated
+
+
+class ErrorResponseData(BaseModel):
+    http_meta: Annotated[
+        Optional[models_httpmetadata.HTTPMetadata], pydantic.Field(exclude=True)
+    ] = None
+    codes: Optional[List[models_errorcode.ErrorCode]] = None
+    r"""Structured error codes for programmatic handling"""
+    error: Optional[str] = None
+    r"""Error detail as a string. Exact message content is not fixed and should not be hard-coded."""
+    metadata: Optional[Dict[str, Any]] = None
+    r"""Additional error context"""
+
+
+@dataclass(unsafe_hash=True)
+class ErrorResponse(FinanceDevAPIError):
+    r"""Flat error body: an `error` string, with optional structured `codes` and additional `metadata`."""
+
+    data: ErrorResponseData = field(hash=False)
+
+    def __init__(
+        self,
+        data: ErrorResponseData,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        fallback = body or raw_response.text
+        message = str(data.error) or fallback
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/financedevapierror.py

@@ -0,0 +1,31 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: fbb7cb7569fb
+
+import httpx
+from typing import Optional
+from dataclasses import dataclass, field
+
+
+@dataclass(unsafe_hash=True)
+class FinanceDevAPIError(Exception):
+    """The base class for all HTTP error responses."""
+
+    message: str
+    status_code: int
+    body: str
+    headers: httpx.Headers = field(hash=False)
+    raw_response: httpx.Response = field(hash=False)
+
+    def __init__(
+        self, message: str, raw_response: httpx.Response, body: Optional[str] = None
+    ):
+        object.__setattr__(self, "message", message)
+        object.__setattr__(self, "status_code", raw_response.status_code)
+        object.__setattr__(
+            self, "body", body if body is not None else raw_response.text
+        )
+        object.__setattr__(self, "headers", raw_response.headers)
+        object.__setattr__(self, "raw_response", raw_response)
+
+    def __str__(self):
+        return self.message

finance_dev/errors/forbidden.py

@@ -0,0 +1,34 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 2d2f7100981d
+
+from __future__ import annotations
+from .authenticationerrorenvelope import AuthenticationErrorEnvelopeData
+from .errorresponse import ErrorResponseData
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+import httpx
+from typing import Optional, Union
+from typing_extensions import TypeAliasType
+
+
+ForbiddenUnion = TypeAliasType(
+    "ForbiddenUnion", Union[ErrorResponseData, AuthenticationErrorEnvelopeData]
+)
+r"""403 responses may use a flat or nested error shape."""
+
+
+@dataclass(unsafe_hash=True)
+class Forbidden(FinanceDevAPIError):
+    r"""403 responses may use a flat or nested error shape."""
+
+    data: ForbiddenUnion = field(hash=False)
+
+    def __init__(
+        self,
+        data: ForbiddenUnion,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        message = body or raw_response.text
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/internalservererror.py

@@ -0,0 +1,35 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 3e7657d6c17f
+
+from __future__ import annotations
+from .authenticationerrorenvelope import AuthenticationErrorEnvelopeData
+from .errorresponse import ErrorResponseData
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+import httpx
+from typing import Optional, Union
+from typing_extensions import TypeAliasType
+
+
+InternalServerErrorUnion = TypeAliasType(
+    "InternalServerErrorUnion",
+    Union[ErrorResponseData, AuthenticationErrorEnvelopeData],
+)
+r"""5xx responses may use a flat or nested error shape."""
+
+
+@dataclass(unsafe_hash=True)
+class InternalServerError(FinanceDevAPIError):
+    r"""5xx responses may use a flat or nested error shape."""
+
+    data: InternalServerErrorUnion = field(hash=False)
+
+    def __init__(
+        self,
+        data: InternalServerErrorUnion,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        message = body or raw_response.text
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/no_response_error.py

@@ -0,0 +1,18 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 144798d156da
+
+from dataclasses import dataclass
+
+
+@dataclass(unsafe_hash=True)
+class NoResponseError(Exception):
+    """Error raised when no HTTP response is received from the server."""
+
+    message: str
+
+    def __init__(self, message: str = "No response received"):
+        object.__setattr__(self, "message", message)
+        super().__init__(message)
+
+    def __str__(self):
+        return self.message

finance_dev/errors/notfound.py

@@ -0,0 +1,34 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: bf844adb69d2
+
+from __future__ import annotations
+from .authenticationerrorenvelope import AuthenticationErrorEnvelopeData
+from .errorresponse import ErrorResponseData
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+import httpx
+from typing import Optional, Union
+from typing_extensions import TypeAliasType
+
+
+NotFoundUnion = TypeAliasType(
+    "NotFoundUnion", Union[ErrorResponseData, AuthenticationErrorEnvelopeData]
+)
+r"""404 responses may use a flat or nested error shape."""
+
+
+@dataclass(unsafe_hash=True)
+class NotFound(FinanceDevAPIError):
+    r"""404 responses may use a flat or nested error shape."""
+
+    data: NotFoundUnion = field(hash=False)
+
+    def __init__(
+        self,
+        data: NotFoundUnion,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        message = body or raw_response.text
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/orderhistorybadrequest.py

@@ -0,0 +1,35 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: bf69f58e8e0c
+
+from __future__ import annotations
+from .authenticationerrorenvelope import AuthenticationErrorEnvelopeData
+from .errorresponse import ErrorResponseData
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+import httpx
+from typing import Optional, Union
+from typing_extensions import TypeAliasType
+
+
+OrderHistoryBadRequestUnion = TypeAliasType(
+    "OrderHistoryBadRequestUnion",
+    Union[ErrorResponseData, AuthenticationErrorEnvelopeData],
+)
+r"""Bad request: missing or invalid `from`/`to`, range over 90 days, or invalid `order_by`, returned as a flat `ErrorResponse` (`error` string). Account-ID path validation failures return the nested error envelope."""
+
+
+@dataclass(unsafe_hash=True)
+class OrderHistoryBadRequest(FinanceDevAPIError):
+    r"""Bad request: missing or invalid `from`/`to`, range over 90 days, or invalid `order_by`, returned as a flat `ErrorResponse` (`error` string). Account-ID path validation failures return the nested error envelope."""
+
+    data: OrderHistoryBadRequestUnion = field(hash=False)
+
+    def __init__(
+        self,
+        data: OrderHistoryBadRequestUnion,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        message = body or raw_response.text
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/predorderserrorenvelope.py

@@ -0,0 +1,42 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 610fbbbb210f
+
+from __future__ import annotations
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+from finance_dev.models import (
+    httpmetadata as models_httpmetadata,
+    predordersapperror as models_predordersapperror,
+)
+from finance_dev.types import BaseModel
+import httpx
+import pydantic
+from typing import Optional
+from typing_extensions import Annotated
+
+
+class PredOrdersErrorEnvelopeData(BaseModel):
+    error: models_predordersapperror.PredOrdersAppError
+    r"""Structured error returned by the prediction-market order endpoints."""
+    success: bool
+    http_meta: Annotated[
+        Optional[models_httpmetadata.HTTPMetadata], pydantic.Field(exclude=True)
+    ] = None
+
+
+@dataclass(unsafe_hash=True)
+class PredOrdersErrorEnvelope(FinanceDevAPIError):
+    r"""Invalid request. `INVALID_ORDER` carries the reason in `message`; on placement this includes refusals from order entry and the venue (price, tick size, account setup)."""
+
+    data: PredOrdersErrorEnvelopeData = field(hash=False)
+
+    def __init__(
+        self,
+        data: PredOrdersErrorEnvelopeData,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        fallback = body or raw_response.text
+        message = str(data.error.message) or fallback
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)

finance_dev/errors/responsevalidationerror.py

@@ -0,0 +1,28 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: bc22467068db
+
+import httpx
+from typing import Optional
+from dataclasses import dataclass
+
+from finance_dev.errors import FinanceDevAPIError
+
+
+@dataclass(unsafe_hash=True)
+class ResponseValidationError(FinanceDevAPIError):
+    """Error raised when there is a type mismatch between the response data and the expected Pydantic model."""
+
+    def __init__(
+        self,
+        message: str,
+        raw_response: httpx.Response,
+        cause: Exception,
+        body: Optional[str] = None,
+    ):
+        message = f"{message}: {cause}"
+        super().__init__(message, raw_response, body)
+
+    @property
+    def cause(self):
+        """Normally the Pydantic ValidationError"""
+        return self.__cause__

finance_dev/errors/unauthorized.py

@@ -0,0 +1,34 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: da48252d44a2
+
+from __future__ import annotations
+from .authenticationerrorenvelope import AuthenticationErrorEnvelopeData
+from .errorresponse import ErrorResponseData
+from dataclasses import dataclass, field
+from finance_dev.errors import FinanceDevAPIError
+import httpx
+from typing import Optional, Union
+from typing_extensions import TypeAliasType
+
+
+UnauthorizedUnion = TypeAliasType(
+    "UnauthorizedUnion", Union[ErrorResponseData, AuthenticationErrorEnvelopeData]
+)
+r"""401 responses may use a flat `ErrorResponse` shape or a nested `error` object. Inspect `error`: if it is a string, use the flat shape; if it is an object, use the structured shape."""
+
+
+@dataclass(unsafe_hash=True)
+class Unauthorized(FinanceDevAPIError):
+    r"""401 responses may use a flat `ErrorResponse` shape or a nested `error` object. Inspect `error`: if it is a string, use the flat shape; if it is an object, use the structured shape."""
+
+    data: UnauthorizedUnion = field(hash=False)
+
+    def __init__(
+        self,
+        data: UnauthorizedUnion,
+        raw_response: httpx.Response,
+        body: Optional[str] = None,
+    ):
+        message = body or raw_response.text
+        super().__init__(message, raw_response, body)
+        object.__setattr__(self, "data", data)