mdocument

MDocument

Simple DRM for async mongo motor client

Usage

import asyncio

from MDocument import Document

class Comment(Document):
    __collection__ = "comments"


class Video(Document):
    __collection__ = "videos"

    @Document.related(self_field="_id", other_field="video")
    def comments(self):
        return Comment


loop = asyncio.get_event_loop()
Document.setup(loop, "localhost", "test_database")

async def main():
    video = await Video.create(
        title="Test",
    )

    comment1 = await Comment.create(
        video=video._id,
        message="First!",
    )

    comment2 = await Comment.create(
        video=video._id,
        message="Second!"
    )

loop.run_until_complete(main())

Now we can easily access our comments using our related documents

print(await video.comments)
[
    Comment(_id=5e7533d55eb6a8c6d24d3cc7, video=5e7533d55eb6a8c6d24d3cc6, message=First!),
    Comment(_id=5e7533d55eb6a8c6d24d3cc8, video=5e7533d55eb6a8c6d24d3cc6, message=Second!)
]

Play from console

If you want changes made from console immediately you can use update_immediately argument

run = loop.run_until_complete

video = run(Video.create(update_immediately=True,
    title="Test"))
video.length = "1:10"

Now we can find that original document was changed

print(run(Video.collection.find_one({"length": "1:10"})))
{'_id': ObjectId('5e75373e5eb6a8c6d24d3cce'), 'title': 'Test', 'length': '1:10'}

Document methods

Here is a list of Document basic methods

.create

async def create(cls, loop=None, update_immediately=False, **kwargs):

If you want to create a new document you can do it easily with .create method. Example:

import asyncio

from MDocument import Document


class Message(Document):
    __collection__ = "messages"

Document.setup(loop, "localhost", "test_database")

loop.run_until_complete(
    Message.create(from_user="admin", text="Test message!")
)

This will create document in database:

{
    '_id': ObjectId('5e75373e5eb6a8c6d14d3ccd'),
    'from_user': 'admin',
    'text': "Test message!"
}

.delete

Deletion of document from database. Based on your set @related rules all related documents will be modified too.

message = await Message.one(from_user="admin")

await message.delete()

Metadata

Release files for mdocument 1.0.1584884718

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

Source distribution (sdist)

Source distribution for mdocument 1.0.1584884718
File	Size	Uploaded
MDocument-1.0.1584884718.tar.gz	5.5 kB	Mar 22, 2020	Details

Release files / MDocument-1.0.1584884718.tar.gz

Download URL	MDocument-1.0.1584884718.tar.gz
Size	5.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`700cb30d333e19b5b4f5a2730244833e9edaca5b3cb97efa396d5858c02c347a`
BLAKE2b-256 checksum How to use checksums	`4287cc0497f0f0aed728e89a8e03e855d9679862dd153fe7663a0bb2261cf658`
Upload date	Mar 22, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.1 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.8.2`