o h@sdZddlmZddlZddlZddlmZmZmZm Z m Z er&ddl m Z e dddZ Gd d d eejZGd ddeejZGd d d ZdS)z4Base classes and other objects used by enumerations.) annotationsN) TYPE_CHECKINGAnyDictTypeTypeVar)Self_T BaseXmlEnum)boundc@s"eZdZdZd ddZdd Zd S) BaseEnumzBase class for Enums that do not map XML attr values. The enum's value will be an integer, corresponding to the integer assigned the corresponding member in the MS API enum of the same name. ms_api_valueintdocstrstrcCs t||}||_||_|SN)r__new___value_strip__doc__)clsr rselfrN/var/www/html/premium_crap/venv/lib/python3.10/site-packages/docx/enum/base.pyrs  zBaseEnum.__new__cC|jd|jdSzEThe symbolic name and string value of this member, e.g. 'MIDDLE (3)'.z ()namevaluerrrr__str__zBaseEnum.__str__N)r rrr)__name__ __module__ __qualname__rrr!rrrrr s  r c@sHeZdZUdZded<ddd Zd d ZedddZedddZ dS)r zBase class for Enums that also map XML attr values. The enum's value will be an integer, corresponding to the integer assigned the corresponding member in the MS API enum of the same name. str | None xml_valuer rrrcCs&t||}||_||_||_|Sr)rrrr'rr)rr r'rrrrrr*s  zBaseXmlEnum.__new__cCrrrr rrrr!1r"zBaseXmlEnum.__str__returnrcs:tfdd|Dd}|durt|jdd|S)zEnumeration member corresponding to XML attribute value `xml_value`. Example:: >>> WD_PARAGRAPH_ALIGNMENT.from_xml("center") WD_PARAGRAPH_ALIGNMENT.CENTER c3s|] }|jkr|VqdSrr'.0memberr)rr ?sz'BaseXmlEnum.from_xml..Nz has no XML mapping for '')next ValueErrorr#)rr'r,rr)rfrom_xml5s zBaseXmlEnum.from_xmlrType[_T]rint | _T | NonecCs.||}|j}|st|jd|jd|S)z@XML value of this enum member, generally an XML attribute value..z has no XML representation)r'r0r#r)rrr,r'rrrto_xmlDs zBaseXmlEnum.to_xmlN)r rr'r&rr)r'r&r(r)rr2rr3r(r&) r#r$r%r__annotations__rr! classmethodr1r5rrrrr !s   c@s`eZdZdZdddZedd Zed d ZdddZeddZ eddZ eddZ dS)DocsPageFormatterzGenerate an .rst doc page for an enumeration. Formats a RestructuredText documention page (string) for the enumeration class parts passed to the constructor. An immutable one-shot service object. clsnamerclsdictDict[str, Any]cCs||_||_dSr)_clsname_clsdict)rr9r:rrr__init__Ws zDocsPageFormatter.__init__cCs d}|j|j|j|jf}||S)zyThe RestructuredText documentation page for the enumeration. This is the only API member for the class. z.. _%s: %s %s ---- %s)_ms_name _page_title _intro_text _member_defs)rtmpl componentsrrrpage_str[szDocsPageFormatter.page_strcCs@z|jd}Wn tyd}Ynw|durdSt|S)z?Docstring of the enumeration, formatted for documentation page.rN)r=KeyErrortextwrapdedentr)r cls_docstringrrrrAjs zDocsPageFormatter._intro_textr,BaseEnum | BaseXmlEnumcCs>|jdusJt|j}tj|dddd}d|j|fS)ztReturn an individual member definition formatted as an RST glossary entry, wrapped to fit within 78 columns.NNz )widthinitial_indentsubsequent_indentz%s %s )rrHrIrfillr)rr,member_docstringrrr _member_defwszDocsPageFormatter._member_defcs&jd}fdd|D}d|S)zgA single string containing the aggregated member definitions section of the documentation page. __members__cs g|] }|jdur|qSr)rrRr*r rr s z2DocsPageFormatter._member_defs.. )r=join)rmembers member_defsrr rrBs  zDocsPageFormatter._member_defscCs |jdS)z,The Microsoft API name for this enumeration. __ms_name__)r=r rrrr?s zDocsPageFormatter._ms_namecCs dt|jd}d|j|fS)zThe title for the documentation page, formatted as code (surrounded in double-backtics) and underlined with '=' characters.=z ``%s`` %s)lenr<)rtitle_underscorerrrr@szDocsPageFormatter._page_titleN)r9rr:r;)r,rK) r#r$r%rr>propertyrErArRrBr?r@rrrrr8Ps      r8)r __future__renumrHtypingrrrrrtyping_extensionsrr rEnumr r r8rrrrs   /