finctx 0.3.2__tar.gz → 0.3.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: finctx
-Version: 0.3.2
+Version: 0.3.4
 Summary: Finctx SDK for the Finctx Data API
 Project-URL: Homepage, https://www.ultrastiching.com
 Author: Finctx
@@ -8,19 +8,20 @@ License-Expression: Apache-2.0
 License-File: LICENSE
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
-Requires-Dist: requests<3,>=2.31
-Requires-Dist: urllib3<2,>=1.26.20; python_version < '3.10'
+Requires-Python: >=3.10
+Requires-Dist: certifi>=2026.10.19
+Requires-Dist: requests<3,>=2.33.0
+Requires-Dist: urllib3<3,>=2.8.0
 Requires-Dist: websocket-client<1.9,>=1.8
 Provides-Extra: arrow
-Requires-Dist: pyarrow>=14; extra == 'arrow'
+Requires-Dist: pyarrow>=14.0.1; extra == 'arrow'
 Provides-Extra: marketdb
-Requires-Dist: duckdb<1.6,>=1.4.1; extra == 'marketdb'
+Requires-Dist: duckdb<1.6,>=1.4.2; extra == 'marketdb'
 Provides-Extra: test
-Requires-Dist: duckdb<1.6,>=1.4.1; extra == 'test'
-Requires-Dist: pyarrow>=14; extra == 'test'
+Requires-Dist: duckdb<1.6,>=1.4.2; extra == 'test'
+Requires-Dist: pyarrow>=14.0.1; extra == 'test'
 Requires-Dist: pytest<10,>=8; extra == 'test'
 Description-Content-Type: text/markdown
 
@@ -30,23 +31,25 @@ Description-Content-Type: text/markdown
 
 ## 1. 安装
 
-需要 Python 3.9 或更高版本。安装下载的 SDK 包：
+需要 Python 3.10 或更高版本。本轮安全更新提高了运行环境要求；使用 Python 3.9 的项目需先升级 Python。
+
+安装下载的 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 +123,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.4}/README.md

@@ -4,23 +4,25 @@
 
 ## 1. 安装
 
-需要 Python 3.9 或更高版本。安装下载的 SDK 包：
+需要 Python 3.10 或更高版本。本轮安全更新提高了运行环境要求；使用 Python 3.9 的项目需先升级 Python。
+
+安装下载的 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 +96,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.4}/pyproject.toml

@@ -9,17 +9,18 @@ description = "Finctx SDK for the Finctx Data API"
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE"]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 authors = [{ name = "Finctx" }]
 dependencies = [
-  "requests>=2.31,<3",
-  "urllib3>=1.26.20,<2; python_version < '3.10'",
+  "requests>=2.33.0,<3",
+  "certifi>=2026.10.19",
+  "urllib3>=2.8.0,<3",
   "websocket-client>=1.8,<1.9",
 ]
 classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
   "Typing :: Typed",
 ]
 
@@ -27,9 +28,9 @@ classifiers = [
 Homepage = "https://www.ultrastiching.com"
 
 [project.optional-dependencies]
-arrow = ["pyarrow>=14"]
-marketdb = ["duckdb>=1.4.1,<1.6"]
-test = ["pytest>=8,<10", "duckdb>=1.4.1,<1.6", "pyarrow>=14"]
+arrow = ["pyarrow>=14.0.1"]
+marketdb = ["duckdb>=1.4.2,<1.6"]
+test = ["pytest>=8,<10", "duckdb>=1.4.2,<1.6", "pyarrow>=14.0.1"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/finctx"]

{finctx-0.3.2 → finctx-0.3.4}/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.4"