Phn?ddlmZddlZddlmZddlmZmZddlm Z m Z ddl m Z ddl mZddl mZdd lmZmZdd lmZmZmZmZmZmZmZmZmZmZerddlZdd l m!Z!dd l"m#Z#Gd dZ$y)) annotationsN)cached_property) TYPE_CHECKINGcast)format_iso8824_dateparse_iso8824_date)CatalogAttributes)"FileSpecificationDictionaryEntries)PageAttributes) PdfReadError PyPdfError) ArrayObjectByteStringObjectDecodedStreamObjectDictionaryObject NameObject NullObject NumberObject StreamObjectTextStringObjectis_null_or_none) Generator) PdfWriterceZdZdZd!d"dZed#dZed$dZed%dZ ed&dZ ed'dZ e jd(d Z ed'd Z e jd(d Z ed#d Zejd)d Zed*dZed+dZed+dZed'dZejd,dZed-dZejd.dZed/dZejd0dZed1dZejd2dZed1dZejd2dZed3dZejd4dZd5dZd#dZed6dZed7d Zy)8 EmbeddedFilez Container holding the information on an embedded file. Attributes are evaluated lazily if possible. Further information on embedded files can be found in section 7.11 of the PDF 2.0 specification. Nc.||_||_||_y)z Args: name: The (primary) name as provided in the name tree. pdf_object: The corresponding PDF object to allow retrieving further data. parent: The parent list. N)_name pdf_object_parent)selfnamerparents N/var/www/html/saasai/venv/lib/python3.12/site-packages/pypdf/generic/_files.py__init__zEmbeddedFile.__init__(s $ c|jS)zEThe (primary) name of the embedded file as provided in the name tree.)rr s r#r!zEmbeddedFile.name3szzr%c &t|tr|jd}t}|j ||j t tjt dit}|j t d|j|iddl m }t}|j|}tt||} |j t tjt dt tj | t tj"|i|j%|} |j'| | } | j)| || j)| | |||| S)aO Create a new embedded file and add it to the PdfWriter. Args: writer: The PdfWriter instance to add the embedded file to. name: The filename to display. content: The data in the file. Returns: EmbeddedFile instance for the newly created embedded file. latin-1z /EmbeddedFilez/Fr)create_string_objectz /Filespecr!rr") isinstancestrencoderset_dataupdaterPGTYPEr _add_object pypdf.genericr*rrr FEF_get_names_array_get_insertion_indexinsert) clswriterr!content file_entryef_entryr*filespecfilespec_reference name_object names_arrayinsertion_indexs r# _create_newzEmbeddedFile._create_new8sM gs #nnY/G)* G$:bgg. ?0KLM$%D)6+=+=j+IJK 7#%#//9+-A$-GH 277#Z %<=??@+=@@A8  **62 22; L?,>??K8+FFr%ctj|jvr=|jt |jt tj<t t|jtj}d|vrMt}t t tj|i}|j||t d<|St t|d}d|vr*t t|t tjSd|vr tdt}t t|dj}t t tj|i}|j||t d<|D]8}|jjdgD]}|j|:|S)zLGet the names array for embedded files, possibly creating and flattening it./EmbeddedFiles/Names/Kidsz2Got neither Names nor Kids in embedded files tree.) CANAMES root_objectr3rrrrr get_objectgetappend) r:r; names_dictnamesembedded_files_names_dictionaryembedded_files_names_treekidskidr!s r#r7zEmbeddedFile._get_names_arrayjs 886-- -7=7I7IJZJ\7]F  z"((3 4*F,>,>rxx,HI : -ME.>BHH%u-/ +8>7I7IJi7jJz"23 4L%))9:FV;W$X! 0 0 %>z"((?S%TU U 3 3ST T  K!:7!C!N!N!PQ*:  !5 )+ '4:3E3EFe3f :./0C (,,Xr: T";  r%cDtdt|dDcgc]}||jd}}|jd}tj||}tj ||}||k7r|dzS|dk(ry|t|x}k(r|dzS|dzScc}w)Nrzutf-8)rangelenr.bisect bisect_left bisect_right) r:rBr!ikeys name_bytesstartend key_counts r#r8z!EmbeddedFile._get_insertion_indexs8=a[AQST8UV8U1 A%%g.8UV[[) ""44!!$ 3 C<7N A: #d)+Y ,q= QwWsBctjtjfD]K}||jvs|j|j }t |r;t t|cSy)z3Retrieve the alternative name (file specification).N)r UFr5rrLrrr-)r keyvalues r#alternative_namezEmbeddedFile.alternative_names`799;];_;_`Cdoo%,779&u-U++ ar%c|tj|jvr.t|jt tj<tj |jvr/t|jt tj <yy||jt tj<||jt tj <y)z.Set the alternative name (file specification).N)r rcrrrr5r res r#rfzEmbeddedFile.alternative_names =144GU_Ua +M+P+P QR133tFT^T` +M+O+O PQGRWDOOJ'I'L'LM NPUDOOJ'I'K'KL Mr%cp|jjtj}t |ry|S)zRetrieve the description.N)rrMr DESCrrhs r# descriptionzEmbeddedFile.descriptions/##$F$K$KL 5 ! r%c|/t|jttj<y||jttj<y)zSet the description.N)rrrr rjrhs r#rkzEmbeddedFile.descriptions@ =S]S_DOOJ'I'N'NO PSXDOOJ'I'N'NO Pr%c:|jjddS)zJRetrieve the relationship of the referring document to this embedded file./AFRelationshipz /Unspecified)rrMr's r#associated_file_relationshipz)EmbeddedFile.associated_file_relationships""#4nEEr%c4||jtd<y)zESet the relationship of the referring document to this embedded file.rnN)rrrhs r#roz)EmbeddedFile.associated_file_relationships:? #456r%c<d|jvrtd|jtt|jd}tj tj fD])}||vstt||jcStd|)z)Retrieve the actual embedded file stream.z/EFz/EF entry not found: z'No /(U)F key found in file dictionary: ) rr rrr rcr5rrL)r efrds r#_embedded_filezEmbeddedFile._embedded_files  '!6t6GHI I "DOOE$: ;699;];_;_`CbyL"S'*<*<*>??aDRDIJJr%cf|jjdtjS)z&Retrieve the file-specific parameters./Params)rsrMrrLr's r#_paramszEmbeddedFile._paramss*""&&y2B2DEPPRRr%ct|j}d|vrt|td<tt|dS)z3Ensure the /Params dictionary exists and return it.ru)rsrrr)r embedded_files r#_ensure_paramszEmbeddedFile._ensure_paramss<++ M )3C3EM*Y/ 0$mI&>??r%cT|jjd}t|ry|S)zERetrieve the subtype. This is a MIME media type, prefixed by a slash./SubtypeN)rsrMrrhs r#subtypezEmbeddedFile.subtypes*##'' 3 5 ! r%cj|j}|t|td<y||td<y)zGSet the subtype. This should be a MIME media type, prefixed by a slash.Nr{)rsrr)r rerxs r#r|zEmbeddedFile.subtypes4++ =4>LM*Z0 149M*Z0 1r%c6|jjS)z!Retrieve the actual file content.)rsget_datar's r#r<zEmbeddedFile.contents""++--r%c|t|tr|jd}|jj |y)zSet the file content.r)N)r,r-r.rsr/rhs r#r<zEmbeddedFile.contents0 eS !LL+E $$U+r%cT|jjd}t|ry|S)z4Retrieve the size of the uncompressed file in bytes./SizeNrvrMrrhs r#sizezEmbeddedFile.size s(   ) 5 ! r%cj|j}|t|td<y||td<y)z/Set the size of the uncompressed file in bytes.Nrryrrr reparamss r#rzEmbeddedFile.sizes4$$ =*4,F:g& '*/F:g& 'r%cJt|jjdS)z$Retrieve the file creation datetime. /CreationDaterrvrMr's r# creation_datezEmbeddedFile.creation_dates"$,,"2"2?"CDDr%c|j}|t|td<yt|}t ||td<y)zSet the file creation datetime.Nrryrrrrr rerdate_strs r#rzEmbeddedFile.creation_date#sC$$ =2<,F:o. /*51H2B82LF:o. /r%cJt|jjdS)z4Retrieve the datetime of the last file modification./ModDaterr's r#modification_datezEmbeddedFile.modification_date-s"$,,"2"2:">??r%c|j}|t|td<yt|}t ||td<y)z/Set the datetime of the last file modification.Nrrrs r#rzEmbeddedFile.modification_date2sC$$ =-7\F:j) **51H-=h-GF:j) *r%cT|jjd}t|ry|S)z5Retrieve the MD5 checksum of the (uncompressed) file. /CheckSumNrrhs r#checksumzEmbeddedFile.checksum<s(   - 5 ! r%cj|j}|t|td<y||td<y)z0Set the MD5 checksum of the (uncompressed) file.Nrrrs r#rzEmbeddedFile.checksumDs4$$ =.8lF:k* +.3F:k* +r%c|js td|j|jvr&|jj|j}nNt |jddx}*||jvr|jj|}n td|jj ||jj |dz t |_y)z"Delete the file from the document.z-Parent required to delete file from document.indirect_referenceNz File not found in parent object.)rr rindexgetattrpopr)r rrs r#deletezEmbeddedFile.deleteMs||LM M ??dll *LL&&t7E'.t@TVZ'[[#h&$,,6LL&&'9:E?@ @  #*,r%cPd|jjd|jdS)N) __class____name__r!r's r#__repr__zEmbeddedFile.__repr__^s&4>>**+6$))a@@r%c#Kt|D]L\}}t|tr|j}||dz j}t |||Nyw)z Convert the given name tree into class instances. Args: names: The name tree to load the data from. Returns: Iterable of class instances for the files found. rr+N) enumerater,r-rLr)r:rPr\r!file_dictionary direct_names r#_load_from_nameszEmbeddedFile._load_from_namesasW!'GAtdC("&//"3#AEl557 " X]^^ (s "A9Ac#K tttt|dd}d|vrett|dj D]A}|j }d|vs|j tt|dEd{Cd|vr+|j tt|dEd{yy#t$rYywxYw7E7w)aI Load the embedded files for the given document catalog. This method and its signature are considered internal API and thus not exposed publicly for now. Args: catalog: The document catalog to load from. Returns: Iterable of class instances for the files found. rGrFNrH)rrKeyErrorrrLr)r:catalog containerrTs r#_loadzEmbeddedFile._loadts  %wx'89:JKI i K7);)F)F)HInn&s?"33Dc(m4TUUU J y ++Di>Q,RS S S !   V SsKC$CrsK" %&@3>01   )'qTqTr%