hdZddlmZGddeZGddeZGddeZGd d eZGd d eZd Z y)zkTools for working with `collations`_. .. _collations: http://userguide.icu-project.org/collation/concepts )commonc,eZdZdZdZ dZ dZ dZ dZy)CollationStrengthzd An enum that defines values for `strength` on a :class:`~pymongo.collation.Collation`. N) __name__ __module__ __qualname____doc__PRIMARY SECONDARYTERTIARY QUATERNARY IDENTICALT/var/www/html/ranktracker/api/venv/lib/python3.12/site-packages/pymongo/collation.pyrrs1 G4I*H'J;INrrceZdZdZdZ dZy)CollationAlternateze An enum that defines values for `alternate` on a :class:`~pymongo.collation.Collation`. z non-ignorableshiftedN)r r r r NON_IGNORABLESHIFTEDrrrrr-s $M@GrrceZdZdZdZ dZy)CollationMaxVariablezh An enum that defines values for `max_variable` on a :class:`~pymongo.collation.Collation`. punctspaceN)r r r rPUNCTSPACErrrrr@s E2 E#rrc eZdZdZdZ dZ dZy)CollationCaseFirstzf An enum that defines values for `case_first` on a :class:`~pymongo.collation.Collation`. upperloweroffN)r r r rUPPERLOWEROFFrrrr#r#Ms! E* E* C3rr#cNeZdZdZdZ d dZedZdZdZ dZ y) Collationa{ Collation :Parameters: - `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. - `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``. - `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) - `strength`: (optional) 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. - `numericOrdering`: (optional) If ``True``, order numbers numerically instead of in collation order (defaults to ``False``). - `alternate`: (optional) 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` - `maxVariable`: (optional) 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` - `normalization`: (optional) If ``True``, normalizes text into Unicode NFD. Defaults to ``False``. - `backwards`: (optional) 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``. - `kwargs`: (optional) Keyword arguments supplying any additional options to be sent with this Collation object. .. versionadded: 3.4 ) __documentNc  tjd|}d|i|_|#tjd||jd<|#tjd||jd<|#tjd||jd<|#tjd||jd<|#tjd||jd<|#tjd||jd<|#tjd||jd<| #tjd | |jd <|jj | y) Nlocale caseLevel caseFirststrengthnumericOrdering alternate maxVariable normalization backwards)rvalidate_string_Collation__documentvalidate_booleanvalidate_integerupdate) selfr.r/r0r1r2r3r4r5r6kwargss r__init__zCollation.__init__sU''&9#V,  +1+B+BY,(DOOK (  +1+A+AY,(DOOK (  *0*A*AH+&DOOJ '  &171H1H!?24DOO- .  +1+A+AY,(DOOK (  "-3-C-C{.,DOOM *  $/5/F/F00DOOO ,  +1+B+BY,(DOOK ( v&rc6|jjS)zThe document representation of this collation. .. note:: :class:`Collation` is immutable. Mutating the value of :attr:`document` does not mutate this :class:`Collation`. )r8copy)r<s rdocumentzCollation.documents##%%rcX|jddjfdDdS)Nz Collation(z, c32K|]}|d|yw)=Nr).0keyrAs r z%Collation.__repr__..sIhsm4Is))rAjoin)r<rAs @r__repr__zCollation.__repr__s*== IIII IL Lrc`t|tr|j|jk(StSN) isinstancer+rANotImplementedr<others r__eq__zCollation.__eq__s% eY '==ENN2 2rc||k( SrLrrOs r__ne__zCollation.__ne__s5=  r)NNNNNNNN) r r r r __slots__r>propertyrArJrQrSrrrr+r+]sS8t I !%!#$'L&&L  !rr+cz|yt|tr |jSt|tr|St d)NzFcollation must be a dict, an instance of collation.Collation, or None.)rMr+rAdict TypeError)values rvalidate_collation_or_nonerZs? }%#~~%   rN) rpymongorobjectrrrr#r+rZrrrr]sU OO,& $6 $ 4 4 x!x!v r