beanie

Overview

Beanie - is an Asynchronous Python object-document mapper (ODM) for MongoDB, based on Motor and Pydantic.

When using Beanie each database collection has a corresponding Document that is used to interact with that collection. In addition to retrieving data, Beanie allows you to add, update, or delete documents from the collection as well.

Beanie saves you time by removing boiler-plate code and it helps you focus on the parts of your app that actually matter.

Data and schema migrations are supported by Beanie out of the box.

Installation

PIP

pip install beanie

Poetry

poetry add beanie

Example

from typing import Optional
from pydantic import BaseModel
from beanie import Document, Indexed, init_beanie
import asyncio, motor

class Category(BaseModel):
    name: str
    description: str

class Product(Document):
    name: str                          # You can use normal types just like in pydantic
    description: Optional[str] = None
    price: Indexed(float)              # You can also specify that a field should correspond to an index
    category: Category                 # You can include pydantic models as well

# Beanie is fully asynchronous, so we will access it from an async function
async def example():
    # Beanie uses Motor under the hood 
    client = motor.motor_asyncio.AsyncIOMotorClient("mongodb://user:pass@host:27017")

    # Init beanie with the Product document class
    await init_beanie(database=client.db_name, document_models=[Product])

    chocolate = Category(name="Chocolate", description="A preparation of roasted and ground cacao seeds.")
    # Beanie documents work just like pydantic models
    tonybar = Product(name="Tony's", price=5.95, category=chocolate)
    # And can be inserted into the database
    await tonybar.insert() 
    
    # You can find documents with pythonic syntax
    product = await Product.find_one(Product.price < 10)
    
    # And update them
    await product.set({Product.name:"Gold bar"})
    
asyncio.run(example())

Sponsor the project

Bitcoin bc1qz8z0uhftdcra7u8hjyft6nqn30uhktlcgsg0tq
Doge DPKs32RSEVwPiKuGAAmQHZ8VQ8BQK5Qg4L

Supported by JetBrains

Release files for beanie 1.10.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for beanie 1.10.5
File	Size	Uploaded
beanie-1.10.5.tar.gz	42.7 kB	Apr 11, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for beanie 1.10.5
File	Interpreter	ABI	Platform	Reset
beanie-1.10.5-py3-none-any.whl 63.3 kB Apr 11, 2022	Python 3	none	any	Details

Total release size: 106.0 kB

Release files / beanie-1.10.5.tar.gz

Download URL	beanie-1.10.5.tar.gz
Size	42.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`0133ccc3712eae9ac99417d3d6b47c9c15ffa5a1e7b0be0c096972240cd98dbe`
BLAKE2b-256 checksum How to use checksums	`7fececeb1d574d3731eb662e5d1898eeed01ab634dc0cd06be5c3314c7390ead`
Upload date	Apr 11, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.1.4 CPython/3.9.12 Linux/5.13.0-1021-azure`

Release files / beanie-1.10.5-py3-none-any.whl

Download URL	beanie-1.10.5-py3-none-any.whl
Size	63.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3aa4fada82465b4c5d243e0f9ba8519451eff55497af5c4de9f83cd7cc5e5ca9`
BLAKE2b-256 checksum How to use checksums	`ffdbe5e3ca7137fd8e19e4701059ad486c7c583173a9cd29ac7eb40ff29c633b`
Upload date	Apr 11, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.1.4 CPython/3.9.12 Linux/5.13.0-1021-azure`