跳转到主要内容

适用于Tornado或asyncio的非阻塞MongoDB驱动程序

项目描述

电机

PyPI Version Python Versions Monthly Downloads Documentation Status

image

关于

电机是一个全功能的、非阻塞的MongoDB驱动程序,适用于Python asyncioTornado应用程序。Motor提供了一个基于协程的API,用于非阻塞访问MongoDB。

"我们在高吞吐量环境中使用Motor,每秒处理数十万个请求。它使我们能够充分利用现代硬件,确保我们充分利用购买的CPU的整个容量。这有助于我们更有效地利用计算能力,降低计算成本,并最大限度地减少我们基础设施的环境影响。"

--David Mytton,Server Density

"我们使用开源软件开发易于使用的传感器和传感器系统,以确保每个创新者,从学童到实验室研究人员,都有相同的机会来创造。我们将Motor集成到我们的软件中,以确保为每个人提供大规模可扩展的传感器系统。"

--Ryan Smith,inXus Interactive

支持/反馈

有关PyMongo的问题、疑问或反馈,请查看我们的支持渠道。请勿直接通过电子邮件与任何Motor开发者联系问题或疑问 - 您更有可能在StackOverflow(使用"mongodb"标签)上得到答案。

错误/功能请求

认为你发现了一个错误?想在Motor中看到新功能?请在我们的问题管理工具JIRA中创建一个案例。

JIRA中所有驱动程序项目(即MOTOR、CSHARP、JAVA)和核心服务器项目(即SERVER)的错误报告是公开的

如何请求帮助

在打开问题时应包含以下所有信息

  • 重现问题的详细步骤,包括完整的跟踪回溯,如果可能的话。

  • 使用的确切python版本,包括补丁级别

python -c "import sys; print(sys.version)"
  • 使用的确切Motor版本,包括补丁级别
python -c "import motor; print(motor.version)"
  • 使用的确切PyMongo版本,包括补丁级别
python -c "import pymongo; print(pymongo.version); print(pymongo.has_c())"
  • 如果您使用Tornado,确切的Tornado版本
python -c "import tornado; print(tornado.version)"
  • 操作系统和版本(例如RedHat Enterprise Linux 6.4,OSX 10.9.5,...)

安全漏洞

如果您在驱动程序或任何其他MongoDB项目中发现安全漏洞,请根据此处说明进行报告。

安装

Motor可以使用pip安装。

pip install motor

依赖关系

Motor在Tornado或asyncio官方支持的任何环境中都有效。它需要

  • Unix(包括macOS)或Windows。
  • PyMongo >=4.1,<5
  • Python 3.8+

可选依赖项

Motor支持与PyMongo相同的可选依赖项。可以在安装Motor的同时安装所需依赖项。

GSSAPI身份验证需要gssapi额外依赖项。正确的依赖项可以与Motor自动安装

pip install "motor[gssapi]"

同样,

MONGODB-AWS身份验证需要aws额外依赖项

pip install "motor[aws]"

支持mongodb+srv:// URI需要srv额外依赖项

pip install "motor[srv]"

OCSP需要ocsp额外依赖项

pip install "motor[ocsp]"

使用snappy进行线协议压缩需要snappy额外依赖项

pip install "motor[snappy]"

使用zstandard进行线协议压缩需要zstd额外依赖项

pip install "motor[zstd]"

客户端字段级加密需要encryption额外依赖项

pip install "motor[encryption]"

您可以使用以下命令自动安装所有依赖项

pip install "motor[gssapi,aws,ocsp,snappy,srv,zstd,encryption]"

有关兼容性的详细信息,请参阅要求

示例

请参阅ReadTheDocs上的示例

文档

Motor的文档位于ReadTheDocs

使用Python 3.8+构建文档。安装sphinxTornadoaiohttp,然后执行cd doc; make html

学习资源

测试

运行python setup.py test。测试位于test/目录中。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分发

motor-3.6.0.tar.gz (278.4 kB 查看散列值)

源代码

构建分发

motor-3.6.0-py3-none-any.whl (74.8 kB 查看散列值)

Python 3

支持者