laplace-python-sdk 0.4.0__tar.gz → 1.1.0__tar.gz

{laplace_python_sdk-0.4.0/src/laplace_python_sdk.egg-info → laplace_python_sdk-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: laplace-python-sdk
-Version: 0.4.0
+Version: 1.1.0
 Summary: Python SDK for Laplace stock data platform
 Author: Laplace SDK Team
 License: MIT

{laplace_python_sdk-0.4.0 → laplace_python_sdk-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "laplace-python-sdk"
-version = "0.4.0"
+version = "1.1.0"
 description = "Python SDK for Laplace stock data platform"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -64,14 +64,14 @@ profile = "black"
 line_length = 100
 
 [tool.mypy]
-python_version = "0.4.0"
+python_version = "1.1.0"
 strict = true
 warn_return_any = true
 warn_unused_configs = true
 
 [tool.ruff]
 line-length = 100
-target-version = "0.4.0"
+target-version = "1.1.0"
 select = ["E", "W", "F", "I", "N", "B", "UP"]
 ignore = ["B008", "N805"]
 

{laplace_python_sdk-0.4.0 → laplace_python_sdk-1.1.0}/src/laplace/base.py

@@ -39,7 +39,7 @@ class BaseClient:
         self.base_url = base_url.rstrip("/")
         self._client = httpx.Client(
             headers={
-                "User-Agent": "laplace-python-sdk/0.1.0",
+                "User-Agent": "laplace-python-sdk/1.0.0",
             },
             timeout=30.0,
         )
@@ -119,3 +119,33 @@ class BaseClient:
     def delete(self, endpoint: str) -> Dict[str, Any]:
         """Make a DELETE request."""
         return self._request("DELETE", endpoint)
+
+    def patch(self, endpoint: str, json: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """Make a PATCH request."""
+        return self._request("PATCH", endpoint, json=json)
+
+    def get_bytes(self, endpoint: str, params: Optional[Dict[str, Any]] = None) -> bytes:
+        """Make a GET request and return raw bytes."""
+        url = f"{self.base_url}/{endpoint.lstrip('/')}"
+
+        if params is None:
+            params = {}
+        params["api_key"] = self.api_key
+
+        try:
+            response = self._client.request(method="GET", url=url, params=params)
+            response.raise_for_status()
+            return response.content
+        except httpx.HTTPStatusError as e:
+            try:
+                error_data = e.response.json()
+            except Exception:
+                error_data = {"error": e.response.text}
+
+            raise LaplaceAPIError(
+                message=f"API request failed: {e.response.status_code} {e.response.reason_phrase}",
+                status_code=e.response.status_code,
+                response=error_data,
+            ) from e
+        except httpx.RequestError as e:
+            raise LaplaceAPIError(f"Request failed: {str(e)}") from e

{laplace_python_sdk-0.4.0 → laplace_python_sdk-1.1.0}/src/laplace/brokers.py

@@ -1,16 +1,17 @@
 """Brokers client for Laplace API."""
 
 from datetime import datetime
+from typing import Optional
 
 from laplace.base import BaseClient
 
 from .models import (
+    AssetClass,
     Broker,
+    BrokerList,
     PaginationPageSize,
     Region,
-    BrokerMarketData,
-    BrokerStockData,
-    BrokerSortDirection,
+    SortDirection,
     BrokerSort,
     PaginatedResponse,
 )
@@ -32,6 +33,7 @@ class BrokersClient:
         region: Region = Region.TR,
         page: int = 0,
         size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
+        asset_class: Optional[AssetClass] = None
     ) -> PaginatedResponse[Broker]:
         """Retrieve all brokers.
 
@@ -47,6 +49,9 @@ class BrokersClient:
 
         params = {"region": region.value, "page": page, "size": size.value}
 
+        if asset_class:
+            params["assetClass"] = asset_class.value
+
         response = self._client.get("v1/brokers", params=params)
         return PaginatedResponse[Broker](**response)
 
@@ -55,12 +60,12 @@ class BrokersClient:
         symbol: str,
         region: Region,
         sort_by: BrokerSort,
-        sort_direction: BrokerSortDirection,
+        sort_direction: SortDirection,
         from_date: datetime,
         to_date: datetime,
         page: int = 0,
         size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
-    ) -> BrokerStockData:
+    ) -> BrokerList:
         """Retrieve broker information by symbol.
 
         Args:
@@ -73,7 +78,7 @@ class BrokersClient:
             page: Page number (default: 0)
             size: Page size (default: 10)
         Returns:
-            BrokerStockData: Broker information
+            BrokerList: Broker information
         """
         if region != Region.TR:
             raise ValueError("Broker endpoint only works with the 'tr' region")
@@ -89,18 +94,18 @@ class BrokersClient:
         }
 
         response = self._client.get(f"v1/brokers/stock/{symbol}", params=params)
-        return BrokerStockData(**response)
+        return BrokerList(**response)
 
     def get_broker_list_for_market(
         self,
         region: Region,
         sort_by: BrokerSort,
-        sort_direction: BrokerSortDirection,
+        sort_direction: SortDirection,
         from_date: datetime,
         to_date: datetime,
         page: int = 0,
         size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
-    ) -> BrokerMarketData:
+    ) -> BrokerList:
         """Retrieve broker market data.
 
         Args:
@@ -113,7 +118,7 @@ class BrokersClient:
             size: Page size (default: 10)
 
         Returns:
-            BrokerStockData: Broker market data
+            BrokerList: Broker market data
         """
         if region != Region.TR:
             raise ValueError("Broker market endpoint only works with the 'tr' region")
@@ -129,19 +134,19 @@ class BrokersClient:
         }
 
         response = self._client.get("v1/brokers/market", params=params)
-        return BrokerMarketData(**response)
+        return BrokerList(**response)
 
     def get_broker_list_for_stock(
         self,
         symbol: str,
         region: Region,
         sort_by: BrokerSort,
-        sort_direction: BrokerSortDirection,
+        sort_direction: SortDirection,
         from_date: datetime,
         to_date: datetime,
         page: int = 0,
         size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
-    ) -> BrokerMarketData:
+    ) -> BrokerList:
         """Retrieve stock data for a specific broker.
 
         Args:
@@ -155,7 +160,7 @@ class BrokersClient:
             size: Page size (default: 10)
 
         Returns:
-            BrokerStockData: Stock data for the broker
+            BrokerList: Stock data for the broker
         """
         if region != Region.TR:
             raise ValueError("Broker stock endpoint only works with the 'tr' region")
@@ -171,18 +176,18 @@ class BrokersClient:
         }
 
         response = self._client.get(f"v1/brokers/{symbol}", params=params)
-        return BrokerMarketData(**response)
+        return BrokerList(**response)
 
     def get_stock_list_for_market(
         self,
         region: Region,
         sort_by: BrokerSort,
-        sort_direction: BrokerSortDirection,
+        sort_direction: SortDirection,
         from_date: datetime,
         to_date: datetime,
         page: int = 0,
         size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
-    ) -> BrokerStockData:
+    ) -> BrokerList:
         """Retrieve market stock data for brokers.
 
         Args:
@@ -195,7 +200,7 @@ class BrokersClient:
             size: Page size (default: 10)
 
         Returns:
-            BrokerStockData: Market stock data for brokers
+            BrokerList: Market stock data for brokers
         """
         if region != Region.TR:
             raise ValueError("Broker market stock endpoint only works with the 'tr' region")
@@ -211,4 +216,4 @@ class BrokersClient:
         }
 
         response = self._client.get("v1/brokers/market/stock", params=params)
-        return BrokerStockData(**response)
+        return BrokerList(**response)

{laplace_python_sdk-0.4.0 → laplace_python_sdk-1.1.0}/src/laplace/capital_increase.py

@@ -1,6 +1,7 @@
 """Capital Increase client for Laplace API."""
 
-from typing import List
+from datetime import datetime
+from typing import List, Optional
 from laplace.base import BaseClient
 
 from .models import (
@@ -53,7 +54,7 @@ class CapitalIncreaseClient:
         page: int = 0,
         size: PaginationPageSize = PaginationPageSize.PAGE_SIZE_10,
     ) -> PaginatedResponse[CapitalIncrease]:
-        """Retrieve capital increase information by ID.
+        """Retrieve capital increase information by symbol.
 
         Args:
             symbol: Stock symbol (e.g., "AKBNK")
@@ -72,20 +73,20 @@ class CapitalIncreaseClient:
         response = self._client.get(f"v1/capital-increase/{symbol}", params=params)
         return PaginatedResponse[CapitalIncrease](**response)
 
-    def get_active_rights(self, symbol: str, region: Region = Region.TR) -> List[CapitalIncrease]:
+    def get_active_rights(self, symbol: str, date: Optional[datetime] = None) -> List[CapitalIncrease]:
         """Retrieve active rights for a specific stock.
 
         Args:
             symbol: Stock symbol (e.g., "AKBNK")
-            region: Region code (only 'tr' is supported) (default: tr)
+            date: Optional date filter (defaults to today on the server)
 
         Returns:
             List[CapitalIncrease]: Active rights data
         """
-        if region != Region.TR:
-            raise ValueError("Rights endpoint only works with the 'tr' region")
+        params = {}
 
-        params = {"region": region.value}
+        if date is not None:
+            params["date"] = date.strftime("%Y-%m-%d")
 
         response = self._client.get(f"v1/rights/active/{symbol}", params=params)
 

{laplace_python_sdk-0.4.0 → laplace_python_sdk-1.1.0}/src/laplace/client.py

@@ -1,5 +1,6 @@
 """Main Laplace client."""
 
+from laplace.news import NewsClient
 from .base import BaseClient
 from .brokers import BrokersClient
 from .capital_increase import CapitalIncreaseClient
@@ -19,7 +20,7 @@ from typing import Optional, List
 class LaplaceClient(BaseClient):
     """Main Laplace API client with all sub-clients."""
 
-    def __init__(self, api_key: str, base_url: str = "https://uat.api.finfree.app/api"):
+    def __init__(self, api_key: str, base_url: str = "https://api.finfree.app/api"):
         """Initialize the Laplace client.
 
         Args:
@@ -40,6 +41,7 @@ class LaplaceClient(BaseClient):
         self.earnings = EarningsClient(self)
         self.search = SearchClient(self)
         self.state = StateClient(self)
+        self.news = NewsClient(self)
 
         # WebSocket client will be created on demand
         self._websocket_client: Optional[LivePriceWebSocketClient] = None

{laplace_python_sdk-0.4.0 → laplace_python_sdk-1.1.0}/src/laplace/collections.py

@@ -1,20 +1,15 @@
 """Collections client for Laplace API."""
 
-from typing import List, Optional
+from typing import Dict, List, Optional
 
 from laplace.base import BaseClient
 
 from .models import (
     Collection,
     CollectionDetail,
-    Industry,
-    IndustryDetail,
+    CollectionStatus,
     Locale,
-    Region,
-    Sector,
-    SectorDetail,
-    Theme,
-    ThemeDetail,
+    Region
 )
 
 
@@ -62,7 +57,7 @@ class CollectionsClient:
         response = self._client.get(f"v1/collection/{collection_id}", params=params)
         return CollectionDetail(**response)
 
-    def get_themes(self, region: Region, locale: Locale = "en") -> List[Theme]:
+    def get_themes(self, region: Region, locale: Locale = "en") -> List[Collection]:
         """Retrieve a list of themes along with the number of stocks in each.
 
         Args:
@@ -70,14 +65,14 @@ class CollectionsClient:
             locale: Locale code (tr, en) (default: en)
 
         Returns:
-            List[Theme]: List of themes
+            List[Collection]: List of themes
         """
         params = {"region": region.value, "locale": locale}
 
         response = self._client.get("v1/theme", params=params)
-        return [Theme(**theme) for theme in response]
+        return [Collection(**theme) for theme in response]
 
-    def get_theme_detail(self, theme_id: str, region: Region, locale: Locale = "en") -> ThemeDetail:
+    def get_theme_detail(self, theme_id: str, region: Region, locale: Locale = "en") -> CollectionDetail:
         """Retrieve detailed information about a specific theme.
 
         Args:
@@ -86,14 +81,14 @@ class CollectionsClient:
             locale: Locale code (tr, en) (default: en)
 
         Returns:
-            ThemeDetail: Detailed theme information
+            CollectionDetail: Detailed theme information
         """
         params = {"locale": locale, "region": region.value}
 
         response = self._client.get(f"v1/theme/{theme_id}", params=params)
-        return ThemeDetail(**response)
+        return CollectionDetail(**response)
 
-    def get_industries(self, region: Region, locale: Locale = "en") -> List[Industry]:
+    def get_industries(self, region: Region, locale: Locale = "en") -> List[Collection]:
         """Retrieve a list of industries along with the number of stocks in each.
 
         Args:
@@ -101,16 +96,16 @@ class CollectionsClient:
             locale: Locale code (tr, en) (default: en)
 
         Returns:
-            List[Industry]: List of industries
+            List[Collection]: List of industries
         """
         params = {"region": region.value, "locale": locale}
 
         response = self._client.get("v1/industry", params=params)
-        return [Industry(**industry) for industry in response]
+        return [Collection(**industry) for industry in response]
 
     def get_industry_detail(
         self, industry_id: str, region: Region, locale: Locale = "en"
-    ) -> IndustryDetail:
+    ) -> CollectionDetail:
         """Retrieve detailed information about a specific industry.
 
         Args:
@@ -119,14 +114,14 @@ class CollectionsClient:
             locale: Locale code (tr, en) (default: en)
 
         Returns:
-            IndustryDetail: Detailed industry information
+            CollectionDetail: Detailed industry information
         """
         params = {"locale": locale, "region": region.value}
 
         response = self._client.get(f"v1/industry/{industry_id}", params=params)
-        return IndustryDetail(**response)
+        return CollectionDetail(**response)
 
-    def get_custom_themes(self, locale: Locale, region: Region) -> List[CollectionDetail]:
+    def get_custom_themes(self, locale: Locale, region: Region) -> List[Collection]:
         """Get a list of all your custom themes.
 
         Args:
@@ -134,12 +129,12 @@ class CollectionsClient:
             region: Region code (tr, us)
 
         Returns:
-            List[CollectionDetail]: List of custom themes
+            List[Collection]: List of custom themes
         """
         params = {"locale": locale, "region": region.value}
 
         response = self._client.get("v1/custom-theme", params=params)
-        return [CollectionDetail(**theme) for theme in response]
+        return [Collection(**theme) for theme in response]
 
     def get_custom_theme_detail(
         self, theme_id: str, locale: Locale, region: Region, sort_by: Optional[str] = None
@@ -163,7 +158,115 @@ class CollectionsClient:
         response = self._client.get(f"v1/custom-theme/{theme_id}", params=params)
         return CollectionDetail(**response)
 
-    def get_sectors(self, region: Region, locale: Locale = "en") -> List[Sector]:
+    def delete_custom_theme(self, theme_id: str) -> None:
+        """Delete specific custom theme.
+
+        Args:
+            theme_id: Unique identifier for the custom theme
+        """
+        self._client.delete(f"v1/custom-theme/{theme_id}")
+
+    def create_custom_theme(
+        self,
+        title: Dict[str, str],
+        stock_ids: List[str],
+        status: CollectionStatus,
+        description: Optional[Dict[str, str]] = None,
+        region: Optional[List[Region]] = None,
+        image_url: Optional[str] = None,
+        image: Optional[str] = None,
+        avatar_url: Optional[str] = None,
+        order: Optional[int] = None,
+        meta_data: Optional[dict] = None,
+    ) -> str:
+        """Create a new custom theme.
+
+        Args:
+            title: Localized title (e.g., {"tr": "Başlık", "en": "Title"})
+            stock_ids: List of stock IDs
+            status: Collection status
+            description: Localized description (optional)
+            region: List of regions (optional)
+            image_url: Image URL (optional)
+            image: Image data (optional)
+            avatar_url: Avatar URL (optional)
+            order: Display order (optional)
+            meta_data: Additional metadata (optional)
+
+        Returns:
+            str: Created theme ID
+        """
+        body: dict = {
+            "title": title,
+            "stocks": stock_ids,
+            "status": status.value,
+        }
+
+        if description is not None:
+            body["description"] = description
+        if region is not None:
+            body["region"] = [r.value for r in region]
+        if image_url is not None:
+            body["image_url"] = image_url
+        if image is not None:
+            body["image"] = image
+        if avatar_url is not None:
+            body["avatar_url"] = avatar_url
+        if order is not None:
+            body["order"] = order
+        if meta_data is not None:
+            body["meta_data"] = meta_data
+
+        response = self._client.post("v1/custom-theme", json=body)
+        return response["id"]
+
+    def update_custom_theme(
+        self,
+        theme_id: str,
+        title: Optional[Dict[str, str]] = None,
+        stock_ids: Optional[List[str]] = None,
+        status: Optional[CollectionStatus] = None,
+        description: Optional[Dict[str, str]] = None,
+        image_url: Optional[str] = None,
+        image: Optional[str] = None,
+        avatar_url: Optional[str] = None,
+        meta_data: Optional[dict] = None,
+    ) -> None:
+        """Update an existing custom theme.
+
+        Args:
+            theme_id: Unique identifier for the custom theme
+            title: Localized title (optional)
+            stock_ids: List of stock IDs (optional)
+            status: Collection status (optional)
+            description: Localized description (optional)
+            image_url: Image URL (optional)
+            image: Image data (optional)
+            avatar_url: Avatar URL (optional)
+            meta_data: Additional metadata (optional)
+        """
+        body: dict = {}
+
+        if title is not None:
+            body["title"] = title
+        if stock_ids is not None:
+            body["stockIds"] = stock_ids
+        if status is not None:
+            body["status"] = status.value
+        if description is not None:
+            body["description"] = description
+        if image_url is not None:
+            body["image_url"] = image_url
+        if image is not None:
+            body["image"] = image
+        if avatar_url is not None:
+            body["avatar_url"] = avatar_url
+        if meta_data is not None:
+            body["meta_data"] = meta_data
+
+        self._client.patch(f"v1/custom-theme/{theme_id}", json=body)
+
+    def get_sectors(self, region: Region, locale: Locale = "en") -> List[Collection]:
         """Retrieve a list of sectors along with the number of stocks in each.
 
         Args:
@@ -171,16 +274,16 @@ class CollectionsClient:
             locale: Locale code (tr, en) (default: en)
 
         Returns:
-            List[Sector]: List of sectors
+            List[Collection]: List of sectors
         """
         params = {"region": region.value, "locale": locale}
 
         response = self._client.get("v1/sector", params=params)
-        return [Sector(**sector) for sector in response]
+        return [Collection(**sector) for sector in response]
 
     def get_sector_detail(
         self, sector_id: str, region: Region, locale: Locale = "en"
-    ) -> SectorDetail:
+    ) -> CollectionDetail:
         """Retrieve detailed information about a specific sector.
 
         Args:
@@ -189,9 +292,9 @@ class CollectionsClient:
             locale: Locale code (tr, en) (default: en)
 
         Returns:
-            SectorDetail: Detailed sector information
+            CollectionDetail: Detailed sector information
         """
         params = {"locale": locale, "region": region.value}
 
         response = self._client.get(f"v1/sector/{sector_id}", params=params)
-        return SectorDetail(**response)
+        return CollectionDetail(**response)

{laplace_python_sdk-0.4.0 → laplace_python_sdk-1.1.0}/src/laplace/financials.py

@@ -1,6 +1,6 @@
 """Financials client for Laplace API."""
 
-from typing import List
+from typing import List, Optional
 
 from laplace.base import BaseClient
 
@@ -41,14 +41,17 @@ class FinancialsClient:
         return [StockPeerFinancialRatioComparison(**item) for item in resp]
 
     def get_historical_ratios(
-        self, symbol: str, keys: List[str], region: Region, locale: Locale
+        self, symbol: str, keys: List[str], region: Region, locale: Optional[Locale] = None
     ) -> List[StockHistoricalRatios]:
         params = {
             "symbol": symbol,
             "region": region.value,
-            "locale": locale,
             "slugs": ",".join(keys),
         }
+
+        if locale:
+            params["locale"] = locale
+
         resp = self._client.get("v2/stock/historical-ratios", params=params)
         return [StockHistoricalRatios(**item) for item in resp]