FAQ > 金融建模 > 第三方交互 > Python

天软pyTSL接口    

简述
pyTSL是天软TSL语言的python接口：
接口简单易用，支持Windows、Linux操作系统与MacOS操作系统。
  • pyTSL是天软TSL语言的python接口，追求简单好用。

    维护说明： pyTSL是社区版本，需要提供者维护，推荐使用官方维护版本。
    技术支持：如果有任何问题或者建议，可发电子邮件到pytsl@py3k.cn。
    官方维护版本（TSLPy模块）使用说明请参考：FAQ：2019-05-08-应用专题-第三方交互07：天软平台和PYTHON的交互
    与pyTSL的差异可参考：FAQ：Q：python与天软的交互方式

    pyTSL模块：
    pyTSL接口使用说明文档：附件:2025-10-14-天软pyTSL接口使用说明.pdf

    配置步骤：
    1）下载
    可直接通过pip install tspytsl下载相关包，也可在http://py3k.cn/pyTSL/setup.html#下载相应Python版本的pyTSL.*.pyd文件后，将其复制到Python安装目录的Lib\site-packages目录或者自己项目的目录下。
    2）安装
    通过import pyTSL导入使用。
    注意：Windows操作系统下需要安装vc2019的x86的运行时库，安装地址：https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-160#
    3）升级
    通过pip install tspytsl -U来更新pyTSL包。

    特点：
    1）pyTSL包是一个独立的Python模块，不依赖天软客户端，更符合Python开发者的编程习惯。
    2）该包目前功能已经成熟，功能在TSLPy的接口上有更多的扩展，已经支持Python的大部分版本。

    更新日志：
    更新日期更新说明
    2025-10-14新增对Python3.14和Python3.14 free-threaded(无GIL)支持
    2025-09-111、query方法和async_query方法增加可选参数cyclefilter，用于过滤假期的分时数据
    2、补充DatetimeToDouble方法可选参数timezone的说明，用于指定时区
    3、新增常见问题：在非中国时区下转换日期时间为天软日期时间类型时有误差
    2024-12-271、TSBatchIterator增加__len__方法
    2、新增常见问题：使用代理登录天软服务器时报错："connection refused"
    3、新增常见问题：在Linux下使用ProcessPoolExecutor方式执行子进程异常卡死
    2024-11-271、增加异步方法、类的支持
    2、增加下载、上传、删除数据等方法
    3、增加离线安装pyTSL的支持
    4、增加范例：SendRunningData
    5、新增对Python3.13支持
    2024-08-20调整文档结构，优化及补充更多实用范例
    2024-02-23修正pyTSL返回数据结果对象类名称：TSReturnValue类应为TSResultValue类
    2023-11-221、增加方法、类的功能说明
    2、增加pyTSL.Const说明
    2023-09-121、新增常见问题：天软日期时间类型参数该如何传参
    2、增加、修改部分范例。
    2023-08-291、pyTSL.Client支持代理服务器账号密码验证
    2、调整部分范例
    2022-11-04新增对windows下的32位Python的支持，目前仅支持手动安装。
    1）安装地址：https://py3k.cn/pyTSL/testing/win32/
    2）安装方法：把对应Python版本的pyTSL.*.pyd复制到Python安装目录的Lib\site-packages目录，或者自己项目的目录
    2022-08-101、pyTSL.Client类query方法fields参数支持tuple和list数据类型
    2、pyTSL.Client类exec方法增加resultname参数，用于指定委托保存的结果集名称
    3、pyTSL.Const增加STOCKID等与行情相关常量
    4、修正TSReturnValue类value方法parse_date的说明
    2022-07-051、新增对 macOS(arm64) Apple M1 支持
    2、修改 register_proc 说明，默认实现了importfile和exportfile函数，用户不能注册同名函数
    3、调整文章的部分结构
    4、新增常见问题 pyTSL 中返回值编码为 utf-8
    2022-06-201、新增常见问题：c.logout后，再次执行c的方法会自动重新登陆
    2、last_error的报错信息查看源链接
    3、新增pip install tspytsl安装方式，使用方法不变
    4、新增章节：7对于老用户如何使用pyTSLPy模块替代TSLPy3.pyd
    2021-09-031、Client增加了代理服务器的支持
    2、Batch系列方法加了key参数
    3、增加了基于centos7的编译包，可以用于centos7及以上操作系统
    4、arm64适配了飞腾CPU
    2021-06-17Client 类新增last_error常见返回错误代码方法
    2020-12-251、Batch类增加query方法、构造函数增加reconnect参数、Task类增加key方法
    2、Client类增加server_list方法、Client.exec方法增加stock等参数设置
    3、增加Const模块返回常用的一些常量
    2020-12-07增加了对MacOS的支持
    2020-10-201、Client 类增加了对加密码的支持
    2、增加了指定、返回默认执行的服务节点的方法
    3、TSReturnValue类增加返回TSL流格式、STN格式数据的方法