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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: reportify-sdk
3
- Version: 0.2.7
3
+ Version: 0.2.8
4
4
  Summary: Python SDK for Reportify API - Financial data and document search
5
5
  Author-email: Reportify <support@reportify.cn>
6
6
  License-Expression: MIT
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "reportify-sdk"
7
- version = "0.2.7"
7
+ version = "0.2.8"
8
8
  description = "Python SDK for Reportify API - Financial data and document search"
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -69,7 +69,7 @@ class Reportify:
69
69
  return {
70
70
  "Authorization": f"Bearer {self.api_key}",
71
71
  "Content-Type": "application/json",
72
- "User-Agent": "reportify-sdk-python/0.2.7",
72
+ "User-Agent": "reportify-sdk-python/0.2.8",
73
73
  }
74
74
 
75
75
  def _request(
@@ -32,21 +32,44 @@ class StockModule:
32
32
  # Company Information
33
33
  # -------------------------------------------------------------------------
34
34
 
35
- def overview(self, symbol: str) -> dict[str, Any]:
35
+ def overview(
36
+ self, symbols: str | None = None, names: str | None = None
37
+ ) -> dict[str, Any] | list[dict[str, Any]]:
36
38
  """
37
39
  Get company overview including business description, sector, and key metrics
38
40
 
39
41
  Args:
40
- symbol: Stock symbol (e.g., "US:AAPL", "HK:0700", "CN:600519")
42
+ symbols: Stock symbols. You can enter multiple items, separated by commas(,)
43
+ Example: "US:AAPL,US:MSFT"
44
+ names: Stock names. You can enter multiple items, separated by commas(,)
45
+ Example: "Apple Inc.,Microsoft"
41
46
 
42
47
  Returns:
43
- Company information dictionary
48
+ Dictionary or list of dictionaries with company overview data
44
49
 
45
50
  Example:
46
- >>> info = client.stock.overview("US:AAPL")
51
+ >>> # Single stock by symbol
52
+ >>> info = client.stock.overview(symbols="US:AAPL")
47
53
  >>> print(info["name"], info["sector"])
54
+
55
+ >>> # Multiple stocks by symbols
56
+ >>> infos = client.stock.overview(symbols="US:AAPL,US:MSFT")
57
+ >>> for info in infos:
58
+ ... print(info["name"])
59
+
60
+ >>> # Search by name
61
+ >>> info = client.stock.overview(names="Apple Inc.")
48
62
  """
49
- response = self._post("/v1/stock/company-overview", json={"symbol": symbol})
63
+ if not symbols and not names:
64
+ raise ValueError("Either symbols or names must be provided")
65
+
66
+ data = {}
67
+ if symbols:
68
+ data["symbols"] = symbols
69
+ if names:
70
+ data["names"] = names
71
+
72
+ response = self._post("/v1/stock/company-overview", json=data)
50
73
  return response
51
74
 
52
75
  def shareholders(self, symbol: str) -> list[dict[str, Any]]:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: reportify-sdk
3
- Version: 0.2.7
3
+ Version: 0.2.8
4
4
  Summary: Python SDK for Reportify API - Financial data and document search
5
5
  Author-email: Reportify <support@reportify.cn>
6
6
  License-Expression: MIT
File without changes
File without changes
File without changes