,hGJdZddlmZddlmZmZmZmZmZddl m Z ddl m Z ddl mZddlmZmZddlmZdd lmZdd lmZer&dd l mZmZdd lmZdd lmZddlmZddl m!Z!ddlm"Z"GddZ#Gddee#Z$Gdde Z%Gdde%Z&Gdde%Z'y)z/The |Section| object and related proxy classes.) annotations) TYPE_CHECKINGIteratorListSequenceoverload)BlockItemContainer)WD_HEADER_FOOTER)CT_P) FooterPart HeaderPart) lazyproperty)Table) Paragraph)WD_ORIENTATIONWD_SECTION_START) CT_Document) CT_SectPr) DocumentPart) StoryPart)LengthcJeZdZdZd#fd Zed$dZejd%dZed&dZejd'dZed(dZ ed)dZ ed(d Z ed)d Z e d(d Zed$d Zejd%d Zed$dZejd%dZe d)dZed$dZejd%dZd*dZed$dZejd%dZed+dZejd,dZed$dZejd-dZed$dZejd-dZed.dZed$dZejd-dZed/dZejd0d Zed$d!Zejd-d"ZxZS)1Sectionz}Document section, providing access to section and page setup settings. Also provides access to headers and footers. cFtt| ||_||_yN)superr__init___sectPr_document_part)selfsectPr document_part __class__s N/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/docx/section.pyrzSection.__init__s gt%' +c.|jjS)zRead/write. Bottom margin for pages in this section, in EMU. `None` when no bottom margin has been specified. Assigning |None| removes any bottom-margin setting. r bottom_marginr s r$r(zSection.bottom_margin#s||)))r%c&||j_yrr'r values r$r(zSection.bottom_margin,s%* "r%c.|jjS)zTrue if this section displays a distinct first-page header and footer. Read/write. The definition of the first-page header and footer are accessed using :attr:`.first_page_header` and :attr:`.first_page_footer` respectively. r titlePg_valr)s r$"different_first_page_header_footerz*Section.different_first_page_header_footer0s||'''r%c&||j_yrr.r+s r$r0z*Section.different_first_page_header_footer9#(  r%c`t|j|jtjS)z|_Footer| object defining footer content for even pages. The content of this footer definition is ignored unless the document setting :attr:`~.Settings.odd_and_even_pages_header_footer` is set True. )_Footerrrr EVEN_PAGEr)s r$even_page_footerzSection.even_page_footer=$t||T%8%8:J:T:TUUr%c`t|j|jtjS)z|_Header| object defining header content for even pages. The content of this header definition is ignored unless the document setting :attr:`~.Settings.odd_and_even_pages_header_footer` is set True. )_Headerrrr r5r)s r$even_page_headerzSection.even_page_headerFr7r%c`t|j|jtjS)z|_Footer| object defining footer content for the first page of this section. The content of this footer definition is ignored unless the property :attr:`.different_first_page_header_footer` is set True. )r4rrr FIRST_PAGEr)s r$first_page_footerzSection.first_page_footerO$t||T%8%8:J:U:UVVr%c`t|j|jtjS)z|_Header| object defining header content for the first page of this section. The content of this header definition is ignored unless the property :attr:`.different_first_page_header_footer` is set True. )r9rrr r<r)s r$first_page_headerzSection.first_page_headerXr>r%c`t|j|jtjS)z|_Footer| object representing default page footer for this section. The default footer is used for odd-numbered pages when separate odd/even footers are enabled. It is used for both odd and even-numbered pages otherwise. )r4rrr PRIMARYr)s r$footerzSection.footera$t||T%8%8:J:R:RSSr%c.|jjS)zDistance from bottom edge of page to bottom edge of the footer. Read/write. |None| if no setting is present in the XML. rrCr)s r$footer_distancezSection.footer_distancejs ||"""r%c&||j_yrrFr+s r$rGzSection.footer_distancer# r%c.|jjS)ai|Length| object representing page gutter size in English Metric Units. Read/write. The page gutter is extra spacing added to the `inner` margin to ensure even margins after page binding. Generally only used in book-bound documents with double-sided and facing pages. This setting applies to all pages in this section. rgutterr)s r$rLzSection.guttervs||"""r%c&||j_yrrKr+s r$rLzSection.gutterrIr%c`t|j|jtjS)z|_Header| object representing default page header for this section. The default header is used for odd-numbered pages when separate odd/even headers are enabled. It is used for both odd and even-numbered pages otherwise. )r9rrr rBr)s r$headerzSection.headerrDr%c.|jjS)zDistance from top edge of page to top edge of header. Read/write. |None| if no setting is present in the XML. Assigning |None| causes default value to be used. rrOr)s r$header_distancezSection.header_distances||"""r%c&||j_yrrQr+s r$rRzSection.header_distancerIr%c#K|jjD],}t|tr t ||n t ||.yw)zlGenerate each Paragraph or Table object in this `section`. Items appear in document order. N)riter_inner_content isinstancer rr)r elements r$rUzSection.iter_inner_contentsG ||668 dG/9'4/H9Wd+eT[]aNb c dsA A c.|jjS)zk|Length| object representing the left margin for all pages in this section in English Metric Units.r left_marginr)s r$rZzSection.left_margins||'''r%c&||j_yrrYr+s r$rZzSection.left_marginr2r%c.|jjS)z:ref:`WdOrientation` member specifying page orientation for this section. One of ``WD_ORIENT.PORTRAIT`` or ``WD_ORIENT.LANDSCAPE``. r orientationr)s r$r^zSection.orientations ||'''r%c&||j_yrr]r+s r$r^zSection.orientationr2r%c.|jjS)a)Total page height used for this section. This value is inclusive of all edge spacing values such as margins. Page orientation is taken into account, so for example, its expected value would be ``Inches(8.5)`` for letter-sized paper when orientation is landscape. r page_heightr)s r$rbzSection.page_heights||'''r%c&||j_yrrar+s r$rbzSection.page_heightr2r%c.|jjS)aATotal page width used for this section. This value is like "paper size" and includes all edge spacing values such as margins. Page orientation is taken into account, so for example, its expected value would be ``Inches(11)`` for letter-sized paper when orientation is landscape. r page_widthr)s r$rfzSection.page_widths||&&&r%c&||j_yrrer+s r$rfzSection.page_width"' r%c|jSr)rr)s r$partz Section.parts"""r%c.|jjS)zl|Length| object representing the right margin for all pages in this section in English Metric Units.r right_marginr)s r$rmzSection.right_margins||(((r%c&||j_yrrlr+s r$rmzSection.right_margins$) !r%c.|jjS)zType of page-break (if any) inserted at the start of this section. For exmple, ``WD_SECTION_START.ODD_PAGE`` if the section should begin on the next odd page, possibly inserting two page-breaks instead of one. r start_typer)s r$rqzSection.start_types||&&&r%c&||j_yrrpr+s r$rqzSection.start_typerhr%c.|jjS)zj|Length| object representing the top margin for all pages in this section in English Metric Units.r top_marginr)s r$ruzSection.top_margins||&&&r%c&||j_yrrtr+s r$ruzSection.top_marginrhr%)r!rr"r)return Length | None)r,zint | Length | Nonerwbool)r,rz)rwr4)rwr9)rwzIterator[Paragraph | Table])rwr)r,zWD_ORIENTATION | None)r,rx)rwr)rwr)r,zWD_SECTION_START | None)__name__ __module__ __qualname____doc__rpropertyr(setterr0r6r:r=r@rrCrGrLrOrRrUrZr^rbrfrjrmrqru __classcell__r#s@r$rrs , **++(((..)/)VVVVWWWWTT##$$ # # ]]$$TT##$$d(( ))(())(()) ' '((##)) **''(('' ((r%rc`eZdZdZdfd Zed dZed dZd dZd dZd dZxZ S)SectionszSequence of |Section| objects corresponding to the sections in the document. Supports ``len()``, iteration, and indexed access. cFtt| ||_||_yr)rrr _document_elmr)r document_elmr"r#s r$rzSections.__init__s  h&()+r%cyrr keys r$ __getitem__zSections.__getitem__ s03r%cyrrrs r$rzSections.__getitem__s8;r%ct|tr;|jj|Dcgc]}t ||j c}St |jj||j Scc}wr)rVslicer sectPr_lstrr)r rr!s r$rzSections.__getitem__sr c5 !#00;;C@ 3 34 t))44S94;N;NOO sA9c#rK|jjD]}t||jywr)rrrr)r r!s r$__iter__zSections.__iter__s4((33 7F&$"5"56 6 7s57c@t|jjSr)lenrrr)s r$__len__zSections.__len__s4%%0011r%)rrr"r)rintrwr)rrrwz List[Section])rz int | slicerwzSection | List[Section])rwzIterator[Section])rwr) r{r|r}r~rrrrrrrs@r$rrs; , 33 ;;P72r%rceZdZdZ ddZeddZejddZeddZddZ eddZ ddZ ed Z dd Z edd Zedd Zy )_BaseHeaderFooterz)Base class for header and footer classes.c.||_||_||_yr)rr _hdrftr_index)r r!r"header_footer_indexs r$rz_BaseHeaderFooter.__init__$s  +0r%c|j S)a``True`` if this header/footer uses the definition from the prior section. ``False`` if this header/footer has an explicit definition. Assigning ``True`` to this property removes the header/footer definition for this section, causing it to "inherit" the corresponding definition of the prior section. Assigning ``False`` causes a new, empty definition to be added for this section, but only if no definition is already present. )_has_definitionr)s r$is_linked_to_previousz'_BaseHeaderFooter.is_linked_to_previous.s''''r%ct|}||jk(ry|dur|jy|jy)NT)rzr_drop_definition_add_definition)r r, new_states r$rz'_BaseHeaderFooter.is_linked_to_previous<s<K 22 2     ! ! #  "r%c"|jS)zThe |HeaderPart| or |FooterPart| for this header/footer. This overrides `BlockItemContainer.part` and is required to support image insertion and perhaps other content like hyperlinks. )_get_or_add_definitionr)s r$rjz_BaseHeaderFooter.partGs**,,r%ctd)z&Return newly-added header/footer part.$must be implemented by each subclassNotImplementedErrorr)s r$rz!_BaseHeaderFooter._add_definitionR!"HIIr%ctd)zE|HeaderPart| or |FooterPart| object containing header/footer content.rrr)s r$ _definitionz_BaseHeaderFooter._definitionV""HIIr%ctd)zJRemove header/footer part containing the definition of this header/footer.rrr)s r$rz"_BaseHeaderFooter._drop_definition[rr%c6|jjS)z7`w:hdr` or `w:ftr` element, root of header/footer part.)rrWr)s r$_elementz_BaseHeaderFooter._element_s**,444r%c|jr |jS|j}|r|jS|j S)aReturn HeaderPart or FooterPart object for this section. If this header/footer inherits its content, the part for the prior header/footer is returned; this process continue recursively until a definition is found. If the definition cannot be inherited (because the header/footer belongs to the first section), a new definition is added for that first section and then returned. )rr_prior_headerfooterrr)r prior_headerfooters r$rz(_BaseHeaderFooter._get_or_add_definitiondsF   ## #!55 %<<> >##%%r%ctd)zHTrue if this header/footer has a related part containing its definition.rrr)s r$rz!_BaseHeaderFooter._has_definitionxrr%ctd)zn|_Header| or |_Footer| proxy on prior sectPr element. Returns None if this is first section. rrr)s r$rz%_BaseHeaderFooter._prior_headerfooter}s ""HIIr%N)r!rr"rrr ry)r,rzrwNone)rwzHeaderPart | FooterPart)rwr)rwz_Header | _Footer | None)r{r|r}r~rrrrrjrrrrrrrrr%r$rr!s311$1. 1 ( (!!#"#--JJJJ55&(JJJJr%rcPeZdZdZddZedZdZed dZedZ y) r4aPage footer, used for all three types (default, even-page, and first-page). Note that, like a document or table cell, a footer must contain a minimum of one paragraph and a new or otherwise "empty" footer contains a single empty paragraph. This first paragraph can be accessed as `footer.paragraphs[0]` for purposes of adding content to it. Using :meth:`add_paragraph()` by itself to add content will leave an empty paragraph above the newly added one. c|jj\}}|jj|j||S)zReturn newly-added footer part.)radd_footer_partradd_footerReferencer)r footer_partrIds r$rz_Footer._add_definition;..>>@ S ((););SAr%c|jj|j}|J|jj |j S)z6|FooterPart| object containing content of this footer.)rget_footerReferencerrrrr footerReferences r$rz_Footer._definitionD,,::4;M;MN**""../B/BCCr%c|jj|j}|jj |y)zDRemove footer definition (footer part) associated with this section.N)rremove_footerReferencerrdrop_relr rs r$rz_Footer._drop_definitions0ll11$2D2DE $$S)r%cT|jj|j}|duS)z-True if a footer is defined for this section.N)rrrrs r$rz_Footer._has_definition),,::4;M;MNd**r%cx|jj}|dSt||j|jS)zI|_Footer| proxy on prior sectPr element or None if this is first section.N)rpreceding_sectPrr4rrr rs r$rz_Footer._prior_headerfooterF <<88 '  )4+>+>@R@RS r%N)rwr ry r{r|r}r~rrrrrrrr%r$r4r4sO DD* ++   r%r4cNeZdZdZdZedZdZeddZedZ y) r9aPage header, used for all three types (default, even-page, and first-page). Note that, like a document or table cell, a header must contain a minimum of one paragraph and a new or otherwise "empty" header contains a single empty paragraph. This first paragraph can be accessed as `header.paragraphs[0]` for purposes of adding content to it. Using :meth:`add_paragraph()` by itself to add content will leave an empty paragraph above the newly added one. c|jj\}}|jj|j||S)zReturn newly-added header part.)radd_header_partradd_headerReferencer)r header_partrs r$rz_Header._add_definitionrr%c|jj|j}|J|jj |j S)z6|HeaderPart| object containing content of this header.)rget_headerReferencerrrrr headerReferences r$rz_Header._definitionrr%c|jj|j}|jj |y)z6Remove header definition associated with this section.N)rremove_headerReferencerrdrop_header_partrs r$rz_Header._drop_definitions0ll11$2D2DE ,,S1r%cT|jj|j}|duS)z8True if a header is explicitly defined for this section.N)rrrrs r$rz_Header._has_definitionrr%cx|jj}|dSt||j|jS)zI|_Header| proxy on prior sectPr element or None if this is first section.N)rrr9rrrs r$rz_Header._prior_headerfooterrr%Nryrrr%r$r9r9sO DD2 ++   r%r9N)(r~ __future__rtypingrrrrr docx.blkcntnrr docx.enum.sectionr docx.oxml.text.paragraphr docx.parts.hdrftrr r docx.sharedr docx.tablerdocx.text.paragraphrrrdocx.oxml.documentrdocx.oxml.sectionrdocx.parts.documentrdocx.parts.storyrrrrrr4r9rr%r$rs5"DD,.)4$)B.+0*"e(e(P2x 2BbJ*bJJ+ + \+ + r%