reportify-sdk 0.2.6__tar.gz → 0.2.8__tar.gz

{reportify_sdk-0.2.6/reportify_sdk.egg-info → reportify_sdk-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reportify-sdk
-Version: 0.2.6
+Version: 0.2.8
 Summary: Python SDK for Reportify API - Financial data and document search
 Author-email: Reportify <support@reportify.cn>
 License-Expression: MIT

{reportify_sdk-0.2.6 → reportify_sdk-0.2.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "reportify-sdk"
-version = "0.2.6"
+version = "0.2.8"
 description = "Python SDK for Reportify API - Financial data and document search"
 readme = "README.md"
 license = "MIT"

{reportify_sdk-0.2.6 → reportify_sdk-0.2.8}/reportify_sdk/client.py

@@ -62,13 +62,14 @@ class Reportify:
         self._docs = None
         self._tools = None
         self._quant = None
+        self._concepts = None
 
     def _get_headers(self) -> dict[str, str]:
         """Get default headers for API requests"""
         return {
             "Authorization": f"Bearer {self.api_key}",
             "Content-Type": "application/json",
-            "User-Agent": "reportify-sdk-python/0.1.0",
+            "User-Agent": "reportify-sdk-python/0.2.8",
         }
 
     def _request(
@@ -360,6 +361,14 @@ class Reportify:
             self._quant = QuantModule(self)
         return self._quant
 
+    @property
+    def concepts(self):
+        """Concepts module for accessing concept data and feeds"""
+        if self._concepts is None:
+            from reportify_sdk.concepts import ConceptsModule
+            self._concepts = ConceptsModule(self)
+        return self._concepts
+
     def close(self):
         """Close the HTTP client"""
         self._client.close()

reportify_sdk-0.2.8/reportify_sdk/concepts.py

@@ -0,0 +1,64 @@
+"""
+Concepts Module
+
+Provides access to concept-related data and feeds.
+"""
+
+from typing import Any
+
+from reportify_sdk.client import Reportify
+
+
+class ConceptsModule:
+    """
+    Concepts module for accessing concept data and feeds
+
+    This module provides methods to:
+    - Get latest concepts
+    - Get today's concept feeds
+    """
+
+    def __init__(self, client: Reportify):
+        self.client = client
+
+    def _get(self, path: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        """Helper method for GET requests"""
+        return self.client._get(path, params)
+
+    def latest(self, include_docs: bool = True) -> list[dict[str, Any]]:
+        """
+        Get latest concepts
+
+        Args:
+            include_docs: Whether to include related documents (default: True)
+
+        Returns:
+            List of latest concepts with stocks, keywords, and events
+
+        Example:
+            >>> # Get latest concepts
+            >>> concepts = client.concepts.latest()
+            >>> for concept in concepts:
+            ...     print(concept['concept_name'])
+            
+            >>> # Get concepts without documents
+            >>> concepts = client.concepts.latest(include_docs=False)
+        """
+        params = {"include_docs": include_docs}
+        return self._get("/v1/concepts/latest", params)
+
+    def today(self) -> list[dict[str, Any]]:
+        """
+        Get today's concept feeds
+
+        Returns:
+            List of today's concept feeds with events, stocks, and docs
+
+        Example:
+            >>> # Get today's concept feeds
+            >>> feeds = client.concepts.today()
+            >>> for feed in feeds:
+            ...     print(f"{feed['concept_name']}: {feed['gen_count']} generations")
+            ...     print(f"Time range: {feed['earliest_at']} - {feed['latest_at']}")
+        """
+        return self._get("/v1/concepts/today")

{reportify_sdk-0.2.6 → reportify_sdk-0.2.8}/reportify_sdk/stock.py

@@ -32,21 +32,44 @@ class StockModule:
     # Company Information
     # -------------------------------------------------------------------------
 
-    def overview(self, symbol: str) -> dict[str, Any]:
+    def overview(
+        self, symbols: str | None = None, names: str | None = None
+    ) -> dict[str, Any] | list[dict[str, Any]]:
         """
         Get company overview including business description, sector, and key metrics
 
         Args:
-            symbol: Stock symbol (e.g., "US:AAPL", "HK:0700", "CN:600519")
+            symbols: Stock symbols. You can enter multiple items, separated by commas(,)
+                    Example: "US:AAPL,US:MSFT"
+            names: Stock names. You can enter multiple items, separated by commas(,)
+                  Example: "Apple Inc.,Microsoft"
 
         Returns:
-            Company information dictionary
+            Dictionary or list of dictionaries with company overview data
 
         Example:
-            >>> info = client.stock.overview("US:AAPL")
+            >>> # Single stock by symbol
+            >>> info = client.stock.overview(symbols="US:AAPL")
             >>> print(info["name"], info["sector"])
+            
+            >>> # Multiple stocks by symbols
+            >>> infos = client.stock.overview(symbols="US:AAPL,US:MSFT")
+            >>> for info in infos:
+            ...     print(info["name"])
+            
+            >>> # Search by name
+            >>> info = client.stock.overview(names="Apple Inc.")
         """
-        response = self._post("/v1/stock/company-overview", json={"symbol": symbol})
+        if not symbols and not names:
+            raise ValueError("Either symbols or names must be provided")
+
+        data = {}
+        if symbols:
+            data["symbols"] = symbols
+        if names:
+            data["names"] = names
+
+        response = self._post("/v1/stock/company-overview", json=data)
         return response
 
     def shareholders(self, symbol: str) -> list[dict[str, Any]]:

{reportify_sdk-0.2.6 → reportify_sdk-0.2.8/reportify_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reportify-sdk
-Version: 0.2.6
+Version: 0.2.8
 Summary: Python SDK for Reportify API - Financial data and document search
 Author-email: Reportify <support@reportify.cn>
 License-Expression: MIT

{reportify_sdk-0.2.6 → reportify_sdk-0.2.8}/reportify_sdk.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 reportify_sdk/__init__.py
 reportify_sdk/client.py
+reportify_sdk/concepts.py
 reportify_sdk/docs.py
 reportify_sdk/exceptions.py
 reportify_sdk/kb.py