ffdata 0.2.8__tar.gz → 0.2.9__tar.gz

{ffdata-0.2.8 → ffdata-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffdata
-Version: 0.2.8
+Version: 0.2.9
 Summary: ffdata lightweight Python client for governed financial-data APIs
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown

{ffdata-0.2.8 → ffdata-0.2.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ffdata"
-version = "0.2.8"
+version = "0.2.9"
 description = "ffdata lightweight Python client for governed financial-data APIs"
 readme = "README.md"
 requires-python = ">=3.12"

{ffdata-0.2.8 → ffdata-0.2.9}/src/ffdata/__init__.py

@@ -165,6 +165,16 @@ def macro_indicator_data(*args: Any, **kwargs: Any):
     return _client().macro_indicator_data(*args, **kwargs)
 
 
+def intl_macro_indicator_basic(*args: Any, **kwargs: Any):
+    """通过默认客户端查询国际宏观指标基本信息（国家/口径/频率/单位随行返回）。"""
+    return _client().intl_macro_indicator_basic(*args, **kwargs)
+
+
+def intl_macro_indicator_data(*args: Any, **kwargs: Any):
+    """通过默认客户端查询国际宏观指标时间序列（含预测值标识）。"""
+    return _client().intl_macro_indicator_data(*args, **kwargs)
+
+
 def trade_cal(*args: Any, **kwargs: Any):
     """通过默认客户端查询交易日历（8 列，支持沪深/北交所/港股/美股/银行间）。"""
     return _client().trade_cal(*args, **kwargs)
@@ -196,6 +206,8 @@ __all__ = [
     "index_valuation",
     "index_weight",
     "index_industry",
+    "intl_macro_indicator_basic",
+    "intl_macro_indicator_data",
     "macro_indicator_basic",
     "macro_indicator_data",
     "query",

{ffdata-0.2.8 → ffdata-0.2.9}/src/ffdata/client.py

@@ -358,10 +358,23 @@ class Client:
         *,
         indicator_code: int | list[int] | None = None,
         name: str | None = None,
+        state: str = "active",
+        limit: int = 20,
         fields: list[str] | None = None,
     ) -> pd.DataFrame:
+        """查询宏观指标基本信息（名称 → 指标代码）。
+
+        ``name`` 走全库名称检索（支持空格分词），``state`` 默认 ``active`` 只返回有效
+        指标（``all`` 含已终止指标），``limit`` 默认 20、最大 200。返回的
+        ``indicator_code`` 可直接用于 :meth:`macro_indicator_data`。
+        """
         return self.query(
-            "macro_indicator_basic", indicator_code=indicator_code, name=name, fields=fields
+            "macro_indicator_basic",
+            indicator_code=indicator_code,
+            name=name,
+            state=state,
+            limit=limit,
+            fields=fields,
         )
 
     def macro_indicator_data(
@@ -380,6 +393,55 @@ class Client:
             fields=fields,
         )
 
+    def intl_macro_indicator_basic(
+        self,
+        *,
+        name: str | None = None,
+        indicator_code: int | list[int] | None = None,
+        region: str | list[str] | None = None,
+        state: str = "active",
+        limit: int = 20,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询国际宏观指标基本信息（名称/地区 → 指标代码）。
+
+        ``name`` 同时匹配中文名与英文名（支持空格分词），``region`` 按国家/地区名称
+        精确筛选；``state`` 默认 ``active`` 只返回有效指标（``all`` 含已终止指标），
+        ``limit`` 默认 20、最大 200。返回的 ``indicator_code`` 可直接用于
+        :meth:`intl_macro_indicator_data`。
+        """
+        return self.query(
+            "intl_macro_indicator_basic",
+            indicator_code=indicator_code,
+            name=name,
+            region=region,
+            state=state,
+            limit=limit,
+            fields=fields,
+        )
+
+    def intl_macro_indicator_data(
+        self,
+        indicator_code: int | list[int],
+        *,
+        start_date: Any = None,
+        end_date: Any = None,
+        fields: list[str] | None = None,
+    ) -> pd.DataFrame:
+        """查询国际宏观指标时间序列（指标代码 → 指标数据）。
+
+        ``indicator_code`` 取自 :meth:`intl_macro_indicator_basic`；``start_date`` /
+        ``end_date`` 可只给一端，都不给表示返回全部可用数据。返回行含单位/频率与
+        ``data_disclosure_type``（``2401`` 表示预测值，空表示实际值），数值不做换算。
+        """
+        return self.query(
+            "intl_macro_indicator_data",
+            indicator_code=indicator_code,
+            start_date=start_date,
+            end_date=end_date,
+            fields=fields,
+        )
+
     def stock_basic(
         self,
         *,

{ffdata-0.2.8 → ffdata-0.2.9}/src/ffdata.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffdata
-Version: 0.2.8
+Version: 0.2.9
 Summary: ffdata lightweight Python client for governed financial-data APIs
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown