PqhhdZddlmZddlmZmZmZmZddlm 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'y)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) ParagraphcJeZdZdZdfd ZdddZdZ d ddZ d ddZe jfddZ dddZ e d Ze d Zdd Ze d d Ze d!d Zd"dZe d#dZe d$dZe dZe d%dZe d&dZe d'dZxZS)(DocumentzWordprocessingML (WML) document. Not intended to be constructed directly. Use :func:`docx.Document` to open or create a document. cVtt| |||_||_d|_yN)superr__init___element_part_Document__body)selfelementpart __class__s N/srv/www/ollama/chat-ollama/venv/lib/python3.12/site-packages/docx/document.pyrzDocument.__init__"s' h&w/   ctd|cxkrdksntd|z|dk(rdnd|z}|j||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"textlevelstyles r& add_headingzDocument.add_heading(sEEQAEIJ J A:<%+?!!$..r'c|j}|jjtj|S)z=Return newly |Paragraph| object containing only a page break.)r,add_run add_breakr PAGE)r" paragraphs r&add_page_breakzDocument.add_page_break5s1&&( %%hmm4r'c:|jj||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/s r&r,zDocument.add_paragraph;szz''e44r'cd|jj}|j|||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"image_path_or_streamwidthheightruns r&r:zDocument.add_pictureIs/   "**,3UFCCr'c|jjj}||_t ||j S)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_break start_typer r )r"rB new_sectPrs r& add_sectionzDocument.add_section\s5 ]]''99; * z4::..r'cb|jj|||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"rowscolsr/tables r&rFzDocument.add_tablefs.  $$T41B1BC  r'c.|jjS)zGA |CoreProperties| object providing Dublin Core properties of document.)r core_propertiesr"s r&rLzDocument.core_propertiespszz)))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_shapesrMs r&rOzDocument.inline_shapesuszz'''r'c6|jjS)zHGenerate each `Paragraph` or `Table` in this document in document order.)r8iter_inner_contentrMs r&rQzDocument.iter_inner_contentszz,,..r'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. )r8 paragraphsrMs r&rSzDocument.paragraphsszz$$$r'c|jS)z+The |DocumentPart| object of this document.)r rMs r&r$z Document.partszzr'c:|jj|y)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"path_or_streams r&rVz Document.saves 'r'cBt|j|jS)zD|Sections| object providing access to each section in this document.)r rr rMs r&sectionszDocument.sectionss tzz22r'c.|jjS)zDA |Settings| object providing access to the document-level settings.)r settingsrMs r&r[zDocument.settingsszz"""r'c.|jjS)zBA |Styles| object providing access to the styles in this document.)r stylesrMs r&r]zDocument.stylesszz   r'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. )r8tablesrMs r&r_zDocument.tablesszz   r'c~|jd}t|j|jz |jz S)zGA |Length| object specifying the space between margins in last section.)rYr page_width left_margin right_margin)r"sections r&rGzDocument._block_widths9--#7%%(;(;;g>R>RRSSr'c||j%t|jj||_|jS)z>The |_Body| instance containing the content for this document.)r!_Bodyrr@rMs r&r8zDocument._bodys0 ;;  2 2D9DK{{r')r#rr$r))r-strr.int)rhN)r-rjr/zstr | ParagraphStyle | Nonereturnr)NN)r;str | IO[bytes]r<int | Length | Noner=rn)rBr r)rHrkrIrkr/zstr | _TableStyle | None)rlzIterator[Paragraph | Table])rlzList[Paragraph])rlr)rWrm)rlr )rlr)rlz List[Table])rlr)rlrg)__name__ __module__ __qualname____doc__rr0r6r,r:r NEW_PAGErDrFpropertyrLrOrQrSr$rVrYr[r]r_rGr8 __classcell__r%s@r&rrsQ  /DH 5 5%@ 5  5"&*&* D-D#D$ D&4>3F3F/**((/%%(33##!!!!TT r'rc*eZdZdZdfd ZdZxZS)rgzoProxy for `` element in this document. It's primary role is a container for document content. c<tt| ||||_yr)rrgrr8)r"body_elmparentr%s r&rz_Body.__init__s eT#Hf5 r'c:|jj|S)zReturn this |_Body| instance after clearing it of all content. Section properties for the main document story, if present, are preserved. )r8 clear_contentrMs r&r|z_Body.clear_contents   " r')ryrrzzt.ProvidesStoryPart)rorprqrrrr|rurvs@r&rgrgs r'rgN)(rr __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.paragraphrrrgr'r&rsY."44,(#*)70&"= -c|cL r'