Metadata-Version: 2.1
Name: fyiban
Version: 1.0.7
Summary: Apis lib for yiban.
Home-page: https://github.com/sricor/yiban
Author: Sricor
Author-email: josricor@outlook.com
License: MIT
Project-URL: Source, https://github.com/sricor/yiban
Project-URL: Bug Tracker, https://github.com/sricor/yiban/issues
Keywords: yiban school task health
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Environment :: Console
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Development Status :: 4 - Beta
Description-Content-Type: text/markdown

<h1 align="center"> 易班 🔔</h1>  
  
- 🔥 简单、易用、可扩展的易班 API 接口  
- 📕 适用于校本化分应用打卡
- ⏰ 适用于校本化晚点签到
- 🔧 可适配不同分应用


[![python version](https://img.shields.io/pypi/pyversions/fyiban)](https://pypi.org/project/fyiban/)

```bash
pip install --upgrade fyiban
```

## 快速入门

```python
"""快速入门"""
from yiban import Yiban

if __name__ == '__main__':
    yb = Yiban("手机号", "密码")  
    yb.get_user_name()         # 用户信息
    yb.get_user_access_token() # 登录密钥
    yb.get_user_school_name()  # 院校名称
    yb.get_task_feedback_uncompleted_task()  # 校本化 任务反馈入口 完成任务
    yb.get_task_feedback_uncompleted_task()  # 校本化 任务反馈入口 未完成任务
    ...

```
## 示例 
- 校本化健康打卡提交示例 [SubmitTask](https://github.com/Sricor/yiban/blob/main/examples/example-03-%E5%81%A5%E5%BA%B7%E6%89%93%E5%8D%A1.py)  

```python
"""校本化健康打卡"""
from yiban import Yiban

if __name__ == '__main__':
    task_data = {
        "Data":{...},
        "Extend": {...},
        "...":"..."
    }
    yb = Yiban("手机号", "密码")
    yb.submit...(task_data)
    ...
```

- 更多示例 [Examples](https://github.com/sricor/yiban/tree/main/examples)



## 目录结构
```
yiban
├── Apis
│   ├── Task.py
│   ├── User.py
│   └── Yiban.py
└── Core
    ├── BaseReq.py
    ├── Login.py
    ├── EpidemicPrevention.py
    ├── SchoolBased.py
    ├── SchoolBasedAuth.py
    └── TaskFeedback.py
```


## 声明

> 此项目仅供学习交流，为配合防疫工作，请确保每日体温正常再进行上报。  

## 更新日志
> 2022-7-19 移动端登录接口问题，暂时替换  
> 2022-10-23 新增校本化疫情防控打卡入口  
> 2022-10-28 新增校本化晚点签到入口
