
    j                        d Z ddlmZ ddlmZmZ ddlmZ ddlm	Z	 ddl
mZ ddlmZmZ ddlmZ dd	lmZ dd
lmZ ddlmZ ddlmZ ddlmZ erddlmZ  G d de          ZdS )z+|DocumentPart| and closely related objects.    )annotations)TYPE_CHECKINGcast)Document)WD_STYLE_TYPE)RELATIONSHIP_TYPE)
FooterPart
HeaderPart)NumberingPart)SettingsPart)	StoryPart)
StylesPart)InlineShapes)lazyproperty)	BaseStylec                      e Zd ZdZd Zd Zed             Zed             Zdd
Z	ddZ
ddZd ZddZed             Zed             Zd Zed             Zed             Zed             Zed d            ZdS )!DocumentParta  Main document part of a WordprocessingML (WML) package, aka a .docx file.

    Acts as broker to other parts such as image, core properties, and style parts. It
    also acts as a convenient delegate when a mid-document object needs a service
    involving a remote ancestor. The `Parented.part` property inherited by many content
    objects provides access to this part object for that purpose.
    c                |    t          j        | j                  }|                     |t          j                  }||fS )z=Return (footer_part, rId) pair for newly-created footer part.)r	   newpackage	relate_toRTFOOTER)selffooter_partrIds      ]/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/docx/parts/document.pyadd_footer_partzDocumentPart.add_footer_part   3     nT\22nn[")44C    c                |    t          j        | j                  }|                     |t          j                  }||fS )z=Return (header_part, rId) pair for newly-created header part.)r
   r   r   r   r   HEADER)r   header_partr   s      r   add_header_partzDocumentPart.add_header_part%   r   r    c                    | j         j        S )zfA |CoreProperties| object providing read/write access to the core properties
        of this document.)r   core_propertiesr   s    r   r&   zDocumentPart.core_properties+   s     |++r    c                ,    t          | j        |           S )zEA |Document| object providing access to the content of this document.)r   _elementr'   s    r   documentzDocumentPart.document1   s     t,,,r    r   strreturnNonec                0    |                      |           dS )z/Remove related header part identified by `rId`.N)drop_relr   r   s     r   drop_header_partzDocumentPart.drop_header_part6   s    cr    c                    | j         |         S )z%Return |FooterPart| related by `rId`.related_partsr0   s     r   r   zDocumentPart.footer_part:       !#&&r    style_id
str | None
style_typer   r   c                8    | j                             ||          S )zReturn the style in this document matching `style_id`.

        Returns the default style for `style_type` if `style_id` is |None| or does not
        match a defined style of `style_type`.
        )styles	get_by_id)r   r6   r8   s      r   	get_stylezDocumentPart.get_style>   s     {$$Xz:::r    c                8    | j                             ||          S )aT  Return the style_id (|str|) of the style of `style_type` matching
        `style_or_name`.

        Returns |None| if the style resolves to the default style for `style_type` or if
        `style_or_name` is itself |None|. Raises if `style_or_name` is a style of the
        wrong type or names a style not present in the document.
        )r:   get_style_id)r   style_or_namer8   s      r   r>   zDocumentPart.get_style_idF   s     {''zBBBr    c                    | j         |         S )z%Return |HeaderPart| related by `rId`.r3   r0   s     r   r#   zDocumentPart.header_partP   r5   r    c                6    t          | j        j        |           S )zIThe |InlineShapes| instance containing the inline shapes in the document.)r   r)   bodyr'   s    r   inline_shapeszDocumentPart.inline_shapesT   s     DM.555r    c                    	 |                      t          j                  S # t          $ r8 t	          j                    }|                     |t          j                   |cY S w xY w)zA |NumberingPart| object providing access to the numbering definitions for
        this document.

        Creates an empty numbering part if one is not present.
        )part_related_byr   	NUMBERINGKeyErrorr   r   r   )r   numbering_parts     r   rH   zDocumentPart.numbering_partY   sh    	"''555 	" 	" 	"*.00NNN>2<888!!!!	"s   ! ?A#"A#c                :    | j                             |           dS )zSave this document to `path_or_stream`, which can be either a path to a
        filesystem location (a string) or a file-like object.N)r   save)r   path_or_streams     r   rJ   zDocumentPart.saveg   s      	.)))))r    c                    | j         j        S )zcA |Settings| object providing access to the settings in the settings part of
        this document.)_settings_partsettingsr'   s    r   rN   zDocumentPart.settingsl   s     "++r    c                    | j         j        S )z]A |Styles| object providing access to the styles in the styles part of this
        document.)_styles_partr:   r'   s    r   r:   zDocumentPart.stylesr   s      ''r    c                    	 |                      t          j                  S # t          $ r> t	          j        | j                  }|                     |t          j                   |cY S w xY w)zA |SettingsPart| object providing access to the document-level settings for
        this document.

        Creates a default settings part if one is not present.
        )rE   r   SETTINGSrG   r   defaultr   r   )r   settings_parts     r   rM   zDocumentPart._settings_partx   sl    	!''444 	! 	! 	!(0>>MNN="+666    	!s   ! AA)(A)r   c                
   	 t          t          |                     t          j                            S # t
          $ rD | j        }|J t          j        |          }|                     |t          j                   |cY S w xY w)zqInstance of |StylesPart| for this document.

        Creates an empty styles part if one is not present.
        )	r   r   rE   r   STYLESrG   r   rS   r   )r   r   styles_parts      r   rP   zDocumentPart._styles_part   s    	
D$8$8$C$CDDD 	 	 	lG&&&$,W55KNN;	222	s   14 ABBN)r   r+   r,   r-   )r   r+   )r6   r7   r8   r   r,   r   )r,   r   )__name__
__module____qualname____doc__r   r$   propertyr&   r*   r1   r   r<   r>   r#   r   rC   rH   rJ   rN   r:   rM   rP    r    r   r   r      s                   , , X,
 - - X-   ' ' ' '; ; ; ;C C C' ' ' ' 6 6 \6 " " \"* * *
 , , X,
 ( ( X(
 ! ! X!    X  r    r   N)r[   
__future__r   typingr   r   docx.documentr   docx.enum.styler   docx.opc.constantsr   r   docx.parts.hdrftrr	   r
   docx.parts.numberingr   docx.parts.settingsr   docx.parts.storyr   docx.parts.stylesr   
docx.shaper   docx.sharedr   docx.styles.styler   r   r]   r    r   <module>rk      sG   1 1 " " " " " " & & & & & & & & " " " " " " ) ) ) ) ) ) 6 6 6 6 6 6 4 4 4 4 4 4 4 4 . . . . . . , , , , , , & & & & & & ( ( ( ( ( ( # # # # # # $ $ $ $ $ $ ,++++++} } } } }9 } } } } }r    