mongodb/mongo-python-driver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

PYTHON-1359: Add Example for RawBSONDocument (#578)

Browse Source 
Add doctest/example for inserting/retrieving RawBSONDocument
This commit is contained in:
William Zhou 2021-03-17 16:15:22 -07:00 committed by GitHub
parent 92a7433035
commit 8ef4524076
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 40 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
bson/raw_bson.py
View File

@ -13,6 +13,46 @@
# limitations under the License.
"""Tools for representing raw BSON documents.
Inserting and Retrieving RawBSONDocuments
=========================================
Example: Moving a document between different databases/collections
.. testsetup::
from pymongo import MongoClient
client = MongoClient(document_class=RawBSONDocument)
client.drop_database('db')
client.drop_database('replica_db')
.. doctest::
>>> import bson
>>> from pymongo import MongoClient
>>> from bson.raw_bson import RawBSONDocument
>>> client = MongoClient(document_class=RawBSONDocument)
>>> 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(f"raw document: {doc.raw}")
... print(f"decoded document: {bson.decode(doc.raw)}")
... result = replica_db.test.insert_one(doc)
raw document: b'...'
decoded document: {'_id': ObjectId('...'), 'a': 1}
raw document: b'...'
decoded document: {'_id': ObjectId('...'), 'b': 1}
raw document: b'...'
decoded document: {'_id': ObjectId('...'), 'c': 1}
raw document: b'...'
decoded document: {'_id': ObjectId('...'), '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.
"""
from collections.abc import Mapping as _Mapping