pjUdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZddlmZmZer4dd lmZdd lmZmZdd lmZdd lmZdd lmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%GddeZ&Gdde Z'd S)z'|Document| and closely related objects.) annotations)IO TYPE_CHECKINGIteratorList)BlockItemContainer) WD_SECTION)WD_BREAK)SectionSections) ElementProxyEmuN)CT_Body CT_Document) DocumentPart)Settings)Length)ParagraphStyle _TableStyle)Table) ParagraphcfeZdZdZd6fd Zd7d8d ZdZd9d:dZ d;dd?d!Z e d"Ze d#Zd@d%Ze dAd'Ze dBd(ZdCd*Ze dDd,Ze dEd.Ze d/Ze dFd1Ze dGd3Ze dHd5ZxZS)IDocumentzWordprocessingML (WML) document. Not intended to be constructed directly. Use :func:`docx.Document` to open or create a document. elementrpartrctt||||_||_d|_dSN)superr__init___element_part_Document__body)selfrr __class__s ]/lsinfo/ai/hellotax_ai/data_center/backend/venv/lib/python3.11/site-packages/docx/document.pyrzDocument.__init__"s: h&&w///   textstrlevelintcd|cxkrdksntd|z|dkrdnd|z}|||S)aReturn a heading paragraph newly added to the end of the document. The heading paragraph will contain `text` and have its paragraph style determined by `level`. If `level` is 0, the style is set to `Title`. If `level` is 1 (or omitted), `Heading 1` is used. Otherwise the style is set to `Heading {level}`. Raises |ValueError| if `level` is outside the range 0-9. r z"level must be in range 0-9, got %dTitlez Heading %d) ValueError add_paragraph)r#r)r+styles r% add_headingzDocument.add_heading(s[EQAEIJJ J A::<%+?!!$...r&c|}|tj|S)z=Return newly |Paragraph| object containing only a page break.)r1add_run add_breakr PAGE)r# paragraphs r%add_page_breakzDocument.add_page_break5s;&&(( %%hm444r&Nr2str | ParagraphStyle | Nonereturnrc8|j||S)aReturn paragraph newly added to the end of the document. The paragraph is populated with `text` and having paragraph style `style`. `text` can contain tab (``\t``) characters, which are converted to the appropriate XML form for a tab. `text` can also include newline (``\n``) or carriage return (``\r``) characters, each of which is converted to a line break. )_bodyr1)r#r)r2s r%r1zDocument.add_paragraph;sz''e444r&image_path_or_streamstr | IO[bytes]widthint | Length | Noneheightc||}||||S)aReturn new picture shape added in its own paragraph at end of the document. The picture contains the image at `image_path_or_stream`, scaled based on `width` and `height`. If neither width nor height is specified, the picture appears at its native size. If only one is specified, it is used to compute a scaling factor that is then applied to the unspecified dimension, preserving the aspect ratio of the image. The native size of the picture is calculated using the dots-per-inch (dpi) value specified in the image file, defaulting to 72 dpi if no value is specified, as is often the case. )r1r5 add_picture)r#r>r@rBruns r%rDzDocument.add_pictureGs8   ""**,,3UFCCCr& start_typer cv|jj}||_t ||jS)zReturn a |Section| object newly added at the end of the document. The optional `start_type` argument must be a member of the :ref:`WdSectionStart` enumeration, and defaults to ``WD_SECTION.NEW_PAGE`` if not provided. )r bodyadd_section_breakrFr r!)r#rF new_sectPrs r% add_sectionzDocument.add_sectionZs4 ]'99;; * z4:...r&rowscolsstr | _TableStyle | NonecV|j|||j}||_|S)zAdd a table having row and column counts of `rows` and `cols` respectively. `style` may be a table style object or a table style name. If `style` is |None|, the table inherits the default table style of the document. )r= add_table _block_widthr2)r#rLrMr2tables r%rPzDocument.add_tableds,  $$T41BCC  r&c|jjS)zGA |CoreProperties| object providing Dublin Core properties of document.)r!core_propertiesr#s r%rTzDocument.core_propertiesnsz))r&c|jjS)zThe |InlineShapes| collection for this document. An inline shape is a graphical object, such as a picture, contained in a run of text and behaving like a character glyph, being flowed like other text in a paragraph. )r! inline_shapesrUs r%rWzDocument.inline_shapesssz''r&Iterator[Paragraph | Table]c4|jS)zHGenerate each `Paragraph` or `Table` in this document in document order.)r=iter_inner_contentrUs r%rZzDocument.iter_inner_content}sz,,...r&List[Paragraph]c|jjS)zThe |Paragraph| instances in the document, in document order. Note that paragraphs within revision marks such as ```` or ```` do not appear in this list. )r= paragraphsrUs r%r]zDocument.paragraphssz$$r&c|jS)z+The |DocumentPart| object of this document.)r!rUs r%rz Document.parts zr&path_or_streamc:|j|dS)zSave this document to `path_or_stream`. `path_or_stream` can be either a path to a filesystem location (a string) or a file-like object. N)r!save)r#r_s r%raz Document.saves '''''r&r c6t|j|jS)zD|Sections| object providing access to each section in this document.)r r r!rUs r%sectionszDocument.sectionss tz222r&rc|jjS)zDA |Settings| object providing access to the document-level settings.)r!settingsrUs r%rezDocument.settingssz""r&c|jjS)zBA |Styles| object providing access to the styles in this document.)r!stylesrUs r%rgzDocument.stylessz  r& List[Table]c|jjS)aPAll |Table| instances in the document, in document order. Note that only tables appearing at the top level of the document appear in this list; a table nested inside a table cell does not appear. A table within revision marks such as ```` or ```` will also not appear in the list. )r=tablesrUs r%rjzDocument.tablessz  r&rcd|jd}t|j|jz |jz S)zGA |Length| object specifying the space between margins in last section.)rcr page_width left_margin right_margin)r#sections r%rQzDocument._block_widths1-#7%(;;g>RRSSSr&_Bodyc\|jt|jj||_|jS)z>The |_Body| instance containing the content for this document.)r"rqr rHrUs r%r=zDocument._bodys* ;  2D99DK{r&)rrrr)r'r()r)r*r+r,)r'N)r)r*r2r:r;r)NN)r>r?r@rArBrA)rFr r)rLr,rMr,r2rN)r;rX)r;r[)r;r)r_r?)r;r )r;r)r;rh)r;r)r;rq)__name__ __module__ __qualname____doc__rr3r9r1rDr NEW_PAGErKrPpropertyrTrWrZr]rrarcrergrjrQr= __classcell__r$s@r%rrsE  / / / / / 5 5 5 5 5&*&* DDDDD&4>3F/////**X*((X(////%%%X%X((((333X3###X#!!X!!!!X!TTTXT Xr&rc*eZdZdZdfd ZdZxZS) rqzoProxy for `` element in this document. It's primary role is a container for document content. body_elmrparentt.ProvidesStoryPartchtt|||||_dSr)rrqrr=)r#r|r}r$s r%rz_Body.__init__s. eT##Hf555 r&c8|j|S)zReturn this |_Body| instance after clearing it of all content. Section properties for the main document story, if present, are preserved. )r= clear_contentrUs r%rz_Body.clear_contents   """ r&)r|rr}r~)rsrtrurvrrryrzs@r%rqrqsV r&rq)(rv __future__rtypingrrrr docx.blkcntnrrdocx.enum.sectionr docx.enum.textr docx.sectionr r docx.sharedr r docx.typestypestdocx.oxml.documentrrdocx.parts.documentr docx.settingsrrdocx.styles.stylerr docx.tablerdocx.text.paragraphrrrqr&r%rs.-""""""444444444444,,,,,,((((((######********)))))))).77777777000000&&&&&&""""""========      ------aaaaa|aaaH r&