Skip to content

Latest commit

 

History

History
69 lines (47 loc) · 3.65 KB

MIGRATION_GUIDE.md

File metadata and controls

69 lines (47 loc) · 3.65 KB

Migration Guide

v2.0.9 -> 2.1.0

Development Related

  • Windows 在创建多进程时只能采用 spawn 方法，子进程创建后并不直接共享父进程已经设置好的的用户配置项，因此还需要将用户配置项 userInfo 在进程中共享。但是 userInfo 直接影响着最基本的 config.py ，为了让用户自定义配置 userInfo 能够在子进程中被正确应用，userInfo 的更新至子线程 _internal.py 和 config 单例的第一次初始化必须早于任何依赖于 config 单例的方法的调用。
  • 因此，这一版中对包调用的逻辑进行了大幅度的修改，删减了大部分包的在导入时即创建 _config 全局变量的逻辑，改成将 config 变量在函数使用时才创建，并且将 loop.py 和 monitor.py 中的所有全局变量和全局函数声明为局部
  • 个人觉得这个改动很丑陋，但是由于我的开发经验有限，一时想不到其他的写法，如果你对这个问题有更好的解决方法，欢迎发 Issue ！
  • 个人的一个改进想法是把多进程全部换成多线程，这样就不需要考虑资源共享的问题

v2.0.6 -> v2.0.7

  • monitor 进程中 /loop 路由细分为 /main_loop 和 /login_loop 两个路由
  • monitor 进程中 /all 路由添加了与错误捕获记录相关的键
  • monitor 进程中添加了 /errors 路由

Development Related

  • 进程共享的 status 对象中的 loop 项细分为了 main_loop 和 login_loop 两个值，并添加了与错误捕获记录相关的键

v2.0.4 -> v2.0.5

Development Related

  • 修改了错误类 IAAANotSuccessError 的全局错误码

v2.0.3 -> v2.0.4

  • config.ini 内添加了 elective 多会话相关的配置
  • config.ini 内删除了 iaaa_relogin_interval 字段

Development Related

  • 为了应对选课网偶发的会话过期问题，为 elective 客户端引入了多会话机制，并删除了旧有的定时重登机制。具体见 README 中的 运行流程 小节

v2.0.1 -> v2.0.2

  • config.ini 内添加了 client/supply_cancel_page 值，以支持不处于选课计划第一页的课程

v1.0.4 -> v2.0.1

  • 新版对 config.ini 内的绝大多数配置项名称做了修改，需要用新提供 config.sample.ini 重新填写一遍配置
  • 添加了自定义 config.ini 和 course.csv
  • 添加了对 Flask 库的依赖，对于尚未安装该依赖的环境，还需额外运行 pip3 install flask

For 'git pull' Comment

如果你使用了 git 命令更新该项目，在输入 git pull origin master 后，可能会报错 error: Your local changes to the following files would be overwritten by merge: ，这是因为新版删除了 config.ini 和 course.*.csv 文件，而改用 config.sample.ini 和 course.*.sample.csv 代替。只需要输入以下命令即可消除冲突：

在项目根目录下：

$ git checkout config.ini
$ git checkout course.utf-8.csv
$ git checkout course.gbk.csv

Development Related

  • 在 BaseClient 内添加了 persist_cookies 方法，会在 hooks.py 内被调用，以确保在一些特定的错误下仍然可以保持会话
  • 在 elective.py 的 sso_login 的请求头中添加了一个固定的无效 Cookie 以防止登录时报 101 状态码
  • 修改了 IAAA 的重新登录逻辑，由原来的遇到错误重登，变为每隔一段时间重登
  • 在 loop.py 中对 elective.py 的 get_Validate 方法的调用结果添加了一层错误捕获，以应对非 JSON 格式的响应体