reportify-sdk 0.2.6__py3-none-any.whl → 0.2.8__py3-none-any.whl

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/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/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.dist-info → reportify_sdk-0.2.8.dist-info}/METADATA

@@ -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.dist-info → reportify_sdk-0.2.8.dist-info}/RECORD

@@ -1,13 +1,14 @@
 reportify_sdk/__init__.py,sha256=f2bq8Exeuf5g7hAhEQ3qrS7wMVqZRXP7xmQEYA3Nvso,662
-reportify_sdk/client.py,sha256=P56qBme48UPkZhMb9BlDnLMLXwHK-DjU7qDhGFFxMI0,11019
+reportify_sdk/client.py,sha256=Q6HDx9_sC9z_Qrp9SntUmcL4OmumZZlRn_EzsGTHyPg,11332
+reportify_sdk/concepts.py,sha256=XlHPuuZacFFUccMthyeb5R2OTayFYxXgIODKNfJLa_c,1891
 reportify_sdk/docs.py,sha256=O30I1J4qTC8zpkVP_qu1cgT8nv6ysXNClqvaiRb0lhY,4957
 reportify_sdk/exceptions.py,sha256=r2_C_kTh6tCrQnfA3UozSqMMA-2OBnoP3pGpgYeqcdU,1049
 reportify_sdk/kb.py,sha256=-4UHWtudFncGRBB42B4YEoMPsEHr4QOtY55_8hKyogE,2240
 reportify_sdk/quant.py,sha256=9rWKWo2UlG3GfsQC-jpEgXUl25ojEabpvOGISyGMamM,15110
-reportify_sdk/stock.py,sha256=MHrWt7L1_xanhplmfYoGJszQqKcFF7VJVD_sgfEsny0,16230
+reportify_sdk/stock.py,sha256=0IjXUSwOVccOB37a1Fc_rubnmwkH_wL4-GGRFHhV4fM,17128
 reportify_sdk/timeline.py,sha256=b5Zj5SjXT4gP0dvEl8gXCWDZJHemyU7NSYahet2nHhc,4075
-reportify_sdk-0.2.6.dist-info/licenses/LICENSE,sha256=zBUq4DL4lE-fZU_PMkr0gnxkYS1LhdRHFw8_LmCb-ek,1066
-reportify_sdk-0.2.6.dist-info/METADATA,sha256=Dukp1KSTLjzNyVzHnAK6sWibFqNHTUgRigxCvXWnBuQ,4311
-reportify_sdk-0.2.6.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-reportify_sdk-0.2.6.dist-info/top_level.txt,sha256=tc_dzCSWIDsNbHSi-FlyEEX8xwinhN9gl-CwyLRE4B0,14
-reportify_sdk-0.2.6.dist-info/RECORD,,
+reportify_sdk-0.2.8.dist-info/licenses/LICENSE,sha256=zBUq4DL4lE-fZU_PMkr0gnxkYS1LhdRHFw8_LmCb-ek,1066
+reportify_sdk-0.2.8.dist-info/METADATA,sha256=Ieq07Z124BnTyDxrTwQljiPCVW8vAc57LztmmwQX97M,4311
+reportify_sdk-0.2.8.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+reportify_sdk-0.2.8.dist-info/top_level.txt,sha256=tc_dzCSWIDsNbHSi-FlyEEX8xwinhN9gl-CwyLRE4B0,14
+reportify_sdk-0.2.8.dist-info/RECORD,,