o 'hnK @sPddlmZddlZddlmZddlmZmZmZm Z m Z m Z m Z m Z ddlmZ dZ dZ dZ dZ d Z erHdd lmZdd lmZGd d d ZejZ ejZ ejZ ejZ eefZejejejejejfZ ejdejdejdejdejdiZ!dZ" dZ# dZ$ dZ% dZ& GdddeZ'GdddZ(Gddde)Z*dS)) annotationsN)Enum) TYPE_CHECKINGAnyOptionalSequenceTupleTypeUnionoverload)UUID)array)mmapc@s(eZdZdZ eZ eZ dZ dZ dS)UuidRepresentationrN) __name__ __module__ __qualname__ UNSPECIFIED UUID_SUBTYPESTANDARDOLD_UUID_SUBTYPE PYTHON_LEGACY JAVA_LEGACY CSHARP_LEGACYr r G/var/www/html/olx_land/venv/lib/python3.10/site-packages/bson/binary.pyrDs   rzUuidRepresentation.UNSPECIFIEDzUuidRepresentation.STANDARDz UuidRepresentation.PYTHON_LEGACYzUuidRepresentation.JAVA_LEGACYz UuidRepresentation.CSHARP_LEGACYr c@seZdZdZdZdZdZdS)BinaryVectorDtypeaNDatatypes of vector subtype. :param FLOAT32: (0x27) Pack list of :class:`float` as float32 :param INT8: (0x03) Pack list of :class:`int` in [-128, 127] as signed int8 :param PACKED_BIT: (0x10) Pack list of :class:`int` in [0, 255] as unsigned uint8 The `PACKED_BIT` value represents a special case where vector values themselves can only be of two values (0 or 1) but these are packed together into groups of 8, a byte. In Python, these are displayed as ints in range [0, 255] Each value is of type bytes with a length of one. .. versionadded:: 4.10 'N)rrr__doc__INT8FLOAT32 PACKED_BITr r r r!r&s r&c@s4eZdZdZdZddd d ZdddZdddZdS) BinaryVectorzbVector of numbers along with metadata for binary interoperability. .. versionadded:: 4.10 datadtypepaddingrr0Sequence[float | int]r1r&r2intcCs||_||_||_dS)a\ :param data: Sequence of numbers representing the mathematical vector. :param dtype: The data type stored in binary :param padding: The number of bits in the final byte that are to be ignored when a vector element's size is less than a byte and the length of the vector is not a multiple of 8. Nr/)selfr0r1r2r r r!__init__s zBinaryVector.__init__returnstrcCsd|jd|jd|jdS)NzBinaryVector(dtype=z , padding=z, data=))r1r2r0r5r r r!__repr__szBinaryVector.__repr__otherrboolcCs2t|tsdS|j|jko|j|jko|j|jkSNF) isinstancer.r1r2r0r5r<r r r!__eq__s "zBinaryVector.__eq__Nr)r0r3r1r&r2r4r7r8r<rr7r=)rrrr* __slots__r6r;rAr r r r!r.s   r.cseZdZUdZdZded<efd6d d Zee j fd7ddZ e j fd8ddZ ee d9ddZee d:d;ddZe  dd#d$Zed?d%d&Zd@fd(d) ZdAd-d.Zd?fd/d0 ZdAd1d2ZdBd4d5ZZS)CBinaryaRepresentation of BSON binary data. We want to represent Python strings as the BSON string type. We need to wrap binary data so that we can tell the difference between what should be considered binary data and what should be considered a string when we encode to BSON. Subtype 9 provides a space-efficient representation of 1-dimensional vector data. Its data is prepended with two bytes of metadata. The first (dtype) describes its data type, such as float32 or int8. The second (padding) prescribes the number of bits to ignore in the final byte. This is relevant when the element size of the dtype is not a multiple of 8. Raises TypeError if `subtype` is not an instance of :class:`int`. Raises ValueError if `subtype` is not in [0, 256). .. note:: Instances of Binary with subtype 0 will be decoded directly to :class:`bytes`. :param data: the binary data to represent. Can be any bytes-like type that implements the buffer protocol. :param subtype: the `binary subtype `_ to use .. versionchanged:: 3.9 Support any bytes-like type that implements the buffer protocol. .. versionchanged:: 4.10 Addition of vector subtype. rr4_Binary__subtypecls Type[Binary]r0,Union[memoryview, bytes, _mmap, _array[Any]]subtyper7cCsRt|tstdt||dks|dkrtdt|t|}||_ |S)Nz(subtype must be an instance of int, not rz%subtype must be contained in [0, 256)) r?r4 TypeErrortype ValueErrorbytes__new__ memoryviewtobytesrG)rHr0rKr5r r r!rQ's zBinary.__new__uuidr uuid_representationcCst|tstdt||tvrtd|tjkrtdt}|tj kr*|j }n-|tj krI|j }|ddddd|ddddd}n|tj krR|j }nt}|j }|||S) aCreate a BSON Binary object from a Python UUID. Creates a :class:`~bson.binary.Binary` object from a :class:`uuid.UUID` instance. Assumes that the native :class:`uuid.UUID` instance uses the byte-order implied by the provided ``uuid_representation``. Raises :exc:`TypeError` if `uuid` is not an instance of :class:`~uuid.UUID`. :param uuid: A :class:`uuid.UUID` instance. :param uuid_representation: A member of :class:`~bson.binary.UuidRepresentation`. Default: :const:`~bson.binary.UuidRepresentation.STANDARD`. See :ref:`handling-uuid-data-example` for details. .. versionadded:: 3.11 z+uuid must be an instance of uuid.UUID, not Guuid_representation must be a value from bson.binary.UuidRepresentationacannot encode native uuid.UUID with UuidRepresentation.UNSPECIFIED. UUIDs can be manually converted to bson.Binary instances using bson.Binary.from_uuid() or a different UuidRepresentation can be configured. See the documentation for UuidRepresentation for more information.rr#N)r?r rMrNALL_UUID_REPRESENTATIONSrOrrrrrPrrbytes_ler)rHrTrUrKpayload from_uuidr r r!r\5s*    .  zBinary.from_uuidcCs|jtvrtd|jd|tvrtd|tjkrtd|tjkr/|jtkr.t|dSn>|tj krS|jtkrRt|ddddd |dd ddd dSn|tj krc|jtkrbt|d Sn |jt krmt|dStd|jd t |) a9Create a Python UUID from this BSON Binary object. Decodes this binary object as a native :class:`uuid.UUID` instance with the provided ``uuid_representation``. Raises :exc:`ValueError` if this :class:`~bson.binary.Binary` instance does not contain a UUID. :param uuid_representation: A member of :class:`~bson.binary.UuidRepresentation`. Default: :const:`~bson.binary.UuidRepresentation.STANDARD`. See :ref:`handling-uuid-data-example` for details. .. versionadded:: 3.11 zcannot decode subtype z as a uuidrVz)uuid_representation cannot be UNSPECIFIED)rPrr#NrWrX)rZz to ) rKALL_UUID_SUBTYPESrOrYrrrrr rrrUUID_REPRESENTATION_NAMES)r5rUr r r!as_uuidls2       2     zBinary.as_uuidvectorr.cCdSNr )rHr`r r r! from_vectorszBinary.from_vectorrUnion[list[int], list[float]]r1r&r2cCrarbr )rHr`r1r2r r r!rcsN+Union[BinaryVector, list[int], list[float]]Optional[BinaryVectorDtype] Optional[int]cCst|tr|s |r td|j}|j}|j}|durdn|}|tjkr/d}|r.td|n;|tjkrSd}d|kr@dkrJnntd|d |rR|sRtd n|tj krdd }|rctd|nt d |t d |j |}t j dt||g|R}|||tdS)aCreate a BSON :class:`~bson.binary.Binary` of Vector subtype. To interpret the representation of the numbers, a data type must be included. See :class:`~bson.binary.BinaryVectorDtype` for available types and descriptions. The dtype and padding are prepended to the binary data's value. :param vector: Either a List of values, or a :class:`~bson.binary.BinaryVector` dataclass. :param dtype: Data type of the values :param padding: For fractional bytes, number of bits to ignore at end of vector. :return: Binary packed data identified by dtype and padding. .. versionadded:: 4.10 zkThe first argument, vector, has type BinaryVector. dtype or padding cannot be separately defined, but were.Nrbz padding does not apply to dtype=Br"zpadding=z. It must be in [0,1, ..7].z#Empty vector with non-zero padding.fz%s not yet supported)r?rFrGrPrKr@r r r!rAs z Binary.__eq__cstt|jASrb)r__hash__hashrGr:rr r!rszBinary.__hash__cCs ||k Srbr r@r r r!__ne__ s z Binary.__ne__r8cCs2|jtkr d|jdSdt|d|jdS)NzzBinary(z, r9)rGSENSITIVE_SUBTYPErPr;r:r r r!r;#s zBinary.__repr__)rHrIr0rJrKr4r7rF)rHrIrTr rUr4r7rF)rUr4r7r )rHrIr`r.r7rFrB) rHrIr`rdr1r&r2r4r7rF)NN) rHrIr`rer1rfr2rgr7rF)r7r.)r7r4)r7rrDrC)rrrr* _type_marker__annotations__BINARY_SUBTYPErQ classmethodrrr\r_r rcr~propertyrKrrArrr; __classcell__r r rr!rFs:   6, 4-   rF)+ __future__rrnenumrtypingrrrrrr r r rTr rFUNCTION_SUBTYPEOLD_BINARY_SUBTYPErrr_arrayr_mmaprrrrrr]rrYr^ MD5_SUBTYPECOLUMN_SUBTYPErrrUSER_DEFINED_SUBTYPEr&r.rPrFr r r r!sl  (    C