# mongodb-crud

**Repository Path**: miali/mongodb-crud

## Basic Information

- **Project Name**: mongodb-crud
- **Description**: 基于 Flask 和 pymongo 的简单 WEB 应用，重点实践 pymongo 的 CRUD 操作。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-09
- **Last Updated**: 2024-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MongoDB CRUD

## 一. 项目简介



本项目旨在通过一个简单的 Flask WEB 应用实践 pymongo 的使用，包括 MongoDB 数据库连接以及增删改查。



![输入图片说明](index.png)



## 二. 项目运行



Python 版本要求：



```bash
$ python --version
Python 3.9.5
```



将项目克隆到本地后，创建虚拟环境：



```bash
$ git clone https://gitee.com/miali/mongodb-crud.git
$ cd mongodb-crud/
$ python3 -m venv .venv
```



激活虚拟环境，并安装依赖：



```bash
$ source .venv/Scripts/activate
(.venv)
$ pip3 install -r requirements.txt
```



接下来，如果我们的 MongoDB 数据库位于远程服务器或者设置为用户名和密码，需要配置环境变量 `MONGODB_URI` ，语法格式为：



```ini
MONGODB_URI = 'mongodb://用户名:密码@IP地址:27017'
```



从 requirements.txt 安装的依赖包含 `python-dotenv` 第三方库，使用 python-dotenv 管理环境变量时，我们可以在项目目录下创建一个 `.env` 文件来记录上述的环境变量，避免每次开机都要重新设置环境变量。



在项目目录下，我们还会看到已经存在一个名为 `.flaskenv` 的配置文件，该文件中记录的配置项也会被 python-dotenv 加载到环境变量中。



```ini
DATABASE = 'mongodb-crud'
COLLECTION = 'students'
```



> **提示：**`.env` 用来保存敏感配置项，该文件不会被提交到远程仓库。相反 `.flaskenv` 不应包含敏感信息。



第三方依赖安装完成后，使用 `flask forge` 可以生成测试数据，选项 `--count` 指定生成的记录数，默认生成 10 条记录。



```bash
$ flask forge --count=5
```



运行 Flask 开发服务器，访问  http://127.0.0.1:5000/  地址获取应用主页。



```bash
$ flask run --debug
```