_ic ddlmZddlZddlZddlmZddlmZmZm Z m Z m Z m Z m Z mZddlmZ dZ dZ dZ dZ d Z erdd lmZdd lmZddlZddlmZGd d Zej>Z ej@Z ejBZ! ejDZ" eefZ#ejHej>ej@ejBejDfZ%ejHdej>dej@dejBdejDdiZ&dZ' dZ( dZ) dZ* dZ+ GddeZ,GddZ-Gdde.Z/y)) annotationsN)Enum) TYPE_CHECKINGAnyOptionalSequenceTupleTypeUnionoverload)UUID)array)mmapc(eZdZdZ eZ eZ dZ dZ y)UuidRepresentationrN) __name__ __module__ __qualname__ UNSPECIFIED UUID_SUBTYPESTANDARDOLD_UUID_SUBTYPE PYTHON_LEGACY JAVA_LEGACY CSHARP_LEGACYN/var/www/pod-logistic/pod-api/venv/lib/python3.12/site-packages/bson/binary.pyrrHs<K H %M K M r#rzUuidRepresentation.UNSPECIFIEDzUuidRepresentation.STANDARDz UuidRepresentation.PYTHON_LEGACYzUuidRepresentation.JAVA_LEGACYz UuidRepresentation.CSHARP_LEGACYr ceZdZdZdZdZdZy)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  DGJr#r*cBeZdZdZdZ d d dZd dZd dZd dZy) BinaryVectorzbVector of numbers along with metadata for binary interoperability. .. versionadded:: 4.10 datadtypepaddingc.||_||_||_y)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. (Padding is equivalent to a negative value of `count` in `numpy.unpackbits `_) Nr4)selfr5r6r7s r$__init__zBinaryVector.__init__s   r#cVd|jd|jd|jdS)NzBinaryVector(dtype=z , padding=z, data=))r6r7r5r9s r$__repr__zBinaryVector.__repr__s-$TZZL 4<<.PTPYPY{Z[\\r#ct|tsy|j|jk(xr4|j|jk(xr|j|jk(SNF) isinstancer3r6r7r5r9others r$__eq__zBinaryVector.__eq__sK%. JJ%++ % c$,,%--*G cDIIY^YcYcLc r#c,t|jSN)lenr5r=s r$__len__zBinaryVector.__len__ s499~r#Nr)r5z4Union[Sequence[float | int], npt.NDArray[np.number]]r6r*r7intreturnstrrCrrLboolrLrJ) rrrr. __slots__r:r>rDrHr"r#r$r3r3sD-I  B! &] r#r3ceZdZUdZdZded<ef ddZee jf ddZ e jfddZ ee ddZee d dd Zee d dd Ze d dd Zddd Zedd Zdfd Zd dZdfd Zd dZd!dZxZS)"BinaryaRepresentation 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. rrJ_Binary__subtypect|tstdt||dk\s|dkr t dt j |t|j}||_ |S)Nz(subtype must be an instance of int, not rz%subtype must be contained in [0, 256)) rArJ TypeErrortype ValueErrorbytes__new__ memoryviewtobytesrT)clsr5subtyper9s r$r[zBinary.__new__5sh '3'FtG}oVW W c>Wq[DE E}}S*T"2":":"<=  r#ct|tstdt||tvr t d|t jk(r t dt}|t jk(r |j}ni|t jk(r$|j}|ddddd|dddddz}n2|t jk(r |j}nt}|j}|||S) a3Create 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 `UUID representations `_ 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)rAr rWrXALL_UUID_REPRESENTATIONSrYrrrrrZr r!bytes_ler)r^uuiduuid_representationr_payload from_uuids r$rizBinary.from_uuidCs,$%I$t*VW W &> >Y  "4"@"@ @; # "4"B"B BjjG $6$B$B B I!nTrT*Yq_TrT-BBG $6$D$D DmmG#GjjG7G$$r#c|jtvrtd|jd|tvr td|tj k(r td|tj k(r|jtk(rt|S|tjk(r4|jtk(rrt|ddddd |dd ddd zS|tjk(r|jtk(r+t| S|jtk(r t|Std|jd t|) aCreate 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 `UUID representations `_ for details. .. versionadded:: 3.11 zcannot decode subtype z as a uuidraz)uuid_representation cannot be UNSPECIFIED)rZrr&Nrbrc)rez to ) r_ALL_UUID_SUBTYPESrYrdrrrrr r r!rUUID_REPRESENTATION_NAMES)r9rgs r$as_uuidzBinary.as_uuidzs9 <<0 05dll^:NO O &> >Y  "4"@"@ @HI I $6$D$D D||//$'' $6$B$B B||//$q)DbD/D2Jtt4D"DEE $6$D$D D||//T**|||+$''$T\\N$7PQd7e6f g  r#cyrFr")r^vectors r$ from_vectorzBinary.from_vectors r#cyrFr"r^ror6r7s r$rpzBinary.from_vector r#cyrFr"rrs r$rpzBinary.from_vectorrsr#c"t|tr3|s|r td|j}|j}|j }|dn|}t|t s tdtjd|j|}t|tr|t jk(rd}|rtd||t jk(r.d}d|cxkrd kDrnntd |d |r@|s>td |t jk(rd }|rtd|td|ztjdt!||g|}ne ddl}t||j&s td|j(dk7r td|t jk(r$|j+|jdd}n|t jk(rU|j-dk\r7|j/dkr$|j+|jdd}ntd|t jk(rU|j-dk\r7|j/dkr$|j+|jdd}ntdtd|z|j1}|r't!|r|dd|zdz zdk(s td|||zt2S#t$$r}t%d|d}~wwxYw) a#Create 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. .. versionchanged:: 4.14 When padding is non-zero, ignored bits should be zero. Raise exception on encoding, warn on decoding. .. versionadded:: 4.10 zkThe first argument, vector, has type BinaryVector. dtype or padding cannot be separately defined, but were.NrzUdtype must be a bson.BinaryVectorDtype of BinaryVectorDType.INT8, PACKED_BIT, FLOAT32>#D s6{DHg8J,KPQ+Qr 8d?N;;C !o sK44 L= L  Lch|jtk7rtd|jdtjd|\}}t |}d}t ||z }|r%|t jk7rtd|d|d|sa|t jk(r6d}d ||}ttj|||}t|||S|t jk(rK|d z} |d zr td d }d | |}ttj|||}t|||S|t jk(r|r |s td |dkDs|dkrtd|dd}d ||}ttj|||} |r/|r-| dd|zdz zdk7rtjdtdt| ||Std|j z ddl} |t jk(r| j&||dd} n|t jk(r(|d zr td | j&||dd} n|t jk(r|r |s td |dkDs|dkrtd|d| j&||dd} |r_| j(| d| dj+dkDr5tjdtdntd|j zt| ||S#t$$r} t%d| d} ~ wwxYw)aFrom the Binary, create a list or 1-d numpy array of numbers, along with dtype and padding. :param return_numpy: If True, BinaryVector.data will be a one-dimensional numpy array. By default, it is a list. :return: BinaryVector .. versionadded:: 4.10 zCannot decode subtype z as a vectorrvrzCorrupt data. Padding (z2) must be 0 for all but PACKED_BIT dtypes. (dtype=r<rwrzrzCCorrupt data. N bytes for a float32 vector must be a multiple of 4.ryz2Corrupt data. Vector has a padding P, but no data.r%rz) must be between 0 and 7.rxrbrzrVector has a padding P, but bits in the final byte lower than P are non-zero. For pymongo>=5.0, they must be zero.) stacklevelz(Binary Vector dtype %s not yet supportedNzBConverting binary to numpy.ndarray requires numpy to be installed.r~)r6r{r)r_rrYr unpack_fromr*rGr1r/rr3r0warningswarnDeprecationWarningrnamerr frombuffer unpackbitssum)r9 return_numpyr6r7offsetn_bytes dtype_format format_stringron_valuesunpacked_uint8srrr5s r$ as_vectorzBinary.as_vector s <<> )5dll^<PQ Q++E48w!%(d)f$ u 1 < <<)'2e_d^ffgh )..." "#G9\N ; f00fMN#FE7;;+333"a<Q;$] # "#H:l^ < f00fMN#FE7;;+6667$%YZZQ;'A+$'>wiGa%bcc" "#G9\N ; "&v'9'9-v'V"Ww?2+>!w,RSAS+SWX+XMMM*#$ $OUGDD**TW\WaWa*abb " )...$r}}T&']&A+333Q;$]%r}}T&'])D+6667$%YZZQ;'A+$'>wiGa%bcc$r}}T&']'B}r}}T"X6xyAEEG!KMMM*#$ **TW\WaWa*abbeW5 57 !X s-L L1 L,,L1c|jS)zSubtype of this binary data.)rTr=s r$r_zBinary.subtype{s~~r#ct|d}t|ts|j d}||j fS)Nrzlatin-1)super__getnewargs__rArZencoderT)r9r5 __class__s r$rzBinary.__getnewargs__s<w%'*$&;;y)DT^^##r#ct|tr/|jt|f|jt|fk(Syr@)rArSrTrZr_rBs r$rDz Binary.__eq__s6 eV $NNE$K0U]]E%L4QQ Qr#cLt|t|jz SrF)r__hash__hashrT)r9rs r$rzBinary.__hash__sw!D$888r#c||k( SrFr"rBs r$__ne__z Binary.__ne__s5=  r#c|jtk(rd|jdSdtj|d|jdS)NzzBinary(z, r<)rTSENSITIVE_SUBTYPErZr>r=s r$r>zBinary.__repr__sG >>. .''7r: :U^^D12"T^^4DAF Fr#)r^ Type[Binary]r5z7Union[memoryview, bytes, bytearray, _mmap, _array[Any]]r_rJrLrS)r^rrfr rgrJrLrS)rgrJrLr )r^rror3rLrSrI) r^rrozUnion[list[int], list[float]]r6r*r7rJrLrS) r^rroznpt.NDArray[np.number]r6r*r7rJrLrS)NN) r^rrozCUnion[BinaryVector, list[int], list[float], npt.NDArray[np.number]]r6zOptional[BinaryVectorDtype]r7z Optional[int]rLrS)F)rrOrLr3rP)rLzTuple[bytes, int]rNrK)rrrr. _type_marker__annotations__BINARY_SUBTYPEr[ classmethodrrrirmr rprpropertyr_rrDrrr> __classcell__)rs@r$rSrSs@LN &   E    BTB]B]4% 4%!%4%rs# WWW    %"@@F  & & #00  !,, #00 &|4""$$""$$ ""$D!>$$&H""$D$$&H     *%%PHGUHGr#