drishti-sdk 0.2.0__tar.gz

drishti_sdk-0.2.0/.gitignore

@@ -0,0 +1,14 @@
+.DS_Store
+*.pyc
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+python/.venv/
+python/build/
+python/dist/
+python/*.egg-info/
+js/node_modules/
+js/dist/

drishti_sdk-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Market-Stack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

drishti_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: drishti-sdk
+Version: 0.2.0
+Summary: Python client for the Alpha API (/v1)
+Author: Market-Stack
+License: MIT
+License-File: LICENSE
+Keywords: alpha-api,http-client,python,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27.0
+Requires-Dist: pydantic<3,>=2.0
+Requires-Dist: websockets<16,>=12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Drishti SDK (Python)
+
+Official Python SDK for the Manasija Alpha API (`/v1`).
+
+This SDK provides:
+- A synchronous HTTP client with named-argument endpoint helpers
+- A low-level request interface for advanced/custom usage
+- A WebSocket client for real-time streams (`/v1/ws`)
+
+## Requirements
+
+- Python `3.10+`
+- A valid Alpha API key
+
+## Installation
+
+```bash
+pip install drishti-sdk
+```
+
+
+## Quick Start
+
+```python
+from market_stack_sdk import DrishtiClient
+
+with DrishtiClient(api_key="YOUR_API_KEY") as client:
+    news = client.get_news(
+        symbols=["RELIANCE", "TCS"],
+        limit=10,
+    )
+    print(len(news["data"]))
+```
+
+All requests automatically include `X-API-Key` using the provided `api_key`.
+
+## HTTP Usage
+
+```python
+from market_stack_sdk import DrishtiClient
+
+with DrishtiClient(api_key="YOUR_API_KEY") as client:
+    announcements = client.get_announcements(
+        symbols=["RELIANCE"],
+        categories=["Corporate Action"],
+        detailed=True,
+        limit=20,
+    )
+
+    earnings = client.get_earnings_detail(
+        symbol="MEDIASSIST",
+        quarter="q4_26",
+        detailed=True,
+    )
+
+    transcript = client.get_concalls_transcript(
+        symbol="TCS",
+        quarter="q4_26",
+    )
+
+    alerts = client.get_alerts(
+        symbols=["INFY"],
+        important=True,
+        limit=25,
+    )
+```
+
+## Error Handling
+
+```python
+from market_stack_sdk import MarketStackApiError, DrishtiClient
+
+try:
+    with DrishtiClient(api_key="YOUR_API_KEY") as client:
+        client.get_account()
+except MarketStackApiError as exc:
+    print(exc.status_code)
+    print(exc.body)
+    raise
+```
+
+## WebSocket Usage (`/v1/ws`)
+
+```python
+import asyncio
+from market_stack_sdk import DrishtiClient, SubscribeOptions
+
+
+async def main() -> None:
+    client = DrishtiClient(api_key="YOUR_API_KEY")
+    async with client.websocket() as ws:
+        await ws.subscribe(
+            SubscribeOptions(
+                product="announcements",
+                symbols=["RELIANCE"],
+                detailed=False,
+            )
+        )
+        async for event in ws.events():
+            if event.kind == "subscribed":
+                print("ready", event.product, event.tier)
+            elif event.kind == "data":
+                print(event.channel, event.data)
+
+
+asyncio.run(main())
+```
+
+Reconnect/callback style:
+
+```python
+async with client.websocket(
+    auto_reconnect=True,
+    reconnect_initial_delay=1.0,
+    reconnect_max_delay=30.0,
+    on_reconnect_attempt=lambda attempt, delay, reason: print(attempt, delay, reason),
+    on_data=lambda event: print(event.data) if event.kind == "data" else None,
+) as ws:
+    await ws.subscribe("alerts", symbols=["RELIANCE"])
+    await ws.run()
+```
+
+## Batch Jobs
+
+```python
+from market_stack_sdk import DrishtiClient
+
+with DrishtiClient(api_key="YOUR_API_KEY") as client:
+    with open("batch.jsonl", "rb") as f:
+        file_bytes = f.read()
+
+    job = client.post_batch_jobs_file(
+        file_name="batch.jsonl",
+        file_bytes=file_bytes,
+        display_name="Quarterly run",
+    )
+
+    status = client.get_batch_jobs_job_id(job_id=job["id"])
+```
+
+## API Surface
+
+### REST helper methods
+
+- `get_news`
+- `get_symbols_metadata`
+- `get_announcements_categories`
+- `get_announcements`
+- `get_announcements_attachments`
+- `post_daily_summary`
+- `get_earnings`
+- `get_earnings_detail`
+- `get_earnings_attachments`
+- `get_concalls`
+- `get_concalls_detail`
+- `get_concalls_transcript`
+- `post_concalls_transcripts`
+- `get_alerts`
+- `get_account`
+- `get_account_limits`
+- `get_account_usage`
+- `get_account_ledger`
+- `post_batch_jobs`
+- `post_batch_jobs_file`
+- `get_batch_jobs`
+- `get_batch_jobs_job_id`
+- `delete_batch_jobs_job_id`
+- `get_batch_jobs_job_id_results`
+- `websocket`
+
+### Low-level HTTP methods
+
+- `request`
+- `get`
+- `post`
+- `put`
+- `patch`
+- `delete`
+- `request_v1`
+
+## Development
+
+```bash
+pip install -e .[dev]
+```

drishti_sdk-0.2.0/README.md

@@ -0,0 +1,185 @@
+# Drishti SDK (Python)
+
+Official Python SDK for the Manasija Alpha API (`/v1`).
+
+This SDK provides:
+- A synchronous HTTP client with named-argument endpoint helpers
+- A low-level request interface for advanced/custom usage
+- A WebSocket client for real-time streams (`/v1/ws`)
+
+## Requirements
+
+- Python `3.10+`
+- A valid Alpha API key
+
+## Installation
+
+```bash
+pip install drishti-sdk
+```
+
+
+## Quick Start
+
+```python
+from market_stack_sdk import DrishtiClient
+
+with DrishtiClient(api_key="YOUR_API_KEY") as client:
+    news = client.get_news(
+        symbols=["RELIANCE", "TCS"],
+        limit=10,
+    )
+    print(len(news["data"]))
+```
+
+All requests automatically include `X-API-Key` using the provided `api_key`.
+
+## HTTP Usage
+
+```python
+from market_stack_sdk import DrishtiClient
+
+with DrishtiClient(api_key="YOUR_API_KEY") as client:
+    announcements = client.get_announcements(
+        symbols=["RELIANCE"],
+        categories=["Corporate Action"],
+        detailed=True,
+        limit=20,
+    )
+
+    earnings = client.get_earnings_detail(
+        symbol="MEDIASSIST",
+        quarter="q4_26",
+        detailed=True,
+    )
+
+    transcript = client.get_concalls_transcript(
+        symbol="TCS",
+        quarter="q4_26",
+    )
+
+    alerts = client.get_alerts(
+        symbols=["INFY"],
+        important=True,
+        limit=25,
+    )
+```
+
+## Error Handling
+
+```python
+from market_stack_sdk import MarketStackApiError, DrishtiClient
+
+try:
+    with DrishtiClient(api_key="YOUR_API_KEY") as client:
+        client.get_account()
+except MarketStackApiError as exc:
+    print(exc.status_code)
+    print(exc.body)
+    raise
+```
+
+## WebSocket Usage (`/v1/ws`)
+
+```python
+import asyncio
+from market_stack_sdk import DrishtiClient, SubscribeOptions
+
+
+async def main() -> None:
+    client = DrishtiClient(api_key="YOUR_API_KEY")
+    async with client.websocket() as ws:
+        await ws.subscribe(
+            SubscribeOptions(
+                product="announcements",
+                symbols=["RELIANCE"],
+                detailed=False,
+            )
+        )
+        async for event in ws.events():
+            if event.kind == "subscribed":
+                print("ready", event.product, event.tier)
+            elif event.kind == "data":
+                print(event.channel, event.data)
+
+
+asyncio.run(main())
+```
+
+Reconnect/callback style:
+
+```python
+async with client.websocket(
+    auto_reconnect=True,
+    reconnect_initial_delay=1.0,
+    reconnect_max_delay=30.0,
+    on_reconnect_attempt=lambda attempt, delay, reason: print(attempt, delay, reason),
+    on_data=lambda event: print(event.data) if event.kind == "data" else None,
+) as ws:
+    await ws.subscribe("alerts", symbols=["RELIANCE"])
+    await ws.run()
+```
+
+## Batch Jobs
+
+```python
+from market_stack_sdk import DrishtiClient
+
+with DrishtiClient(api_key="YOUR_API_KEY") as client:
+    with open("batch.jsonl", "rb") as f:
+        file_bytes = f.read()
+
+    job = client.post_batch_jobs_file(
+        file_name="batch.jsonl",
+        file_bytes=file_bytes,
+        display_name="Quarterly run",
+    )
+
+    status = client.get_batch_jobs_job_id(job_id=job["id"])
+```
+
+## API Surface
+
+### REST helper methods
+
+- `get_news`
+- `get_symbols_metadata`
+- `get_announcements_categories`
+- `get_announcements`
+- `get_announcements_attachments`
+- `post_daily_summary`
+- `get_earnings`
+- `get_earnings_detail`
+- `get_earnings_attachments`
+- `get_concalls`
+- `get_concalls_detail`
+- `get_concalls_transcript`
+- `post_concalls_transcripts`
+- `get_alerts`
+- `get_account`
+- `get_account_limits`
+- `get_account_usage`
+- `get_account_ledger`
+- `post_batch_jobs`
+- `post_batch_jobs_file`
+- `get_batch_jobs`
+- `get_batch_jobs_job_id`
+- `delete_batch_jobs_job_id`
+- `get_batch_jobs_job_id_results`
+- `websocket`
+
+### Low-level HTTP methods
+
+- `request`
+- `get`
+- `post`
+- `put`
+- `patch`
+- `delete`
+- `request_v1`
+
+## Development
+
+```bash
+pip install -e .[dev]
+```

drishti_sdk-0.2.0/market_stack_sdk/__init__.py

@@ -0,0 +1,75 @@
+from market_stack_sdk.client import DEFAULT_BASE_URL, DrishtiClient
+from market_stack_sdk.exceptions import MarketStackApiError, MarketStackWebSocketError
+from market_stack_sdk.params import (
+    AccountLedgerQueryParams,
+    AlertsQueryParams,
+    AnnouncementsListQueryParams,
+    AnnouncementsQueryParams,
+    BatchJobsListQueryParams,
+    ConcallsQueryParams,
+    DailySummaryPortfolioItem,
+    DailySummaryRequest,
+    DocumentIdsQueryParams,
+    EarningsQueryParams,
+    FeedQueryParams,
+    NewsQueryParams,
+    SymbolMetadataQueryParams,
+    SymbolQuarterDetailQueryParams,
+    SymbolQuarterQueryParams,
+    BatchJobIdParams,
+    coerce_query_params,
+)
+from market_stack_sdk import types as response_types
+from market_stack_sdk.websocket import (
+    ALPHA_WS_PRODUCTS,
+    AlphaWebSocketClientSessionOptions,
+    AlphaWebSocketProduct,
+    AlphaWebSocketSession,
+    DataEvent,
+    ErrorEvent,
+    RawEvent,
+    SubscribeOptions,
+    SubscribedEvent,
+    WebSocketEvent,
+    build_websocket_url,
+    parse_websocket_message,
+    stream_product,
+)
+
+__all__ = [
+    "DEFAULT_BASE_URL",
+    "ALPHA_WS_PRODUCTS",
+    "AccountLedgerQueryParams",
+    "AlertsQueryParams",
+    "AlphaWebSocketClientSessionOptions",
+    "AlphaWebSocketProduct",
+    "AlphaWebSocketSession",
+    "AnnouncementsListQueryParams",
+    "AnnouncementsQueryParams",
+    "BatchJobsListQueryParams",
+    "ConcallsQueryParams",
+    "DailySummaryPortfolioItem",
+    "DailySummaryRequest",
+    "DataEvent",
+    "DocumentIdsQueryParams",
+    "EarningsQueryParams",
+    "ErrorEvent",
+    "FeedQueryParams",
+    "DrishtiClient",
+    "MarketStackApiError",
+    "MarketStackWebSocketError",
+    "NewsQueryParams",
+    "RawEvent",
+    "SubscribeOptions",
+    "SubscribedEvent",
+    "SymbolMetadataQueryParams",
+    "SymbolQuarterDetailQueryParams",
+    "SymbolQuarterQueryParams",
+    "BatchJobIdParams",
+    "WebSocketEvent",
+    "build_websocket_url",
+    "coerce_query_params",
+    "parse_websocket_message",
+    "response_types",
+    "stream_product",
+]