,h)dZddlmZmZddlZddlZdZGddeZGdde Z Gd d eZ e d efe e jZGd d eZGddeZGddeZGddeZGddeZy)z5 Base classes and other objects used by enumerations )absolute_importprint_functionNcfd}|S)z Decorating a class with @alias('FOO', 'BAR', ..) allows the class to be referenced by each of the names provided as arguments. cbtjd}|j}D]}|||< |S)N)sys _getframe f_globals)clscaller globals_dictaliasaliasess P/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/enum/base.py decoratorzalias..decorators:q!''  &E"%L  & )rrs` rrr s  rcleZdZdZdZedZedZdZedZ edZ edZ y ) _DocsPageFormatterz Formats a RestructuredText documention page (string) for the enumeration class parts passed to the constructor. An immutable one-shot service object. c ||_||_yN)_clsname_clsdict)selfclsnameclsdicts r__init__z_DocsPageFormatter.__init__%s  rcld}|j|j|j|jf}||zS)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 componentss rpage_strz_DocsPageFormatter.page_str)s? 3 MM           j  rc |jd}|ytj|j S#t$rd}Y3wxYw)zr The docstring of the enumeration, formatted for use at the top of the documentation page __doc__)rKeyErrortextwrapdedentstrip)r cls_docstrings rr!z_DocsPageFormatter._intro_text8sN   MM)4M  }-3355  M s7 AActj|jj}tj|ddd}|j d|dS)z Return an individual member definition formatted as an RST glossary entry, wrapped to fit within 78 columns. Nz )widthinitial_indentsubsequent_indent )r*r+ docstringr,fillname)rmembermember_docstrings r _member_defz_DocsPageFormatter._member_defHsO $??6+;+;<BBD#== "%   $[[*:;;rc|jd}|Dcgc] }|j|j|"}}dj|Scc}w)zx A single string containing the aggregated member definitions section of the documentation page __members__r3)rr6r9join)rmembersr7 member_defss rr"z_DocsPageFormatter._member_defsVsV -- .3: )/fkk>UD  V $  yy%% s A A c |jdS)z= The Microsoft API name for this enumeration __ms_name__)rrs rrz_DocsPageFormatter._ms_namebs }}]++rc\dt|jdzz}d|jd|S)z The title for the documentation page, formatted as code (surrounded in double-backtics) and underlined with '=' characters =z``z`` )lenr)rtitle_underscores rr z_DocsPageFormatter._page_titleis- #dmm"4q"89#}}.>??rN) __name__ __module__ __qualname__r'rpropertyr%r!r9r"rr rrrrrsw   ! ! 6 6 < & &,, @@rrcFeZdZdZdZedZedZedZy)MetaEnumerationz The metaclass for Enumeration and its subclasses. Adds a name for each named member and compiles state needed by the enumeration class to respond to other attribute gets c|j||j||j||tj ||||Sr)_add_enum_members_collect_valid_settings_generate_docs_pagetype__new__)metarbasesrs rrRzMetaEnumeration.__new__zsC w' $$W-   '2||D'5'::rc>|d}|D]}|j|y)z Dispatch ``.add_to_enum()`` call to each member so it can do its thing to properly add itself to the enumeration class. This delegation allows member sub-classes to add specialized behaviors. r;N) add_to_enum)rSr enum_membersr7s rrNz!MetaEnumeration._add_enum_memberss+}- " (F   w ' (rc`|d}g}|D]}|j|j||d<y)z Return a sequence containing the enumeration values that are valid assignment values. Return-only values are excluded. r;_valid_settingsN)extendvalid_settings)rSrrWr[r7s rrOz'MetaEnumeration._collect_valid_settingssA }- " 9F  ! !&"7"7 8 9%3!"rc6t||j|d<y)zH Return the RST documentation page for the enumeration. __docs_rst__N)rr%)rSrrs rrPz#MetaEnumeration._generate_docs_pages #5Wg"F"O"OrN) rGrHrIr'rR classmethodrNrOrPrrrrLrLssJ ; (( 4 4PPrrLc(eZdZdZdZdZedZy)EnumerationBasez Base class for all enumerations, used directly for enumerations requiring only basic behavior. It's __dict__ is used below in the Python 2+3 compatible metaclass definition. rr(cV||jvrt|d|jdy)zK Raise |ValueError| if *value* is not an assignable value. z not a member of z enumerationN)rY ValueErrorrG)r values rvalidatezEnumerationBase.validates0 ++ +7>r) rGrHrIr'rRrrJr __classcell__rs@rrvrvs+ =$ '' ?rrvc eZdZdZedZy)ReturnValueOnlyEnumMemberz Used to define a member of an enumeration that is only valid as a query result and is not valid as a setting, e.g. MSO_VERTICAL_ANCHOR.MIXED (-2) cy)z@ No settings are valid for a return-only value. rrrAs rr[z(ReturnValueOnlyEnumMember.valid_settings4s rN)rGrHrIr'rJr[rrrrr.s rrcbeZdZdZfdZfdZdZedZe dZ e dZ xZ S)XmlMappedEnumMemberzM Used to define a member whose value maps to an XML attribute value. c>tt| |||||_yr)rrr _xml_value)rr6rc xml_valuer4rs rrzXmlMappedEnumMember.__init__As !41$yI#rcNtt| ||j|y)zH Compile XML mappings in addition to base add behavior. N)rrrVregister_xml_mapping)rrrs rrVzXmlMappedEnumMember.add_to_enumEs# !44W= !!'*rc|j|}|j||j<|j|}|j||j<y)zR Add XML mappings to the enumeration class state for this member. N)_get_or_add_member_to_xmlrrc_get_or_add_xml_to_member)rr member_to_xml xml_to_members rrz(XmlMappedEnumMember.register_xml_mappingLsH66w? $(NN djj!66w? (, dnn%rc|jS)zT The XML attribute value that corresponds to this enumeration value )rrAs rrzXmlMappedEnumMember.xml_valueUr}rc.d|vr t|d<|dS)zR Add the enum -> xml value mapping to the enumeration class state rmdictrs rrz-XmlMappedEnumMember._get_or_add_member_to_xml\% 7 *(,G$ %'((rc.d|vr t|d<|dS)zR Add the xml -> enum value mapping to the enumeration class state rirrs rrz-XmlMappedEnumMember._get_or_add_xml_to_membererr) rGrHrIr'rrVrrJr staticmethodrrrrs@rrr<sS$+3 ))))rr)r' __future__rrrr*robjectrrQrLr`r__dict__rergrqrurvrrrrrrs7 "R@R@j)Pd)PXf*mfY_=U=U8VW ,[,4==@??:  0)*0)r