
    hb)                        S r SSKJr  SSKrSSKrSSKJrJrJ	r	  SSK
JrJr  SSKJr  SSKJrJr  \(       a  SSKJr   " S	 S
\5      rg)z@Custom element classes for core properties-related XML elements.    )annotationsN)TYPE_CHECKINGAnyCallable)nsdeclsqn)	parse_xml)BaseOxmlElement	ZeroOrOne)_Elementc                     \ rS rSr% SrS\S'   \" SSS9r\" SSS9r\" S	SS9r	\" S
SS9r
\" SSS9r\" SSS9r\" SSS9r\" SSS9r\" SSS9r\" SSS9r\" SSS9r\" SSS9rS\S'   \" SSS9r\" SSS9r\" SSS9rS\" SSS5      -  r\S 5       r\S 5       r\R8                  SDS j5       r\SES j5       r\R8                  SDS  j5       r\SES! j5       r\R8                  SDS" j5       r\S# 5       r\R8                  SDS$ j5       r\S% 5       r \ R8                  SFS& j5       r \S' 5       r!\!R8                  SDS( j5       r!\S) 5       r"\"R8                  SDS* j5       r"\S+ 5       r#\#R8                  SDS, j5       r#\S- 5       r$\$R8                  SDS. j5       r$\S/ 5       r%\%R8                  SFS0 j5       r%\SGS1 j5       r&\&R8                  SFS2 j5       r&\S3 5       r'\'R8                  SHS4 j5       r'\S5 5       r(\(R8                  SDS6 j5       r(\S7 5       r)\)R8                  SDS8 j5       r)\S9 5       r*\*R8                  SDS: j5       r*SIS; jr+SJS< jr,\SKS= j5       r-\.R^                  " S>5      r0\SLS? j5       r1SMS@ jr2SNSA jr3SOSB jr4Sr5gC)PCT_CoreProperties   aH  `<cp:coreProperties>` element, the root element of the Core Properties part.

Stored as `/docProps/core.xml`. Implements many of the Dublin Core document metadata
elements. String elements resolve to an empty string ("") if the element is not
present in the XML. String elements are limited in length to 255 unicode characters.
zCallable[[], etree_Element]get_or_add_revisionzcp:category )
successorszcp:contentStatuszdcterms:createdz
dc:creatorzdc:descriptionzdc:identifierzcp:keywordszdc:languagezcp:lastModifiedByzcp:lastPrintedzdcterms:modifiedzcp:revisionzetree_Element | Nonerevisionz
dc:subjectzdc:titlez
cp:versionz<cp:coreProperties %s/>
cpdcdctermsc                4    U R                   n[        U5      nU$ )z+Return a new `<cp:coreProperties>` element.)_coreProperties_tmplr	   )clsxmlcorePropertiess      E/var/www/html/env/lib/python3.13/site-packages/docx/oxml/coreprops.pynewCT_CoreProperties.new/   s     &&"3    c                $    U R                  S5      $ )z+The text in the `dc:creator` child element.creator_text_of_elementselfs    r   author_textCT_CoreProperties.author_text6   s     $$Y//r   c                (    U R                  SU5        g )Nr!   _set_element_textr%   values     r   r&   r'   ;       y%0r   c                $    U R                  S5      $ Ncategoryr"   r$   s    r   category_textCT_CoreProperties.category_text?       $$Z00r   c                (    U R                  SU5        g r/   r)   r+   s     r   r1   r2   C       z51r   c                $    U R                  S5      $ Ndescriptionr"   r$   s    r   comments_textCT_CoreProperties.comments_textG   s    $$]33r   c                (    U R                  SU5        g r7   r)   r+   s     r   r9   r:   K   s    }e4r   c                $    U R                  S5      $ NcontentStatusr"   r$   s    r   contentStatus_text$CT_CoreProperties.contentStatus_textO   s    $$_55r   c                (    U R                  SU5        g r=   r)   r+   s     r   r?   r@   S   s    6r   c                $    U R                  S5      $ Ncreated_datetime_of_elementr$   s    r   created_datetime"CT_CoreProperties.created_datetimeW   s    ((33r   c                (    U R                  SU5        g rC   _set_element_datetimer+   s     r   rG   rH   [   s    ""9e4r   c                $    U R                  S5      $ N
identifierr"   r$   s    r   identifier_text!CT_CoreProperties.identifier_text_   s    $$\22r   c                (    U R                  SU5        g rM   r)   r+   s     r   rO   rP   c   s    |U3r   c                $    U R                  S5      $ Nkeywordsr"   r$   s    r   keywords_textCT_CoreProperties.keywords_textg   r3   r   c                (    U R                  SU5        g rS   r)   r+   s     r   rU   rV   k   r5   r   c                $    U R                  S5      $ Nlanguager"   r$   s    r   language_textCT_CoreProperties.language_texto   r3   r   c                (    U R                  SU5        g rY   r)   r+   s     r   r[   r\   s   r5   r   c                $    U R                  S5      $ NlastModifiedByr"   r$   s    r   lastModifiedBy_text%CT_CoreProperties.lastModifiedBy_textw   s    $$%566r   c                (    U R                  SU5        g r_   r)   r+   s     r   ra   rb   {   s    /7r   c                $    U R                  S5      $ NlastPrintedrE   r$   s    r   lastPrinted_datetime&CT_CoreProperties.lastPrinted_datetime   s    ((77r   c                (    U R                  SU5        g re   rJ   r+   s     r   rg   rh      s    ""=%8r   c                $    U R                  S5      $ NmodifiedrE   r$   s    r   modified_datetime#CT_CoreProperties.modified_datetime   s    ((44r   c                (    U R                  SU5        g rk   rJ   r+   s     r   rm   rn      s    "":u5r   c                    U R                   nUc  g[        UR                  5      n [        U5      nUS:  a  SnU$ ! [         a    Sn Nf = f)z#Integer value of revision property.r   )r   strtextint
ValueError)r%   r   revision_strs      r   revision_number!CT_CoreProperties.revision_number   s\     ==8==)	<(H
 a<H  	H	s   < A
Ac                    [        U[        5      (       a  US:  a  Sn[        X!-  5      eU R                  5       n[	        U5      Ul        g)z9Set revision property to string value of integer `value`.   z1revision property requires positive int, got '%s'N)
isinstancers   rt   r   rq   rr   )r%   r,   tmplr   s       r   rv   rw      sB     %%%FDT\**++-E
r   c                $    U R                  S5      $ Nsubjectr"   r$   s    r   subject_textCT_CoreProperties.subject_text       $$Y//r   c                (    U R                  SU5        g r}   r)   r+   s     r   r   r      r-   r   c                $    U R                  S5      $ Ntitler"   r$   s    r   
title_textCT_CoreProperties.title_text   s    $$W--r   c                (    U R                  SU5        g r   r)   r+   s     r   r   r      s    w.r   c                $    U R                  S5      $ Nversionr"   r$   s    r   version_textCT_CoreProperties.version_text   r   r   c                (    U R                  SU5        g r   r)   r+   s     r   r   r      r-   r   c                |    [        X5      nUc  g UR                  n U R                  U5      $ ! [         a     g f = f)N)getattrrr   _parse_W3CDTF_to_datetimert   )r%   property_nameelementdatetime_strs       r   rF   &CT_CoreProperties._datetime_of_element   sE    $.?||	11,?? 		s   . 
;;c                4    SU-  n[        X5      nU" 5       nU$ )z@Return element returned by "get_or_add_" method for `prop_name`.zget_or_add_%s)r   )r%   	prop_nameget_or_add_method_nameget_or_add_methodr   s        r   _get_or_addCT_CoreProperties._get_or_add   s%    !09!<#DA#%r   c                    U R                   R                  U5      nUc  [        SU-  5      eUR                  5       u  pEnUS:X  a  SOSn[	        U5      U-  n[	        U5      U-  n	[
        R                  " XS9n
X-   $ )znA |datetime| instance offset from `dt_` by timezone offset in `offset_str`.

`offset_str` is like `"-07:00"`.
z!'%s' is not a valid offset string+ry   )hoursminutes)_offset_patternmatchrt   groupsrs   dt	timedelta)r   dt_
offset_strr   sign	hours_strminutes_strsign_factorr   r   tds              r   
_offset_dtCT_CoreProperties._offset_dt   s     ##))*5=@:MNN',||~$ CKbQI,k"[0\\7xr   z([+-])(\d\d):(\d\d)c                D   SnUS S nUSS  nS nU H#  n [         R                  R                  X65      nM%     Uc  Sn[        Xa-  5      e[	        U5      S:X  a  U R                  XT5      nUR                  [         R                  R                  S9$ ! [         a     M  f = f)N)z%Y-%m-%dT%H:%M:%Sz%Y-%m-%dz%Y-%mz%Y   z+could not parse W3CDTF datetime string '%s'   )tzinfo)	r   datetimestrptimert   lenr   replacetimezoneutc)r   
w3cdtf_str	templatesparseable_partr   r   r{   s          r   r   +CT_CoreProperties._parse_W3CDTF_to_datetime   s    
	 $CR_
Dkk**>@ 
 ;@DT.//z?a..1C{{"++//{22  s   B
BBc                j   [        U[        R                  5      (       d  Sn[        U[	        U5      -  5      eU R                  U5      nUR                  S5      nXTl        US;   aM  U R                  [        S5      S5        UR                  [        S5      S5        U R                  [        S5      	 gg)	zCSet date/time value of child element having `prop_name` to `value`.z;property requires <type 'datetime.datetime'> object, got %sz%Y-%m-%dT%H:%M:%SZ)rD   rl   zxsi:foobarzxsi:typezdcterms:W3CDTFN)rz   r   r   rt   typer   strftimerr   setr   attrib)r%   r   r,   r{   r   dt_strs         r   rK   'CT_CoreProperties._set_element_datetime  s    %--PDTDK/00""9- 45//
 HHR	]E*KK:(89ByM* 0r   c                    [        U[        5      (       d  [        U5      n[        U5      S:  a  Sn[        X2-  5      eU R	                  U5      nX$l        g)z/Set string value of `name` property to `value`.   z0exceeded 255 char limit for property, got:

'%s'N)rz   rq   r   rt   r   rr   )r%   r   r,   r{   r   s        r   r*   #CT_CoreProperties._set_element_text  sK    %%%JEu:GDT\**""9-r   c                T    [        X5      nUc  gUR                  c  gUR                  $ )zwThe text in the element matching `property_name`.

The empty string if the element is not present or contains no text.
 )r   rr   )r%   r   r   s      r   r#   "CT_CoreProperties._text_of_element   s-    
 $.?<<||r   N)r,   rq   )returnrq   )r,   dt.datetime)r   dt.datetime | None)r,   rs   )r   rq   r   r   )r   rq   r   r
   )r   r   r   rq   r   r   )r   rq   r   r   )r   rq   r,   r   )r   rq   r,   r   r   None)r   rq   r   rq   )6__name__
__module____qualname____firstlineno____doc____annotations__r   r0   r>   rD   r!   r8   rN   rT   rZ   r`   rf   rl   r   r~   r   r   r   r   classmethodr   propertyr&   setterr1   r9   r?   rG   rO   rU   r[   ra   rg   rm   rv   r   r   r   rF   r   r   recompiler   r   rK   r*   r#   __static_attributes__r   r   r   r   r      s    5426H0R@M)b9G4G,<K?r:J26H26H2rBN,<K+;H%."&H"  4GjR0E4G6tY9WW  0 0 1 1 1 1 2 2 4 4 5 5 6 6 7 7 4 4 5 5 3 3 4 4 1 1 2 2 1 1 2 2 7 7 8  8 8 8   9 !9 5 5 6 6    # # 0 0 1 1 . . / / 0 0 1 1	   jj!78O3 3<+"	
r   r   )r   
__future__r   r   r   r   typingr   r   r   docx.oxml.nsr   r   docx.oxml.parserr	   docx.oxml.xmlchemyr
   r   
lxml.etreer   etree_Elementr   r   r   r   <module>r      s4    F "  	 / / $ & 94Y Yr   