hdZddlmZmZddlmZddlmZddlm Z m Z ddl m Z Gdde jZd Zej e Zy ) aLTools for representing raw BSON documents. Inserting and Retrieving RawBSONDocuments ========================================= Example: Moving a document between different databases/collections .. doctest:: >>> import bson >>> from pymongo import MongoClient >>> from bson.raw_bson import RawBSONDocument >>> client = MongoClient(document_class=RawBSONDocument) >>> client.drop_database('db') >>> client.drop_database('replica_db') >>> db = client.db >>> result = db.test.insert_many([{'a': 1}, ... {'b': 1}, ... {'c': 1}, ... {'d': 1}]) >>> replica_db = client.replica_db >>> for doc in db.test.find(): ... print("raw document: %r" % (doc.raw,)) ... result = replica_db.test.insert_one(doc) raw document: '...' raw document: '...' raw document: '...' raw document: '...' >>> for doc in replica_db.test.find(projection={'_id': 0}): ... print("decoded document: %r" % (bson.decode(doc.raw),)) decoded document: {u'a': 1} decoded document: {u'b': 1} decoded document: {u'c': 1} decoded document: {u'd': 1} For use cases like moving documents across different databases or writing binary blobs to disk, using raw BSON documents provides better speed and avoids the overhead of decoding or encoding BSON. )_get_object_size _raw_to_dict)_RAW_BSON_DOCUMENT_MARKER)DEFAULT_CODEC_OPTIONS)abc iteritems)SONcdeZdZdZdZeZd dZedZ dZ edZ dZ d Z d Zd Zd Zy)RawBSONDocumentzRepresentation for a MongoDB document that provides access to the raw BSON bytes that compose it. Only when a field is accessed or modified within the document does RawBSONDocument decode its bytes. )__raw__inflated_doc__codec_optionsNc||_d|_|t}n*|jturt d|j||_t|dt|y)a9Create a new :class:`RawBSONDocument` :class:`RawBSONDocument` is a representation of a BSON document that provides access to the underlying raw BSON bytes. Only when a field is accessed or modified within the document does RawBSONDocument decode its bytes. :class:`RawBSONDocument` implements the ``Mapping`` abstract base class from the standard library so it can be used like a read-only ``dict``:: >>> from bson import encode >>> raw_doc = RawBSONDocument(encode({'_id': 'my_doc'})) >>> raw_doc.raw b'...' >>> raw_doc['_id'] 'my_doc' :Parameters: - `bson_bytes`: the BSON bytes that compose this document - `codec_options` (optional): An instance of :class:`~bson.codec_options.CodecOptions` whose ``document_class`` must be :class:`RawBSONDocument`. The default is :attr:`DEFAULT_RAW_BSON_OPTIONS`. .. versionchanged:: 3.8 :class:`RawBSONDocument` now validates that the ``bson_bytes`` passed in represent a single bson document. .. versionchanged:: 3.5 If a :class:`~bson.codec_options.CodecOptions` is passed in, its `document_class` must be :class:`RawBSONDocument`. Nz((DDXDXYYrr$)__name__ __module__ __qualname____doc__ __slots__r _type_markerrpropertyrr"r!r)r,r.r3r6rrr r >s`?I,L/9b*##%%$ Zrr cHt|dt|dz |tS)a%Inflates the top level fields of a BSON document. :Parameters: - `bson_bytes`: the BSON bytes that compose this document - `codec_options`: An instance of :class:`~bson.codec_options.CodecOptions` whose ``document_class`` must be :class:`RawBSONDocument`. )rrr )rrs rr%r%s"  As:':M35 QQr)rN)r:bsonrrbson.codec_optionsrrDEFAULTbson.py3compatrrbson.sonr Mappingr r% with_optionsrr>rrrIsQ&P08?)]Zckk]Z@ R07//Or