PyMODM 0.4.3

为什么选择PyMODM？

PyMODM是一个“核心”ODM，这意味着它提供简单、可扩展的功能，可以被其他库利用以针对Django等平台。同时，PyMODM功能强大，足以独立用于开发应用程序。由于MongoDB工程师参与了项目的开发和维护，PyMODM也将迅速采用新的MongoDB功能。

支持/反馈

有关PyMODM的问题、疑问或反馈，请查阅我们的支持渠道。请不要直接通过电子邮件向任何PyMODM开发者发送有关问题或疑问 - 您更有可能在MongoDB社区论坛上获得答案。

错误/功能请求

发现了一个bug吗？想要看到PyMODM的新特性？请在我们的问题管理工具JIRA中创建一个案例。

• 创建账户并登录。.

• 导航到PYMODM项目。

• 点击创建问题 - 请尽可能提供关于问题类型及其复现步骤的信息。

JIRA中所有驱动项目（例如PYMODM、PYTHON、JAVA）和核心服务器（即SERVER）项目的问题报告是公开的。

示例

以下是一个如何定义一些模型并将它们连接到MongoDB的基本示例。

from pymongo import TEXT
from pymongo.operations import IndexModel
from pymodm import connect, fields, MongoModel, EmbeddedMongoModel


# Connect to MongoDB first. PyMODM supports all URI options supported by
# PyMongo. Make sure also to specify a database in the connection string:
connect('mongodb://localhost:27017/myApp')


# Now let's define some Models.
class User(MongoModel):
    # Use 'email' as the '_id' field in MongoDB.
    email = fields.EmailField(primary_key=True)
    fname = fields.CharField()
    lname = fields.CharField()


class BlogPost(MongoModel):
    # This field references the User model above.
    # It's stored as a bson.objectid.ObjectId in MongoDB.
    author = fields.ReferenceField(User)
    title = fields.CharField(max_length=100)
    content = fields.CharField()
    tags = fields.ListField(fields.CharField(max_length=20))
    # These Comment objects will be stored inside each Post document in the
    # database.
    comments = fields.EmbeddedDocumentListField('Comment')

    class Meta:
        # Text index on content can be used for text search.
        indexes = [IndexModel([('content', TEXT)])]

# This is an "embedded" model and will be stored as a sub-document.
class Comment(EmbeddedMongoModel):
    author = fields.ReferenceField(User)
    body = fields.CharField()
    vote_score = fields.IntegerField(min_value=0)


# Start the blog.
# We need to save these objects before referencing them later.
han_solo = User('mongoblogger@reallycoolmongostuff.com', 'Han', 'Solo').save()
chewbacca = User(
    'someoneelse@reallycoolmongostuff.com', 'Chewbacca', 'Thomas').save()


post = BlogPost(
    # Since this is a ReferenceField, we had to save han_solo first.
    author=han_solo,
    title="Five Crazy Health Foods Jabba Eats.",
    content="...",
    tags=['alien health', 'slideshow', 'jabba', 'huts'],
    comments=[
        Comment(author=chewbacca, body='Rrrrrrrrrrrrrrrr!', vote_score=42)
    ]
).save()


# Find objects using familiar MongoDB-style syntax.
slideshows = BlogPost.objects.raw({'tags': 'slideshow'})

# Only retrieve the 'title' field.
slideshow_titles = slideshows.only('title')

# u'Five Crazy Health Foods Jabba Eats.'
print(slideshow_titles.first().title)