Pqh1ldZddlmZddlmZmZmZddlmZm Z ddl m Z ddl m Z mZddlmZddlmZmZmZmZmZdd lmZmZmZmZmZmZmZdd lm Z m!Z!er dd l"m#Z#dd lm$Z$Gd deZ%GddeZ&GddeZ'GddeZ(GddeZ)GddeZ*GddeZ+GddeZ,GddeZ-Gdd eZ.Gd!d"eZ/Gd#d$eZ0Gd%d&eZ1y')(z"Custom element classes for tables.) annotations) TYPE_CHECKINGCallableList)WD_CELL_VERTICAL_ALIGNMENTWD_ROW_HEIGHT_RULE)InvalidSpanError)nsdeclsqn) parse_xml)ST_MergeST_TblLayoutType ST_TblWidthST_TwipsMeasureXsdInt)BaseOxmlElement OneAndOnlyOne OneOrMoreOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOne)EmuTwips)CT_P)Lengthc4eZdZdZedeZedeZy) CT_HeightzFUsed for ```` to specify a row height and row height rule.w:valzw:hRuleN) __name__ __module__ __qualname____doc__rrvalrhRuleP/srv/www/ollama/chat-ollama/venv/lib/python3.12/site-packages/docx/oxml/table.pyrr"sP G_ 5C i); `` element.z w:tblPrExzw:trPrzw:tccd}|jD]-}||k(r|cS||jz }||kDs!td|ztd)zThe ```` element appearing at grid column `idx`. Raises |ValueError| if no ``w:tc`` element begins at that grid column. rzno cell on grid column %dzindex out of bounds)tc_lst grid_span ValueError)selfidxgrid_coltcs r(tc_at_grid_colzCT_Row.tc_at_grid_col0s^ ++ DB3  $H#~ !`` element within its parent ```` element.) getparenttr_lstindexr/s r(tr_idxz CT_Row.tr_idx>s"~~&&,,T22r'c8|j}|y|jS)zJReturn the value of `w:trPr/w:trHeight@w:hRule`, or |None| if not present.N)trPrtrHeight_hRuler/r;s r(r<zCT_Row.trHeight_hRuleDs!yy <"""r'c2|j}||_yN)get_or_add_trPrr<r/valuer;s r(r<zCT_Row.trHeight_hRuleLs##%#r'c8|j}|y|jS)zHReturn the value of `w:trPr/w:trHeight@w:val`, or |None| if not present.N)r; trHeight_valr=s r(rDzCT_Row.trHeight_valQs!yy <   r'c2|j}||_yr?)r@rDrAs r(rDzCT_Row.trHeight_valYs##%!r'c(|jd|yNrinsert)r/tblPrExs r(_insert_tblPrExzCT_Row._insert_tblPrEx^s Awr'ch|j}||j|y|jd|yrG)rJaddnextrI)r/r;rJs r( _insert_trPrzCT_Row._insert_trPras+,,   OOD ! KK4 r'c*tjSr?)CT_Tcnewr8s r(_new_tczCT_Row._new_tchsyy{r'N)r r!r"r#rrJr;rr2r3propertyr9r<setterrDrKrNrRr&r'r(r*r*)s $G X D F B 033 ##$$!!"" !r'r*ceZdZdZedZedZedZe dZ e jdZ e dZ dZ edd Ze d Zejd Zedd Zed ZedZedZy)CT_Tblz```` element.zw:tblPrz w:tblGridzw:trcL|jj}|y|jS)zValue of `w:tblPr/w:bidiVisual/@w:val` or |None| if not present. Controls whether table cells are displayed right-to-left or left-to-right. N)tblPr bidiVisualr$)r/rYs r(bidiVisual_valzCT_Tbl.bidiVisual_valss& ZZ**  ~~r'cl|j}||jy||j_yr?)rX_remove_bidiVisualget_or_add_bidiVisualr$)r/rBrXs r(rZzCT_Tbl.bidiVisual_val~s-  =  $ $ &05E ' ' ) -r'c@t|jjS)z)The number of grid columns in this table.)lentblGrid gridCol_lstr8s r( col_countzCT_Tbl.col_counts4<<++,,r'c#XK|jD]}|jD]}|yw)zGenerate each of the `w:tc` elements in this table, left to right and top to bottom. Each cell in the first row is generated, followed by each cell in the second row, etc. N)r6r,)r/trr2s r(iter_tcszCT_Tbl.iter_tcss3++ Bii   s(*c:t|j|||S)zReturn a new `w:tbl` element having `rows` rows and `cols` columns. `width` is distributed evenly between the columns. )r _tbl_xml)clsrowscolswidths r(new_tblzCT_Tbl.new_tbls dD%899r'cL|jj}|y|jS)zYValue of `w:tblPr/w:tblStyle/@w:val` (a table style id) or |None| if not present.N)rXtblStyler$r/rns r( tblStyle_valzCT_Tbl.tblStyle_vals&::&&  ||r'cl|j}|j|y||j_y)zSet the value of `w:tblPr/w:tblStyle/@w:val` (a table style id) to `styleId`. If `styleId` is None, remove the `w:tblStyle` element. N)rX_remove_tblStyle _add_tblStyler$)r/styleIdrXs r(rpzCT_Tbl.tblStyle_vals2    ? $+!r'c |dkDrt||z n td}dtdd|j|||j|||dS)Nrz z )rr _tblGrid_xml_trs_xml)rhrirjrk col_widths r(rgzCT_Tbl._tbl_xmlsO)-C %s1v  CL   T9 - LLtY /  r'cXd}t|D]}|d|jzz }|dz }|S)Nz z z rangetwipsrhrbryxmlis r(rwzCT_Tbl._tblGrid_xmlsAy! CA 09??B BC C !! r'cZd}t|D]}|d|j||zz }|S)Nz %s )r|_tcs_xml)rh row_countrbryrrs r(rxzCT_Tbl._trs_xmlsDy! A 3s||98 C  r'cNd}t|D]}|d|jzz }|S)Nrzj r{r~s r(rzCT_Tbl._tcs_xmls?y! A    C  r'N)riintrjrrkrreturnrV)rirrjrrkrrstr)r r!r"r#rrXr`rrdrSrZrTrbre classmethodrlrprgrwrxrr&r'r(rVrVls ) $EK(G F B 66-- :: , ,  &  r'rVc$eZdZdZeddZy) CT_TblGridzw```` element, child of ````, holds ```` elements that define column count, width, etc.z w:gridCol)zw:tblGridChange successorsN)r r!r"r#rgridColr&r'r(rrs-1EFGr'rc2eZdZdZedeZedZy) CT_TblGridColzJ```` element, child of ````, defines a table column.w:wcT|jjj|S)z\The index of this ```` element within its parent ```` element.)r5rar7r8s r( gridCol_idxzCT_TblGridCol.gridCol_idxs"~~++11$77r'N) r r!r"r#rrrvrSrr&r'r(rrs#T%1A 88r'rc"eZdZdZedeZy)CT_TblLayoutTypez|```` element, specifying whether column widths are fixed or can be automatically adjusted based on content.w:typeN)r r!r"r#rrtyper&r'r(rrs0 X'7 8Dr'rceZdZdZdZededdZededdZed ed dZed ed dZ [e d Z e jdZ e ddZ e jddZ e dZejdZy)CT_TblPrz}```` element, child of ````, holds child elements that define table properties such as style and borders.) w:tblStylezw:tblpPrz w:tblOverlap w:bidiVisualzw:tblStyleRowBandSizezw:tblStyleColBandSizezw:tblWw:jcw:tblCellSpacingzw:tblIndz w:tblBordersw:shd w:tblLayoutz w:tblCellMarz w:tblLookz w:tblCaptionzw:tblDescriptionz w:tblPrChangerNrrrr c8|j}|y|jS)zMember of :ref:`WdRowAlignment` enumeration or |None|, based on the contents of the `w:val` attribute of `./w:jc`. |None| if no `w:jc` element is present. N)jcr$)r/rs r( alignmentzCT_TblPr.alignmentsWW :vv r'cX|j|y|j}||_yr?) _remove_jc get_or_add_jcr$)r/rBrs r(rzCT_TblPr.alignment+s)  =     !r'c@|j}|dS|jdk7S)zg|False| when there is a `w:tblLayout` child with `@w:type="fixed"`. Otherwise |True|. Tfixed) tblLayoutr)r/rs r(autofitzCT_TblPr.autofit3s& NN  (tGinn.GGr'cF|j}|rd|_yd|_y)Nrr)get_or_add_tblLayoutr)r/rBrs r(rzCT_TblPr.autofit<s--/ &+  r'c8|j}|y|jS)ziReturn the value of the ``val`` attribute of the ```` child or |None| if not present.N)rnr$ros r(stylezCT_TblPr.styleAs ==  ||r'cN|j|y|j|y)N)r$)rrrsr/rBs r(rzCT_TblPr.styleJs'  =  u%r')rbool)rBr)r r!r"r#_tag_seqrrnrYrrrSrrTrrr&r'r(rrs3H((12,?H>hqrlCJ 6hqrl 3B-HRSMBI   HH ^^99 \\&&r'rcheZdZdZedeZedeZe dZ e jdZ y) CT_TblWidthzeUsed for ```` and ```` elements and many others, to specify a table-related width.rrcL|jdk7ryt|jS)zbReturn the EMU length value represented by the combined ``w:w`` and ``w:type`` attributes.dxaN)rrrvr8s r(rkzCT_TblWidth.width\s! 99 TVV}r'cFd|_t|j|_y)Nr)rrr}rvrs r(rkzCT_TblWidth.widthds U!!r'N) r r!r"r#rrrvrrrSrkrTr&r'r(rrRsK %(A X{ 3D  \\""r'rcXeZdZUdZded<ded<ded<ded <ed Zed Zed Z e d Z dZ e dZ e jdZ e d1dZdZe dZdZedZe dZe dZe dZejdZe dZejdZdZe dZd2dZd Ze d!Zd"Zd#Ze d$Z d%Z!d&Z"d'Z#d(Z$d)Z%e d*Z&e d+Z'e d,Z(e d-Z)e d.Z*e d/Z+e d0Z,y)3rPz`w:tc` table cell element.zCallable[[], CT_P]add_pz List[CT_P]p_lstz List[CT_Tbl]tbl_lstzCallable[[CT_Tbl], CT_Tbl] _insert_tblzw:tcPrw:pw:tblc|j7|j}|)|jtjk(r |jS|j dzS)zThe row index that marks the bottom extent of the vertical span of this cell. This is one greater than the index of the bottom-most row of the span, similar to how a slice of the cell's rows would be specified. r)vMerge _tc_belowr CONTINUEbottom_tr_idx)r/tc_belows r(rz CT_Tc.bottomwsG ;; "~~H#8;L;L(L&||ar'cPg}|j}||j|||ddy)aMRemove all content child elements, preserving the ```` element if present. Note that this leaves the ```` element in an invalid state because it doesn't contain at least one block-level element. It's up to the caller to add a ````child element as the last content element. N)tcPrappend)r/ new_childrenrs r( clear_contentzCT_Tc.clear_contents/ yy      %Qr'c8|j}|y|jS)zzThe integer number of columns this cell spans. Determined by ./w:tcPr/w:gridSpan/@val, it defaults to 1. r)rr-r/rs r(r-zCT_Tc.grid_spans yy <~~r'c2|j}||_yr?)get_or_add_tcPrr-r/rBrs r(r-zCT_Tc.grid_spans##%r'c$|jdS)zGenerate all `w:p` and `w:tbl` elements in this document-body. Elements appear in document order. Elements shaded by nesting in a `w:ins` or other "wrapper" element will not be included. z./w:p | ./w:tblxpathr8s r(inner_content_elementszCT_Tc.inner_content_elementsszz+,,r'c#Ktdtdtdf}|D]}|j|vs|yw)zpGenerate a reference to each of the block-level content elements in this cell, in the order they appear.rrzw:sdtN)r tag)r/block_item_tagschilds r(iter_block_itemszCT_Tc.iter_block_itemss@e9bk2g;? EyyO+  s4>>c|jS)z?The grid column index at which this ```` element appears.) _grid_colr8s r(leftz CT_Tc.lefts~~r'c|j|\}}}}|jj|j|}|j |||S)zReturn the top-left ```` element of a new span formed by merging the rectangular region defined by using this tc element and `other_tc` as diagonal corners.)_span_dimensions_tblr6r3_grow_to)r/other_tctoprheightrktop_tcs r(mergez CT_Tc.mergesO$(#8#8#B T65!!#&55d;v& r'c0tdtdzS)zhReturn a new ```` element, containing an empty paragraph as the required EG_BlockLevelElt.z rv)r r )rhs r(rQz CT_Tc.news= LMMr'c4|j|jzS)aThe grid column index that marks the right-side extent of the horizontal span of this cell. This is one greater than the index of the right-most column of the span, similar to how a slice of the cell's columns would be specified. )rr-r8s r(rightz CT_Tc.rights~~..r'c|j|jtjk(r |jS|jj S)z9The top-most row index in the vertical span of this cell.)rr RESTARTr _tc_aboverr8s r(rz CT_Tc.tops9 ;; $++1A1A"A<< ~~!!!r'c8|j}|y|jS)zlThe value of the ./w:tcPr/w:vMerge/@val attribute, or |None| if the w:vMerge element is not present.N)r vMerge_valrs r(rz CT_Tc.vMergesyy <r'c2|j}||_yr?)rrrs r(rz CT_Tc.vMerges##%r'c8|j}|y|jS)zqReturn the EMU length value represented in the ``./w:tcPr/w:tcW`` child element or |None| if not present.N)rrkrs r(rkz CT_Tc.widthsyy <zzr'c2|j}||_yr?)rrkrs r(rkz CT_Tc.widths##% r'cv|jr-|jr |xj|jz c_yyy)zAdd the width of `other_tc` to this cell. Does nothing if either this tc or `other_tc` does not have a specified width. N)rk)r/rs r( _add_width_ofzCT_Tc._add_width_ofs* ::(.. JJ(.. (J):r'c|j}|jj|}|jd|}td|DS)z*The grid column at which this cell begins.Nc34K|]}|jywr?)r-).0r2s r( z"CT_Tc._grid_col..s8B2<<8s)_trr,r7sum)r/rdr0 preceding_tcss r(rzCT_Tc._grid_cols?XXiiood# $3 8-888r'Ncfd}|n|}j||||dkDr!jj|dz |yy)zGrow this cell to `width` grid columns and `height` rows by expanding horizontal spans and creating continuation cells to form vertical spans.cX|urtjSdk(rytjSNr)r rr)rrr/s r(rz"CT_Tc._grow_to..vMerge_vals-T!((({## #r'Nr)_span_to_widthrr)r/rkrrrs` ` r(rzCT_Tc._grow_tosR $ V E6:f+=> A: NN # #E6A:v > r'c*|jd||S)z``tcPr`` has a bunch of successors, but it comes first if it appears, so just overriding and using insert(0, ...) rather than spelling out successors.rrHrs r( _insert_tcPrzCT_Tc._insert_tcPrs At r'ct|j}t|dkDry|d}t|jdk(ryy)zATrue if this cell contains only a single empty ```` element.rFrT)listrr_r_lst)r/ block_itemsps r( _is_emptyzCT_Tc._is_emptysF40023 { a  N qww<1 r'c||ury|jry|j|jD]}|j||j|j y)zoAppend the content of this cell to `other_tc`, leaving this cell with a single empty ```` element.N)r_remove_trailing_empty_prr_new_p)r/r block_elements r(_move_content_tozCT_Tc._move_content_to%s] t   >> ))+!224 +M OOM * + DKKM"r'c*tjSr?)rVrQr8s r(_new_tblzCT_Tc._new_tbl3szz|r'c6|jd}|r|dSdS)zThe `w:tc` element immediately following this one in this row, or |None| if this is the last `w:tc` element in the row.z./following-sibling::w:tcrNr)r/ following_tcss r(_next_tczCT_Tc._next_tc6s% #>? #0}Q:d:r'cB|jj|y)z-Remove this `w:tc` element from the XML tree.N)r5remover8s r(_removez CT_Tc._remove=s %r'ct|j}|d}|jtdk7ry|}t |j dkDry|j |y)z[Remove the last content element from this cell if it is an empty ```` element.rNr)rrrr r_rr)r/rlast_content_elmrs r(r zCT_Tc._remove_trailing_empty_pAsY40023 &r?   2e9 ,   qww.raise_on_inverted_LRs_uu~!((ahh"6&'GHHvvAGGqww$6&'GHH%7r'c|j|jkr||fn||f\}}|j|jkr$|j|jkDr td|j|jkr||fn||f\}}|j|jkr%|j|jkDr tdyyrr)rrtop_mostother left_mosts r(raise_on_tee_shapedz3CT_Tc._span_dimensions..raise_on_tee_shapedXs() q!fAq6OHe||eii'HOOell,J&'GHH)*!&&1vq!f Iu~~ *y/L&'GHH0M*r')minrrmaxrr)r/rrr#rrrrs r(rzCT_Tc._span_dimensionsMs  I  I D(+D(+$((HLL)499hmm,T[[(//2DJJ/D&3, 44r'c|j||j|kr"|j|||j|kr"||_y)aZIncorporate and then remove `w:tc` elements to the right of this one until this cell spans `grid_width`. Raises |ValueError| if `grid_width` cannot be exactly achieved, such as when a merged cell would drive the span width greater than `grid_width` or if not enough grid columns are available to make this cell that wide. All content from incorporated cells is appended to `top_tc`. The val attribute of the vMerge element on the single remaining cell is set to `vMerge`. If `vMerge` is |None|, the vMerge element is removed if present. N)r r-_swallow_next_tcr)r/ grid_widthrrs r(rzCT_Tc._span_to_widthksC f%nnz)  ! !*f 5nnz) r'cfd}j}|||j|j|xj|jz c_|j y)aExtend the horizontal span of this `w:tc` element to incorporate the following `w:tc` element in the row and then delete that following `w:tc` element. Any content in the following `w:tc` element is appended to the content of `top_tc`. The width of the following `w:tc` element is added to this one, if present. Raises |InvalidSpanError| if the width of the resulting cell is greater than `grid_width` or if there is no next `` element in the row. cn| tdj|jzkDr tdy)Nznot enough grid columnszspan is not rectangular)r r-)next_tcr(r/s r(raise_on_invalid_swallowz8CT_Tc._swallow_next_tc..raise_on_invalid_swallows<&'@AA~~ 1 11J>&'@AA?r'N)rr rr-r)r/r(rr,r+s`` r(r'zCT_Tc._swallow_next_tc{sV B -- )  ( 7# '+++r'c*|jddS)z+The tbl element this tc element appears in.z./ancestor::w:tbl[position()=1]rrr8s r(rz CT_Tc._tblszz;>  &&t~~66r'c*|jddS)z*The tr element this tc element appears in.z./ancestor::w:tr[position()=1]rrr8s r(rz CT_Tc._trszz:;A>>r'c|jj}|j|j}|dk(r t d||dz S)zThe tr element prior in sequence to the tr this cell appears in. Raises |ValueError| if called on a cell in the top-most row. rzno tr above topmost trr)rr6r7rr.r/r6r9s r(r/zCT_Tc._tr_abovesG !!dhh' Q;56 6fqj!!r'c|jj}|j|j} ||dzS#t$rYywxYw)zzThe tr element next in sequence after the tr this cell appears in, or |None| if this cell appears in the last row.rN)rr6r7r IndexErrorr5s r(r1zCT_Tc._tr_belowsK!!dhh' &1*% %  s; AAc`|jjj|jS)z;The row index of the tr element this tc element appears in.)rr6r7rr8s r(rz CT_Tc._tr_idxs#yy%%dhh//r')rzList[CT_P | CT_Tbl]r?)-r r!r"r#__annotations__rrrrtblrSrrr-rTrrrrrrQrrrrkrrrrrr rrrr rrr'rrrrr/r1rr&r'r(rPrPjsD$   ++ X D%A G C      --NN //""  ]]   \\)99?   #;; & 5< 0@@==77?? " "00r'rPcNeZdZdZdZededdZededdZed ed dZed ed dZ [e d Z e jdZ e dZ e jdZ e dZejdZe dZejdZy)CT_TcPrz5```` element, defining table cell properties.) w:cnfStylew:tcW w:gridSpanzw:hMergew:vMergez w:tcBordersrzw:noWrapzw:tcMarzw:textDirectionz w:tcFitTextw:vAlignz w:hideMarkz w:headersz w:cellInsz w:cellDelz w:cellMergez w:tcPrChanger>Nrr?r@rA c8|j}|y|jS)zsThe integer number of columns this cell spans. Determined by ./w:gridSpan/@val, it defaults to 1. r)gridSpanr$)r/rGs r(r-zCT_TcPr.grid_spans ==  ||r'cZ|j|dkDr||j_yyr)_remove_gridSpanget_or_add_gridSpanr$rs r(r-zCT_TcPr.grid_spans+  19-2D $ $ & * r'c8|j}|y|jS)zValue of `w:val` attribute on `w:vAlign` child. Value is |None| if `w:vAlign` child is not present. The `w:val` attribute on `w:vAlign` is required. N)vAlignr$)r/rLs r( vAlign_valzCT_TcPr.vAlign_vals >zzr'cT||jy||j_yr?)_remove_vAlignget_or_add_vAlignr$rs r(rMzCT_TcPr.vAlign_vals' =    ! ', $r'c8|j}|y|jS)zeThe value of the ./w:vMerge/@val attribute, or |None| if the w:vMerge element is not present.N)rr$)r/rs r(rzCT_TcPr.vMerge_vals >zzr'cT|j|||j_yyr?)_remove_vMerge _add_vMerger$rs r(rzCT_TcPr.vMerge_vals*   %*D    " r'c8|j}|y|jS)zReturn the EMU length value represented in the ```` child element or |None| if not present or its type is not 'dxa'.N)tcWrk)r/rVs r(rkz CT_TcPr.widthshh ;yyr'c2|j}||_yr?)get_or_add_tcWrk)r/rBrVs r(rkz CT_TcPr.width s!!# r')r r!r"r#rrrVrGrrLrSr-rTrMrrkr&r'r(r<r<s ?H( G 5C(12,?H zhqrl ;F zhrsm `` element, defining table row properties.)r=zw:divIdz w:gridBeforez w:gridAfterz w:wBeforezw:wAfterz w:cantSplit w:trHeightz w:tblHeaderrrzw:hiddenzw:inszw:delz w:trPrChanger[rNrc8|j}|y|jS)zCReturn the value of `w:trHeight@w:hRule`, or |None| if not present.N)trHeightr%r/r]s r(r<zCT_TrPr.trHeight_hRule=s ==  ~~r'cP| |jy|j}||_yr?)r]get_or_add_trHeightr%r/rBr]s r(r<zCT_TrPr.trHeight_hRuleEs( =T]]2 ++-r'c8|j}|y|jS)zAReturn the value of `w:trHeight@w:val`, or |None| if not present.N)r]r$r^s r(rDzCT_TrPr.trHeight_valLs ==  ||r'cP| |jy|j}||_yr?)r]r`r$ras r(rDzCT_TrPr.trHeight_valTs( =T]]2 ++- r') r r!r"r#rrr]rSr<rTrDr&r'r(rZrZ&s}>H"(12,?H  r'rZc"eZdZdZedeZy) CT_VerticalJcz:`w:vAlign` element, specifying vertical alignment of cell.rN)r r!r"r#rrr$r&r'r(rere\sD G%? @Cr'rec:eZdZdZedeej Zy) CT_VMergezG```` element, specifying vertical merging behavior of a cell.r)defaultN)r r!r"r#rr rr$r&r'r(rgrgbsQ GXx7H7H ICr'rgN)2r# __future__rtypingrrrdocx.enum.tablerrdocx.exceptionsr docx.oxml.nsr r docx.oxml.parserr docx.oxml.simpletypesr rrrrdocx.oxml.xmlchemyrrrrrrr docx.sharedrrdocx.oxml.text.paragraphrrrr*rVrrrrrrPr<rZrergr&r'r(rss("00J,$&#-"==@_@Fx_xvGG 8O 899N&N&b"/"0Z0OZ0z \o\~3o3lAOA JJr'