reportify-sdk 0.2.5__py3-none-any.whl → 0.2.7__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.7",
         }
 
     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

@@ -454,7 +454,7 @@ class StockModule:
         response = self._post("/v1/stock/index-constituents", json={"symbol": symbol})
         return self._to_dataframe(response)
 
-    def index_funds(self, symbol: str) -> pd.DataFrame:
+    def index_tracking_funds(self, symbol: str) -> pd.DataFrame:
         """
         Get tracking funds of an index
 
@@ -466,11 +466,11 @@ class StockModule:
 
         Example:
             >>> # Get CSI 300 tracking funds
-            >>> funds = client.stock.index_funds("000300")
+            >>> funds = client.stock.index_tracking_funds("000300")
             >>> print(funds[["short_name", "name", "symbol"]])
             
             >>> # Get SSE 50 tracking funds
-            >>> funds = client.stock.index_funds("000016")
+            >>> funds = client.stock.index_tracking_funds("000016")
         """
         response = self._post("/v1/stock/index-tracking-funds", json={"symbol": symbol})
         return self._to_dataframe(response)

{reportify_sdk-0.2.5.dist-info → reportify_sdk-0.2.7.dist-info}/METADATA

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

{reportify_sdk-0.2.5.dist-info → reportify_sdk-0.2.7.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=V66J_IH3qq9VPxbiQcB0tyRzg3iWjS0nYA-XS_KcSg8,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=8rJBR86-okwjQnI0n4iwfKaanVSLf1RLjSh8VYxyvOw,16203
+reportify_sdk/stock.py,sha256=MHrWt7L1_xanhplmfYoGJszQqKcFF7VJVD_sgfEsny0,16230
 reportify_sdk/timeline.py,sha256=b5Zj5SjXT4gP0dvEl8gXCWDZJHemyU7NSYahet2nHhc,4075
-reportify_sdk-0.2.5.dist-info/licenses/LICENSE,sha256=zBUq4DL4lE-fZU_PMkr0gnxkYS1LhdRHFw8_LmCb-ek,1066
-reportify_sdk-0.2.5.dist-info/METADATA,sha256=o9kD1myWJldCQ5GEEA_orYwv1oOkjSDFE1yPwaWJHzI,4311
-reportify_sdk-0.2.5.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-reportify_sdk-0.2.5.dist-info/top_level.txt,sha256=tc_dzCSWIDsNbHSi-FlyEEX8xwinhN9gl-CwyLRE4B0,14
-reportify_sdk-0.2.5.dist-info/RECORD,,
+reportify_sdk-0.2.7.dist-info/licenses/LICENSE,sha256=zBUq4DL4lE-fZU_PMkr0gnxkYS1LhdRHFw8_LmCb-ek,1066
+reportify_sdk-0.2.7.dist-info/METADATA,sha256=gfjpqCZXPHFAGAHKQSPUZzlECUCV4ZY91Qg74Hdhco8,4311
+reportify_sdk-0.2.7.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+reportify_sdk-0.2.7.dist-info/top_level.txt,sha256=tc_dzCSWIDsNbHSi-FlyEEX8xwinhN9gl-CwyLRE4B0,14
+reportify_sdk-0.2.7.dist-info/RECORD,,