o 7h@sdZddlmZddlZddlZddlmZmZmZm Z er$ddl m Z e dddZ Gd d d e ejZGd dde ejZGd d d eZdS)z4Base classes and other objects used by enumerations.) annotationsN) TYPE_CHECKINGAnyTypeTypeVar)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 rselfrV/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/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 r rr)__name__ __module__ __qualname__rrr rrrrr s  r c@sVeZdZUdZded<ddd Zd d ZedddZedddZ edddZ 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 r rrcCs&t||}||_||_||_|Sr)r rrr&rr)rr r&rrrrrr*s  zBaseXmlEnum.__new__cCrrrrrrrr 1r!zBaseXmlEnum.__str__returnrcsDrtfdd|Ddnd}|dur t|jdt|S)aEnumeration member corresponding to XML attribute value `xml_value`. Raises `ValueError` if `xml_value` is the empty string ("") or is not an XML attribute value registered on the enumeration. Note that enum members that do not correspond to one of the defined values for an XML attribute have `xml_value == ""`. These "return-value only" members cannot be automatically mapped from an XML attribute value and must be selected explicitly by code, based on the appropriate conditions. Example:: >>> WD_PARAGRAPH_ALIGNMENT.from_xml("center") WD_PARAGRAPH_ALIGNMENT.CENTER c3s|] }|jkr|VqdSrr&.0memberr(rr Gsz'BaseXmlEnum.from_xml..Nz has no XML mapping for )next ValueErrorr"repr)rr&r+rr(rfrom_xml5szBaseXmlEnum.from_xmlrType[_T]rint | _TcCs.||}|j}|st|jd|jd|S)z@XML value of this enum member, generally an XML attribute value..z has no XML representation)r&r.r"r)rrr+r&rrrto_xmlQs zBaseXmlEnum.to_xmlrcCs"||vrt|d|jddS)z9Raise |ValueError| if `value` is not an assignable value.z not a member of z enumerationN)r.r")rrrrrvalidate\szBaseXmlEnum.validateN)r r r&r%rr)r&rr'r)rr1rr2r'r)rr1rr) r"r#r$r__annotations__rr classmethodr0r4r5rrrrr !s     c@s`eZdZdZdddZedd Zed d ZdddZeddZ eddZ eddZ dS)DocsPageFormatterzHFormats a reStructuredText documention page (string) for an enumeration.clsnamerclsdictdict[str, Any]cCs||_||_dSr)_clsname_clsdict)rr9r:rrr__init__fs zDocsPageFormatter.__init__cCs d}|j|j|j|jf}||S)z The 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_strjszDocsPageFormatter.page_strcCs@z|jd}Wn tyd}Ynw|durdSt|S)zr The docstring of the enumeration, formatted for use at the top of the documentation page rN)r=KeyErrortextwrapdedentr)rZ cls_docstringrrrrAys zDocsPageFormatter._intro_textr+BaseEnum | BaseXmlEnumcCs4t|jpd}tj|dddd}d|j|fS)zReturn an individual member definition formatted as an RST glossary entry. Output is wrapped to fit within 78 columns. rFNz )widthinitial_indentsubsequent_indentz%s %s )rHrIrrfillr)rr+Zmember_docstringrrr _member_defszDocsPageFormatter._member_defcs&jd}fdd|D}d|S)zx A single string containing the aggregated member definitions section of the documentation page __members__cs g|] }|jdur|qSr)rrPr)rrr s z2DocsPageFormatter._member_defs.. )r=join)rmembersZ member_defsrrrrBs  zDocsPageFormatter._member_defscCs |jdS)z= The Microsoft API name for this enumeration Z __ms_name__)r=rrrrr?s zDocsPageFormatter._ms_namecCs dt|jd}d|j|fS)z The title for the documentation page, formatted as code (surrounded in double-backtics) and underlined with '=' characters =z ``%s`` %s)lenr<)rZtitle_underscorerrrr@szDocsPageFormatter._page_titleN)r9rr:r;)r+rJ) r"r#r$rr>propertyrErArPrBr?r@rrrrr8cs      r8)r __future__renumrHtypingrrrrtyping_extensionsrrr Enumr r objectr8rrrrs   B