Update Version 2.8.1

Author: shinny-pack

PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tqsdk
-Version: 2.8.0
+Version: 2.8.1
 Summary: TianQin SDK
 Home-page: https://www.shinnytech.com/tqsdk
 Author: TianQin
@@ -15,7 +15,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 
 <p align="center">
-  <img src ="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/tqsdk_new_logo.png"/>
+  <img src ="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/images/tqsdk_new_logo.png"/>
 </p>
 <p align="center">
     <img src ="https://img.shields.io/pypi/v/tqsdk?color=blueviolet">

README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src ="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/logo.png"/>
+  <img src ="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/images/tqsdk_new_logo.png"/>
 </p>
 <p align="center">
     <img src ="https://img.shields.io/pypi/v/tqsdk?color=blueviolet">

doc/conf.py

@@ -48,9 +48,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'2.8.0'
+version = u'2.8.1'
 # The full version, including alpha/beta/rc tags.
-release = u'2.8.0'
+release = u'2.8.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

doc/profession.rst

@@ -33,7 +33,7 @@ TqSdk 中大部分功能是供用户免费使用的, 同时我们也提供了 Tq
 
 .. figure:: images/web_gui_backtest.png
 
-对于 TqSdk 免费版本的用户,每天可以进行3次回测，同时也可以使用 :ref:`replay` 或申请模拟账户后模拟运行来检验策略 :ref:`sim_trading`
+对于 TqSdk 免费版本的用户，每天可以进行3次回测，同时也可以申请模拟账户后模拟运行来检验策略 :ref:`sim_trading`
 
 股票行情
 -------------------------------------------------

doc/reference/tqsdk.backtest.rst

@@ -1,7 +1,7 @@
 .. _tqsdk.backtest:
 
-tqsdk.backtest - 策略回测/复盘工具
+tqsdk.backtest - 策略回测
 ------------------------------------------------------------------
 .. automodule:: tqsdk.backtest
-    :members:
+    :members: TqBacktest
 

doc/usage/backtest.rst

@@ -6,7 +6,7 @@
 
 如果想使用策略回测该功能，可以点击 `天勤量化专业版 <https://www.shinnytech.com/tqsdk_professional/>`_ 申请使用或购买
 
-对于 TqSdk 免费版本的用户,每天可以进行3次回测，同时也可以使用 :ref:`replay` 或申请模拟账户后模拟运行来检验策略 :ref:`sim_trading`
+对于 TqSdk 免费版本的用户，每天可以进行3次回测，同时也可以申请模拟账户后模拟运行来检验策略 :ref:`sim_trading`
 
 执行策略回测
 -------------------------------------------------
@@ -149,9 +149,10 @@ TqSdk回测框架使用一套复杂的规则来推进行情：
 规则3: quote按照以下规则更新::
 
   if 策略程序中使用了这个合约的tick序列:
-    每次tick序列推进时会更新quote的这些字段 datetime/ask&bid_price1/ask&bid_volume1/last_price/highest/lowest/average/volume/amount/open_interest/ price_tick/price_decs/volume_multiple/max&min_limit&market_order_volume/underlying_symbol/strike_price
+    每次tick序列推进时会更新quote的这些字段 datetime/ask&bid_price1/ask&bid_volume1/last_price/highest/lowest/average/volume/amount/open_interest/price_tick/price_decs/volume_multiple/max&min_limit&market_order_volume/underlying_symbol/strike_price
   elif 策略程序中使用了这个合约的K线序列:
-    每次K线序列推进时会更新quote. 使用 k线生成的 quote 的盘口由收盘价分别加/减一个最小变动单位, 并且 highest/lowest/average/amount 始终为 nan, volume 始终为0. 
+    每次K线序列推进时会更新quote. 使用 k线生成的 quote 的盘口由收盘价分别加/减一个最小变动单位, 并且 highest/lowest/average/amount 始终为 nan, volume 始终为0.
+    每次K线序列推进时会更新quote的这些字段 datetime/ask&bid_price1/ask&bid_volume1/last_price/open_interest/price_tick/price_decs/volume_multiple/max&min_limit&market_order_volume/underlying_symbol/strike_price
     if 策略程序使用的K线周期大于1分钟:
       回测框架会隐式的订阅一个1分钟K线, 确保quote的更新周期不会超过1分钟
   else:

doc/usage/index.rst

@@ -14,5 +14,4 @@
     option_trade.rst
     targetpostask.rst
     backtest.rst
-    replay.rst
     web_gui.rst

doc/usage/web_gui.rst

@@ -69,45 +69,3 @@
 
 .. _web_gui_replay:
 
-复盘情况下的图形化界面
-----------------------------------------------------
-复盘情况下，设置完复盘时间点参数后传入web_gui=True，也可以用同样的方法来生成图形化地址::
-
-        from datetime import date
-        from tqsdk import TqApi, TqAuth, TqReplay, TargetPosTask
-        # 在创建 api 实例时传入 TqReplay 就会进入复盘模式,设置web_gui=True开启图形化界面
-        api = TqApi(backtest=TqReplay(date(2020,5,26)),web_gui=True, auth=TqAuth("信易账户", "账户密码"))
-        # 获得 m2009 5分钟K线的引用
-        klines = api.get_kline_serial("DCE.m2009", 5 * 60, data_length=15)
-        # 创建 m2009 的目标持仓 task，该 task 负责调整 m2009 的仓位到指定的目标仓位
-        target_pos = TargetPosTask(api, "DCE.m2009")
-        while True:
-            api.wait_update()
-            if api.is_changing(klines):
-                ma = sum(klines.close.iloc[-15:]) / 15
-                print("最新价", klines.close.iloc[-1], "MA", ma)
-                if klines.close.iloc[-1] > ma:
-                    print("最新价大于MA: 目标多头5手")
-                    # 设置目标持仓为多头5手
-                    target_pos.set_target_volume(5)
-                elif klines.close.iloc[-1] < ma:
-                    print("最新价小于MA: 目标空仓")
-                    # 设置目标持仓为空仓
-                    target_pos.set_target_volume(0)
-
-点击访问地址后，显示网址效果如下:
-
-.. figure:: ../images/replay.png
-
-同时你可以点击复盘控制框上的前进和后退按钮来控制复盘行情速度
-
-如何在 TqSdk 中进行回测可以参见 :ref:`replay` 
-
-
-**在使用web_gui图形化界面时需要注意以下几点：**
-
-1.推荐打开图形化界面的浏览器为Google Chrome 或 Firefox
-
-2.为了保证图形化界面能够接收到程序传输的数据并且刷新，在程序中，需要循环调用 api.wait_update的形式去更新和获取数据
-
-3.回测指标数据会在本次回测完成之后才会显示

doc/version.rst

@@ -2,6 +2,19 @@
 
 版本变更
 =============================
+2.8.1 (2021/08/12)
+
+* 增加：增强在协程中的支持，以下接口 :py:meth:`~tqsdk.api.TqApi.query_quotes`，:py:meth:`~tqsdk.api.TqApi.query_cont_quotes`，
+  :py:meth:`~tqsdk.api.TqApi.query_options`，:py:meth:`~tqsdk.api.TqApi.query_atm_options`，
+  :py:meth:`~tqsdk.api.TqApi.query_symbol_info`，:py:meth:`~tqsdk.api.TqApi.query_all_level_options`，
+  :py:meth:`~tqsdk.api.TqApi.query_all_level_finance_options`，支持协程中
+  ``in_options, at_options, out_options = await api.query_all_level_finance_options("SSE.510300", 4.60, "CALL", nearbys = 1)`` 写法，参考文档：:ref:`multi_async_task`
+* 修复：target_pos_task 优化报错提示，已经结束的 TargetPosTask 实例再调用 set_target_volume 设置手数会报错。参考文档：:py:meth:`~tqsdk.lib.target_pos_task.TargetPosTask.cancel`
+* 修复：下载历史数据时，某些数据未按照最小价格变动单位保留相应小数位数的问题
+* 重构：优化 wait_update、is_changing 接口的实现，增强对协程的支持
+* docs：完善回测字段规则文档说明
+
+
 2.8.0 (2021/08/05)
 
 * 增加：**支持免费用户每日回测 3 次**

setup.py

@@ -36,7 +36,7 @@ def get_tag(self):
 
 setuptools.setup(
     name='tqsdk',
-    version="2.8.0",
+    version="2.8.1",
     description='TianQin SDK',
     author='TianQin',
     author_email='tianqincn@gmail.com',