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

https://github.com/well2333/nonebot-plugin-mongodb

基于 MongoDB ODM 的数据库管理插件
https://github.com/well2333/nonebot-plugin-mongodb

beanie mongodb nonebot-plugin nonebot2

Last synced: about 1 month ago
JSON representation

基于 MongoDB ODM 的数据库管理插件

Awesome Lists containing this project

README

        


NoneBotPluginLogo

# nonebot-plugin-mongodb

_✨ 基于 MongoDB ODM 的数据库管理插件 ✨_


license


PyPI - Downloads


pypi

python


pdm-managed


Code style: black


QQ Chat Group


QQ Chat Group

## 💿 安装

> 如果你不是插件开发者,那么此插件一般不需要额外安装和加载

pip

pip install nonebot-plugin-mongodb

pdm

pdm add nonebot-plugin-mongodb

poetry

poetry add nonebot-plugin-mongodb

conda

conda install nonebot-plugin-mongodb

在你的插件中添加对应的 require 以确保此插件在被引用前正确加载

```
from nonebot import require

require("nonebot_plugin_mongodb")
```

## ⚙️ 配置

在 nonebot2 项目的`.env`文件中添加下表中的配置, 配置均为**非必须项**

### 通用配置项

| 配置项 | 必填 | 类型 | 默认值 | 说明 |
| :-----------------: | :--: | :--: | :------: | :----------------: |
| mongo_uri | ⭕ | str | None | MongoDB 的连接 uri |
| mongo_database_name | ❌ | str | nonebot2 | 连接的数据库名 |

## 🎉 使用

> 如果你不是插件开发者,那么此部分无需阅读

> 参考 exmple 中的[示例代码](./example/beanie_usage.py)

在 nonebot 的 `startup` 阶段时,本插件会读取 `beanie.Document` 的全部子类并加载,因此开发者无需额外进行 `init_beanie` 即可直接使用,关于具体的操作方法可以参考 [beanie 文档](https://beanie-odm.dev/)。

## 🙏 感谢

在此感谢以下开发者(项目)对本项目做出的贡献:

- [nonebot-plugin-template](https://github.com/A-kirami/nonebot-plugin-template): 项目的 README 模板

## ⏳ Star 趋势

[![Stargazers over time](https://starchart.cc/Well2333/nonebot-plugin-mongodb.svg)](https://starchart.cc/Well2333/nonebot-plugin-mongodb)