o Z2hU@sdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZddlmZmZerldd lmZdd lmZmZdd lmZdd lmZdd lmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%GdddeZ&Gddde 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) ParagraphcseZdZdZdIfdd ZdJdKddZddZdLdMddZ  dNdOddZe j fdPd"d#Z dQdRd'd(Z e d)d*Ze d+d,ZdSd.d/Ze dTd1d2Ze dUd3d4ZdVd6d7Ze dWd9d:Ze dXdd?Ze dYdAdBZe dZdDdEZe d[dGdHZZS)\DocumentzWordprocessingML (WML) document. Not intended to be constructed directly. Use :func:`docx.Document` to open or create a document. elementrpartrcs&tt||||_||_d|_dSN)superr__init___element_part_Document__body)selfrr __class__^/home/skpark/git/infrasmart_work/infrasmart/venv/lib/python3.10/site-packages/docx/document.pyr"s zDocument.__init__textstrlevelintcCsBd|kr dksntd||dkrdnd|}|||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)styler#r#r$ add_heading(s  zDocument.add_headingcCs|}|tj|S)z=Return newly |Paragraph| object containing only a page break.)r.add_run add_breakr PAGE)r paragraphr#r#r$add_page_break5szDocument.add_page_breakNr/str | ParagraphStyle | NonereturnrcCs|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. )_bodyr.)r r'r/r#r#r$r.;s zDocument.add_paragraphimage_path_or_streamstr | IO[bytes]widthint | Length | NoneheightcCs|}||||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. )r.r1 add_picture)r r9r;r=runr#r#r$r>Gs zDocument.add_picture start_typercCs|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. )rbodyadd_section_breakr@r r)r r@ new_sectPrr#r#r$ add_sectionZs  zDocument.add_sectionrowscolsstr | _TableStyle | NonecCs|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. )r8 add_table _block_widthr/)r rErFr/tabler#r#r$rHdszDocument.add_tablecC|jjS)zGA |CoreProperties| object providing Dublin Core properties of document.)rcore_propertiesr r#r#r$rLnzDocument.core_propertiescCrK)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_shapesrMr#r#r$rOsszDocument.inline_shapesIterator[Paragraph | Table]cCs |jS)zHGenerate each `Paragraph` or `Table` in this document in document order.)r8iter_inner_contentrMr#r#r$rQ}s zDocument.iter_inner_contentList[Paragraph]cCrK)zThe |Paragraph| instances in the document, in document order. Note that paragraphs within revision marks such as ```` or ```` do not appear in this list. )r8 paragraphsrMr#r#r$rSszDocument.paragraphscCs|jS)z+The |DocumentPart| object of this document.)rrMr#r#r$rsz Document.partpath_or_streamcCs|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)rsave)r rTr#r#r$rUsz Document.saver cCst|j|jS)zD|Sections| object providing access to each section in this document.)r rrrMr#r#r$sectionsszDocument.sectionsrcCrK)zDA |Settings| object providing access to the document-level settings.)rsettingsrMr#r#r$rWrNzDocument.settingscCrK)zBA |Styles| object providing access to the styles in this document.)rstylesrMr#r#r$rXrNzDocument.styles List[Table]cCrK)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. )r8tablesrMr#r#r$rZs zDocument.tablesrcCs |jd}t|j|j|jS)zGA |Length| object specifying the space between margins in last section.)rVr page_width left_margin right_margin)r sectionr#r#r$rIs zDocument._block_width_BodycCs |jdur t|jj||_|jS)z>The |_Body| instance containing the content for this document.N)rr`rrArMr#r#r$r8s zDocument._body)rrrr)r%r&)r'r(r)r*)r%N)r'r(r/r6r7r)NN)r9r:r;r<r=r<)r@rr)rEr*rFr*r/rG)r7rP)r7rR)r7r)rTr:)r7r )r7r)r7rY)r7r)r7r`)__name__ __module__ __qualname____doc__rr0r5r.r>rNEW_PAGErDrHpropertyrLrOrQrSrrUrVrWrXrZrIr8 __classcell__r#r#r!r$rsB               rcs*eZdZdZd fdd Zdd ZZS) r`zoProxy for `` element in this document. It's primary role is a container for document content. body_elmrparentt.ProvidesStoryPartcstt|||||_dSr)rr`rr8)r rhrir!r#r$rs z_Body.__init__cCs|j|S)zReturn this |_Body| instance after clearing it of all content. Section properties for the main document story, if present, are preserved. )r8 clear_contentrMr#r#r$rks z_Body.clear_content)rhrrirj)rarbrcrdrrkrgr#r#r!r$r`sr`)(rd __future__rtypingrrrr docx.blkcntnrrdocx.enum.sectionrdocx.enum.textr docx.sectionr r docx.sharedr r docx.typestypestdocx.oxml.documentrrdocx.parts.documentr docx.settingsrrdocx.styles.stylerr docx.tablerdocx.text.paragraphrrr`r#r#r#r$s(          %