Metadata-Version: 2.1
Name: cqu-de
Version: 0.3.5
Summary: 基于 Python3 的第三方重庆大学Dr.COM登录器
Home-page: https://github.com/CQU-AI/DrcomExecutor
Author: CQU-AI
Author-email: peter@mail.loopy.tech
License: GPL License
Platform: all
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: beautifulsoup4 (>=4.9.1)
Requires-Dist: PyYAML (>=5.3.1)
Requires-Dist: requests (>=2.24.0)

# Drcom Executor

[![cqu-tool-bucket](https://img.shields.io/badge/CQU-%E9%87%8D%E5%BA%86%E5%A4%A7%E5%AD%A6%E5%85%A8%E5%AE%B6%E6%A1%B6%E8%AE%A1%E5%88%92-blue)](https://github.com/topics/cqu-tool-bucket)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/c3b9072a56d745ac868aabd676aa524c)](https://www.codacy.com/gh/CQU-AI/DrcomExecutor?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=CQU-AI/DrcomExecutor&amp;utm_campaign=Badge_Grade)
![Liscence](https://img.shields.io/github/license/CQU-AI/DrcomExecutor)
[![pypi](https://img.shields.io/pypi/v/cqu-de)](https://pypi.org/project/cqu-de/)
![download](https://pepy.tech/badge/cqu-de)
![Upload Python Package](https://github.com/CQU-AI/DrcomExecutor/workflows/Upload%20Python%20Package/badge.svg)

<div align=center> <img src="https://github.com/CQU-AI/DrcomExecutor/raw/master/doc/logo.png"><img src="https://github.com/CQU-AI/DrcomExecutor/raw/master/doc/logo.png"></div>

Drcom Executor 是一个基于 Python3 的第三方重庆大学 Dr.COM 登录器。

这个程序可以用来代替官方版的Drcom登录器来连接重庆大学校园网.

## 特性

与其他大多数drcom系列项目具有差异的是，本登陆器的**目标是让PC端使用者感受不到drcom的存在**，实现插网线即能上网和开热点，而且无需在前台驻留任何窗口或终端。

为了实现该目标，该登陆器加入了
 - 暴力重连：周期性检查外部网络联通性，并捕捉任何网络错误，回缩到合适的阶段开始重连。可能导致退出的错误见[wiki](https://github.com/CQU-AI/DrcomExecutor/wiki/%E5%8F%AF%E8%83%BD%E5%AF%BC%E8%87%B4%E9%80%80%E5%87%BA%E7%9A%84-Critical-Error)
 - 指数退避：在持续遇到网络问题时，逐渐增加重试休眠间隔（默认最高500s），避免系统资源占用。

由于其特殊的设计，你可以考虑直接将其添加到开机启动项中（见[wiki](https://github.com/CQU-AI/DrcomExecutor/wiki) ），它就会在后台默默无闻的完成它的工作。（即使从没有校园网的地方突然接入校园网，你也至多需要等待一个指数退避周期就能开始正常上网）

本登陆器还支持
 - 自动查询剩余流量与付费组
 - 开包即用，直接输入用户和密码，无需配置
 - 完美支持Mac和Linux,在Windows上也能稳定运行

## 安装和使用

### 1. 常规使用
1. 安装Python
2. 安装DE：`pip install cqu-de`
3. 在命令行中输入`cqu-de`即可开始运行
4. 首次运行，需要输入上网帐号和密码

上网帐号和密码会存储在你的电脑上，如需清除记录，可使用`cqu-de -r`

### 2. 进阶使用

请参见[wiki](https://github.com/CQU-AI/DrcomExecutor/wiki):
 - [macOS上的开机自启动](https://github.com/CQU-AI/DrcomExecutor/wiki/macOS%E4%B8%8A%E7%9A%84%E5%BC%80%E6%9C%BA%E8%87%AA%E5%90%AF%E5%8A%A8)

## TODO

- [x] 日志系统
- [x] 基于指数退避的自动重连机制
- [ ] 更丰富的配置选项
- [ ] 其它系统的自启动教程wiki

## 声明
1. 本程序核心代码主要基于 [drcom-generic](https://github.com/drcoms/drcom-generic) 。
1. 本程序开放源代码，可自行检查是否窃取你的信息。
1. 本程序不存储用户的帐号，密码。


