Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/SE2020-TopUnderstanding/BUAA-Campus-Tools-Backend

北航教务小助手-后端(Python Web、爬虫)
https://github.com/SE2020-TopUnderstanding/BUAA-Campus-Tools-Backend

Last synced: about 2 months ago
JSON representation

北航教务小助手-后端(Python Web、爬虫)

Awesome Lists containing this project

README

        

# 航胥——北航教务助手

本项目为北京航空航天大学2020年“软件工程”课程项目——“航胥”,一款更想要了解你的北航教务助手,后端项目采用的框架为Django框架。

## **上手指南**

以下指南将帮助你在本地机器上安装和运行该项目,进行开发和测试。关于如何将该项目部署到在线环境,请参考部署小节。

**基础环境**

Python 3.7+

**安装步骤(windows环境)**

1. 克隆项目:

选择一个文件夹作为git根目录,在命令行中执行

`git clone https://github.com/SE2020-TopUnderstanding/BUAA-Campus-Tools-Backend.git`

将本项目克隆到本地。

2. 安装依赖:

首先进入项目路径

`cd BUAA-Campus-Tools-Backend`

再在命令行中执行

`pip install -r requirements.txt`

本地运行不需要PyMySQL,本地运行默认使用的是自带的Sqlite3轻量级数据库。

3. 执行数据库迁移(非必须):

在相同路径下,命令行中执行

`python manage.py makemigrations`

`python manage.py migrate`

4. 运行框架:

在相同路径下,命令行中执行:

`python manage.py runserver`

若出现以下提示信息,则本地运行成功,可以在浏览器中访问相应的接口

```
System check identified no issues (0 silenced).
May 11, 2020 - 11:42:14
Django version 3.0.5, using settings 'API.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.
```

## 测试

**单元测试:**

若想运行单元测试,请在项目的根目录下执行:

`python manage.py test`

**代码风格测试**:

本项目采用的代码风格标准为pylint,具体内容可以参考.pylintrc文件

若想运行代码风格测试,请在项目的根目录下执行:

`pylint BUAA-Campus-Tools-Backend `

## 部署

部署部分请等待补充完成。

## 使用到的框架

Django - Web应用框架

## Wiki Link

[wiki主页](https://github.com/SE2020-TopUnderstanding/BUAA-Campus-Tools-Backend/wiki)