a ߙfb!@sdZddlZddlZddlmZddlZddlmZeeZ edde j Z edde j Z ddZd d Zd d Zd dZddZddZdddZddZddZdddZdS)z} Miscellaneous utilities for `astropy.units`. None of the functions in the module are meant for use outside of the package. N)Fraction)finfo?g@cCs*td|}|dur|d}|ddS)zS Get the first sentence from a string and remove any carriage returns. z .*?\S\.\sNr  )rematchgroupreplace)sxr 2lib/python3.9/site-packages/astropy/units/utils.py_get_first_sentences  rc csddlm}g}t}|D]N\}}t||js4q||jkr@qt||jrb||j j djq| |q|j ddd|D]r}t |j}d}t||jrd|j d dd d }d d d|jD} |||| |j|vrdndfVqdS)z Generates the ``(unit, doc, represents, aliases, prefixes)`` tuple used to format the unit summary docs in `generate_unit_summary`. )corercSs |jSN)namelower)r r r rAz$_iter_unit_summary..)keyz:math:`Zlatex`z, css|]}d|dVqdS)z``Nr .0r r r r Hrz%_iter_unit_summary..ZYesZNoN)rrsetitems isinstanceZUnitBaser PrefixUnitaddZ _representsbasesappendsortr__doc__stripZUnitZ to_stringjoinaliases) namespacerZunitsZ has_prefixesrvalunitdoc representsr)r r r_iter_unit_summary$s&      r/cCs8t}|dt|D]}|dj|q|S)a` Generates a summary of units from a given namespace. This is used to generate the docstring for the modules that define the actual units. Parameters ---------- namespace : dict A namespace containing units. Returns ------- docstring : str A docstring containing a summary table of the units. z .. list-table:: Available Units :header-rows: 1 :widths: 10 20 20 20 1 * - Unit - Description - Represents - Aliases - SI Prefixes z7 * - ``{}`` - {} - {} - {} - {} )ioStringIOwriter/formatgetvalue)r* docstring unit_summaryr r rgenerate_unit_summaryMs r7cCspddlm}i}|D](\}}t||r|jjd}|||j<qt}t |D]}| dj |qR| S)a Generates table entries for units in a namespace that are just prefixes without the base unit. Note that this is intended to be used *after* `generate_unit_summary` and therefore does not include the table header. Parameters ---------- namespace : dict A namespace containing units that are prefixes but do *not* have the base unit in their namespace. Returns ------- docstring : str A docstring containing a summary table of the units. r)r!rzO * - Prefixes for ``{}`` - {} prefixes - {} - {} - Only ) rr!rr r.r#rr0r1r/r2r3r4)r*r!Zfaux_namespaceZnmr,Z base_unitr5r6r r r generate_prefixonly_unit_summaryxs     r8cCsjzt|kotknWStydt|jko.)r@)Zquantityr[r rSZndarrayrTanyZ asanyarray)rNr@r rZrquantity_asanyarray"s , r])rH)N)r&r0rZ fractionsrZnumpyrSrrBZ _float_finfoZepsnegr9Zepsr:rr/r7r8r?rGrOrWrYr]r r r rs$   )+'  -