o 'fh@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'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) Paragraphcs eZdZdZdIfdd ZdJdKddZddZ dLdMddZ  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__E/home/ubuntu/flask/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_breakNr0str | 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(r0r$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/r2 add_picture)r!r:r<r>runr$r$r%r?Is 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_breakrAr r)r!rA new_sectPrr$r$r% add_section\s  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. )r9 add_table _block_widthr0)r!rFrGr0tabler$r$r%rIfszDocument.add_tablecC|jjS)zGA |CoreProperties| object providing Dublin Core properties of document.)rcore_propertiesr!r$r$r%rMpzDocument.core_propertiescCrL)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_shapesrNr$r$r%rPuszDocument.inline_shapesIterator[Paragraph | Table]cCs |jS)zHGenerate each `Paragraph` or `Table` in this document in document order.)r9iter_inner_contentrNr$r$r%rRs zDocument.iter_inner_contentList[Paragraph]cCrL)zThe |Paragraph| instances in the document, in document order. Note that paragraphs within revision marks such as ```` or ```` do not appear in this list. )r9 paragraphsrNr$r$r%rTszDocument.paragraphscCs|jS)z+The |DocumentPart| object of this document.)rrNr$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!rUr$r$r%rVsz Document.saver cCst|j|jS)zD|Sections| object providing access to each section in this document.)r rrrNr$r$r%sectionsszDocument.sectionsrcCrL)zDA |Settings| object providing access to the document-level settings.)rsettingsrNr$r$r%rXrOzDocument.settingscCrL)zBA |Styles| object providing access to the styles in this document.)rstylesrNr$r$r%rYrOzDocument.styles List[Table]cCrL)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. )r9tablesrNr$r$r%r[s zDocument.tablesrcCs |jd}t|j|j|jS)zGA |Length| object specifying the space between margins in last section.)rWr page_width left_margin right_margin)r!sectionr$r$r%rJs zDocument._block_width_BodycCs |jdur t|jj||_|jS)z>The |_Body| instance containing the content for this document.N)r rarrBrNr$r$r%r9s zDocument._body)rrrr)r&r')r(r)r*r+)r&N)r(r)r0r7r8r)NN)r:r;r<r=r>r=)rArr)rFr+rGr+r0rH)r8rQ)r8rS)r8r)rUr;)r8r )r8r)r8rZ)r8r)r8ra)__name__ __module__ __qualname____doc__rr1r6r/r?rNEW_PAGErErIpropertyrMrPrRrTrrVrWrXrYr[rJr9 __classcell__r$r$r"r%rsD                rcs*eZdZdZd fdd Zdd ZZS) razoProxy for `` element in this document. It's primary role is a container for document content. body_elmrparentt.ProvidesStoryPartcstt|||||_dSr)rrarr9)r!rirjr"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. )r9 clear_contentrNr$r$r%rls z_Body.clear_content)rirrjrk)rbrcrdrerrlrhr$r$r"r%rasraN)(re __future__rtypingrrrr docx.blkcntnrrdocx.enum.sectionrdocx.enum.textr docx.sectionr r docx.sharedr r docxrtdocx.oxml.documentrrdocx.parts.documentr docx.settingsrrdocx.styles.stylerr docx.tablerdocx.text.paragraphrrrar$r$r$r%s(          '