boarddata 4.1.3__tar.gz → 4.2.2__tar.gz

{boarddata-4.1.3 → boarddata-4.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boarddata
-Version: 4.1.3
+Version: 4.2.2
 Summary: Python SDK for the BoardData V2 REST API
 License: MIT
 Classifier: Development Status :: 4 - Beta

{boarddata-4.1.3 → boarddata-4.2.2}/__init__.py

@@ -7,7 +7,7 @@ from .errors import BoardDataError
 
 from . import types as types  # noqa: F401 — makes types accessible as boarddata.types
 
-__version__ = "4.1.3"
+__version__ = "4.2.2"
 __all__ = [
     "Base",
     "BoardDataClient",

{boarddata-4.1.3 → boarddata-4.2.2}/_companies.py

@@ -5,7 +5,12 @@ from __future__ import annotations
 import logging
 from typing import Any
 
-from .types.companies import CompanyDetail, CompanyListItem, TemporalAttributePayload
+from .types.companies import (
+    CompanyDetail,
+    CompanyListItem,
+    CompanyResolveResult,
+    TemporalAttributePayload,
+)
 from .types.core import AddressPayload, FieldSourcePayload, PaginatedResponse, UpsertResult
 
 logger = logging.getLogger("boarddata")
@@ -253,6 +258,48 @@ class CompanyMixin:
         results = resp.get("results", []) if isinstance(resp, dict) else resp
         return results[0] if results else None
 
+    def resolve_company(
+        self,
+        *,
+        ticker: str | None = None,
+        isin: str | None = None,
+        exchange: str | None = None,
+    ) -> CompanyResolveResult | None:
+        """Resolve a company by ticker and/or ISIN.
+
+        Cascading resolution: DB → OpenFIGI → Perplexity.
+        At least one of ticker or isin is required.
+
+        Args:
+            ticker: Stock ticker symbol (e.g. ``"TTE"``).
+            isin: ISIN identifier (e.g. ``"FR0000120271"``).
+            exchange: Optional OpenFIGI exchange code (e.g. ``"FP"`` for
+                Euronext Paris) to disambiguate short tickers.
+
+        Returns:
+            CompanyResolveResult if found, or ``None`` if not found.
+
+        Raises:
+            BoardDataError: On non-2xx API response (except 404).
+            ValueError: If neither ticker nor isin is provided.
+        """
+        if not ticker and not isin:
+            raise ValueError("Provide at least one of: ticker, isin")
+
+        from .errors import BoardDataError
+
+        try:
+            return self._get(  # type: ignore[attr-defined]
+                "companies/resolve/",
+                ticker=ticker,
+                isin=isin,
+                exchange=exchange,
+            )
+        except BoardDataError as exc:
+            if exc.status_code == 404:
+                return None
+            raise
+
     def upsert_company(
         self,
         isin: str,

{boarddata-4.1.3 → boarddata-4.2.2}/boarddata.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boarddata
-Version: 4.1.3
+Version: 4.2.2
 Summary: Python SDK for the BoardData V2 REST API
 License: MIT
 Classifier: Development Status :: 4 - Beta

{boarddata-4.1.3 → boarddata-4.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "boarddata"
-version = "4.1.3"
+version = "4.2.2"
 description = "Python SDK for the BoardData V2 REST API"
 readme = "README.md"
 license = {text = "MIT"}

{boarddata-4.1.3 → boarddata-4.2.2}/types/companies.py

@@ -68,6 +68,15 @@ class UpdateCompanyPayload(TypedDict, total=False):
     field_sources: list[FieldSourcePayload]
 
 
+class CompanyResolveResult(TypedDict):
+    id: str
+    name: str
+    isin: str
+    ticker: str
+    country: str
+    logo: str
+
+
 class CompanyListItem(TypedDict):
     id: str
     name: str