|hLdZddlmZdZdZdZdZdZeefeefdZd Z d Z y ) aCustom descriptions and summaries for the builtin types. The docstrings for objects of primitive types reflect the type of the object, rather than the object itself. For example, the docstring for any dict is this: > print({'key': 'value'}.__doc__) dict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs dict(iterable) -> new dictionary initialized as if via: d = {} for k, v in iterable: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2) As you can see, this docstring is more pertinent to the function `dict` and would be suitable as the result of `dict.__doc__`, but is wholely unsuitable as a description for the dict `{'key': 'value'}`. This modules aims to resolve that problem, providing custom summaries and descriptions for primitive typed values. ) formattingz""z The string ct|}|tttfvs0|tt t fvs|tttttfvryy)a~Whether the component should use a custom description and summary. Components of primitive type, such as ints, floats, dicts, lists, and others have messy builtin docstrings. These are inappropriate for display as descriptions and summaries in a CLI. This function determines whether the provided component has one of these docstrings. Note that an object such as `int` has the same docstring as an int like `3`. The docstring is OK for `int`, but is inappropriate as a docstring for `3`. Args: component: The component of interest. Returns: Whether the component should use a custom description and summary. TF) typestrintbytesfloatcomplexbooldicttuplelistset frozenset) componenttype_s W/var/www/html/test/engine/venv/lib/python3.12/site-packages/fire/custom_descriptions.pyNeedsCustomDescriptionr-sD y/% S%  5'4( ( 4c95 5  ct|ttz|kr|}nWttttjz}||kr|}tj||ttz |}tj |S)aReturns a custom summary for string type objects. This function constructs a summary for string type objects by double quoting the string value. The double quoted string value will be potentially truncated with ellipsis depending on whether it has enough space available to show the full string value. Args: obj: The object to generate summary for. available_space: Number of character spaces available. line_length: The full width of the terminal, default is 80. Returns: A summary for the input object. )lenTWO_DOUBLE_QUOTESrELLIPSISEllipsisTruncate DoubleQuote)objavailable_space line_lengthcontentadditional_len_neededs rGetStringTypeSummaryr!Gs~  X%&&/9G 12S9L9L5MM..#o)) _s#45 5{DG    ((rc $ttttzttjz}||kr|}ttj tj ||ttz ttz |zS)aReturns the predefined description for string obj. This function constructs a description for string type objects in the format of 'The string ""'. could be potentially truncated depending on whether it has enough space available to show the full string value. Args: obj: The object to generate description for. available_space: Number of character spaces available. line_length: The full width of the terminal, default if 80. Returns: A description for input object. )rSTRING_DESC_PREFIXrrrrr)rrrr s rGetStringTypeDescriptionr$bs 01C5z2234,,!O j44!! %7!88  !"-/0 00r)runicodec|t|j}|tvrtj|d|||Sy)Nrr__name__CUSTOM_DESC_SUM_FN_DICTgetrrr obj_type_names r GetSummaryr-Cs)$$--- " & &} 5a 8o9D FF rc|t|j}|tvrtj|d|||Sy)Nr'r+s rGetDescriptionr1r.rN) __doc__firerrr#rr!r$r)r-r1rrr5sP0"4)608 !": ;$&>? r