finchx 2.0.2__tar.gz → 3.0.0__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.
Files changed (437) hide show
  1. finchx-3.0.0/MANIFEST.in +19 -0
  2. finchx-3.0.0/PKG-INFO +75 -0
  3. finchx-3.0.0/README.md +52 -0
  4. finchx-3.0.0/docs/API.md +4727 -0
  5. finchx-3.0.0/pyproject.toml +30 -0
  6. finchx-3.0.0/src/finchx/__init__.py +7 -0
  7. finchx-3.0.0/src/finchx/_common/__init__.py +1 -0
  8. finchx-3.0.0/src/finchx/_common/convert.py +141 -0
  9. finchx-3.0.0/src/finchx/_common/deviation.py +95 -0
  10. finchx-3.0.0/src/finchx/_common/errors.py +18 -0
  11. finchx-3.0.0/src/finchx/_common/http.py +177 -0
  12. finchx-3.0.0/src/finchx/_common/news.py +41 -0
  13. finchx-3.0.0/src/finchx/_common/pdf.py +154 -0
  14. finchx-3.0.0/src/finchx/api/__init__.py +1 -0
  15. finchx-3.0.0/src/finchx/api/articles.py +35 -0
  16. finchx-3.0.0/src/finchx/api/company.py +18 -0
  17. finchx-3.0.0/src/finchx/api/disclosure.py +26 -0
  18. finchx-3.0.0/src/finchx/api/financial.py +16 -0
  19. finchx-3.0.0/src/finchx/api/forum.py +23 -0
  20. finchx-3.0.0/src/finchx/api/fund_flow.py +23 -0
  21. finchx-3.0.0/src/finchx/api/fupan.py +14 -0
  22. finchx-3.0.0/src/finchx/api/hotlist.py +29 -0
  23. finchx-3.0.0/src/finchx/api/iwencai.py +28 -0
  24. finchx-3.0.0/src/finchx/api/market.py +97 -0
  25. finchx-3.0.0/src/finchx/api/news.py +35 -0
  26. finchx-3.0.0/src/finchx/api/reference.py +57 -0
  27. finchx-3.0.0/src/finchx/api/regulation.py +39 -0
  28. finchx-3.0.0/src/finchx/api/reports.py +23 -0
  29. finchx-3.0.0/src/finchx/api/sector.py +38 -0
  30. finchx-3.0.0/src/finchx/client.py +48 -0
  31. finchx-3.0.0/src/finchx/sources/__init__.py +1 -0
  32. finchx-3.0.0/src/finchx/sources/aigupiao/__init__.py +1 -0
  33. finchx-3.0.0/src/finchx/sources/aigupiao/articles.py +366 -0
  34. finchx-3.0.0/src/finchx/sources/aigupiao/consecutive.py +143 -0
  35. finchx-3.0.0/src/finchx/sources/aigupiao/dragon_tiger.py +142 -0
  36. finchx-3.0.0/src/finchx/sources/aigupiao/news.py +187 -0
  37. finchx-3.0.0/src/finchx/sources/aigupiao/reports.py +374 -0
  38. finchx-3.0.0/src/finchx/sources/aigupiao/sentiment.py +92 -0
  39. finchx-3.0.0/src/finchx/sources/baidu/__init__.py +1 -0
  40. finchx-3.0.0/src/finchx/sources/baidu/news.py +145 -0
  41. finchx-3.0.0/src/finchx/sources/eastmoney/__init__.py +1 -0
  42. finchx-3.0.0/src/finchx/sources/eastmoney/breadth.py +91 -0
  43. finchx-3.0.0/src/finchx/sources/eastmoney/disclosure.py +433 -0
  44. finchx-3.0.0/src/finchx/sources/eastmoney/keywords.py +89 -0
  45. finchx-3.0.0/src/finchx/sources/eastmoney/news.py +421 -0
  46. finchx-3.0.0/src/finchx/sources/eastmoney/pools.py +245 -0
  47. finchx-3.0.0/src/finchx/sources/eastmoney/regulation.py +389 -0
  48. finchx-3.0.0/src/finchx/sources/iwencai/__init__.py +1 -0
  49. finchx-3.0.0/src/finchx/sources/iwencai/_document.py +480 -0
  50. finchx-3.0.0/src/finchx/sources/iwencai/_values.py +144 -0
  51. finchx-3.0.0/src/finchx/sources/iwencai/report.py +151 -0
  52. finchx-3.0.0/src/finchx/sources/iwencai/search.py +54 -0
  53. finchx-3.0.0/src/finchx/sources/iwencai/selection.py +303 -0
  54. finchx-3.0.0/src/finchx/sources/jiuyangongshe/__init__.py +1 -0
  55. finchx-3.0.0/src/finchx/sources/jiuyangongshe/replay.py +270 -0
  56. finchx-3.0.0/src/finchx/sources/pandas_market_calendars/__init__.py +1 -0
  57. finchx-3.0.0/src/finchx/sources/pandas_market_calendars/calendar.py +39 -0
  58. finchx-3.0.0/src/finchx/sources/sina/__init__.py +1 -0
  59. finchx-3.0.0/src/finchx/sources/sina/report.py +178 -0
  60. finchx-3.0.0/src/finchx/sources/szse/__init__.py +1 -0
  61. finchx-3.0.0/src/finchx/sources/szse/calendar.py +63 -0
  62. finchx-3.0.0/src/finchx/sources/taoguba/__init__.py +1 -0
  63. finchx-3.0.0/src/finchx/sources/taoguba/forum.py +493 -0
  64. finchx-3.0.0/src/finchx/sources/tencent/__init__.py +1 -0
  65. finchx-3.0.0/src/finchx/sources/tencent/company.py +426 -0
  66. finchx-3.0.0/src/finchx/sources/tencent/deviation.py +342 -0
  67. finchx-3.0.0/src/finchx/sources/tencent/fund_flow.py +143 -0
  68. finchx-3.0.0/src/finchx/sources/tencent/intraday.py +177 -0
  69. finchx-3.0.0/src/finchx/sources/tencent/klines.py +125 -0
  70. finchx-3.0.0/src/finchx/sources/tencent/market.py +280 -0
  71. finchx-3.0.0/src/finchx/sources/tencent/quote.py +86 -0
  72. finchx-3.0.0/src/finchx/sources/tencent/sector.py +145 -0
  73. finchx-3.0.0/src/finchx/sources/tonghuashun/__init__.py +1 -0
  74. finchx-3.0.0/src/finchx/sources/tonghuashun/_article_url.py +81 -0
  75. finchx-3.0.0/src/finchx/sources/tonghuashun/articles.py +689 -0
  76. finchx-3.0.0/src/finchx/sources/tonghuashun/concept.py +307 -0
  77. finchx-3.0.0/src/finchx/sources/tonghuashun/financial.py +185 -0
  78. finchx-3.0.0/src/finchx/sources/tonghuashun/hot_content.py +254 -0
  79. finchx-3.0.0/src/finchx/sources/tonghuashun/hotlist.py +572 -0
  80. finchx-3.0.0/src/finchx/sources/tonghuashun/topic_articles.py +207 -0
  81. finchx-3.0.0/src/finchx.egg-info/PKG-INFO +75 -0
  82. finchx-3.0.0/src/finchx.egg-info/SOURCES.txt +237 -0
  83. finchx-3.0.0/src/finchx.egg-info/requires.txt +14 -0
  84. finchx-3.0.0/tests/fixtures/articles_ths/detail_deep.html +1341 -0
  85. finchx-3.0.0/tests/fixtures/articles_ths/detail_long.json +23 -0
  86. finchx-3.0.0/tests/fixtures/articles_ths/detail_mams.html +24 -0
  87. finchx-3.0.0/tests/fixtures/articles_ths/detail_news.json +88 -0
  88. finchx-3.0.0/tests/fixtures/articles_ths/detail_short.json +64 -0
  89. finchx-3.0.0/tests/fixtures/articles_ths/detail_short_kuaicha.json +1 -0
  90. finchx-3.0.0/tests/fixtures/articles_ths/detail_short_kuaicha_q.json +254 -0
  91. finchx-3.0.0/tests/fixtures/articles_ths/detail_video.json +23 -0
  92. finchx-3.0.0/tests/fixtures/articles_ths/hot_articles.json +1 -0
  93. finchx-3.0.0/tests/fixtures/articles_ths/hot_topics.json +1 -0
  94. finchx-3.0.0/tests/fixtures/articles_ths/hot_topics_empty.json +1 -0
  95. finchx-3.0.0/tests/fixtures/articles_ths/topic_feed.json +1 -0
  96. finchx-3.0.0/tests/fixtures/articles_ths/topic_recommend.json +1 -0
  97. finchx-3.0.0/tests/fixtures/articles_ths/topic_snsview_feed.json +730 -0
  98. finchx-3.0.0/tests/fixtures/company_holders_1990.txt +1 -0
  99. finchx-3.0.0/tests/fixtures/company_holders_2013.txt +1 -0
  100. finchx-3.0.0/tests/fixtures/company_holders_2024.txt +1 -0
  101. finchx-3.0.0/tests/fixtures/company_sh600519_f10.txt +1 -0
  102. finchx-3.0.0/tests/fixtures/company_sh600519_holders.txt +1 -0
  103. finchx-3.0.0/tests/fixtures/company_sz000001_f10.txt +1 -0
  104. finchx-3.0.0/tests/fixtures/company_sz000001_holders.txt +1 -0
  105. finchx-3.0.0/tests/fixtures/company_sz000333_f10.txt +1 -0
  106. finchx-3.0.0/tests/fixtures/company_sz000333_holders.txt +1 -0
  107. finchx-3.0.0/tests/fixtures/disclosure/annual_2.json +30 -0
  108. finchx-3.0.0/tests/fixtures/disclosure/annual_3.json +30 -0
  109. finchx-3.0.0/tests/fixtures/disclosure/annual_4.json +30 -0
  110. finchx-3.0.0/tests/fixtures/disclosure/annual_5.json +30 -0
  111. finchx-3.0.0/tests/fixtures/disclosure/detail_annual.json +30 -0
  112. finchx-3.0.0/tests/fixtures/disclosure/detail_mixed.json +35 -0
  113. finchx-3.0.0/tests/fixtures/disclosure/detail_old.json +30 -0
  114. finchx-3.0.0/tests/fixtures/disclosure/review_exact100.json +2039 -0
  115. finchx-3.0.0/tests/fixtures/financial_ths_000001_benefit.json +3 -0
  116. finchx-3.0.0/tests/fixtures/financial_ths_000001_cash.json +3 -0
  117. finchx-3.0.0/tests/fixtures/financial_ths_000001_debt.json +3 -0
  118. finchx-3.0.0/tests/fixtures/financial_ths_000333_benefit.json +3 -0
  119. finchx-3.0.0/tests/fixtures/financial_ths_000333_cash.json +3 -0
  120. finchx-3.0.0/tests/fixtures/financial_ths_000333_debt.json +3 -0
  121. finchx-3.0.0/tests/fixtures/financial_ths_600519_benefit.json +3 -0
  122. finchx-3.0.0/tests/fixtures/financial_ths_600519_cash.json +3 -0
  123. finchx-3.0.0/tests/fixtures/financial_ths_600519_debt.json +3 -0
  124. finchx-3.0.0/tests/fixtures/forum/public-replies-103521741-103521904.html +314 -0
  125. finchx-3.0.0/tests/fixtures/forum/short-quote-103543436.html +2 -0
  126. finchx-3.0.0/tests/fixtures/fund_flow_600519.json +124 -0
  127. finchx-3.0.0/tests/fixtures/fupan_agp_detail.json +1 -0
  128. finchx-3.0.0/tests/fixtures/fupan_agp_list.json +1351 -0
  129. finchx-3.0.0/tests/fixtures/hotlist/bond.json +806 -0
  130. finchx-3.0.0/tests/fixtures/hotlist/etf_metrics_all.json +22034 -0
  131. finchx-3.0.0/tests/fixtures/hotlist/etf_metrics_commodity.json +246 -0
  132. finchx-3.0.0/tests/fixtures/hotlist/etf_metrics_cross_border.json +3249 -0
  133. finchx-3.0.0/tests/fixtures/hotlist/etf_metrics_price_limit_20.json +3236 -0
  134. finchx-3.0.0/tests/fixtures/hotlist/etf_metrics_t0.json +4510 -0
  135. finchx-3.0.0/tests/fixtures/hotlist/etf_pool_commodity.json +162 -0
  136. finchx-3.0.0/tests/fixtures/hotlist/etf_pool_cross_border.json +1779 -0
  137. finchx-3.0.0/tests/fixtures/hotlist/etf_pool_popular.json +11894 -0
  138. finchx-3.0.0/tests/fixtures/hotlist/etf_pool_price_limit_20.json +1772 -0
  139. finchx-3.0.0/tests/fixtures/hotlist/etf_pool_t0.json +2458 -0
  140. finchx-3.0.0/tests/fixtures/hotlist/etf_tags_all_correct.json +38877 -0
  141. finchx-3.0.0/tests/fixtures/hotlist/index_etf_quotes.json +270 -0
  142. finchx-3.0.0/tests/fixtures/hotlist/index_etf_recommend.json +166 -0
  143. finchx-3.0.0/tests/fixtures/hotlist/index_sector.json +374 -0
  144. finchx-3.0.0/tests/fixtures/hotlist/new_stock.json +71 -0
  145. finchx-3.0.0/tests/fixtures/hotlist/plate_concept.json +288 -0
  146. finchx-3.0.0/tests/fixtures/hotlist/plate_industry.json +291 -0
  147. finchx-3.0.0/tests/fixtures/hotlist/stock_popular_day.json +1641 -0
  148. finchx-3.0.0/tests/fixtures/hotlist/stock_popular_hour.json +1672 -0
  149. finchx-3.0.0/tests/fixtures/hotlist/stock_rising_day.json +1679 -0
  150. finchx-3.0.0/tests/fixtures/hotlist/stock_rising_hour.json +1630 -0
  151. finchx-3.0.0/tests/fixtures/hotlist/stock_technical_day.json +1903 -0
  152. finchx-3.0.0/tests/fixtures/hotlist/stock_trend_day.json +755 -0
  153. finchx-3.0.0/tests/fixtures/hotlist/stock_value_day.json +1896 -0
  154. finchx-3.0.0/tests/fixtures/iwencai/sina-report-excerpt.html +10 -0
  155. finchx-3.0.0/tests/fixtures/iwencai_notice_detail.json +13 -0
  156. finchx-3.0.0/tests/fixtures/limit_pool_rows.json +158 -0
  157. finchx-3.0.0/tests/fixtures/news_agp_rows.json +80 -0
  158. finchx-3.0.0/tests/fixtures/news_bd_rows.json +26 -0
  159. finchx-3.0.0/tests/fixtures/news_eastmoney/cfh.html +93 -0
  160. finchx-3.0.0/tests/fixtures/news_eastmoney/cfh_modified_excerpt.html +7 -0
  161. finchx-3.0.0/tests/fixtures/news_eastmoney/cms.html +7 -0
  162. finchx-3.0.0/tests/fixtures/news_eastmoney/list.json +1 -0
  163. finchx-3.0.0/tests/fixtures/news_eastmoney/routes_page_5.json +192 -0
  164. finchx-3.0.0/tests/fixtures/regulation_counts.json +175 -0
  165. finchx-3.0.0/tests/fixtures/regulation_history.json +140 -0
  166. finchx-3.0.0/tests/fixtures/regulation_ordinary.json +172 -0
  167. finchx-3.0.0/tests/fixtures/regulation_predictions.json +166 -0
  168. finchx-3.0.0/tests/fixtures/regulation_severe.json +140 -0
  169. finchx-3.0.0/tests/fixtures/regulation_watchlist.json +107 -0
  170. finchx-3.0.0/tests/fixtures/reports/detail-2477158.html +62 -0
  171. finchx-3.0.0/tests/fixtures/reports/detail-2477179.html +58 -0
  172. finchx-3.0.0/tests/fixtures/reports/detail-2477185.html +62 -0
  173. finchx-3.0.0/tests/fixtures/reports/industry-dictionary.json +1 -0
  174. finchx-3.0.0/tests/fixtures/reports/list-all.json +1 -0
  175. finchx-3.0.0/tests/fixtures/sector_em_keywords_600519.json +49 -0
  176. finchx-3.0.0/tests/fixtures/sector_tencent_industry_600519.json +1 -0
  177. finchx-3.0.0/tests/fixtures/sector_tencent_sectors_600519.json +151 -0
  178. finchx-3.0.0/tests/fixtures/tonghuashun_concept_detail.html +55 -0
  179. finchx-3.0.0/tests/fixtures/tonghuashun_concept_last.txt +1 -0
  180. finchx-3.0.0/tests/fixtures/tonghuashun_concept_list.html +363 -0
  181. finchx-3.0.0/tests/fixtures/tonghuashun_concept_quote.txt +1 -0
  182. finchx-3.0.0/tests/fixtures/tonghuashun_concept_year.txt +1 -0
  183. finchx-3.0.0/tests/test_all_quotes.py +434 -0
  184. finchx-3.0.0/tests/test_articles_aigupiao.py +364 -0
  185. finchx-3.0.0/tests/test_articles_api.py +88 -0
  186. finchx-3.0.0/tests/test_articles_hot_content.py +225 -0
  187. finchx-3.0.0/tests/test_articles_ths_get.py +538 -0
  188. finchx-3.0.0/tests/test_articles_ths_list.py +296 -0
  189. finchx-3.0.0/tests/test_baidu_empty_state.py +76 -0
  190. finchx-3.0.0/tests/test_company.py +286 -0
  191. finchx-3.0.0/tests/test_company_financial.py +195 -0
  192. finchx-3.0.0/tests/test_consecutive_limit_up.py +244 -0
  193. finchx-3.0.0/tests/test_date_parameters.py +83 -0
  194. finchx-3.0.0/tests/test_deviation.py +719 -0
  195. finchx-3.0.0/tests/test_disclosure_api.py +81 -0
  196. finchx-3.0.0/tests/test_disclosure_source.py +350 -0
  197. finchx-3.0.0/tests/test_financial.py +216 -0
  198. finchx-3.0.0/tests/test_forum_api.py +88 -0
  199. finchx-3.0.0/tests/test_forum_source.py +535 -0
  200. finchx-3.0.0/tests/test_fund_flow.py +292 -0
  201. finchx-3.0.0/tests/test_fupan_dragon_tiger.py +278 -0
  202. finchx-3.0.0/tests/test_hotlist_api.py +77 -0
  203. finchx-3.0.0/tests/test_hotlist_source.py +420 -0
  204. finchx-3.0.0/tests/test_http_post.py +202 -0
  205. finchx-3.0.0/tests/test_http_post_text.py +67 -0
  206. finchx-3.0.0/tests/test_intraday.py +166 -0
  207. finchx-3.0.0/tests/test_iwencai_api.py +121 -0
  208. finchx-3.0.0/tests/test_iwencai_document.py +306 -0
  209. finchx-3.0.0/tests/test_iwencai_report_source.py +233 -0
  210. finchx-3.0.0/tests/test_iwencai_search_source.py +98 -0
  211. finchx-3.0.0/tests/test_iwencai_selection_source.py +339 -0
  212. finchx-3.0.0/tests/test_iwencai_sina_report.py +137 -0
  213. finchx-3.0.0/tests/test_jygs_replay.py +368 -0
  214. finchx-3.0.0/tests/test_limit_pools.py +311 -0
  215. finchx-3.0.0/tests/test_market_overview.py +188 -0
  216. finchx-3.0.0/tests/test_news_api.py +66 -0
  217. finchx-3.0.0/tests/test_news_common.py +96 -0
  218. finchx-3.0.0/tests/test_news_eastmoney.py +292 -0
  219. finchx-3.0.0/tests/test_news_eastmoney_directory_urls.py +96 -0
  220. finchx-3.0.0/tests/test_news_eastmoney_modified_time.py +65 -0
  221. finchx-3.0.0/tests/test_news_eastmoney_routes.py +163 -0
  222. finchx-3.0.0/tests/test_news_feeds.py +263 -0
  223. finchx-3.0.0/tests/test_ohlcv.py +142 -0
  224. finchx-3.0.0/tests/test_package_import.py +47 -0
  225. finchx-3.0.0/tests/test_pdf_text.py +474 -0
  226. finchx-3.0.0/tests/test_quote.py +161 -0
  227. finchx-3.0.0/tests/test_regulation.py +238 -0
  228. finchx-3.0.0/tests/test_reports_api.py +73 -0
  229. finchx-3.0.0/tests/test_reports_source.py +315 -0
  230. finchx-3.0.0/tests/test_sector_keywords.py +189 -0
  231. finchx-3.0.0/tests/test_sector_tencent.py +264 -0
  232. finchx-3.0.0/tests/test_sector_tonghuashun.py +302 -0
  233. finchx-3.0.0/tests/test_source_time_compat.py +61 -0
  234. finchx-3.0.0/tests/test_source_time_offsets.py +63 -0
  235. finchx-3.0.0/tests/test_trading_calendar.py +360 -0
  236. finchx-2.0.2/CHANGELOG.md +0 -65
  237. finchx-2.0.2/MANIFEST.in +0 -20
  238. finchx-2.0.2/PKG-INFO +0 -308
  239. finchx-2.0.2/README.md +0 -82
  240. finchx-2.0.2/pyproject.toml +0 -40
  241. finchx-2.0.2/src/finchx/__init__.py +0 -13
  242. finchx-2.0.2/src/finchx/client.py +0 -1606
  243. finchx-2.0.2/src/finchx/collector.py +0 -99
  244. finchx-2.0.2/src/finchx/collectors/__init__.py +0 -109
  245. finchx-2.0.2/src/finchx/collectors/core.py +0 -2134
  246. finchx-2.0.2/src/finchx/collectors/errors.py +0 -145
  247. finchx-2.0.2/src/finchx/computed/__init__.py +0 -33
  248. finchx-2.0.2/src/finchx/computed/deviation.py +0 -1638
  249. finchx-2.0.2/src/finchx/config.py +0 -1
  250. finchx-2.0.2/src/finchx/contracts/__init__.py +0 -49
  251. finchx-2.0.2/src/finchx/contracts/dataset.py +0 -14
  252. finchx-2.0.2/src/finchx/contracts/dates.py +0 -58
  253. finchx-2.0.2/src/finchx/contracts/models.py +0 -203
  254. finchx-2.0.2/src/finchx/contracts/status.py +0 -14
  255. finchx-2.0.2/src/finchx/contracts/units.py +0 -113
  256. finchx-2.0.2/src/finchx/datasets/__init__.py +0 -535
  257. finchx-2.0.2/src/finchx/datasets/article_detail.py +0 -489
  258. finchx-2.0.2/src/finchx/datasets/company_executive_share_change.py +0 -81
  259. finchx-2.0.2/src/finchx/datasets/company_executive_snapshot.py +0 -79
  260. finchx-2.0.2/src/finchx/datasets/corporate_action_dividend.py +0 -91
  261. finchx-2.0.2/src/finchx/datasets/corporate_action_repurchase.py +0 -85
  262. finchx-2.0.2/src/finchx/datasets/definition.py +0 -40
  263. finchx-2.0.2/src/finchx/datasets/disclosure.py +0 -335
  264. finchx-2.0.2/src/finchx/datasets/document_common.py +0 -195
  265. finchx-2.0.2/src/finchx/datasets/financial_statement.py +0 -178
  266. finchx-2.0.2/src/finchx/datasets/forum.py +0 -155
  267. finchx-2.0.2/src/finchx/datasets/fundamental_common.py +0 -81
  268. finchx-2.0.2/src/finchx/datasets/fundamental_company_profile.py +0 -106
  269. finchx-2.0.2/src/finchx/datasets/fundamental_financial_summary.py +0 -140
  270. finchx-2.0.2/src/finchx/datasets/fundamental_industry_comparison.py +0 -169
  271. finchx-2.0.2/src/finchx/datasets/fundamental_revenue_breakdown.py +0 -125
  272. finchx-2.0.2/src/finchx/datasets/hotlist.py +0 -429
  273. finchx-2.0.2/src/finchx/datasets/instrument.py +0 -175
  274. finchx-2.0.2/src/finchx/datasets/iwencai.py +0 -189
  275. finchx-2.0.2/src/finchx/datasets/market_breadth.py +0 -186
  276. finchx-2.0.2/src/finchx/datasets/market_broken_limit_pool.py +0 -171
  277. finchx-2.0.2/src/finchx/datasets/market_concept.py +0 -271
  278. finchx-2.0.2/src/finchx/datasets/market_consecutive_limit_up.py +0 -198
  279. finchx-2.0.2/src/finchx/datasets/market_daily_replay.py +0 -213
  280. finchx-2.0.2/src/finchx/datasets/market_dragon_tiger.py +0 -318
  281. finchx-2.0.2/src/finchx/datasets/market_fund_flow.py +0 -443
  282. finchx-2.0.2/src/finchx/datasets/market_industry_comparison.py +0 -188
  283. finchx-2.0.2/src/finchx/datasets/market_instrument_sector_snapshot.py +0 -184
  284. finchx-2.0.2/src/finchx/datasets/market_intraday.py +0 -400
  285. finchx-2.0.2/src/finchx/datasets/market_klines.py +0 -251
  286. finchx-2.0.2/src/finchx/datasets/market_limit_down_pool.py +0 -167
  287. finchx-2.0.2/src/finchx/datasets/market_limit_up_pool.py +0 -173
  288. finchx-2.0.2/src/finchx/datasets/market_orderbook.py +0 -192
  289. finchx-2.0.2/src/finchx/datasets/market_quote.py +0 -220
  290. finchx-2.0.2/src/finchx/datasets/market_quote_snapshot.py +0 -280
  291. finchx-2.0.2/src/finchx/datasets/market_ranking.py +0 -190
  292. finchx-2.0.2/src/finchx/datasets/market_regulation.py +0 -771
  293. finchx-2.0.2/src/finchx/datasets/market_sentiment.py +0 -213
  294. finchx-2.0.2/src/finchx/datasets/market_stock_keyword.py +0 -180
  295. finchx-2.0.2/src/finchx/datasets/market_strong_pool.py +0 -168
  296. finchx-2.0.2/src/finchx/datasets/market_yesterday_limit_up_pool.py +0 -164
  297. finchx-2.0.2/src/finchx/datasets/news.py +0 -354
  298. finchx-2.0.2/src/finchx/datasets/ownership_capital_snapshot.py +0 -65
  299. finchx-2.0.2/src/finchx/datasets/ownership_float_holder.py +0 -136
  300. finchx-2.0.2/src/finchx/datasets/ownership_holder_summary_snapshot.py +0 -80
  301. finchx-2.0.2/src/finchx/datasets/provider_rows.py +0 -74
  302. finchx-2.0.2/src/finchx/datasets/topic_articles.py +0 -242
  303. finchx-2.0.2/src/finchx/datasets/trading_calendar.py +0 -152
  304. finchx-2.0.2/src/finchx/datasets/trading_calendar_service.py +0 -90
  305. finchx-2.0.2/src/finchx/entities/__init__.py +0 -30
  306. finchx-2.0.2/src/finchx/entities/instrument.py +0 -39
  307. finchx-2.0.2/src/finchx/entities/symbols.py +0 -258
  308. finchx-2.0.2/src/finchx/health/__init__.py +0 -305
  309. finchx-2.0.2/src/finchx/observability.py +0 -276
  310. finchx-2.0.2/src/finchx/providers/__init__.py +0 -119
  311. finchx-2.0.2/src/finchx/providers/aigupiao_market_intelligence.py +0 -613
  312. finchx-2.0.2/src/finchx/providers/eastmoney_disclosure.py +0 -13
  313. finchx-2.0.2/src/finchx/providers/eastmoney_documents.py +0 -744
  314. finchx-2.0.2/src/finchx/providers/eastmoney_market.py +0 -900
  315. finchx-2.0.2/src/finchx/providers/eastmoney_news.py +0 -9
  316. finchx-2.0.2/src/finchx/providers/eastmoney_regulation.py +0 -506
  317. finchx-2.0.2/src/finchx/providers/eastmoney_stock_keyword.py +0 -254
  318. finchx-2.0.2/src/finchx/providers/errors.py +0 -14
  319. finchx-2.0.2/src/finchx/providers/http.py +0 -148
  320. finchx-2.0.2/src/finchx/providers/instrument.py +0 -43
  321. finchx-2.0.2/src/finchx/providers/iwencai.py +0 -949
  322. finchx-2.0.2/src/finchx/providers/jiuyangongshe_replay.py +0 -581
  323. finchx-2.0.2/src/finchx/providers/market_klines.py +0 -18
  324. finchx-2.0.2/src/finchx/providers/market_news.py +0 -527
  325. finchx-2.0.2/src/finchx/providers/market_quote.py +0 -24
  326. finchx-2.0.2/src/finchx/providers/market_ranking.py +0 -24
  327. finchx-2.0.2/src/finchx/providers/registry.py +0 -535
  328. finchx-2.0.2/src/finchx/providers/sohu_klines.py +0 -298
  329. finchx-2.0.2/src/finchx/providers/taoguba_forum.py +0 -368
  330. finchx-2.0.2/src/finchx/providers/tencent.py +0 -794
  331. finchx-2.0.2/src/finchx/providers/tencent_f10.py +0 -831
  332. finchx-2.0.2/src/finchx/providers/tencent_float_holder.py +0 -340
  333. finchx-2.0.2/src/finchx/providers/tencent_fund_flow.py +0 -581
  334. finchx-2.0.2/src/finchx/providers/tencent_industry.py +0 -210
  335. finchx-2.0.2/src/finchx/providers/tencent_intraday.py +0 -415
  336. finchx-2.0.2/src/finchx/providers/tencent_klines.py +0 -726
  337. finchx-2.0.2/src/finchx/providers/tencent_quote.py +0 -201
  338. finchx-2.0.2/src/finchx/providers/tencent_sector.py +0 -197
  339. finchx-2.0.2/src/finchx/providers/ths_articles.py +0 -988
  340. finchx-2.0.2/src/finchx/providers/ths_hotlist.py +0 -467
  341. finchx-2.0.2/src/finchx/providers/ths_topic_articles.py +0 -361
  342. finchx-2.0.2/src/finchx/providers/tonghuashun_concept.py +0 -412
  343. finchx-2.0.2/src/finchx/providers/tonghuashun_financial.py +0 -150
  344. finchx-2.0.2/src/finchx/providers/trading_calendar.py +0 -354
  345. finchx-2.0.2/src/finchx/quality.py +0 -525
  346. finchx-2.0.2/src/finchx/query/__init__.py +0 -15
  347. finchx-2.0.2/src/finchx/query/articles.py +0 -190
  348. finchx-2.0.2/src/finchx/query/documents.py +0 -425
  349. finchx-2.0.2/src/finchx/query/financial.py +0 -57
  350. finchx-2.0.2/src/finchx/query/forum.py +0 -81
  351. finchx-2.0.2/src/finchx/query/market_news.py +0 -339
  352. finchx-2.0.2/src/finchx/schemas/__init__.py +0 -58
  353. finchx-2.0.2/src/finchx/schemas/v1/article-detail.schema.json +0 -388
  354. finchx-2.0.2/src/finchx/schemas/v1/company-executive-share-change.schema.json +0 -25
  355. finchx-2.0.2/src/finchx/schemas/v1/company-executive-snapshot.schema.json +0 -25
  356. finchx-2.0.2/src/finchx/schemas/v1/corporate-action-dividend.schema.json +0 -30
  357. finchx-2.0.2/src/finchx/schemas/v1/corporate-action-repurchase.schema.json +0 -27
  358. finchx-2.0.2/src/finchx/schemas/v1/disclosure-document-ref.schema.json +0 -59
  359. finchx-2.0.2/src/finchx/schemas/v1/disclosure-document.schema.json +0 -50
  360. finchx-2.0.2/src/finchx/schemas/v1/examples/standard-record.json +0 -32
  361. finchx-2.0.2/src/finchx/schemas/v1/examples/status-estimated.json +0 -17
  362. finchx-2.0.2/src/finchx/schemas/v1/examples/status-failed.json +0 -12
  363. finchx-2.0.2/src/finchx/schemas/v1/examples/status-missing.json +0 -12
  364. finchx-2.0.2/src/finchx/schemas/v1/financial-statement.schema.json +0 -39
  365. finchx-2.0.2/src/finchx/schemas/v1/fundamental-company-profile.schema.json +0 -15
  366. finchx-2.0.2/src/finchx/schemas/v1/fundamental-financial-summary.schema.json +0 -36
  367. finchx-2.0.2/src/finchx/schemas/v1/fundamental-industry-comparison.schema.json +0 -31
  368. finchx-2.0.2/src/finchx/schemas/v1/fundamental-revenue-breakdown.schema.json +0 -30
  369. finchx-2.0.2/src/finchx/schemas/v1/hotlist-content.schema.json +0 -470
  370. finchx-2.0.2/src/finchx/schemas/v1/hotlist-convertible-bonds.schema.json +0 -58
  371. finchx-2.0.2/src/finchx/schemas/v1/hotlist-etfs.schema.json +0 -125
  372. finchx-2.0.2/src/finchx/schemas/v1/hotlist-sectors.schema.json +0 -144
  373. finchx-2.0.2/src/finchx/schemas/v1/hotlist-stocks.schema.json +0 -239
  374. finchx-2.0.2/src/finchx/schemas/v1/instrument-identity.schema.json +0 -20
  375. finchx-2.0.2/src/finchx/schemas/v1/instrument.schema.json +0 -14
  376. finchx-2.0.2/src/finchx/schemas/v1/market-abnormal-counts.schema.json +0 -222
  377. finchx-2.0.2/src/finchx/schemas/v1/market-abnormal-records.schema.json +0 -643
  378. finchx-2.0.2/src/finchx/schemas/v1/market-breadth.schema.json +0 -128
  379. finchx-2.0.2/src/finchx/schemas/v1/market-broken-limit-pool.schema.json +0 -219
  380. finchx-2.0.2/src/finchx/schemas/v1/market-concept-list.schema.json +0 -14
  381. finchx-2.0.2/src/finchx/schemas/v1/market-concept-ohlcv.schema.json +0 -18
  382. finchx-2.0.2/src/finchx/schemas/v1/market-concept-quote-snapshot.schema.json +0 -24
  383. finchx-2.0.2/src/finchx/schemas/v1/market-consecutive-limit-up-snapshot.schema.json +0 -237
  384. finchx-2.0.2/src/finchx/schemas/v1/market-daily-replay.schema.json +0 -262
  385. finchx-2.0.2/src/finchx/schemas/v1/market-deviation.schema.json +0 -492
  386. finchx-2.0.2/src/finchx/schemas/v1/market-dragon-tiger-detail.schema.json +0 -278
  387. finchx-2.0.2/src/finchx/schemas/v1/market-dragon-tiger-list.schema.json +0 -188
  388. finchx-2.0.2/src/finchx/schemas/v1/market-equity-intraday-5d.schema.json +0 -134
  389. finchx-2.0.2/src/finchx/schemas/v1/market-equity-intraday.schema.json +0 -134
  390. finchx-2.0.2/src/finchx/schemas/v1/market-fund-flow-daily.schema.json +0 -106
  391. finchx-2.0.2/src/finchx/schemas/v1/market-fund-flow-intraday.schema.json +0 -203
  392. finchx-2.0.2/src/finchx/schemas/v1/market-fund-flow-snapshot.schema.json +0 -249
  393. finchx-2.0.2/src/finchx/schemas/v1/market-index-intraday-5d.schema.json +0 -160
  394. finchx-2.0.2/src/finchx/schemas/v1/market-index-intraday.schema.json +0 -160
  395. finchx-2.0.2/src/finchx/schemas/v1/market-industry-comparison.schema.json +0 -56
  396. finchx-2.0.2/src/finchx/schemas/v1/market-instrument-sector-snapshot.schema.json +0 -28
  397. finchx-2.0.2/src/finchx/schemas/v1/market-klines.schema.json +0 -59
  398. finchx-2.0.2/src/finchx/schemas/v1/market-limit-down-pool.schema.json +0 -234
  399. finchx-2.0.2/src/finchx/schemas/v1/market-limit-up-pool.schema.json +0 -234
  400. finchx-2.0.2/src/finchx/schemas/v1/market-orderbook.schema.json +0 -152
  401. finchx-2.0.2/src/finchx/schemas/v1/market-quote-snapshot.schema.json +0 -234
  402. finchx-2.0.2/src/finchx/schemas/v1/market-quote.schema.json +0 -204
  403. finchx-2.0.2/src/finchx/schemas/v1/market-ranking.schema.json +0 -339
  404. finchx-2.0.2/src/finchx/schemas/v1/market-regulation-watchlist.schema.json +0 -164
  405. finchx-2.0.2/src/finchx/schemas/v1/market-sentiment-snapshot.schema.json +0 -227
  406. finchx-2.0.2/src/finchx/schemas/v1/market-severe-predictions.schema.json +0 -304
  407. finchx-2.0.2/src/finchx/schemas/v1/market-stock-keyword.schema.json +0 -26
  408. finchx-2.0.2/src/finchx/schemas/v1/market-strong-pool.schema.json +0 -219
  409. finchx-2.0.2/src/finchx/schemas/v1/market-yesterday-limit-up-pool.schema.json +0 -196
  410. finchx-2.0.2/src/finchx/schemas/v1/news-document-ref.schema.json +0 -62
  411. finchx-2.0.2/src/finchx/schemas/v1/news-document.schema.json +0 -40
  412. finchx-2.0.2/src/finchx/schemas/v1/ownership-capital-snapshot.schema.json +0 -13
  413. finchx-2.0.2/src/finchx/schemas/v1/ownership-float-holder.schema.json +0 -42
  414. finchx-2.0.2/src/finchx/schemas/v1/ownership-holder-summary-snapshot.schema.json +0 -16
  415. finchx-2.0.2/src/finchx/schemas/v1/provenance.schema.json +0 -44
  416. finchx-2.0.2/src/finchx/schemas/v1/quality.schema.json +0 -28
  417. finchx-2.0.2/src/finchx/schemas/v1/source-reference.schema.json +0 -23
  418. finchx-2.0.2/src/finchx/schemas/v1/source.schema.json +0 -23
  419. finchx-2.0.2/src/finchx/schemas/v1/standard-record.schema.json +0 -130
  420. finchx-2.0.2/src/finchx/schemas/v1/topic-article.schema.json +0 -75
  421. finchx-2.0.2/src/finchx/schemas/v1/trading-calendar.schema.json +0 -21
  422. finchx-2.0.2/src/finchx/schemas/v1/units.schema.json +0 -88
  423. finchx-2.0.2/src/finchx/storage/__init__.py +0 -34
  424. finchx-2.0.2/src/finchx/storage/cache.py +0 -181
  425. finchx-2.0.2/src/finchx/storage/errors.py +0 -40
  426. finchx-2.0.2/src/finchx/storage/memory.py +0 -69
  427. finchx-2.0.2/src/finchx/storage/models.py +0 -210
  428. finchx-2.0.2/src/finchx/storage/protocol.py +0 -49
  429. finchx-2.0.2/src/finchx/storage/serialization.py +0 -224
  430. finchx-2.0.2/src/finchx/storage/sqlite.py +0 -250
  431. finchx-2.0.2/src/finchx.egg-info/PKG-INFO +0 -308
  432. finchx-2.0.2/src/finchx.egg-info/SOURCES.txt +0 -200
  433. finchx-2.0.2/src/finchx.egg-info/requires.txt +0 -14
  434. {finchx-2.0.2 → finchx-3.0.0}/LICENSE +0 -0
  435. {finchx-2.0.2 → finchx-3.0.0}/setup.cfg +0 -0
  436. {finchx-2.0.2 → finchx-3.0.0}/src/finchx.egg-info/dependency_links.txt +0 -0
  437. {finchx-2.0.2 → finchx-3.0.0}/src/finchx.egg-info/top_level.txt +0 -0
@@ -0,0 +1,19 @@
1
+ include README.md LICENSE
2
+ include docs/API.md
3
+ recursive-include tests *.py
4
+ graft tests/fixtures
5
+
6
+ prune .git
7
+ prune .agents
8
+ prune .codex
9
+ prune .aws
10
+ prune .venv
11
+ prune venv
12
+ prune build
13
+ prune dist
14
+ prune .pytest_cache
15
+ prune .mypy_cache
16
+ prune .ruff_cache
17
+ prune htmlcov
18
+ prune docs/tasks
19
+ global-exclude AGENTS.md .env .env.* .pypirc .DS_Store *.py[cod]
finchx-3.0.0/PKG-INFO ADDED
@@ -0,0 +1,75 @@
1
+ Metadata-Version: 2.4
2
+ Name: finchx
3
+ Version: 3.0.0
4
+ Summary: 保留来源原始信息的金融数据接口
5
+ License-Expression: Apache-2.0
6
+ Project-URL: Source, https://github.com/sanshi2026/FinchX
7
+ Project-URL: Documentation, https://github.com/sanshi2026/FinchX/blob/main/docs/API.md
8
+ Project-URL: Issues, https://github.com/sanshi2026/FinchX/issues
9
+ Requires-Python: >=3.10
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Provides-Extra: calendar
13
+ Requires-Dist: pandas_market_calendars<6,>=5.4; extra == "calendar"
14
+ Provides-Extra: jygs
15
+ Requires-Dist: playwright<2,>=1.50; extra == "jygs"
16
+ Provides-Extra: pdf
17
+ Requires-Dist: pypdfium2<6,>=5.14; extra == "pdf"
18
+ Provides-Extra: dev
19
+ Requires-Dist: pytest>=7; extra == "dev"
20
+ Requires-Dist: build>=1.2; extra == "dev"
21
+ Requires-Dist: twine>=6; extra == "dev"
22
+ Dynamic: license-file
23
+
24
+ # FinchX
25
+
26
+ FinchX 是面向 A 股的 Python 数据接口,提供行情、资金流、公司与财务资料,以及新闻、公告、研报等数据。完整接口、参数和业务字段见 [API 文档](https://github.com/sanshi2026/FinchX/blob/main/docs/API.md)。
27
+
28
+ 接口直接返回原生 `dict` 或 `list`,便于查询、分析和接入自己的交易研究流程。
29
+
30
+ ## FinchX 3.0
31
+
32
+ FinchX 3.0 相对旧版有重大更新:重构接口架构与业务分类,统一参数规范,重新核对数据字段、单位和来源语义,并加强完整性校验与错误处理。**强烈推荐旧版用户升级到 3.0。**
33
+
34
+ **3.0 的接口、参数和返回结构与 2.x 不兼容。** 请保留旧环境,在独立环境按 API 文档逐项迁移调用和字段读取。
35
+
36
+ ## 安装
37
+
38
+ 安装:
39
+
40
+ ```bash
41
+ python -m pip install finchx
42
+ ```
43
+ 需要 Python 3.10 或更新版本。建议使用独立虚拟环境。
44
+
45
+ 已有用户升级到 3.0:
46
+
47
+ ```bash
48
+ python -m pip install --upgrade 'finchx==3.0.0'
49
+ ```
50
+
51
+ 按需安装可选依赖:`calendar` 用于离线交易日历及自动日历回退,`pdf` 用于 PDF 文字层和原生书签提取,`jygs` 用于韭研复盘。可组合安装,只保留需要的项:
52
+
53
+ ```bash
54
+ python -m pip install --upgrade 'finchx[calendar,pdf,jygs]==3.0.0'
55
+ ```
56
+
57
+ 使用韭研复盘还须在同一 Python 环境安装 Chromium,并在调用时传入自己的 `SESSION`:
58
+
59
+ ```bash
60
+ python -m playwright install chromium
61
+ ```
62
+
63
+ ## 快速开始
64
+
65
+ 查询当前涨幅排名前五的股票:
66
+
67
+ ```python
68
+ from finchx import FinchX
69
+
70
+ fx = FinchX(timeout=15.0)
71
+ rows = fx.market.ranking(limit=5)
72
+ print(rows)
73
+ ```
74
+
75
+ 每次调用重新取数,不提供结果缓存或文件保存。字段、单位、缺失值和认证要求请按各接口文档处理。
finchx-3.0.0/README.md ADDED
@@ -0,0 +1,52 @@
1
+ # FinchX
2
+
3
+ FinchX 是面向 A 股的 Python 数据接口,提供行情、资金流、公司与财务资料,以及新闻、公告、研报等数据。完整接口、参数和业务字段见 [API 文档](https://github.com/sanshi2026/FinchX/blob/main/docs/API.md)。
4
+
5
+ 接口直接返回原生 `dict` 或 `list`,便于查询、分析和接入自己的交易研究流程。
6
+
7
+ ## FinchX 3.0
8
+
9
+ FinchX 3.0 相对旧版有重大更新:重构接口架构与业务分类,统一参数规范,重新核对数据字段、单位和来源语义,并加强完整性校验与错误处理。**强烈推荐旧版用户升级到 3.0。**
10
+
11
+ **3.0 的接口、参数和返回结构与 2.x 不兼容。** 请保留旧环境,在独立环境按 API 文档逐项迁移调用和字段读取。
12
+
13
+ ## 安装
14
+
15
+ 安装:
16
+
17
+ ```bash
18
+ python -m pip install finchx
19
+ ```
20
+ 需要 Python 3.10 或更新版本。建议使用独立虚拟环境。
21
+
22
+ 已有用户升级到 3.0:
23
+
24
+ ```bash
25
+ python -m pip install --upgrade 'finchx==3.0.0'
26
+ ```
27
+
28
+ 按需安装可选依赖:`calendar` 用于离线交易日历及自动日历回退,`pdf` 用于 PDF 文字层和原生书签提取,`jygs` 用于韭研复盘。可组合安装,只保留需要的项:
29
+
30
+ ```bash
31
+ python -m pip install --upgrade 'finchx[calendar,pdf,jygs]==3.0.0'
32
+ ```
33
+
34
+ 使用韭研复盘还须在同一 Python 环境安装 Chromium,并在调用时传入自己的 `SESSION`:
35
+
36
+ ```bash
37
+ python -m playwright install chromium
38
+ ```
39
+
40
+ ## 快速开始
41
+
42
+ 查询当前涨幅排名前五的股票:
43
+
44
+ ```python
45
+ from finchx import FinchX
46
+
47
+ fx = FinchX(timeout=15.0)
48
+ rows = fx.market.ranking(limit=5)
49
+ print(rows)
50
+ ```
51
+
52
+ 每次调用重新取数,不提供结果缓存或文件保存。字段、单位、缺失值和认证要求请按各接口文档处理。