o h,@s~dZddlZddlZdZgdZgdZhdZdeded dfd d Zd;d ede d efddZ ded efddZ ded efddZ de d efddZde d efddZd informationZseriesZmoneyjeansfishsheepZspeciesZ equipmentricesingularpluralreturnc CsBdtdtfdd}|d|dkr_tdd|d|ddd |ddftdd|d|ddd |ddftdd|d|ddd |ddfdStdd |d||dd|d|ddftdd |d||dd|d|ddftdd |d||dd|d|ddftdd |d||dd|d|ddftdd |d||dd|d|ddftdd |d||dd|d|ddfdS) z A convenience function to add appropriate rules to plurals and singular for irregular words. :param singular: irregular word in singular form :param plural: irregular word in plural form stringrcSsddd|DS)Nr css$|] }d||dVqdS)[]N)upper).0charrR/var/www/html/magazine_api/magazine_env/lib/python3.10/site-packages/inflection.py ds"z6_irregular..caseinsensitive..)join)rrrrcaseinsensitivecsz#_irregular..caseinsensitiverz (?i)({}){}$Nrz{}{}$)strrPLURALSinsertformat SINGULARSlower)rrr rrr _irregular[sT  r(Truppercase_first_lettercCs2|r tddd|S|dt|ddS)aC Convert strings to CamelCase. Examples:: >>> camelize("device_type") 'DeviceType' >>> camelize("device_type", False) 'deviceType' :func:`camelize` can be thought of as a inverse of :func:`underscore`, although there are some cases where that does not hold:: >>> camelize(underscore("IOError")) 'IoError' :param uppercase_first_letter: if set to `True` :func:`camelize` converts strings to UpperCamelCase. If set to `False` :func:`camelize` produces lowerCamelCase. Defaults to `True`. z (?:^|_)(.)cS|dSNr!grouprmrrrzcamelize..rr!N)resubr'camelize)rr)rrrr4sr4wordcCs |ddS)z{Replace underscores with dashes in the string. Example:: >>> dasherize("puni_puni") 'puni-puni' _-)replacer5rrr dasherizes r:cCsBtdd|}|dd}tddd|}tdd d|}|S) a< Capitalize the first word and turn underscores into spaces and strip a trailing ``"_id"``, if any. Like :func:`titleize`, this is meant for creating pretty output. Examples:: >>> humanize("employee_salary") 'Employee salary' >>> humanize("author_id") 'Author' z_id$r r6 z(?i)([a-z\d]*)cSr*r+)r-r'r.rrrr0r1zhumanize..z^\wcSr*)Nrr,r.rrrr0r1)r2r3r8r9rrrhumanizes  r<numbercCs4tt|}|ddvrdSdddd|ddS) a Return the suffix that should be added to a number to denote the position in an ordered sequence such as 1st, 2nd, 3rd, 4th. Examples:: >>> ordinal(1) 'st' >>> ordinal(2) 'nd' >>> ordinal(1002) 'nd' >>> ordinal(1003) 'rd' >>> ordinal(-11) 'th' >>> ordinal(-1021) 'st' d) thstndrd)r! )absintgetr=rrrordinals   rMcCsd|t|S)a Turn a number into an ordinal string used to denote the position in an ordered sequence such as 1st, 2nd, 3rd, 4th. Examples:: >>> ordinalize(1) '1st' >>> ordinalize(2) '2nd' >>> ordinalize(1002) '1002nd' >>> ordinalize(1003) '1003rd' >>> ordinalize(-11) '-11th' >>> ordinalize(-1021) '-1021st' z{}{})r%rMrLrrr ordinalizesrNr7 separatorcCsTt|}td||}|r&t|}td|||}tdj|dd|}|S)z Replace special characters in a string so that it may be used as part of a 'pretty' URL. Example:: >>> parameterize(u"Donald E. Knuth") 'donald-e-knuth' z(?i)[^a-z0-9\-_]+z%s{2,}z(?i)^{sep}|{sep}$)sepr ) transliterater2r3escaper%r')rrOZre_seprrr parameterizes  rScCsD|r|tvr |StD]\}}t||rt|||Sq |S)a  Return the plural form of a word. Examples:: >>> pluralize("posts") 'posts' >>> pluralize("octopus") 'octopi' >>> pluralize("sheep") 'sheep' >>> pluralize("CamelOctopus") 'CamelOctopi' )r' UNCOUNTABLESr#r2searchr3)r5rule replacementrrr pluralizes  rXcCsRtD]}td||r|SqtD]\}}t||r&t|||Sq|S)ac Return the singular form of a word, the reverse of :func:`pluralize`. Examples:: >>> singularize("posts") 'post' >>> singularize("octopi") 'octopus' >>> singularize("sheep") 'sheep' >>> singularize("word") 'word' >>> singularize("CamelOctopi") 'CamelOctopus' z (?i)\b(%s)\Z)rTr2rUr&r3)r5Z inflectionrVrWrrr singularize5s  rYcCs tt|S)as Create the name of a table like Rails does for models to table names. This method uses the :func:`pluralize` method on the last word in the string. Examples:: >>> tableize('RawScaledScorer') 'raw_scaled_scorers' >>> tableize('egg_and_ham') 'egg_and_hams' >>> tableize('fancyCategory') 'fancy_categories' )rX underscorer9rrrtableizeQs r[cCstdddtt|S)a Capitalize all the words and replace some characters in the string to create a nicer looking title. :func:`titleize` is meant for creating pretty output. Examples:: >>> titleize("man from the boondocks") 'Man From The Boondocks' >>> titleize("x-men: the last stand") 'X Men: The Last Stand' >>> titleize("TheManWithoutAPast") 'The Man Without A Past' >>> titleize("raiders_of_the_lost_ark") 'Raiders Of The Lost Ark' z\b('?\w)cSr*r+)r- capitalize)matchrrrr0vr1ztitleize..)r2r3r<rZtitler9rrrtitleizebs r_cCstd|}|dddS)u5 Replace non-ASCII characters with an ASCII approximation. If no approximation exists, the non-ASCII character is ignored. The string must be ``unicode``. Examples:: >>> transliterate('älämölö') 'alamolo' >>> transliterate('Ærøskøbing') 'rskbing' ZNFKDasciiignore) unicodedata normalizeencodedecode)r normalizedrrrrQ{s rQcCs0tdd|}tdd|}|dd}|S)aq Make an underscored, lowercase form from the expression in the string. Example:: >>> underscore("DeviceType") 'device_type' As a rule of thumb you can think of :func:`underscore` as the inverse of :func:`camelize`, though there are cases where that does not hold:: >>> camelize(underscore("IOError")) 'IoError' z([A-Z]+)([A-Z][a-z])z\1_\2z([a-z\d])([A-Z])r7r6)r2r3r8r'r9rrrrZs rZZpersonZpeoplemanZmenZhumanZhumanschildchildrenZsexZsexesmovemovescowZkinezombieZzombies)T)r7)__doc__r2rb __version__r#r&rTr"r(boolr4r:r<rJrMrNrSrXrYr[r_rQrZrrrrs8 $ 5