Skip to content
/ NUAA_ClassSchedule Public
forked from miaotony/NUAA_ClassSchedule

NUAA_ClassSchedule 模拟登录南京航空航天大学新版教务系统，获取课表，解析后生成iCal日历文件...

miaotony.github.io/nuaa_classschedule/

License

GPL-3.0 license
0 stars 8 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

ZegWe/NUAA_ClassSchedule

BranchesTags
 
 

Repository files navigation

NUAA_ClassSchedule

点此访问本项目网页

点此访问本项目GitHub仓库

Description

NUAA_ClassSchedule
模拟登录南京航空航天大学新版教务系统，获取课表，解析后生成iCal日历文件...

  • 话说大家平常是怎么看课表的呀？

  • 上教务系统 / 截图 / 小程序 / 手动建课表 / 问同学 / ...

  • I have an idea! 大家有没有想过把课表导入到日历呀？！
    你看，这么做不仅可以自定义课程，和其他安排放在一起；
    还可以利用桌面插件，方便快捷地获取课表；
    还能根据自己的需要设定提醒……
    更多用途可以自由发挥，多棒的主意呢！

说实话，这的确就是偶然间想到的一个小想法呢，说干就干，于是就有了这个项目啦！
还在犹豫什么呢，不如就来试试吧！嘿嘿嘿~

其实这个项目挺有意思的233 (斜眼笑.gif)

鉴于时间有限，最近事情较多，有继续开发的计划不过估计会咕咕咕

所以——
感兴趣的一起来干呗！
欢迎提issue & PR！

Important!! 免责条款

本项目课表由官方教务系统导出，但使用时请仔细对照教务系统核对是否所有课程均正常导出！

对于解析异常导致的各种后果请自行承担！
（坚决不背锅）

技术问题请提issue，非技术问题原则上不予处理，请咨询有关部门，谢谢！

点击访问南航新版教务系统

Usage

食用指南

请在Python 3环境下食用。

  • 什么？你没有 Python 环境？ 或者 你不想折腾？
  • 在 Windows 或 MacOS 下可以试试这个打包好的可执行程序啦！
    （MacOS版本由 @ZegWe 提供）

下载地址在 Release 下呢！

缺点就是，文件太大下载太慢，而且每一次打开的时候根据电脑性能需要加载一定时间。（这行划掉）
之前的问题出在pyinstaller打包上，现在重新打包了，文件精简啦，欢迎来试试呀！

如果喜欢折腾，或者不放心的话，推荐还是用下面的方法呢！

Step

  • Step 1
    进入你喜欢的目录，将本仓库clone到本地，或直接下载zip文件（Download ZIP）
    git clone https://github.com/miaotony/NUAA_ClassSchedule.git
  • Step 2
    进入目录，安装所需的库（Linux下使用pip3，Windows下使用pip）
    pip3 install -r requirements.txt

  • Step 3
    使用时先修改程序里的stuID为学号，stuPwd为教务处密码
    请在r""两个引号之间输入，即变量类型为字符串str。

    choice为个人或班级课表的选择，0为个人，1为班级，默认为个人课表。
    而后保存，再执行此程序即可。

    密码仅在本地保存，访问官方教务系统，请放心使用。

    习惯命令行参数的，后面会加的啦
    已经实现了命令行参数，具体往下看！

Windows 环境下：

    python main.py

Linux 环境下：

    python3 main.py

或者 直接执行main.py （前提是将文件权限设为可执行）

    chmod +x *
    ./main.py

从 V0.4.0.20191026 版本起开始支持命令行参数啦！

命令行参数说明：

usage: main.py [-h] [-i ID] [-p PWD] [-c {0,1}] [--notxt] [--noxlsx]

Get NUAA class schedule at ease! 一个小jio本，让你获取课表更加便捷而实在~

optional arguments:
  -h, --help            show this help message and exit
  -i ID, --id ID        Student ID 学号
  -p PWD, --pwd PWD     Student password 教务处密码
  -c {0,1}, --choice {0,1}
                        Input `0` for personal curriculum(default), `1` for
                        class curriculum. 输入`0`获取个人课表(无此参数默认为个人课表)，输入`1`获取班级课表
  --notxt               Don't export `.txt` file. 加入此选项则不导出`.txt`文件
  --noxlsx              Don't export `.xlsx` file. 加入此选项则不导出`.xlsx`表格

示例：

    python main.py -i <your ID> -p <your password>

同时也支持在控制台输入学号密码啦，且为了保护，密码不带回显，输完之后<ENTER>就好啦！

当然，和上面的初始参数也是互相兼容的，解析的优先级由高到低为：
命令行参数->上面的初始设置->控制台输入

  • Step 4
    运行后即可得到解析好的课表啦~
    在NUAAiCal-Data目录下就可以看到生成好的.ics日历文件，.txt文本文件，还有.xlsx表格文件啦！

    V0.10.0.20191116: 导出选项可通过命令行参数进行选择

  • Step 5
    将生成好的.ics日历文件导入你喜欢的日历，然后尽情享用吧~！
    顺手再点个Star吧~
    在导入iCal日历前，请确认时区已设定为 UTC/GMT+08:00 即北京时间，否则可能会出现导入后时间不正确的情况！

Screenshots 使用截图

使用命令行参数：
V0.10.0.20191116

控制台输入：
V0.4.0.20191026-1

导出.ics文件：
successful_export_example

将.ics导入到Outlook的效果：
Outlook_example.png
客户端：
Outlook_example_iPad.png

将课表导出到.xlsx文件：
xlsx_file

使用.exe程序执行：（V0.9.0.20191115 开始支持）
exe
Or 从命令行执行：
exe2

Raw Data

课表解析部分原始JavaScript数据片段：

20191107更新：
教务系统中TaskActivity函数新增了一个teachClassName参数，导致之前的版本匹配出现问题， 在 V0.5.0.20191107 版本中已经修复。

var teachers = [{id:2270,name:"任艳芳",lab:false}];
var actTeachers = [{id:2270,name:"任艳芳",lab:false}];
var assistant = _.filter(actTeachers, function(actTeacher) {
    return (_.where(teachers, {id:actTeacher.id,name:actTeacher.name,lab:actTeacher.lab}).length == 0) && (actTeacher.lab == true);
});
var assistantName = "";
if (assistant.length > 0) {
    assistantName = assistant[0].name;
    actTeachers = _.reject(actTeachers, function(actTeacher) {
        return _.where(assistant, {id:actTeacher.id}).length > 0;
    });
}
var actTeacherId = [];
var actTeacherName = [];
for (var i = 0; i < actTeachers.length; i++) {
    actTeacherId.push(actTeachers[i].id);
    actTeacherName.push(actTeachers[i].name);
}

    activity = new TaskActivity(
        actTeacherId.join(','),
            actTeacherName.join(','),
            "8340",
            "信息检索与利用",
            "548",
            "10302(将军路)",
            "00000011111110000000000000000000000000000000000000000",
            "",
            null,
            assistantName,
            "",
            "",
            "");
    index =0*unitCount+8;
    table0.activities[index][table0.activities[index].length]=activity;
    index =0*unitCount+9;
    table0.activities[index][table0.activities[index].length]=activity;

其中的TaskActivity函数如下：

// new taskAcitvity
function TaskActivity(teacherId,teacherName,courseId,courseName,roomId,roomName,vaildWeeks,taskId,remark,assistantName,experiItemName,schGroupNo, teachClassName){
    this.teacherId=teacherId;
    this.teacherName=teacherName;
    this.courseId=courseId;
    this.courseName=courseName;
    this.roomId = roomId;
    this.roomName = roomName;
    this.vaildWeeks = vaildWeeks;	// 53个01组成的字符串，代表了一年的53周
    this.taskId=taskId;
    this.marshal=marshalValidWeeks;
    this.addAbbreviate=addAbbreviate;
    this.clone=cloneTaskActivity;
    this.canMergeWith=canMergeWith;
    this.isSame=isSameActivity;
    this.toString=activityInfo;
    this.adjustClone=adjustClone;
    this.leftShift=leftShift;
    this.needLeftShift=needLeftShift;
    this.remark = remark;
    this.assistantName=assistantName;
    this.experiItemName=experiItemName;
    this.schGroupNo=schGroupNo;
    this.teachClassName = teachClassName;
}

下面这个是原来的：
Code_JS_old

Known Issues

已知存在的bug

  • 登录时提示 ERROR! 请不要过快点击!
    已经解决啦~

  • 隐含bug：未匹配天目湖校区时间表，后面再说吧……（欢迎PR）
    已经匹配天目湖校区时间表啦~
    （潜在bug：教室名称为空则默认是将军路明故宫校区时间表...

  • Issue #13
    由于11.18晚上教务系统在登录验证中加入了验证码，导致本脚本登录失败，目前无法正常使用，恢复时间未知。
    欢迎大佬们的PR哈！
    1574163995402

  • 在Windows下有一个解决方案是，爬取验证码图片后调用PIL库进行显示。
    ---->V0.11.0.20191121版本已利用此方案进行修复

  • Issue #10 课程所在周还没有进行合并，于是显示出来的是分立的，这个后面再说吧。

  • Issue #11 时长持续超过两节（如持续三节课）的课，获取的原始数据中可能存在分开（如2+1）的形式，导致生成的iCal也是独立的， 目前还没有做合并emmm。

  • 考虑到不同课表在解析上可能存在差异，且随着时间发展页面的访问可能会发生变化，目前版本具有时效性。

  • 对于存在的问题和疑问，欢迎在issue中提出，也欢迎提出PR哈！

Version

@Version: V0.11.0.20191121

@Update Log:

V0.11.0.20191121 Fix Issue #13 captcha bug, but only for Windows.调用PIL库显示验证码，仅Windows下有效。

V0.10.0.20191116 新增命令行导出选项参数；重新打包，精简可执行程序大小并新增MacOS版本；修复Linux下sh: 1: pause: not found bug

V0.9.0.20191115 新增打包为.exe可执行程序，可在未安装python环境的Windows系统下使用

V0.8.1.20191113 修复表格导出bug，完善requirement.txt等

V0.8.0.20191112 新增导出课表到.xlsx表格文件；调换输出课程名称和教师顺序，更加符合逻辑

V0.7.0.20191109 新增导出课表到.txt文件；
新增匹配天目湖校区时间表；
修复Issue #2 Too Quick Click bug；
删除requirement.txt中存在的标准库，仅保留第三方库

V0.6.0.20191108 基于对象重构课表解析的部分功能，增加生成iCal日历文件并导出（部分参考NUAA-iCal-Python）

V0.5.1.20191107 优化代码结构，便于下一步重构及生成iCal文件

V0.5.0.20191107 修复因教务系统JS代码变更而无法解析课表的重大bug，增加requirement.txt

V0.4.0.20191026 增加命令行参数解析，增加控制台输入学号密码（不回显处理），并与初始设置兼容；修复班级课表中教师为空时解析异常bug
V0.4.0.20191026-2

V0.3.1.20191018 增加解析课程所在周并优化课表输出格式，修复班级课表中班级解析bug，引入logging模块记录日志便于debug
V0.3.1.20191018

V0.3.0.20191017 增加 课表解析，增加 班级、实践周匹配，优化代码结构
V0.3.0.20191017

V0.2.1.20191012 增加UA列表，增加BeautifulSoup提取姓名学号，优化代码结构，为下一步解析课表做准备

V0.2.0.20191010 成功登录教务系统，并成功获取个人或班级课表，但还未进行提取

V0.1.1.20190910 加入未登录成功或过快点击的判断

V0.1.0.20190909 尝试登录新教务系统成功，仅登录而已

TODO

  • 登录新教务管理系统 Login to the new Educational Administration System
  • 获取课表 Get class schedule data
  • 解析课表 Parse class schedule data
  • 导出课表到.txt文件 Export class schedule data to .txt file
  • 命令行参数 Get args from terminal
  • 基于对象重构 Refactor based on object
  • 生成.ics日历文件 📆 Generate .ics file
  • 生成.xlsx表格文件 Generate .xlsx file
  • 打包为可执行程序 Packing
  • 图形化界面 GUI
  • 搭建网络服务，在线导出日历文件 Web service
  • 提供课表订阅服务 Subscribe service
  • 使用情况分析 Usage analysis
  • 导出考试安排 Export examination schedule
  • 适配研究生课表 Adapt to postgraduate's class schedule
  • 适配教师课表 Adapt to teacher's class schedule
  • etc.

Reference

  1. 开源项目NUAA-Open-Source/NUAA-iCal-Python

    项目网址：点这里
    https://github.com/NUAA-Open-Source/NUAA-iCal-Python

    这是个（已经毕业了的）学长开发的小项目，但老接口随着新教务系统的启用而关闭，进而原脚本无法继续使用。

    在开发本项目过程中，解析课表之后，受到了此项目的启发，参考其实现了iCal日历文件的生成。在此非常感谢原作者！

  2. ISCNU iCal课表

    网址：点这里
    https://i.scnu.edu.cn/ical/

    这里有一些关于iCal的使用方法，可以参考一波。

Sponsorship

如果真想赞助的话，Alipay扫下面的二维码领个红包吧，每天都能领的那种，顺手薅个羊毛。

或者

打开支付宝首页搜“522869066”领红包

WeChat:

非常感谢啦！

如果能给校园生活多一些便利，感觉也挺满足的啦。

更希望有小伙伴来继续开发和维护这个项目啦~

Copyright

网络非法外之地，本项目相关技术内容仅供学习研究，请在合理合法范围内使用！
The relevant technical content of this project is only for study and research, please use within the reasonable and legal scope!

License:
GPL-3.0

未经允许不得商用！
Non-commercial use!

最终解释权归本项目开发者所有。
The final interpretation right belongs to the developer of the project.

Copyright © 2019 MiaoTony

About

NUAA_ClassSchedule 模拟登录南京航空航天大学新版教务系统，获取课表，解析后生成iCal日历文件...

miaotony.github.io/NUAA_ClassSchedule/

Resources

Readme

License

GPL-3.0 license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

1 tags

Packages

No packages published

Languages

  • Python 100.0%