,h7@dZddlmZmZmZmZddlZddlmZddl m Z ddl m Z m Z mZmZddlmZddlmZdd lmZdd lmZdd lmZmZmZmZmZmZmZm Z m!Z!dd l"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+dd l,m-Z-m.Z.Gdde#Z/Gdde#Z0Gdde#Z1Gdde#Z2Gdde#Z3Gdde#Z4Gdde#Z5Gdde#Z6Gdde#Z7Gd d!e#Z8Gd"d#e#Z9Gd$d%e#Z:Gd&d'e#Z;y)(z4Custom element classes for text-related XML elements)absolute_importdivisionprint_functionunicode_literalsN) to_unicode)MSO_LANGUAGE_ID) MSO_AUTO_SIZEMSO_TEXT_UNDERLINE_TYPEMSO_VERTICAL_ANCHORPP_PARAGRAPH_ALIGNMENT)InvalidXmlError) parse_xml)CT_GradientFillPropertiesnsdecls) ST_Coordinate32&ST_TextFontScalePercentOrPercentStringST_TextFontSizeST_TextIndentLevelType$ST_TextSpacingPercentOrPercentStringST_TextSpacingPointST_TextTypefaceST_TextWrappingType XsdBoolean) BaseOxmlElementChoice OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoice)EmuLengthcxeZdZdZeddZedZedZ e jdZ e dZ y ) CT_RegularTextRunz`a:r` custom element classa:rPr)a:t successorsr)cL|jj}| t|SdS)z7(unicode) str containing text of (required) `a:t` childttextr)selfr0s P/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/oxml/text.pyr0zCT_RegularTextRun.text4s&vv{{#'#3z$;;cD|j||j_y)z+*str* is unicode value to replace run text.N)_escape_ctrl_charsr/r0)r1strs r2r0zCT_RegularTextRun.text;s--c2 r3c2tjdd|S)aReturn str after replacing each control character with a plain-text escape. For example, a BEL character (x07) would appear as "_x0007_". Horizontal-tab (x09) and line-feed (x0A) are not escaped. All other characters in the range x00-x1F are escaped. z([\x00-\x08\x0B-\x1F])c<dt|jdzS)Nz_x%04X_)ordgroup)matchs r2z6CT_RegularTextRun._escape_ctrl_chars..IsYU[[QR^AT5Tr3)resub)ss r2r5z$CT_RegularTextRun._escape_ctrl_chars@svv %'TVW  r3N) __name__ __module__ __qualname____doc__r"rPrrr/propertyr0setter staticmethodr5r3r2r'r'.sY$ G 1CeA <<  [[33    r3r'ceZdZdZedZedZdZe dZ e dZ e dZ e dZe d Ze d Zd Ze d Ze d Ze dZy) CT_TextBodyzg`p:txBody` custom element class. Also used for `c:txPr` in charts and perhaps other elements. za:bodyPrza:pcH|jD]}|j|y)zRemove all `a:p` children, but leave any others. cf. lxml `_Element.clear()` method which removes all children. N)p_lstremove)r1ps r2 clear_contentzCT_TextBody.clear_contentVs"  A KKN r3cd|jd}|j}|j}|S)z ```` element of required first ``p`` child, added with its ancestors if not present. Used when element is a ```` in a chart and the ``p`` element is used only to specify formatting, not content. r)rMget_or_add_pPrget_or_add_defRPr)r1rOpPrdefRPrs r2rUzCT_TextBody.defRPr^s2 JJqM &&( r3cz|j}t|dkDry|s td|djdk7ryy)z5True if only a single empty `a:p` element is present.r9Fz#p:txBody must have at least one a:prr-T)rMlenr r0)r1pss r2is_emptyzCT_TextBody.is_emptyks@ZZ r7Q;!"GH H a5:: r3c<|j}t|}|S)z: Return a new ```` element tree ) _txBody_tmplrclsxmltxBodys r2newzCT_TextBody.newys  3 r3c<|j}t|}|S)z Return a new ```` element tree, suitable for use in a table cell and possibly other situations. )_a_txBody_tmplrr\s r2 new_a_txBodyzCT_TextBody.new_a_txBodys   "3 r3c8|j}t|S)zn Return a new ```` element tree, suitable for use in an ```` element. )_p_txBody_tmplr)r]r^s r2 new_p_txBodyzCT_TextBody.new_p_txBodys   "~r3c:dtddz}t|}|S)z Return a ```` element tree suitable for use in a chart object like data labels or tick labels. zp carr)r]r^txPrs r2new_txPrzCT_TextBody.new_txPrs*  C  ~ r3cVt|jdkDry|jy)zEnsure p:txBody has at least one a:p child. Intuitively, reverse a ".clear_content()" operation to minimum conformance with spec (single empty paragraph). rN)rWrMadd_pr1s r2unclear_contentzCT_TextBody.unclear_contents tzz?Q   r3cdtdzS)Nz1 rirr]s r2rbzCT_TextBody._a_txBody_tmpls  's| - r3c dtddzS)Nz1 rOrirrrs r2rezCT_TextBody._p_txBody_tmpls  'sC0 2 r3c dtddzS)NzA rirOrrrs r2r[zCT_TextBody._txBody_tmpls  'sC0  2 r3N)rArBrCrDrbodyPrrrOrPrFrUrY classmethodr`rcrfrlrprbrer[rIr3r2rKrKMs : &F%A    &      r3rKc.eZdZdZeedededfdZedee d Z ed ee d  Z ed ee d Z ed ee d  Z edeZedeZedZej(dZy)CT_TextBodyPropertiesz) custom element class z a:noAutofitz a:normAutofitz a:spAutoFit)z a:scene3dza:sp3dza:flatTxa:extLstr*lInsi0edefaulttInsirInsbInsanchorwrapc|jtjS|jtjS|j tj Sy)zp The autofit setting for the text frame, a member of the ``MSO_AUTO_SIZE`` enumeration. N) noAutofitr NONE normAutofitTEXT_TO_FIT_SHAPE spAutoFitSHAPE_TO_FIT_TEXTros r2autofitzCT_TextBodyProperties.autofitsK >> % %% %    ' 22 2 >> % 22 2r3c@| |tjvrtd|z|j|tjk(r|j y|tj k(r|jy|tjk(r|jyy)Nzoonly None or a member of the MSO_AUTO_SIZE enumeration can be assigned to CT_TextBodyProperties.autofit, got %s) r _valid_settings ValueError_remove_eg_textAutoFitr_add_noAutofitr_add_normAutofitr_add_spAutoFitr1values r2rzCT_TextBodyProperties.autofits  m.K.K!KGINO  ##% M&& &    ! m55 5  ! ! # m55 5    !6r3N)rArBrCrDr#reg_textAutoFitrrr$rzr}r~rr rrrrFrrGrIr3r2rxrxs%   7 9NOBN V_c%j ID V_c%j ID V_c%j ID V_c%j ID x)< =F V%8 9D    ^^ " "r3rxc eZdZdZeededededededfd Zed d Zed d Z e de Z e de Ze deZe deZe deZdZdZy)CT_TextCharacterPropertiesz`a:rPr, a:defRPr, and `a:endParaRPr` custom element class. 'rPr' is short for 'run properties', and it corresponds to the |Font| proxy class. za:noFillz a:solidFillz a:gradFillz a:blipFillz a:pattFillz a:grpFill)z a:effectLstz a:effectDagz a:highlightza:uLnTxza:uLnz a:uFillTxza:uFilla:latina:eaa:csa:sym a:hlinkClicka:hlinkMouseOvera:rtlryr*r)rrrrrrryr)rrrylangszbiuc*tjSN)r new_gradFillros r2 _new_gradFillz(CT_TextCharacterProperties._new_gradFill6s(5577r3c4|j}||_|S)zW Add an child element with r:id attribute set to *rId*. )get_or_add_hlinkClickrId)r1r hlinkClicks r2add_hlinkClickz)CT_TextCharacterProperties.add_hlinkClick9s//1  r3N)rArBrCrDr#reg_fillPropertiesr"latinrrrrrrrrrr rrrrIr3r2rrs ( :  = ! < < < ;    6   E#LJ V_ 5D 4 1B#z*A#z*A#67A8r3rcHeZdZdZeddZeddZedZy) CT_TextFieldzH field element, for either a slide number or date field r()a:pPrr)r*r)rIcV|j}|y|j}| t|SdS)z: The text of the ```` child element. r-r.)r1r/r0s r2r0zCT_TextField.textJs3 FF 9vv#'#3z$;;r3N) rArBrCrDr"rEr/rFr0rIr3r2rrBs4 G(8 9C%B'A <, , , and child elements of CT_TextCharacterProperties, e.g. . typefaceN)rArBrCrDr rrrIr3r2rrVs !_=Hr3rc4eZdZdZeddZedZy)CT_TextLineBreakz`a:br` line break elementr(rIr*cy)zUnconditionally a single vertical-tab character. A line break element can contain no text other than the implicit line feed it represents.  rIros r2r0zCT_TextLineBreak.textdsr3N)rArBrCrDr"rErFr0rIr3r2rr_s## G +C r3rc&eZdZdZededZy)CT_TextNormalAutofitzS element specifying fit text to shape font reduction, etc. fontScalegY@r{N)rArBrCrDrrrrIr3r2rrns";UIr3rceZdZdZeddZeddZeddZedd Z d Z dd Z d Z e dZe dZdZy )CT_TextParagraphz`a:p` custom element classr)a:ra:brza:fld a:endParaRPrr*r)rrrrIc"|jS)z9 Return a newly appended element. )_add_brros r2add_brzCT_TextParagraph.add_brs||~r3Nc8|j}|r||_|S)z8 Return a newly appended element. )_add_rr0)r1r0rs r2add_rzCT_TextParagraph.add_rs KKM AFr3cttjd|D].\}}|dkDr|j|s|j |0y)aoAppend `a:r` and `a:br` elements to *p* based on *text*. Any ` ` or ` ` (vertical-tab) characters in *text* delimit `a:r` (run) elements and themselves are translated to `a:br` (line-break) elements. The vertical-tab character appears in clipboard text from PowerPoint at "soft" line-breaks (new-line, but not new paragraph). z | rN) enumerater>splitrr)r1r0idxr_strs r2 append_textzCT_TextParagraph.append_textsF$BHHWd$;< "JCQw  5!  "r3cNttthtfd|DS)zSequence containing text-container child elements of this `a:p` element. These include `a:r`, `a:br`, and `a:fld`. c3>K|]}t|vs|ywr)type).0elm text_typess r2 z4CT_TextParagraph.content_children..sDSDI,CSDs)r'rrtuple)r1rs @r2content_childrenz!CT_TextParagraph.content_childrens# ()9<H DDDDDr3crdj|jDcgc]}|jc}Scc}w)z%str text contained in this paragraph.r-)joinrr0)r1childs r2r0zCT_TextParagraph.texts+ww0E0EFu FGGFs4c4dtdz}t|S)Nzrirj)r1r_xmls r2_new_rzCT_TextParagraph._new_rs&5r3r)rArBrCrDr"rTr!rbr endParaRPrrrrrFrr0rrIr3r2rrxsx$ G(P QC5%67A F'8 9B>b9J " EEHH  r3rcBeZdZdZdZededdZededdZed ed dZed ed dZ e d e dZ e de Z[edZej"dZedZej"dZedZej"dZy)CT_TextParagraphPropertiesz& custom element class )a:lnSpca:spcBefa:spcAftz a:buClrTxza:buClrza:buSzTxz a:buSzPctz a:buSzPtsz a:buFontTxza:buFontza:buNonez a:buAutoNumza:buCharza:buBlipza:tabLsta:defRPrryrr9Nr*rrrlvlrr{algnc|j}|y|j|jjS|jjS)a= The spacing between baselines of successive lines in this paragraph. A float value indicates a number of lines. A |Length| value indicates a fixed spacing. Value is contained in `./a:lnSpc/a:spcPts/@val` or `./a:lnSpc/a:spcPct/@val`. Value is |None| if no element is present. N)lnSpcspcPtsvalspcPct)r1rs r2 line_spacingz'CT_TextParagraphProperties.line_spacings?  = << #<<## #||r3c|j|yt|tr |jj |y|jj |yr) _remove_lnSpc isinstancer% _add_lnSpc set_spcPts set_spcPctrs r2rz'CT_TextParagraphProperties.line_spacingsJ  =  eV $ OO  ( ( / OO  ( ( /r3cV|j}|y|j}|y|jS)zd The EMU equivalent of the centipoints value in `./a:spcAft/a:spcPts/@val`. N)spcAftrr)r1rrs r2 space_afterz&CT_TextParagraphProperties.space_after0  > >zzr3ch|j| |jj|yyr)_remove_spcAft _add_spcAftrrs r2rz&CT_TextParagraphProperties.space_after0        ) )% 0 r3cV|j}|y|j}|y|jS)zd The EMU equivalent of the centipoints value in `./a:spcBef/a:spcPts/@val`. N)spcBefrr)r1rrs r2 space_beforez'CT_TextParagraphProperties.space_beforerr3ch|j| |jj|yyr)_remove_spcBef _add_spcBefrrs r2rz'CT_TextParagraphProperties.space_beforerr3)rArBrCrD_tag_seqr"rrrrUrrrr rrFrrGrrrIr3r2rrsH& iHQRL 9E zhqrl ;F zhqrl ;F zhrsm , , and elements. za:spcPctza:spcPtscR|j|j}||_y)zr Set spacing to *value* lines, e.g. 1.75 lines. A ./a:spcPts child is removed if present. N)_remove_spcPtsget_or_add_spcPctr)r1rrs r2rzCT_TextSpacing.set_spcPct% '') r3cR|j|j}||_y)zb Set spacing to *value* points. A ./a:spcPct child is removed if present. N)_remove_spcPctget_or_add_spcPtsr)r1rrs r2rzCT_TextSpacing.set_spcPts(r r3N) rArBrCrDr"rrrrrIr3r2rrs' z "F z "Fr3rc"eZdZdZedeZy)CT_TextSpacingPercentzh element, specifying spacing in thousandths of a percent in its `val` attribute. rN)rArBrCrDr rrrIr3r2rr2s E#G HCr3rc"eZdZdZedeZy)CT_TextSpacingPointz[ element, specifying spacing in centipoints in its `val` attribute. rN)rArBrCrDr rrrIr3r2rr;s E#6 7Cr3r) pptx.compatrpptx.enum.langrpptx.enum.textr r r r pptx.excr pptx.oxmlrpptx.oxml.dml.fillr pptx.oxml.nsrpptx.oxml.simpletypesrrrrrrrrrpptx.oxml.xmlchemyrrrrrr r!r"r# pptx.utilr$r%r'rKrxrrrrrrrrrrrIr3r2rs;RR "* %8       "  >@ /@ F+"O+"\AAH/>  ?8 8 v_1_1D_:IOI8/8r3