变更记录 ============ v24.4.1 ----------- 1. 新增: 新增接口函数 ``lib.bash.Bash(name="KUNLUN:AUTOTEST:CLI", output=True)``, 可以在其他常规python程序中使用KunLun的连接了. 注意在此之前需要先 ``kunlun start``. v24.4.0 ----------- 1. 变更: 鼠标在container面板上点击右键后展示display1/2/3/4/5/6的内容. 2. 解决: 修复MEASURE指标时间线图, 鼠标移入时能够展示相关数据, 同时将线图改成平滑线图. 3. 新增: 优化 `lib.add_measure(name, value, title="TEMP")`, 当传入参数 `title` 时, 将仅制作时间线图, 可以将不同 `name` 绘制在同一张名为 `title` 的线图上. v24.3.0 ----------- 1. 新增: 新增 `lib.set_display4/5/6()` , 鼠标在container面板上悬停时将展示display1/2/3/4/5/6的内容. 2. 新增: 新增 `lib.stop_test()/lib.deposit()`, 以满足老化等大规模场景的测试. 3. 新增: 在Station页面上可以看到其下属所有container测试状态的统计. 4. 新增: TestData的TestReport界面可以还原Measure窗口以及线图, 方便用户查看测试指标. v24.2.0 ----------- 1. 新增: 针对第一次安装kunlun的用户, 将自动生成可用的demo ``kunlun_scripts`` . 2. 优化: TestData页面, 支持多条件查询, 支持通配符查询, 支持CSV格式下载测试记录. v24.1.2 ----------- 1. 修复: 当设定 ``finalize=True`` 时, fail的测试记录中无 ``step_name`` 的问题。 2. 优化: 优化连接TELNET&SSH, 当设置有username/password时, 使用 timeout作为超时时间, 默认为10秒 v24.1.1 ----------- 1. 优化: 优化连接open(), 若在timeout内发现连接进程不存在, 则将自动尝试再次open()。 2. 适配: 发布Linux版本, 适配Ubuntu20.04 v24.1.0 ----------- 1. 变更: ``testcase`` 中 ``TestCase`` 中的方法 ``setup()`` 与 ``teardown()`` 将仅被 ``kunlun run`` 默认调用。 2. 优化: ``configs`` 中 ``add_connection()`` 增加 ``timeout=10`` 参数, 作为连接 ``open()`` 的超时时间, 默认10s. v23.12.1 ----------- 1. 优化: 优化TELNET连接, 增加连接在open()/close()时的稳定性. 2. 修复: 变更为 ``http`` 后, ``Test Data`` 页面上无法下载测试日志的问题. v23.12.0 ----------- 1. 变更: 测试界面链接从 ``https`` 变更为 ``http`` , 访问速度提升不少。 通过 ``kunlun web`` 可以打开测试界面. 2. 新增: 通过 ``kunlun package project`` 可以将代码打包成 ``.zip`` 格式, 并以时间戳作为版本号，保存在目录 ``kunlun-data/packages`` 下。 3. 新增: 代码推送更新, 通过 ``kunlun deploy project host`` 可将本地代码包推送并部署到远端, 前提条件是可以通过网络访问远端的测试界面. 4. 新增: 代码拉取更新, 通过 ``kunlun update project host`` 可将远端代码包拉取到本地并部署, 前提条件是可以通过网络访问远端的测试界面. 5. 新增: kunlun版本升级, 通过 ``kunlun upgrade host`` 可将远端kunlun安装包拉取到本地并进行pip部署, 前提条件是可以通过网络访问远端的测试界面. 6. 优化: 解除Connection页面只能同时显示6个窗口的限制. 7. 修复: 解决win10下点击stop test后, 连接窗口无法手工输入指令的问题。 8. 优化其他问题. v23.11.1 ----------- 1. 使能: ``lib.ask_question()`` 与 ``lib.ask_questions()`` 增加 ``image="demo/bee.jpg"`` 入参. 2. 更新: 主页上增加了开发文档的直达链接。 v23.11.0 ----------- 1. 新增: 接口函数 ``lib.add_xlsx_measure(sheet, name, value)`` . 它自动调用项目下 ``measure.xlsx`` 中的取值范围, 并做比较. 2. 新增: 新增网页XLSX Data, 用来更新文件 ``measure.xlsx`` . 3. 变更: 获取连接后, 需要显示地调用 ``open()`` 方法. 4. 修复一些问题。 v23.10.5 ----------- 1. 新增: 接口函数 ``lib.add_measure()`` 增加参数 ``spec=[]`` , 当 ``spec`` 的值是一个 ``list`` 是，将在 ``list`` 中提取 ``low`` 与 ``high`` . 需要说明的是 ``sepc`` 的值大于2个元素, 默认取前两个值。 2. 新增: 接口函数 ``lib.pa`` , 它是 ``params.json`` 的字典形式. 3. 已知问题: 通过网页Json Data修改 ``params.json``, 保存后所有值都自动变成字符串. v23.10.4 ----------- 1. 使能 ``finalize=True``, 可以在 ``lib.get_sequence_definition()`` 中配置. 2. 使能 ``测试报告`` 的 ``Test Step Information`` . 3. 修复一些问题. v23.10.3 ----------- 1. 修改 ``ctn.add_step()`` 为 ``ctn.show_step_panel()`` . 2. 修改 ``ctn.add_measure()`` 为 ``ctn.show_measure_panel()`` . 3. 新增 ``ctn.show_info_panel()`` . 4. 修复一些显示上的问题. v23.10.2 ----------- 1. 使能 ``STEP`` 窗口, 在 ``pc_hostname.py`` 使用 ``ctn.add_step()`` 即可。可以参考 ``autotest.py`` . 2. 增加一些接口函数, 其实是接口变量。 v23.10.1 ----------- 1. 优化 ``autotest web`` , 使用本机IP地址打开测试界面. 2. ``kunlun start`` 优先调用 ``pc_hostname.py``, 次之 ``autotest.py`` . v23.10.0 ----------- 1. 修复TELNET连接无法正常使用的问题. v23.9.0 ----------- 1. Python版本从3.7.5升级至3.8.10 2. 增加 kunlun menu 菜单，作为 kunlun run 的快捷方式，避免记忆复杂的命令行 3. 删除一些python依赖包, 例如: pandas、numpy. 4. 适配Ubuntu20.04 v23.5.0 ----------- 1. 增加类似Scratch的图像化编程, 包括configs测试界面开发, sequence测试序列开发, 测试用例开发。 2. 修复一些问题 v23.4.0 ----------- 1. 用户代码默认文件夹从 ``product`` 更改为 ``kunlun_scripts``, 开发模式文件夹保持不变为 ``develop`` . 2. ``send()`` 中增加回调函数 ``send(on_timeout=None)``, 若无回调函数, ``send()`` 超时将 ``raie Exception()`` . 3. 新增 ``kunlun run [project] [testcase] [--param] [--key value]`` , 可以用命令行直接跑测试用例, 详细参考文档. 4. 修复一些问题 v23.3.0 ----------- 1. 将 ``params.xlsx`` 变更为 ``params.json`` , 接口函数 ``lib.get_xlsx_params()`` 变更为 ``lib.get_json_params()`` . 2. 增加 ``MEASURE`` MEASURE界面, 请参考示例代码. v23.1.0 ----------- 1. 修复两个 ``lib.ask_question()`` 弹窗之间太快导致无法autofocus的问题. 2. 接口函数 ``lib.ask_question()与lib.ask_questions()`` 增加参数 ``tips`` . v22.12.0 ----------- 1. 增加WIN10安装对 ``Visual Studio`` 依赖的说明. 2. 解决 ``kunlun stop`` 的一些问题. v22.11.0 ----------- 1. 将安装包 ``.exe`` 改为 ``.tar.gz`` , 直接使用 ``pip`` 进行安装, 以兼顾 ``Linux版本`` . 2. 去除一些复杂的且不必要的接口函数. 3. 重命名部分接口函数, 例如 ``lib.get_allocation()`` 改为 ``lib.get_configuration()`` . 4. 将所有命名为 ``sequencer`` 全部重命名为 ``sequence`` . v22.8.1 ----------- 1. 优化session连接的交互方案。 v22.8.0 ----------- 1. 增加对license的支持。管理面板view->license可以查看license信息。 2. 增加.add_station(dense=False)参数, 当dense=True时, container面板为精简模式, 仅显示时间信息。 3. 平台需要D盘, 启动控制面板前, 先检查是否存在D盘, 若不存在, 报错提示。 4. 移除 测试开发-自动编排用例。 5. 移除 ``lib.set_test_name()``。 6. 增加测试界面支持中英文语言切换。 7. 增加测试代码的打包(二进制化)支持。 8. 一些其他更新。 v22.5.0 ---------- 1. 移除接口函数：``lib.add_chart_data()``。 2. 移除 **Pack & Deploy** 页面。 3. 增加接口函数：``lib.set_step_name()``, 未来将移除 ``lib.set_test_name()``。 4. TestData页面, 默认展示一周的测试数据。 5. 若手工停止测试, 将会产生 ``A`` 记录。 6. 移除本地文档, 减少安装包体积。 v22.4.2 ---------- 1. 改进send(), 当expect为list时, 收到其中任意一元素即可, 当expect为tuple时, 需要收到所有元素方可。 v22.4.1 ---------- 1. 增加测试时间后台自动更新, 使测试界面上的测试时长更精确。 v22.4.0 ---------- 1. 增加QQ讨论群。 v22.1.1 ---------- 1. 增加对串口serial HEX方式交互的支持, 设置方法为：``add_connection(protocol="SERIAL-HEX")`` . v22.1.0 --------- 1. 增加导入python pypi包的说明。 2. 更新版本命名方案 v1.12.1 ----------- 1. 更新接口函数 ``lib.get_sequencer_definition()`` , 增加 ``自动发现用例`` 模式。 2. TODO: 增加对 ``JWT`` 的支持。 v1.12.0 ----------- 1. ``sequencer`` 每个用例用时精确到小数点2位。 2. 增加 **调试功能** , 当 ``container`` 在 ``非测试`` 状态时, 可以手工调试命令行。 3. 增加接口函数 ``lib.set_chart_data()`` , 将数据以图形方式在界面上呈现出来。 4. 在测试记录查询页面增加测试报告页面。 v1.11.1 --------- 1. 增加 ``ftp`` & ``tftp`` 服务。 2. 增加 ``hostname.py`` 加载错误提示。 3. 增加接口函数 ``lib.start_container_test()`` , 可以使用一个container启动另一个container测试。 4. 增加接口函数 ``lib.get_allocation()`` , 更精细化的配置用户界面。 v1.11.0 --------- 1. 增加接口函数 ``lib.ud`` , ud代表userdict, 是一个用户字典, 可以使用 ``.`` 来随意增加键值对。 2. 更新接口函数 ``lib.get_xlsx_params(sheet, name)`` , 当name以通配符 ``*`` 起始或结尾, 或等于时, 返回一个字典。 3. XLSX文件(params.xlsx & meas.xlsx)增加 ``desc`` 字段, 用来描述 ``name`` 的实际意义。 4. ``add_step()`` 可以接受 ``kwargs`` 参数。 5. 引入https。 v1.10.2 --------- 1. 更新接口函数 ``lib.get_sequencer_definition()`` , 可支持若干测试策略。 2. 增加接口函数 ``lib.set_sequencer_data()`` , 增加当前step的sequencer数据。 3. 增加接口函数 ``lib.get_sequencer_data()`` , 获取 ``sequencer`` 的执行数据, json格式。 4. 增加接口函数 ``lib.xlsx_measure()`` , 根据XLSX ``meas.xlsx`` 中指标数据对实际测量值进行检查。 v1.10.1 --------- 1. (TODO)使用Jupyter Lab作为web IDE, 支撑远程开发测试程序. 2. 增加接口函数 ``lib.ask_questions()`` , 一次提问多个问题. 3. hostname功能中增加 ``recycle`` 参数, 为 ``True`` 时, 测试完成后, 将自动重新开始. 4. 增加对.NET文件(.dll)的调用支持. v1.10.0 --------- 1. 增加接口函数 ``lib.get_xlsx_params()``. 2. 增加logo. v1.9.0 --------- 1. 版本命名采用新方案：v1.9.0, 1代表2021年, 9代表9月, 0代表当月发布的正式版本(其他数字表示补丁版本). 2. 增加接口函数 ``lib.get_params()`` 与 ``lib.get_sequencer_definition()`` . v0.1.6_20210828 ---------------- 1. 增加管理面板, 方便用户操作, 监控后台服务运行状态。 v0.1.5_20210808 ------------------- 1. 解决Issue I43JLW, 重新设计打包方案。 2. 增加用户界面设置方案, 详情参考文档。 v0.1.4_20210627 ------------------- 1. 完成连接 TELNET & SERIAL 的验证, 修复部分BUG, 这两个连接已被证明是可靠的。 v0.1.3_20210615 ------------------- 1. 完成连接 DUMMY & SSH 的验证, 修复部分BUG, 这两个连接已被证明是可靠的。 v0.1.2_20210606 ------------------- 1. 更新部分帮助文档。 2. 增加手工命令行调试窗口。 3. 部分代码更新。 v0.1.1_20210516 ------------------- v0.1.1正式发布, 项目以安装文件形式发布。 1. 安装目录必须为：``C:\Program Files (x86)\KunLun ATP``。 2. 项目所有数据保存在：``D:\kunlun-data``, 项目启动过程中会自动创建此目录。 3. 安装过程中, 选择创建桌面快捷方式。安装完成后, 桌面将有 ``Start KunLun`` 与 ``Stop KunLun`` 两个快捷方式。 4. 双击 ``Start KunLun`` 启动项目, 双击 ``Stop KunLun`` 将停止项目。 5. 打开浏览器(谷歌或者是Edge), 地址栏输入: ``http://localhost:9000`` , 进入用户界面。 6. 有任何问题, 请开 [Issues](https://gitee.com/robinwu0607/kunlun-atp/issues) 。