jhdZddlmZddlmZmZmZmZddlm 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'dS)z'|Document| and closely related objects.) annotations)IO TYPE_CHECKINGIteratorList)BlockItemContainer) WD_SECTION)WD_BREAK)SectionSections) ElementProxyEmu)types)CT_Body CT_Document) DocumentPart)Settings)Length)ParagraphStyle _TableStyle)Table) ParagraphcheZdZdZd6fd Zd7d8d ZdZ d9d: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 W/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/docx/document.pyr zDocument.__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.)r2add_run add_breakr PAGE)r$ paragraphs r&add_page_breakzDocument.add_page_break5s;&&(( %%hm444r'Nr3str | 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. )_bodyr2)r$r*r3s r&r2zDocument.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. )r2r6 add_picture)r$r?rArCruns r&rEzDocument.add_pictureIs8   ""**,,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_breakrGr r")r$rG new_sectPrs r& add_sectionzDocument.add_section\s4 ]'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_widthr3)r$rMrNr3tables r&rQzDocument.add_tablefs,  $$T41BCC  r'c|jjS)zGA |CoreProperties| object providing Dublin Core properties of document.)r"core_propertiesr$s r&rUzDocument.core_propertiespsz))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_shapesrVs r&rXzDocument.inline_shapesusz''r'Iterator[Paragraph | Table]c4|jS)zHGenerate each `Paragraph` or `Table` in this document in document order.)r>iter_inner_contentrVs r&r[zDocument.iter_inner_contentsz,,...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> paragraphsrVs r&r^zDocument.paragraphssz$$r'c|jS)z+The |DocumentPart| object of this document.)r"rVs 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&rbz Document.saves '''''r'r c6t|j|jS)zD|Sections| object providing access to each section in this document.)r r!r"rVs r&sectionszDocument.sectionss tz222r'rc|jjS)zDA |Settings| object providing access to the document-level settings.)r"settingsrVs r&rfzDocument.settingssz""r'c|jjS)zBA |Styles| object providing access to the styles in this document.)r"stylesrVs r&rhzDocument.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>tablesrVs r&rkzDocument.tablessz  r'rcd|jd}t|j|jz |jz S)zGA |Length| object specifying the space between margins in last section.)rdr page_width left_margin right_margin)r$sections r&rRzDocument._block_widths1-#7%(;;g>RRSSSr'_Bodyc\|jt|jj||_|jS)z>The |_Body| instance containing the content for this document.)r#rrr!rIrVs r&r>zDocument._bodys* ;  2D99DK{r')rrrr)r(r))r*r+r,r-)r(N)r*r+r3r;r<r)NN)r?r@rArBrCrB)rGr r)rMr-rNr-r3rO)r<rY)r<r\)r<r)r`r@)r<r )r<r)r<ri)r<r)r<rr)__name__ __module__ __qualname____doc__r r4r:r2rEr NEW_PAGErLrQpropertyrUrXr[r^rrbrdrfrhrkrRr> __classcell__r%s@r&rrsL  / / / / /DH 5 5 5 5 5"&*&* DDDDD&4>3F/////**X*((X(////%%%X%X((((333X3###X#!!X!!!!X!TTTXT Xr'rc*eZdZdZdfd ZdZxZS) rrzoProxy for `` element in this document. It's primary role is a container for document content. body_elmrparentt.ProvidesStoryPartchtt|||||_dSr)rrrr r>)r$r}r~r%s r&r z_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_contentrVs r&rz_Body.clear_contents   """ r')r}rr~r)rtrurvrwr rrzr{s@r&rrrrsV r'rrN)(rw __future__rtypingrrrr docx.blkcntnrrdocx.enum.sectionr docx.enum.textr docx.sectionr r docx.sharedr rdocxrtdocx.oxml.documentrrdocx.parts.documentr docx.settingsrrdocx.styles.stylerr docx.tablerdocx.text.paragraphrrrrr'r&rs.-""""""444444444444,,,,,,((((((######********)))))))).77777777000000&&&&&&""""""========      ------ccccc|cccL r'