_i, dZddlmZddlmZmZmZmZddlm Z ddl m Z GddZ Gdd Z Gd d ZGd d ZGddZddZdS)zTools for working with `collations`_. .. _collations: https://www.mongodb.com/docs/manual/reference/collation/ .. seealso:: This module is compatible with both the synchronous and asynchronous PyMongo APIs. ) annotations)AnyMappingOptionalUnion)common)validate_booleanc.eZdZdZdZ dZ dZ dZ dZdS)CollationStrengthzd An enum that defines values for `strength` on a :class:`~pymongo.collation.Collation`. N) __name__ __module__ __qualname____doc__PRIMARY SECONDARYTERTIARY QUATERNARY IDENTICAL4D:\Nbitz\venv\Lib\site-packages\pymongo/collation.pyr r sA G4I*H'J;INNrr ceZdZdZdZ dZdS)CollationAlternateze An enum that defines values for `alternate` on a :class:`~pymongo.collation.Collation`. z non-ignorableshiftedN)rrrr NON_IGNORABLESHIFTEDrrrrr3s- $M@GrrceZdZdZdZ dZdS)CollationMaxVariablezh An enum that defines values for `max_variable` on a :class:`~pymongo.collation.Collation`. punctspaceN)rrrrPUNCTSPACErrrr#r#Fs) E2 E##rr#c"eZdZdZdZ dZ dZdS)CollationCaseFirstzf An enum that defines values for `case_first` on a :class:`~pymongo.collation.Collation`. upperloweroffN)rrrrUPPERLOWEROFFrrrr)r)Ss1 E* E* C33rr)c`eZdZdZdZ dddZeddZd dZd!dZ d!dZ dS)" Collationa' Collation :param locale: (string) The locale of the collation. This should be a string that identifies an `ICU locale ID` exactly. For example, ``en_US`` is valid, but ``en_us`` and ``en-US`` are not. Consult the MongoDB documentation for a list of supported locales. :param caseLevel: (optional) If ``True``, turn on case sensitivity if `strength` is 1 or 2 (case sensitivity is implied if `strength` is greater than 2). Defaults to ``False``. :param caseFirst: (optional) Specify that either uppercase or lowercase characters take precedence. Must be one of the following values: * :data:`~CollationCaseFirst.UPPER` * :data:`~CollationCaseFirst.LOWER` * :data:`~CollationCaseFirst.OFF` (the default) :param strength: Specify the comparison strength. This is also known as the ICU comparison level. This must be one of the following values: * :data:`~CollationStrength.PRIMARY` * :data:`~CollationStrength.SECONDARY` * :data:`~CollationStrength.TERTIARY` (the default) * :data:`~CollationStrength.QUATERNARY` * :data:`~CollationStrength.IDENTICAL` Each successive level builds upon the previous. For example, a `strength` of :data:`~CollationStrength.SECONDARY` differentiates characters based both on the unadorned base character and its accents. :param numericOrdering: If ``True``, order numbers numerically instead of in collation order (defaults to ``False``). :param alternate: Specify whether spaces and punctuation are considered base characters. This must be one of the following values: * :data:`~CollationAlternate.NON_IGNORABLE` (the default) * :data:`~CollationAlternate.SHIFTED` :param maxVariable: When `alternate` is :data:`~CollationAlternate.SHIFTED`, this option specifies what characters may be ignored. This must be one of the following values: * :data:`~CollationMaxVariable.PUNCT` (the default) * :data:`~CollationMaxVariable.SPACE` :param normalization: If ``True``, normalizes text into Unicode NFD. Defaults to ``False``. :param backwards: If ``True``, accents on characters are considered from the back of the word to the front, as it is done in some French dictionary ordering traditions. Defaults to ``False``. :param kwargs: Keyword arguments supplying any additional options to be sent with this Collation object. .. versionadded: 3.4 ) __documentNlocalestr caseLevelOptional[bool] caseFirst Optional[str]strength Optional[int]numericOrdering alternate maxVariable normalization backwardskwargsrreturnNonec  >tjd|}d|i|_|td||jd<|tjd||jd<|tjd||jd<|td||jd<|tjd||jd<|tjd||jd<|td||jd<| td | |jd <|j| dS) Nr3r5r7r9r;r<r=r>r?)rvalidate_string_Collation__documentr validate_integerupdate) selfr3r5r7r9r;r<r=r>r?r@s r__init__zCollation.__init__s4'&99+3V*<  +;K+S+SDOK (  +1+A+y+Y+YDOK (  *0*A*h*W*WDOJ '  &1A!?22DO- .  +1+A+y+Y+YDOK (  "-3-CMS^-_-_DOM *  $/?Q^/_/_DOO ,  +;K+S+SDOK ( v&&&&&rdict[str, Any]c4|jS)zThe document representation of this collation. .. note:: :class:`Collation` is immutable. Mutating the value of :attr:`document` does not mutate this :class:`Collation`. )rEcopy)rHs rdocumentzCollation.documents##%%%rcz|jddfdDS)Nz Collation({})z, c32K|]}|d|VdS)=Nr).0keyrMs r z%Collation.__repr__..s5/_/_s30J0J#0J0J/_/_/_/_/_/_r)rMformatjoin)rHrMs @r__repr__zCollation.__repr__s@=%%dii/_/_/_/_V^/_/_/_&_&_```rotherboolcZt|tr|j|jkStSN) isinstancer1rMNotImplementedrHrWs r__eq__zCollation.__eq__s) eY ' ' 3=EN2 2rc||k SrZrr]s r__ne__zCollation.__ne__s5=  r)NNNNNNNN)r3r4r5r6r7r8r9r:r;r6r<r8r=r8r>r6r?r6r@rrArB)rArJ)rAr4)rWrrArX) rrrr __slots__rIpropertyrMrVr^r`rrrr1r1cs77r I %)#'"&*.#'%)(,$(!'!'!'!'!'F&&&X&aaaa !!!!!!rr1value-Optional[Union[Mapping[str, Any], Collation]]rAOptional[dict[str, Any]]c|dSt|tr|jSt|tr|St d)NzEcollation must be a dict, an instance of collation.Collation, or None)r[r1rMdict TypeError)rcs rvalidate_collation_or_nonerisN }t%##~% [ \ \\rN)rcrdrAre)r __future__rtypingrrrrpymongorpymongo.write_concernr r rr#r)r1rirrrrnsh #"""""000000000000222222OOOOOOOO,& $ $ $ $ $ $ $ $ 4 4 4 4 4 4 4 4 s!s!s!s!s!s!s!s!l ] ] ] ] ] ]r