Compatibilidade

CPython

PyPy

Dados binários

Em todas as versões do Python, o PyMongo codifica instâncias da classe bytes como dados binários com subtipo 0, o subtipo padrão para dados binários. No Python 3, o PyMongo decodifica esses valores para instâncias da classe bytes. No Python 2, o driver os decodifica para instâncias da classe Binary com subtipo 0.

Os seguintes exemplos de código mostram como o PyMongo decodifica instâncias da classe bytes . Selecione a aba Python 2 ou Python 3 para visualizar o código correspondente.

from pymongo import MongoClient
client = MongoClient()
client.test.test.insert_one({'binary': b'this is a byte string'})
doc = client.test.test.find_one()
print(doc)

{u'_id': ObjectId('67afb78298f604a28f0247b4'), u'binary': Binary('this is a byte string', 0)}

from pymongo import MongoClient
client = MongoClient()
client.test.test.insert_one({'binary': b'this is a byte string'})
doc = client.test.test.find_one()
print(doc)

{'_id': ObjectId('67afb78298f604a28f0247b4'), 'binary': b'this is a byte string'}

O driver se comporta da mesma maneira ao decodificar valores binários JSON com subtipo 0. No Python 3, ele decodifica esses valores para instâncias da classe bytes. No Python 2, o driver os decodifica para instâncias da classe Binary com subtipo 0. Para exemplos de código que mostram as diferenças, consulte a página JSON estendido.

ObjectIds em pedaços

Se você selecionou um ObjectId no Python 2 e deseja retirá-lo do Python 3, deverá passar encoding='latin-1' como um argumento para o método pickle.loads() .

O exemplo a seguir mostra como usar o Python 3 para desmarcar um ObjectId que foi selecionado no Python 2:

import pickle
pickle.loads(b'<ObjectId byte stream>', encoding='latin-1')

Se um aplicação Python 3 usar um protocolo de serialização compatível para desmarcar um ObjectId, você poderá usar o Python 2 para desmarcar. Para especificar um protocolo compatível no Python 3, passe um valor de 0, 1 ou 2 para o parâmetro protocol do método pickle.dumps().

O exemplo a seguir seleciona um ObjectId no Python 3 e, em seguida, imprime o ObjectId e a instância bytes resultante:

import pickle
from bson.objectid import ObjectId
oid = ObjectId()
oid_bytes = pickle.dumps(oid, protocol=2)
print("ObjectId: {}".format(oid))
print("ObjectId bytes: {}".format(oid_bytes))

ObjectId: 67af9b1fae9260c0e97eb9eb
ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00...

O exemplo a seguir retira o ObjectId do exemplo anterior e então imprime as instâncias bytes e ObjectId:

import pickle
from bson.objectid import ObjectId
oid_bytes = b'\x80\x02cbson.objectid\nObjectId\nq\x00...'
oid = pickle.loads(oid_bytes)
print("ObjectId bytes: {}".format(oid_bytes))
print("ObjectId: {}".format(oid))

ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00)...
ObjectId: 67af9b1fae9260c0e97eb9eb