U \ShK@sUdZddlmZddlmZddlmZmZmZm Z dddhdd hd d d d hgZ ddddddZ ddddddZ ddddddZ ddddZeZded<dS) z babel.messages.checkers ~~~~~~~~~~~~~~~~~~~~~~~ Various routines that help with validation of translations. :since: version 0.9 :copyright: (c) 2013-2025 by the Babel Team. :license: BSD, see LICENSE for more details. ) annotations)Callable) PYTHON_FORMATCatalogMessageTranslationErroriduxXfFgGzCatalog | NonerNone)catalogmessagereturncCsd|jst|jtstddS|dkr*dS|j}t|ttfsD|f}t||jkr`td|jdS)z0Verify the number of plurals in the translation.z/Found plural forms for non-pluralizable messageNz*Wrong number of plural forms (expected %d)) Z pluralizable isinstancestringstrrlisttuplelen num_plurals)rrmsgstrsrJ/root/rtd-docs/venv/lib/python3.8/site-packages/babel/messages/checkers.pyrs rcCshd|jkrdS|j}t|ttfs(|f}|j}t|ttfsB|f}t||D]\}}|rLt||qLdS)z9Verify the format string placeholders in the translation.z python-formatN)flagsidrrrrzip_validate_format)rrZmsgidsrmsgidZmsgstrrrr python_format.s r$r)format alternativerc CsHddddd}dddddd }ddd d d }t|||f\}}|sLd St|||f\}}|rt|st|sttdn||krtd|rt|t|krtdtt||D]4\} \\} } \} } || | std| d| | fqn^t|} |D]P\}}|| krtd|q||| |std|d|d| |dqd S)a(Test format string `alternative` against `format`. `format` can be the msgid of a message and `alternative` one of the `msgstr`\s. The two arguments are not interchangeable as `alternative` may contain less placeholders if `format` uses named placeholders. If the string formatting of `alternative` is compatible to `format` the function returns `None`, otherwise a `TranslationError` is raised. Examples for compatible format strings: >>> _validate_format('Hello %s!', 'Hallo %s!') >>> _validate_format('Hello %i!', 'Hallo %d!') Example for an incompatible format strings: >>> _validate_format('Hello %(name)s!', 'Hallo %s!') Traceback (most recent call last): ... TranslationError: the format strings are of different kinds This function is used by the `python_format` checker. :param format: The original format string :param alternative: The alternative format string that should be checked against format :raises TranslationError: on formatting errors rzlist[tuple[str, str]])rrcSsJg}t|D]6}|\}}}|dkr2|dkr2q||t|fq|S)N%)rfinditergroupsappendr)rresultmatchnamer%typecharrrr_parse[sz _validate_format.._parsebool)abrcSs0||kr dStD]}||kr||krdSqdS)NTF)_string_format_compatibilities)r1r2setrrr _compatibleds z%_validate_format.._compatible)resultsrcSs@d}|D].\}}|dkr"|dk}q|dk|krtdqt|S)Nz5format string mixes positional and named placeholders)rr0)r6 positionalr-_charrrr_check_positionalls    z+_validate_format.._check_positionalNzplaceholders are incompatiblez)the format strings are of different kindsz-positional format placeholders are unbalancedzDincompatible format for placeholder %d: %r and %r are not compatiblezunknown named placeholder z$incompatible format for placeholder z: z and z are not compatible)maprr enumerater!dict)r%r&r/r5r9r1r2Z a_positionalZ b_positionalidx_firstsecondZtype_mapr-r.rrrr">s6    "    r"z1list[Callable[[Catalog | None, Message], object]])rcCs@ddlm}g}|dd|dDt|dkrsz!_find_checkers..zbabel.checkers)Zbabel.messages._compatrBextendrrr$)rBcheckersrrr_find_checkerss   rHrGN)__doc__ __future__rcollections.abcrZbabel.messages.catalogrrrrr3rr$r"rHrG__annotations__rrrrs   _