laplace-python-sdk 0.1.0__tar.gz → 0.3.0__tar.gz

{laplace_python_sdk-0.1.0/src/laplace_python_sdk.egg-info → laplace_python_sdk-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: laplace-python-sdk
-Version: 0.1.0
+Version: 0.3.0
 Summary: Python SDK for Laplace stock data platform
 Author: Laplace SDK Team
 License: MIT
@@ -26,6 +26,7 @@ License-File: LICENSE
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: typing-extensions>=4.0.0; python_version < "3.10"
+Requires-Dist: websocket-client>=1.8.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
@@ -51,6 +52,7 @@ The official Python SDK for the Laplace stock data platform. Get easy access to
 - 🧪 **Well-tested**: Comprehensive test coverage with real API integration
 - 🌍 **Multi-region**: Support for US and Turkish markets
 - ⚡ **Fast**: Built on httpx for high performance
+- 🔌 **Real-time**: WebSocket support for live price data
 
 ## Installation
 
@@ -82,12 +84,22 @@ for collection in collections:
 
 # Get collection details
 collection_detail = client.collections.get_collection_detail(
-    collection_id="620f455a0187ade00bb0d55f", 
+    collection_id="620f455a0187ade00bb0d55f",
     region="tr"
 )
 print(f"Stocks in {collection_detail.title}:")
 for stock in collection_detail.stocks:
     print(f"  {stock.symbol}: {stock.name}")
+
+# Get politicians and their holdings
+politicians = client.politicians.get_politicians()
+for politician in politicians:
+    print(f"{politician.politician_name}: {politician.total_holdings} holdings")
+
+# Get holdings for a specific stock
+holdings = client.politicians.get_politician_holdings_by_symbol("AAPL")
+for holding in holdings:
+    print(f"{holding.politician_name}: {holding.holding} ({holding.allocation})")
 ```
 
 ## API Reference
@@ -113,7 +125,7 @@ from laplace.stocks import HistoricalPriceInterval
 
 prices = client.stocks.get_price_with_interval(
     symbol="AAPL",
-    region="us", 
+    region="us",
     from_date=datetime(2024, 1, 1),
     to_date=datetime(2024, 1, 31),
     interval=HistoricalPriceInterval.ONE_DAY
@@ -154,6 +166,97 @@ sectors = client.collections.get_sectors(region="tr", locale="en")
 sector_detail = client.collections.get_sector_detail(sector_id="id", region="tr")
 ```
 
+### Politicians Client
+
+```python
+# Get all politicians
+politicians = client.politicians.get_politicians()
+
+# Get politician detail
+politician = client.politicians.get_politician_detail(id=1)
+
+# Get holdings by stock symbol
+holdings = client.politicians.get_politician_holdings_by_symbol(symbol="AAPL")
+
+# Get top holdings
+top_holdings = client.politicians.get_top_holdings()
+```
+
+### WebSocket Client (Live Price Data)
+
+```python
+import asyncio
+from laplace import LaplaceClient, LivePriceFeed, WebSocketOptions, LogLevel
+
+# Initialize the client
+client = LaplaceClient(api_key="your-api-key")
+
+# Create WebSocket options
+options = WebSocketOptions(
+    enable_logging=True,
+    log_level=LogLevel.INFO,
+    reconnect_attempts=5,
+    reconnect_delay=5000,
+    max_reconnect_delay=30000,
+)
+
+# Create WebSocket client
+websocket_client = client.create_websocket_client(
+    feeds=[LivePriceFeed.LIVE_BIST, LivePriceFeed.LIVE_US],
+    external_user_id="your-user-id",
+    options=options,
+)
+
+# Define callback function for price updates
+def on_price_update(data):
+    print(f"Price update for {data.symbol}: {data.close_price}")
+    if hasattr(data, 'percent_change'):
+        print(f"  Change: {data.percent_change}%")
+    print(f"  Timestamp: {data.timestamp}")
+
+async def main():
+    # Connect to WebSocket
+    await websocket_client.connect()
+
+    # Subscribe to symbols
+    symbols_bist = ["THYAO", "GARAN", "AKBNK"]
+    symbols_us = ["AAPL", "GOOGL", "MSFT"]
+
+    # Subscribe to BIST symbols
+    unsubscribe_bist = websocket_client.subscribe(
+        symbols=symbols_bist,
+        feed=LivePriceFeed.LIVE_BIST,
+        handler=on_price_update
+    )
+
+    # Subscribe to US symbols
+    unsubscribe_us = websocket_client.subscribe(
+        symbols=symbols_us,
+        feed=LivePriceFeed.LIVE_US,
+        handler=on_price_update
+    )
+
+    # Keep connection alive
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except KeyboardInterrupt:
+        # Cleanup
+        unsubscribe_bist()
+        unsubscribe_us()
+        await websocket_client.close()
+
+# Run the WebSocket client
+asyncio.run(main())
+```
+
+### Available WebSocket Feeds
+
+- `LivePriceFeed.LIVE_BIST`: Live BIST (Turkish) stock prices
+- `LivePriceFeed.LIVE_US`: Live US stock prices
+- `LivePriceFeed.DELAYED_BIST`: Delayed BIST stock prices
+- `LivePriceFeed.DEPTH_TR`: Depth data for TR (commented out, available if needed)
+
 ## Supported Regions
 
 - **US**: United States stock market
@@ -212,6 +315,7 @@ LAPLACE_API_KEY=your-key pytest -m integration
 - Python 3.8+
 - httpx >= 0.24.0
 - pydantic >= 2.0.0
+- websocket-client >= 1.8.0
 
 ## Documentation
 

{laplace_python_sdk-0.1.0 → laplace_python_sdk-0.3.0}/README.md

@@ -14,6 +14,7 @@ The official Python SDK for the Laplace stock data platform. Get easy access to
 - 🧪 **Well-tested**: Comprehensive test coverage with real API integration
 - 🌍 **Multi-region**: Support for US and Turkish markets
 - ⚡ **Fast**: Built on httpx for high performance
+- 🔌 **Real-time**: WebSocket support for live price data
 
 ## Installation
 
@@ -45,12 +46,22 @@ for collection in collections:
 
 # Get collection details
 collection_detail = client.collections.get_collection_detail(
-    collection_id="620f455a0187ade00bb0d55f", 
+    collection_id="620f455a0187ade00bb0d55f",
     region="tr"
 )
 print(f"Stocks in {collection_detail.title}:")
 for stock in collection_detail.stocks:
     print(f"  {stock.symbol}: {stock.name}")
+
+# Get politicians and their holdings
+politicians = client.politicians.get_politicians()
+for politician in politicians:
+    print(f"{politician.politician_name}: {politician.total_holdings} holdings")
+
+# Get holdings for a specific stock
+holdings = client.politicians.get_politician_holdings_by_symbol("AAPL")
+for holding in holdings:
+    print(f"{holding.politician_name}: {holding.holding} ({holding.allocation})")
 ```
 
 ## API Reference
@@ -76,7 +87,7 @@ from laplace.stocks import HistoricalPriceInterval
 
 prices = client.stocks.get_price_with_interval(
     symbol="AAPL",
-    region="us", 
+    region="us",
     from_date=datetime(2024, 1, 1),
     to_date=datetime(2024, 1, 31),
     interval=HistoricalPriceInterval.ONE_DAY
@@ -117,6 +128,97 @@ sectors = client.collections.get_sectors(region="tr", locale="en")
 sector_detail = client.collections.get_sector_detail(sector_id="id", region="tr")
 ```
 
+### Politicians Client
+
+```python
+# Get all politicians
+politicians = client.politicians.get_politicians()
+
+# Get politician detail
+politician = client.politicians.get_politician_detail(id=1)
+
+# Get holdings by stock symbol
+holdings = client.politicians.get_politician_holdings_by_symbol(symbol="AAPL")
+
+# Get top holdings
+top_holdings = client.politicians.get_top_holdings()
+```
+
+### WebSocket Client (Live Price Data)
+
+```python
+import asyncio
+from laplace import LaplaceClient, LivePriceFeed, WebSocketOptions, LogLevel
+
+# Initialize the client
+client = LaplaceClient(api_key="your-api-key")
+
+# Create WebSocket options
+options = WebSocketOptions(
+    enable_logging=True,
+    log_level=LogLevel.INFO,
+    reconnect_attempts=5,
+    reconnect_delay=5000,
+    max_reconnect_delay=30000,
+)
+
+# Create WebSocket client
+websocket_client = client.create_websocket_client(
+    feeds=[LivePriceFeed.LIVE_BIST, LivePriceFeed.LIVE_US],
+    external_user_id="your-user-id",
+    options=options,
+)
+
+# Define callback function for price updates
+def on_price_update(data):
+    print(f"Price update for {data.symbol}: {data.close_price}")
+    if hasattr(data, 'percent_change'):
+        print(f"  Change: {data.percent_change}%")
+    print(f"  Timestamp: {data.timestamp}")
+
+async def main():
+    # Connect to WebSocket
+    await websocket_client.connect()
+
+    # Subscribe to symbols
+    symbols_bist = ["THYAO", "GARAN", "AKBNK"]
+    symbols_us = ["AAPL", "GOOGL", "MSFT"]
+
+    # Subscribe to BIST symbols
+    unsubscribe_bist = websocket_client.subscribe(
+        symbols=symbols_bist,
+        feed=LivePriceFeed.LIVE_BIST,
+        handler=on_price_update
+    )
+
+    # Subscribe to US symbols
+    unsubscribe_us = websocket_client.subscribe(
+        symbols=symbols_us,
+        feed=LivePriceFeed.LIVE_US,
+        handler=on_price_update
+    )
+
+    # Keep connection alive
+    try:
+        while True:
+            await asyncio.sleep(1)
+    except KeyboardInterrupt:
+        # Cleanup
+        unsubscribe_bist()
+        unsubscribe_us()
+        await websocket_client.close()
+
+# Run the WebSocket client
+asyncio.run(main())
+```
+
+### Available WebSocket Feeds
+
+- `LivePriceFeed.LIVE_BIST`: Live BIST (Turkish) stock prices
+- `LivePriceFeed.LIVE_US`: Live US stock prices
+- `LivePriceFeed.DELAYED_BIST`: Delayed BIST stock prices
+- `LivePriceFeed.DEPTH_TR`: Depth data for TR (commented out, available if needed)
+
 ## Supported Regions
 
 - **US**: United States stock market
@@ -175,6 +277,7 @@ LAPLACE_API_KEY=your-key pytest -m integration
 - Python 3.8+
 - httpx >= 0.24.0
 - pydantic >= 2.0.0
+- websocket-client >= 1.8.0
 
 ## Documentation
 
@@ -182,4 +285,4 @@ Full API documentation is available at [laplace.finfree.co/en/docs](https://lapl
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

{laplace_python_sdk-0.1.0 → laplace_python_sdk-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "laplace-python-sdk"
-version = "0.1.0"
+version = "0.3.0"
 description = "Python SDK for Laplace stock data platform"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -30,6 +30,7 @@ dependencies = [
     "httpx>=0.24.0",
     "pydantic>=2.0.0",
     "typing-extensions>=4.0.0; python_version<'3.10'",
+    "websocket-client>=1.8.0",
 ]
 
 [project.optional-dependencies]
@@ -63,14 +64,14 @@ profile = "black"
 line_length = 100
 
 [tool.mypy]
-python_version = "0.1.0"
+python_version = "0.3.0"
 strict = true
 warn_return_any = true
 warn_unused_configs = true
 
 [tool.ruff]
 line-length = 100
-target-version = "0.1.0"
+target-version = "0.3.0"
 select = ["E", "W", "F", "I", "N", "B", "UP"]
 ignore = ["B008", "N805"]
 

{laplace_python_sdk-0.1.0 → laplace_python_sdk-0.3.0}/src/laplace/__init__.py

@@ -2,5 +2,5 @@
 
 from .client import LaplaceClient
 
-__version__ = "0.1.0"
-__all__ = ["LaplaceClient"]
+__version__ = "0.1.1"
+__all__ = ["LaplaceClient"]

{laplace_python_sdk-0.1.0 → laplace_python_sdk-0.3.0}/src/laplace/base.py

@@ -1,19 +1,25 @@
 """Base client for Laplace API."""
 
-from typing import Any, Dict, Optional, Union
+from typing import Any, Dict, Optional
+
 import httpx
-from pydantic import BaseModel
 
 
 class LaplaceError(Exception):
     """Base exception for Laplace API errors."""
+
     pass
 
 
 class LaplaceAPIError(LaplaceError):
     """Exception raised for API errors."""
-    
-    def __init__(self, message: str, status_code: Optional[int] = None, response: Optional[Dict[str, Any]] = None):
+
+    def __init__(
+        self,
+        message: str,
+        status_code: Optional[int] = None,
+        response: Optional[Dict[str, Any]] = None,
+    ):
         super().__init__(message)
         self.status_code = status_code
         self.response = response
@@ -21,10 +27,10 @@ class LaplaceAPIError(LaplaceError):
 
 class BaseClient:
     """Base client for Laplace API communication."""
-    
+
     def __init__(self, api_key: str, base_url: str = "https://api.finfree.app/api"):
         """Initialize the base client.
-        
+
         Args:
             api_key: Your Laplace API key
             base_url: Base URL for the API (default: https://api.finfree.app/api)
@@ -37,83 +43,79 @@ class BaseClient:
             },
             timeout=30.0,
         )
-    
+
     def __enter__(self):
         return self
-    
+
     def __exit__(self, exc_type, exc_val, exc_tb):
         self.close()
-    
+
     def close(self):
         """Close the HTTP client."""
         self._client.close()
-    
+
     def _request(
         self,
         method: str,
         endpoint: str,
         params: Optional[Dict[str, Any]] = None,
         json: Optional[Dict[str, Any]] = None,
-        **kwargs
+        **kwargs,
     ) -> Dict[str, Any]:
         """Make a request to the API.
-        
+
         Args:
             method: HTTP method
             endpoint: API endpoint (relative to base_url)
             params: Query parameters
             json: JSON body data
             **kwargs: Additional arguments passed to httpx
-            
+
         Returns:
             Response data as dictionary
-            
+
         Raises:
             LaplaceAPIError: If the API request fails
         """
         url = f"{self.base_url}/{endpoint.lstrip('/')}"
-        
+
         # Add API key to params
         if params is None:
             params = {}
         params["api_key"] = self.api_key
-        
+
         try:
             response = self._client.request(
-                method=method,
-                url=url,
-                params=params,
-                json=json,
-                **kwargs
+                method=method, url=url, params=params, json=json, **kwargs
             )
             response.raise_for_status()
             return response.json()
         except httpx.HTTPStatusError as e:
             try:
                 error_data = e.response.json()
-            except:
+            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
+                response=error_data,
             ) from e
         except httpx.RequestError as e:
             raise LaplaceAPIError(f"Request failed: {str(e)}") from e
-    
+
     def get(self, endpoint: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
         """Make a GET request."""
         return self._request("GET", endpoint, params=params)
-    
+
     def post(self, endpoint: str, json: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
         """Make a POST request."""
         return self._request("POST", endpoint, json=json)
-    
+
     def put(self, endpoint: str, json: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
         """Make a PUT request."""
         return self._request("PUT", endpoint, json=json)
-    
+
     def delete(self, endpoint: str) -> Dict[str, Any]:
         """Make a DELETE request."""
-        return self._request("DELETE", endpoint)
+        return self._request("DELETE", endpoint)