finctx 0.3.2__tar.gz → 0.3.3__tar.gz

{finctx-0.3.2 → finctx-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: finctx
-Version: 0.3.2
+Version: 0.3.3
 Summary: Finctx SDK for the Finctx Data API
 Project-URL: Homepage, https://www.ultrastiching.com
 Author: Finctx
@@ -33,20 +33,20 @@ Description-Content-Type: text/markdown
 需要 Python 3.9 或更高版本。安装下载的 SDK 包：
 
 ```bash
-python -m pip install ./finctx-0.3.1-py3-none-any.whl
+python -m pip install ./finctx-0.3.3-py3-none-any.whl
 ```
 
 也可以直接安装源码包：
 
 ```bash
-python -m pip install ./finctx-0.3.1.tar.gz
+python -m pip install ./finctx-0.3.3.tar.gz
 ```
 
 需要处理 Arrow 数据或使用本地数据库时，再安装相应扩展：
 
 ```bash
-python -m pip install "finctx[arrow]==0.3.1"     # Arrow 数据转换
-python -m pip install "finctx[marketdb]==0.3.1"  # 本地数据库
+python -m pip install "finctx[arrow]==0.3.3"     # Arrow 数据转换
+python -m pip install "finctx[marketdb]==0.3.3"  # 本地数据库
 ```
 
 ## 2. 配置 API Key
@@ -120,16 +120,19 @@ with FinctxClient() as client:
     feed = client.get_tracer_feed(limit=20)
     print(feed["items"])
 
-    page = client.search_tracer_content(q="美债", scope="following", limit=20)
+    page = client.search_tracer_content(q="美债", scope="global", limit=20)
     print(page["items"])
 
+    public_topics = client.list_tracer_public_topics()
+    print(public_topics["items"])  # id、名称、描述、关注状态和主题状态
+
     topics = client.list_tracer_topics()
     print(topics)
 ```
 
 资讯结果使用 `items`，直接读取，不调用 `rows()`。新闻搜索返回 `has_more=True` 时，下一页传入 `next_cursor`，并保留相同筛选条件及返回的时间范围；Python 参数 `from_`、`to` 分别使用 `window["from"]`、`window["to"]`。
 
-主题创建使用 `create_tracer_topic(query=...)`；关注和取消关注使用 `follow_tracer_topic(id=...)`、`unfollow_tracer_topic(id=...)`，主题 ID 从主题列表取得。创建回执表示任务已受理，不代表内容已生成完成。
+主题创建使用 `create_tracer_topic(query=...)`；关注和取消关注使用 `follow_tracer_topic(id=...)`、`unfollow_tracer_topic(id=...)`，主题 ID 从 `list_tracer_public_topics()` 返回的真实 `id` 取得；该列表无需先关注。普通关键词搜索使用 `scope="global"`，无需关注；`scope="following"` 只搜索自己的关注范围。创建回执表示任务已受理，不代表内容已生成完成。
 
 ## 订阅实时快讯
 

{finctx-0.3.2 → finctx-0.3.3}/README.md

@@ -7,20 +7,20 @@
 需要 Python 3.9 或更高版本。安装下载的 SDK 包：
 
 ```bash
-python -m pip install ./finctx-0.3.1-py3-none-any.whl
+python -m pip install ./finctx-0.3.3-py3-none-any.whl
 ```
 
 也可以直接安装源码包：
 
 ```bash
-python -m pip install ./finctx-0.3.1.tar.gz
+python -m pip install ./finctx-0.3.3.tar.gz
 ```
 
 需要处理 Arrow 数据或使用本地数据库时，再安装相应扩展：
 
 ```bash
-python -m pip install "finctx[arrow]==0.3.1"     # Arrow 数据转换
-python -m pip install "finctx[marketdb]==0.3.1"  # 本地数据库
+python -m pip install "finctx[arrow]==0.3.3"     # Arrow 数据转换
+python -m pip install "finctx[marketdb]==0.3.3"  # 本地数据库
 ```
 
 ## 2. 配置 API Key
@@ -94,16 +94,19 @@ with FinctxClient() as client:
     feed = client.get_tracer_feed(limit=20)
     print(feed["items"])
 
-    page = client.search_tracer_content(q="美债", scope="following", limit=20)
+    page = client.search_tracer_content(q="美债", scope="global", limit=20)
     print(page["items"])
 
+    public_topics = client.list_tracer_public_topics()
+    print(public_topics["items"])  # id、名称、描述、关注状态和主题状态
+
     topics = client.list_tracer_topics()
     print(topics)
 ```
 
 资讯结果使用 `items`，直接读取，不调用 `rows()`。新闻搜索返回 `has_more=True` 时，下一页传入 `next_cursor`，并保留相同筛选条件及返回的时间范围；Python 参数 `from_`、`to` 分别使用 `window["from"]`、`window["to"]`。
 
-主题创建使用 `create_tracer_topic(query=...)`；关注和取消关注使用 `follow_tracer_topic(id=...)`、`unfollow_tracer_topic(id=...)`，主题 ID 从主题列表取得。创建回执表示任务已受理，不代表内容已生成完成。
+主题创建使用 `create_tracer_topic(query=...)`；关注和取消关注使用 `follow_tracer_topic(id=...)`、`unfollow_tracer_topic(id=...)`，主题 ID 从 `list_tracer_public_topics()` 返回的真实 `id` 取得；该列表无需先关注。普通关键词搜索使用 `scope="global"`，无需关注；`scope="following"` 只搜索自己的关注范围。创建回执表示任务已受理，不代表内容已生成完成。
 
 ## 订阅实时快讯
 

{finctx-0.3.2 → finctx-0.3.3}/src/finctx/_version.py

@@ -1,3 +1,3 @@
 """Single source of truth for the Finctx Python SDK version."""
 
-__version__ = "0.3.2"
+__version__ = "0.3.3"