- 南京大学统一身份认证登录模块,可用于登录校园各种网站,Github link,PyPI link。
pip install NJUlogin -i https://mirror.nju.edu.cn/pypi/web/simple
注:由于使用了新的打包方式以及一些其他原因,自v3.3起,python依赖调整为python>=3.10,<4.0
,并且在pypi上删除所有旧版包。安装旧版方法(二选一):
- 从Github releases中下载对应版本的
.whl
文件并pip install xxx.whl
- 克隆Github仓库并且checkout到对应tag的分支后使用
pip install .
安装。
- 包含三种登录方法,扫码登录、账号密码登录、加载cookies登录,使用方法见demos文件夹
- 扫码登录:构造
QRlogin
对象即可调用login
方法进行登录。会在终端打印统一身份验证的二维码,使用手机扫码登录即可。(未测试字体,若出问题请尝试更换终端字体,如MesloLGS NF
、Fira Code
,也会在当前目录保存图片文件作为备选方案) - 账号密码登录:使用账号密码作为参数构造
pwdLogin
对象即可调用login
方法进行登录。 - 加载cookies登录:构造
baseLogin
对象即可调用load
方法加载cookies,cookies需要通过上述两种登录方式后使用export
方法导出为文件。load
和export
方法可以设置保存文件的密码防止泄露。 login
方法需要传入登录的目的网址,比如http://p.nju.edu.cn/cas/&renew=true
表示登录到校园网,返回的网页会保存在self.response
中。目的网址也可以留空。- 目的网址获取方法(举一反三即可):打开浏览器输入
p.nju.edu.cn
,会发现自动跳转到https://authserver.nju.edu.cn/authserver/login?service=http%3A%2F%2Fp.nju.edu.cn%2Fcas%2F&renew=true
,即为service=
后面的内容,这里经过了编码,不解码直接作为目的地址传入也可以。 - 返回值
session
记录了登录状态,之后即可使用requests
中的方法进行进一步的操作,也可以使用构造出的对象调用get
或post
方法。(具体能有什么操作就看各位的创意了,也可以查看我的示例)
方法/属性列表:
login(self, dest: str = None)
:登录get(self, url: str, **kwargs) -> requests.Response
:重载了requests.get
方法post(self, url: str, data: dict, **kwargs) -> requests.Response
:重载了requests.post
方法logout(self)
:退出登录logout_all(self)
:退出所有设备的登录available
:判断是否登录成功export(self, filename: str, password: str = None)
:导出cookiesload(self, filename: str, password: str = None)
:加载cookies
- 这个项目很难进行完整的测试,毕竟难以预测所有的网络情况,而且网站的登录方式也会有更新,因此欢迎大家提出issue,我会尽力解决(只要我还在南大)。
- 验证码识别代码来自sml2h3/ddddocr