Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/beanieodm/bunnet
Synchronous Python ODM for MongoDB
https://github.com/beanieodm/bunnet
beanie mongodb odm python synchronous
Last synced: about 2 months ago
JSON representation
Synchronous Python ODM for MongoDB
- Host: GitHub
- URL: https://github.com/beanieodm/bunnet
- Owner: BeanieODM
- License: apache-2.0
- Created: 2022-11-04T18:51:44.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-02T01:12:27.000Z (8 months ago)
- Last Synced: 2024-10-29T05:38:37.889Z (2 months ago)
- Topics: beanie, mongodb, odm, python, synchronous
- Language: Python
- Homepage:
- Size: 2.34 MB
- Stars: 105
- Watchers: 4
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://roman-right.github.io/bunnet/)
[](https://pypi.python.org/pypi/bunnet)
[](https://github.com/roman-right/bunnet)
*The logo is generated by [WOMBO Dream](https://www.wombo.art)*
## Overview
[Bunnet](https://github.com/roman-right/bunnet) - is a Python object-document mapper (ODM) for MongoDB. It is a synchronous fork of [Beanie ODM](https://github.com/roman-right/beanie).
When using Bunnet each database collection has a corresponding `Document` that
is used to interact with that collection. In addition to retrieving data,
Bunnet allows you to add, update, or delete documents from the collection as
well.
Bunnet saves you time by removing boilerplate code, and it helps you focus on
the parts of your app that actually matter.
## Installation
### PIP
```shell
pip install bunnet
```
### Poetry
```shell
poetry add bunnet
```
## Example
```python
from typing import Optional
from pymongo import MongoClient
from pydantic import BaseModel
from bunnet import Document, Indexed, init_bunnet
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
# Bunnet uses Pymongo client under the hood
client = MongoClient("mongodb://user:pass@host:27017")
# Initialize bunnet with the Product document class
init_bunnet(database=client.db_name, document_models=[Product])
chocolate = Category(name="Chocolate", description="A preparation of roasted and ground cacao seeds.")
# Bunnet documents work just like pydantic models
tonybar = Product(name="Tony's", price=5.95, category=chocolate)
# And can be inserted into the database
tonybar.insert()
# You can find documents with pythonic syntax
product = Product.find_one(Product.price < 10).run()
# And update them
product.set({Product.name:"Gold bar"})
```
## Links
### Documentation
- **[Doc](https://beanieodm.github.io/bunnet/)** - Tutorial, API documentation, and development guidelines.
### Resources
- **[GitHub](https://github.com/roman-right/bunnet)** - GitHub page of the
project
- **[Changelog](https://roman-right.github.io/bunnet/changelog)** - list of all
the valuable changes
- **[Discord](https://discord.gg/29mMrEBvr4)** - ask your questions, share
ideas or just say `Hello!!`
----
Supported by [JetBrains](https://jb.gg/OpenSource)
[](https://jb.gg/OpenSource)