Metadata-Version: 2.1
Name: NJUlogin
Version: 2.2.2
Summary: The Nanjing University login module can be used to log on to various campus web sites
Home-page: https://github.com/Do1e/NJUlogin
Author: Do1e
Author-email: dpj.email@qq.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3
Description-Content-Type: text/markdown
License-File: LICENSE

# NJUlogin


* 南京大学统一身份认证登录模块，可用于登录校园各种网站，[Github link](https://github.com/Do1e/NJUlogin)，[PyPI link](https://pypi.org/project/NJUlogin/)。

## 安装
```bash
python setup.py install
```
或者  
```bash
pip install NJUlogin
```

## 使用
* 包含两种登录方法，**扫码登录**和**账号密码登录**，使用方法见`demos`文件夹

</br>

* **扫码登录**：构造`QRlogin`对象即可调用`login`方法进行登录。会在终端打印统一身份验证的二维码，使用手机扫码登录即可。(未测试字体，若出问题请尝试更换终端字体，如`MesloLGS NF`、`Fira Code`)
  ```python
  from NJUlogin.QRlogin import QRlogin
  dest = 'http://p.nju.edu.cn/cas/&renew=true'
  # or:
  # dest = 'http%3A%2F%2Fp.nju.edu.cn%2Fcas%2F&renew=true'
  qrlogin = QRlogin()
  session = qrlogin.login(dest)
  ```

* **账号密码登录**：使用账号密码作为参数构造`pwdLogin`对象即可调用`login`方法进行登录。可能会在终端要求输入手机验证码，输入一次后应该是一周内不再需要输入，也可以将`mobileLogin`参数设置为`True`，这样就不需要输入手机验证码了。
  ```python
  from NJUlogin.pwdLogin import pwdLogin

  dest = 'http://p.nju.edu.cn/cas/&renew=true'
  # or:
  # dest = 'http%3A%2F%2Fp.nju.edu.cn%2Fcas%2F&renew=true'
  mobile_headers = {
    'User-Agent': 'Mozilla/5.0 (Linux; Android 12...'
  }
  pwdlogin = pwdLogin('XXXXXXXXX', 'XXXXXXXXX')
  # or:
  # pwdlogin = pwdLogin('XXXXXXXXX', 'XXXXXXXXX',mobileLogin=True, headers=mobile_headers)
  session = pwdlogin.login(dest)
  ```

* `login`方法需要传入登录的目的网址，比如`http://p.nju.edu.cn/cas/&renew=true`表示登录到校园网。
* 目的网址获取方法（举一反三即可）：打开浏览器输入`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方法（具体能有什么操作就看各位的创意了，也可以查看[我的示例](https://github.com/Do1e/p-dot-nju-login)）

## 补充
* 这个项目很难进行完整的测试，毕竟难以预测所有的网络情况，而且网站的登录方式也会有更新，因此欢迎大家提出issue，我会尽力解决（只要我还在南大）。
