+ vj^RIt^RIHt^RIHtHtHtHt^RIHt^RI H t H t H t H t ^RIHt^RIHtHt^RIHt^R IHtHtHt^R IHt^R IHt^R IHtH t H!t!H"t"^R IH#t$^RIH%t&^RIH't(^RIH)t*^RI+H,t,H-t-^RI.H/t/^RI0H1t1H2t2H3t3H4t4H5t5H6t6H7t7H8t8H9t9H:t:H;t;Ht>H?t?H@t@HAtAHBtBHCtC^RIDHEtE^RIFHGtGHHtH^RIIHJtJRRltK!RR]54tL!RR4tM!RR]] ] 3,4tNR#)N)abstractmethod) GeneratorIterableIteratorMapping)datetime)AnyOptionalUnioncast) Encryption) PageObject _VirtualList) index2label)deprecation_with_replacementlogger_warningparse_iso8824_date)CatalogAttributes)CatalogDictionary)CheckboxRadioButtonAttributesGoToActionArgumentsPagesAttributesUserAccessPermissions)Core)DocumentInformationAttributes)FieldDictionaryAttributes)PageAttributes) PdfReadError PyPdfError)_decompress_with_limit) ArrayObject BooleanObjectByteStringObject DestinationDictionaryObjectEncodedStreamObjectFieldFit FloatObjectIndirectObject NameObject NullObject NumberObject PdfObjectTextStringObject TreeObjectViewerPreferencescreate_string_objectis_null_or_none) EmbeddedFile) OutlineType PagemodeType)XmpInformationc xV^8dQhR\R\R\\\\R3,3,/#)dsizereturn.)bytesintr tupler )formats"U/var/www/html/daimler-pipeline/venv/lib/python3.14/site-packages/pypdf/_doc_common.py __annotate__rBZs300e0305eCHo1E+F0cV^8d \R4hRV,pVRRp\\\P!RV4^,4#)zInvalid size in convert_to_intsNz>qi)rr r>structunpack)r:r;s&&rAconvert_to_intrHZsG ax;<<+a/A "#A V]]4+A. //rCca]tRt^btoRtV3RlRltV3RlRlt]V3RlRl4t]V3RlR l4t ]V3R lR l4t ]V3R lR l4t ]V3RlRl4t ]V3RlRl4t ]V3RlRl4t]V3RlRl4t]V3RlRl4t]V3RlRl4t]V3RlRl4t]V3RlRl4t]V3RlRl4t]V3R lR!l4t]V3R"lR#l4t]V3R$lR%l4tR&tVtR'#)(DocumentInformationaY A class representing the basic document metadata provided in a PDF File. This class is accessible through :py:class:`PdfReader.metadata`. All text properties of the document metadata have *two* properties, e.g. author and author_raw. The non-raw property will always return a ``TextStringObject``, making it ideal for a case where the metadata is being displayed. The raw property can sometimes return a ``ByteStringObject``, if pypdf was unable to decode the string's text encoding; this requires additional safety in the caller and therefore is not as commonly accessed. c<V^8dQhRR/#r9r<N)r@ __classdict__s"rArB DocumentInformation.__annotate__qs(($(rCc2\P!V4R#N)r%__init__selfs&rArRDocumentInformation.__init__qs!!$'rCc6<V^8dQhRS[RS[S[,/#r9keyr<)strr )r@rNs"rArBrOtsSXc]rCcVPVR4p\V\4'dV#\V\4'd \ V4#R#rQ)get isinstancer/r#rY)rTrXretvals&& rA _get_textDocumentInformation._get_textts@#t$ f. / /M f. / /v; rCc0<V^8dQhRS[S[,/#r9r<r rY)r@rNs"rArBrO}s   x}  rCc VP\P4'dUVP\P4;'g.VP\P4P 4#R#)z Read-only property accessing the document's title. Returns a ``TextStringObject`` or ``None`` if the title is not specified. N)r[DITITLEr^ get_objectrSs&rAtitleDocumentInformation.title|sVxx!! NN288 $ G G(:(E(E(G  rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs""8C="rCc @VP\P4#)z>The "raw" version of title; can return a ``ByteStringObject``.)r[rdrerSs&rA title_rawDocumentInformation.title_rawsxx!!rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs)) )rCc @VP\P4#)z Read-only property accessing the document's author. Returns a ``TextStringObject`` or ``None`` if the author is not specified. )r^rdAUTHORrSs&rAauthorDocumentInformation.authors~~bii((rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs##HSM#rCc @VP\P4#)z?The "raw" version of author; can return a ``ByteStringObject``.)r[rdrorSs&rA author_rawDocumentInformation.author_rawsxx ""rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs**#*rCc @VP\P4#)z Read-only property accessing the document's subject. Returns a ``TextStringObject`` or ``None`` if the subject is not specified. )r^rdSUBJECTrSs&rAsubjectDocumentInformation.subjects~~bjj))rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrO$$Xc]$rCc @VP\P4#)z@The "raw" version of subject; can return a ``ByteStringObject``.)r[rdrxrSs&rA subject_rawDocumentInformation.subject_rawxx ##rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs * *# *rCc @VP\P4#)a3 Read-only property accessing the document's creator. If the document was converted to PDF from another format, this is the name of the application (e.g. OpenOffice) that created the original document from which it was converted. Returns a ``TextStringObject`` or ``None`` if the creator is not specified. )r^rdCREATORrSs&rAcreatorDocumentInformation.creators~~bjj))rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOr|rCc @VP\P4#)z@The "raw" version of creator; can return a ``ByteStringObject``.)r[rdrrSs&rA creator_rawDocumentInformation.creator_rawrrCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs + +(3- +rCc @VP\P4#)a Read-only property accessing the document's producer. If the document was converted to PDF from another format, this is the name of the application (for example, macOS Quartz) that converted it to PDF. Returns a ``TextStringObject`` or ``None`` if the producer is not specified. )r^rdPRODUCERrSs&rAproducerDocumentInformation.producers~~bkk**rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrO%%hsm%rCc @VP\P4#)zAThe "raw" version of producer; can return a ``ByteStringObject``.)r[rdrrSs&rA producer_raw DocumentInformation.producer_rawxx $$rCc0<V^8dQhRS[S[,/#rar r)r@rNs"rArBrOsDDx1DrCc R\VP\P44#)z:Read-only property accessing the document's creation date.)rr^rd CREATION_DATErSs&rA creation_date!DocumentInformation.creation_dates"$..1A1A"BCCrCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs**8C=*rCc @VP\P4#)z The "raw" version of creation date; can return a ``ByteStringObject``. Typically in the format ``D:YYYYMMDDhhmmss[+Z-]hh'mm`` where the suffix is the offset from UTC. )r[rdrrSs&rAcreation_date_raw%DocumentInformation.creation_date_rawsxx(())rCc0<V^8dQhRS[S[,/#rar)r@rNs"rArBrOs??8H#5?rCc R\VP\P44#)z| Read-only property accessing the document's modification date. The date and time the document was most recently modified. )rr^rdMOD_DATErSs&rAmodification_date%DocumentInformation.modification_dates"$.."=>>rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs%%x}%rCc @VP\P4#)z The "raw" version of modification date; can return a ``ByteStringObject``. Typically in the format ``D:YYYYMMDDhhmmss[+Z-]hh'mm`` where the suffix is the offset from UTC. )r[rdrrSs&rAmodification_date_raw)DocumentInformation.modification_date_rawsxx $$rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOs++(3-+rCc @VP\P4#)z Read-only property accessing the document's keywords. Returns a ``TextStringObject`` or ``None`` if keywords are not specified. )r^rdKEYWORDSrSs&rAkeywordsDocumentInformation.keywordss~~bkk**rCc0<V^8dQhRS[S[,/#rarb)r@rNs"rArBrOrrCc @VP\P4#)zAThe "raw" version of keywords; can return a ``ByteStringObject``.)r[rdrrSs&rA keywords_raw DocumentInformation.keywords_rawrrCrMN)__name__ __module__ __qualname____firstlineno____doc__rRr^propertyrgrkrprtryr~rrrrrrrrrr__static_attributes____classdictcell__rNs@rArJrJbs` ((    ""))##**$$ * *$$ + +%%DD**??%%++%%rCrJca]tRtRtoRtRtRtRtRt] ] V3RlRl44t ] ] V3RlRl44t ] V3R lR l4t ] V3R lR l4t] ] V3R lRl44t] V3RlRl4t] V3RlRl4t] V3RlRl4tV3RlRltV3RlRltV3RlRlt] V3RlRl4tV3RlRltRiV3RlR lltRjV3R!lR"lltV3R#lR$ltV3R%lR&ltV3R'lR(ltV3R)lR*ltRkV3R+lR,lltV3R-lR.lt] V3R/lR0l4t ] PBV3R1lR2l4t ] V3R3lR4l4t"RlV3R5lR6llt#] V3R7lR8l4t$] V3R9lR:l4t%V3R;lR<lt&V3R=lR>lt'V3R?lR@lt(V3RAlRBlt)] V3RClRDl4t*] V3RElRFl4t+] V3RGlRHl4t,] V3RIlRJl4t-RmV3RKlRLllt.RkV3RMlRNllt/V3ROlRPlt0V3RQlRRlt1] V3RSlRTl4t2] V3RUlRVl4t3] ] V3RWlRXl44t4] V3RYlRZl4t5] V3R[lR\l4t6] V3R]lR^l4t7V3R_lR`lt8V3RalRblt9RnV3RclRdllt:] RiV3RelRfll4t;V3RgltR#)o PdfDocCommoniza Common functions from PdfWriter and PdfReader objects. This root class is strongly abstracted. FNc <V^8dQhRS[/#ra)r%)r@rNs"rArBPdfDocCommon.__annotate__s  - rCcR#rQrMrSs&rA root_objectPdfDocCommon.root_object rCc <V^8dQhRS[/#rarY)r@rNs"rArBrs  C rCcR#rQrMrSs&rA pdf_headerPdfDocCommon.pdf_headerrrCcL<V^8dQhRS[S[S[3,RS[S[,/#)r9indirect_referencer<)r r>r*r r.)r@rNs"rArBrs,  "'^(;"< )  rCcR#rQrMrTrs&&rArfPdfDocCommon.get_object rCc,<V^8dQhRS[RS[RS[/#)r9indirectobjr<)r*r.)r@rNs"rArBr"s"   Y 9 rCcR#rQrM)rTrrs&&&rA_replace_objectPdfDocCommon._replace_object! rCc0<V^8dQhRS[S[,/#ra)r r%)r@rNs"rArBr's  x 01 rCcR#rQrMrSs&rA_infoPdfDocCommon._info%rrCc0<V^8dQhRS[S[,/#ra)r rJ)r@rNs"rArBr+s  (#67 rCc p\4pVPfR#VPVP4V#)z Retrieve the PDF file's document information dictionary, if it exists. Note that some PDF files use metadata streams instead of document information dictionaries, and these metadata streams will not be accessed by this function. N)rJrupdate)rTr]s& rAmetadataPdfDocCommon.metadata*s.%& ::  djj! rCc0<V^8dQhRS[S[,/#ra)r r7)r@rNs"rArBr:s  h~6 rCcR#rQrMrSs&rA xmp_metadataPdfDocCommon.xmp_metadata9rrCc0<V^8dQhRS[S[,/#ra)r r1)r@rNs"rArBr>s  H->$? rCc VPP\PR4pVfR#VP 4p\ V\ 4'go\ V4p\VR4'd-VPeVPVPV4V#WP\\P4&V#)zCReturns the existing ViewerPreferences as an overloaded dictionary.Nr) rr[CDVIEWER_PREFERENCESrfr\r1hasattrrrr+)rTos& rAviewer_preferencesPdfDocCommon.viewer_preferences=s    !6!6 = 9 LLN!.//!!$Aq.//A4H4H4T$$Q%9%91=GH  B,A,A!BCrCc <V^8dQhRS[/#rar>)r@rNs"rArBrLs))s)rCc VP'dVPR,R,#VPfVPVP4VPfQh\ VP4#)z Calculate the number of pages in this PDF file. Returns: The number of pages of the parsed PDF file. Raises: PdfReadError: If restrictions prevent this action. /Pages/Count) is_encryptedrflattened_pages_flatten _readonlylenrSs&rA get_num_pagesPdfDocCommon.get_num_pagesLse    ##H-h7 7    ' MM$.. )##///4''((rCc&<V^8dQhRS[RS[/#r9 page_numberr<)r>r)r@rNs"rArBras11C1J1rCc VPfVPVP4VPfQR4hVPV,#)z Retrieve a page by number from this PDF file. Most of the time ``.pages[page_number]`` is preferred. Args: page_number: The page number to retrieve (pages begin at zero) Returns: A :class:`PageObject` instance. z hint for mypy)rrr)rTrs&&rAget_pagePdfDocCommon.get_pageasH    ' MM$.. )##/@@/##K00rCc<<V^8dQhRS[RS[S[S[3,/#r)r>r?r%)r@rNs"rArBrss*### $ %#rCc aaa\\VPR,4oRVVV3RlloS!S^4wr#\V\4'gQR4hW#3#)z Retrieve the node and position within the /Kids containing the page. If page_number is greater than the number of pages, it returns the top node, -1. rctV^8dQhR\R\R\\\,\3,/#)r9nodemir<)r%r>r?r r.)r@s"rArB4PdfDocCommon._get_page_in_node..__annotate__}s8 C C" C(+ C 8I&+ , CrCc<\\VPR^44pVR,R8XdSV8XdVR3#RV^,3#SV, V8dVS 8XdS R3#RW,3#\\\VR,44FDwr4\\ VP 44pS!WA4wrVVeV^8dW3u#WV3u#TpKF \R4h)rz/Type/PageN/Kidsz"Unexpectedly cannot find the node.)r r>r[ enumerater!r%rfr) rrmaidxkidnirrecursive_calltops && rAr 6PdfDocCommon._get_page_in_node..recursive_call}sc488Ha01BG}'"$8OR!V|#b R'3;7NRW}$%d;W &FG+S^^-=>%c.=1u#y(4KHAB BrCmypy)r r%rr\)rTrrrr r s&f @@rA_get_page_in_nodePdfDocCommon._get_page_in_nodessZ#T%5%5h%?@ C C.#3* $ 0119691yrCc6<V^8dQhRS[S[S[3,/#ra)dictrYr$)r@rNs"rArBrs..Dk)9$:.rCc "VP4#)z8A read-only dictionary which maps names to destinations.)_get_named_destinationsrSs&rAnamed_destinationsPdfDocCommon.named_destinationss++--rCc <V^8dQhRS[/#ra)r!)r@rNs"rArBrs[rCc\4p\PVP9Ed\ VP\P,\ 4'Edj\ \ VP\P,4p\PV9d\ V\P,\ 4'd\ \ V\P,4pVPp\PV9d(\ \V\P,4pV#\4pW\\P4&V#\VR4'dR\ 4pVPV4pWB\\P4&W\\P4&V#\VR4'd\ 4pVPV4pWPP\\P4&\ 4pVPV4pWB\\P4&W\\P4&V#) _add_object) r!CANAMESrr\r%r DESTSrr+rr)rT named_destnamesdests dests_ref names_refs& rAget_named_dest_root PdfDocCommon.get_named_dest_roots ] 88t'' 'J   RXX &(8- - )4+;+;BHH+EFExx5 ZbhhAQ%R%R-uRXX?!44 88u$!%k5?!CJ&#"-J2<*RXX./ }--(* ,,U3 .7j*+.8j*+T= ) )$&E((/I5>  Z1 2$&E((/I*3*RXX& '*4*RXX& 'rCc|<V^8dQhRS[S[R3,RS[S[S[S[3,,RS[S[S[3,/#)r9treeNr]r<)r r0r rrYr$)r@rNs"rArBrsQGGJ$%Gc;./0G c;  GrCc Vf/pVPp\PV9d'\\V\P,4pMt\P V9d`\\ V\P ,4p\PV9d&\\V\P,4p\V4'dV#VfQR4h\PV9dO\\V\P,4F#pVPVP4V4K% V#\P V9Ed\\ V\P ,4p^pV\V48dWF,P4pV^, p\V\\ 34'gKMWF,P4pT^, p\T\ 4'dRT9d TR,pMKTP%Yx4p T fKY\\ T R,4&Y\!T4&KV#VP'4FgwrV P4p \V \ 4'd"RV 9dV R,P4p MKLVP%W4p V fKcWV &Ki V# \"dT#i;i)z Retrieve the named destinations present in the document. Args: tree: The current tree. retval: The previously retrieved destinations for nested calls. Returns: A dictionary which maps names to destinations. r/D/Title)rrrr r0rr%r3rKIDSr!rrfrr\r=rY IndexError_build_destinationitems) rTr%r]catalogrrr rXvaluedestk__v__vals &&& rAr$PdfDocCommon._get_named_destinationssU >F&&Gxx7"J(9:W$-wrxx/@A88u$ E"((O:EAc%j.h))+Q!#s|44!H//1EQe%566u} %d  ..s:#8<4T(^45'+3s8$'!> !JJLnn&c#344s{!$i224 ..s8#"&3K) 1". 1sK K$#K$c <V^8dQhRS[S[,RS[S[S[S[3,,RS[S[,RS[S[S[,,RS[S[S[S[3,,/#)r9r%r]fileobjstackr<)r r0rr listr.rY)r@rNs"rArBr si00z"0c3h(0# 0 Y( 0 $sCx. ! 0rCc a\P!4pVP\P!44VfY/pVPp.p\ P V9d2\\\,V\ P ,4oMR#SfV#VfQhRS9dF\\SR,4pVF&pVP4p VPWW5V4K( V#\;QJdV3RlV4F 'gK RM RM!V3RlV44'dVPSW#WT4V#)aW Extract field data if this PDF contains interactive form fields. The *tree*, *retval*, *stack* parameters are for recursive use. Args: tree: Current object to parse. retval: In-progress list of fields. fileobj: A file object (usually a text file) to write a report to on all interactive form fields found. stack: List of already parsed objects. Returns: A dictionary where each key is a field name, and each value is a :class:`Field` object. By default, the mapping name is used for keys. ``None`` if form data could not be located. Nz/Fieldsc3,<"TF qS9xK R#5irQrM).0attrr%s& rA *PdfDocCommon.get_fields..8s;*:$*:TF)FAattributes_dictrrrr ACRO_FORMr r r0r!rf _build_fieldany) rTr%r]r5r6field_attributesr-fieldsffields &f&&& rA get_fieldsPdfDocCommon.get_fields s4--/ = M M OP >F&&GE||w&HZ0'",,2GH <M    +tI7F !!%ER  S;*:;SSS;*:; ; ;   dF5E M rCc&<V^8dQhRS[RS[/#)r9parentr<)r%rY)r@rNs"rArBr=s / /0@ /S /rCc0RV9d\\VR,4#RV9dSVP\\VR,44R,\\VP RR44,#\\VP RR44#)/TM/Parent./T)r rY_get_qualified_field_namer%r[)rTrKs&&rArR&PdfDocCommon._get_qualified_field_name=s F?VE]+ +  ..)6)+<=sFJJtR01 2 CD"-..rCc x<V^8dQhRS[S[S[3,RS[S[S[3,RS[RS[RS[S[,RR/#)r9rGr]r5rDr6r<N)r r0r%rr r7r.)r@rNs"rArBrJs^(8(8Z!112(8S#X(8 (8  (8 I (8 (8rCcJa\;QJdV3RlR 4F 'dK RM RM!V3RlR 44'dR#VPS4pV'd%VPVSV4VPR4\ S4W&&W&,P P 4pVP\PR4R8XdaVP\\P44'd3V\\P4,W&,\R4&VP\PR4R8XdR V9d\\VR ,R ,P444W&,\R4&R W&,R,9d1W&,\R4,P\R 44EMVP\PR4R8XEdVP\P ^4\P"P$,^8wEd?.p\V4W&,\R4&VP\P&/4Fwp V P 4p \V R ,R ,P44Fp W9gK VPV 4K \V4W&,\R4&Ky VP\P ^4\P"P(,^8wdAR W&,R,9d-W&,R,W&,R,P+R 4VP-SW#V4R#) c3,<"TF qS9xK R#5irQrM)r:r;rGs& rAr<,PdfDocCommon._build_field..Rs;]T5 ]r>FTN rQ/Chz /_States_/Btnz/APz/Nz/Off)rPrM)allrR _write_fieldwriter'rrfr[r?FTr+Optr!r7keysappendFfFfBitsRadioKids NoToggleToOffindex _check_kids) rTrGr]r5rDr6rXrstateskss &f&&&& rArBPdfDocCommon._build_fieldJsu 3;];333;]; ; ; ,,U3    gu.> ? MM$ El k,,779 77255"  &377:bff3E+F+F36z"&&7I3JFK ;/ 0 77255"  'ESL3>SZ%**,-4FK ;/ 0V[55 J{34;;Jvv3FFK ;/ 0WWRWWb)LLNahtn1134A a(58C67J J{34 *q!BII$;$;;q@fk+66K ,V[-E-K-KF-ST 7rCc \<V^8dQhRS[S[S[3,RS[RS[RS[S[,RR/#)r9r%r]r5r6r<N)r r0r%r r7r.)r@rNs"rArBrtsL==J 001== = I =  =rCc(W9d$\R\VPV4R7R#VPV4\P V9dCV\P ,F%pVP 4pVPWRW44K' R#R#)z%(field_name)s already parsed)source field_nameN)rrrRrarr)rfrH)rTr%r]r5r6rs&&&&& rArhPdfDocCommon._check_kidsts{ = /99$?   T   4 'O0011nn&W<2 (rCc0<V^8dQhRS[RS[RS[RR/#)r9r5rGrDr<Nr )r@rNs"rArBrs)##C##s#t#rCc \P!4pV\P!4,pVFpV\P\P39dK*W5,pV\P 8Xd@RRRRRRRR/pW%,V9d'VP V RWrV,, R 24KKV\P8Xd8W%,\P,pVP V RV R 24KVP V RW%, R 24K R # \d!Y%,\P,pLfi;i \dEK3i;i) rZButton/TxTextrYChoicez/Sig Signature: rXN) r? attributesrreAAr^r]ParentTMKeyErrorT) rTr5rGrDfield_attributes_tupler; attr_nametypesnames &&&& rAr\PdfDocCommon._write_fieldsC!# "%B%M%M%O O +D(.I 255=vx E {e+  2e$K6H5I&LM,RYY&1${2551MMYKr$r":;MMYKr%+b"AB5+,$1${24401   sC'AE;ED*.EE*(EEEE E('E(c<<V^8dQhRS[RS[S[S[3,/#)r9full_qualified_namer<)boolrrYr )r@rNs"rArBrs$$$$cSVh$rCc  <RRlpVP4pVf/#/pVP4FiwrVVPR4R8XgKV'dVPR4WE&K:VPR4WB!\\VR,4V4&Kk V#)a_ Retrieve form fields from the document with textual data. Args: full_qualified_name: to get full name Returns: A dictionary. The key is the name of the form field, the value is the content of the field. If the document contains multiple form fields with the same name, the second and following will get the suffix .2, .3, ... c^V^8dQhR\R\\\3,R\/#)r9rjrEr<)rYrr )r@s"rArB7PdfDocCommon.get_form_text_fields..__annotate__s)  3 S#X 3 rCc|aSV9dS#SR,\\V3RlV44^,4,#)rOc3f<"TF&qPSR,4'gK"^xK( R#5i)rON) startswith)r:kkrjs& rAr<IPdfDocCommon.get_form_text_fields..indexed_key..s Gf a#g0F!!fs1 1)rYsum)rjrEsf&rA indexed_key6PdfDocCommon.get_form_text_fields..indexed_keys=cGfGG!KLM rC/FTrvz/VrP)rHr,r[r rY)rTrr formfieldsffrGr.s&& rAget_form_text_fields!PdfDocCommon.get_form_text_fieldss  __&  I &,,.LEyy5(& % $BIBG))D/B{4U4[#92>? /  rCcP<V^8dQhRS[S[S[S[3,RS[S[,/#)r9rGr<)r r'r.r*r7r)r@rNs"rArBrs2D D 5)^;<D j D rCc  aRV3Rllo\\VPP44p\ S!TR44'd \ R4h.pTPRR4R 8Xd`R T9dTR ,P4.pMTPUu.uF(pTPTPR R49gK&TNK* ppMTPR R4pTFpTP4pTPRR4R 8XgK,R T9gK5R T9d!Y6R ,P4., pK\TTPUu.uF(pTPTPR R49gK&TNK* up, pK TUu.uFGp\T\4'dTM+TPTPTP4,NKI up# \dp\ R4ThRp?ii;iuupiuupiuupi)a Provides list of pages where the field is called. Args: field: Field Object, PdfObject or IndirectObject referencing a Field Returns: List of pages: - Empty list: The field has no widgets attached (either hidden field or ancestor field). - Single page list: Page where the widget is present (most common). - Multi-page list: Field with multiple kids widgets (example: radio buttons, field repeated on multiple pages). c<V^8dQhR\R\R\/#)r9rrXr<)r%rYr )r@s"rArB:PdfDocCommon.get_pages_showing_field..__annotate__s"   0 s s rCc<W9d W,#RV9d-S!\\VR,P44V4#R#)rNN)r r%rf)rrX_get_inheriteds&&rAr._get_inheritedsCzxC%)3y>+D+D+FGrCzField type is invalidNrzField is not validz/SubtyperQz/Widgetz/Pz/AnnotsrrPrM) r r%rrf Exception ValueErrorr3r[pagesr\r_get_page_number_by_indirect) rTrGexcretpkidsrjxrs && @rAget_pages_showing_field$PdfDocCommon.get_pages_showing_fields.   ?)5+C+C+N+N+PQE >%7 8 812 2 99Z $ 1u}T{--/0"ZZ'//155B3GGA' 99Wb)DLLNEE*b)Y6T]qy$ 2 2 455%)ZZ %/ 33quuY7KKA%/    !Z(( **T>>q?S?STU W   9 ?453 > ?   s6(G#G<G<#H6H A H G9( G44G9c<<V^8dQhRS[RS[S[S[3,/#rL)r r$r/r#)r@rNs"rArBrs% t["24DD ErCc RVP9dR#VPR,p\V\4'dVP4p\V\4'd \ V4#\V\ 4'd'Vvr#p\V\V44p\RW%4#R# \dp\RT RT 24hRp?ii;i)z Property to access the opening destination (``/OpenAction`` entry in the PDF catalog). It returns ``None`` if the entry does not exist or is not set. Raises: Exception: If a destination is invalid. z /OpenActionN OpenActionzInvalid Destination rz) rr\r=decoderYr2r!r(r?r$r)rToapagetyparrayfitrs& rAopen_destinationPdfDocCommon.open_destinations  0 0 0""=1 b% B b#  '+ + b+ & & D$&!E#uU|,"<;; D"6rd"SE BCC Ds$B,, C 7CC c@<V^8dQhRS[RS[S[S[3,RR/#)r9r/Nr<)r rYr$r)r@rNs"rArBr9s.DDU4k:+M%NDSWDrCc\R4h)zNo setter for open_destination)NotImplementedError)rTr/s&&rArr8s!"BCCrCc <V^8dQhRS[/#ra)r5)r@rNs"rArBr=s###rCc "VP4#)z Read-only property for the outline present in the document (i.e., a collection of 'outline items' which are also known as 'bookmarks'). ) _get_outlinerSs&rAoutlinePdfDocCommon.outline<s  ""rCcr<V^8dQhRS[S[,RS[S[,RS[S[S[,,RS[/#)r9rrvisitedr<)r r%r setr>r5)r@rNs"rArBrEsF88'(8#8#c(# 8  8rCc:Vf.pVPp\PV9dm\\V\P,4p\ V\ 4'dV#\V4'gRV9d\\VR,4pVP4Vn VfV#Vf \4p\V4pWc9d\R\VR7V#VPV4VPV4pV'dVP!V4RV9dU.pVP#4p VP%\\VR,4VV R7V'dVP!V4RV9dV#\\VR,4pK)Nz/Firstz0Detected cycle in outline structure for %(node)s)ror)rrrz/Next)rCOOUTLINESr r%r\r,r3r_named_destinationsridrradd_build_outline_itemracopyr) rTrrrr-linesnode_id outline_obj sub_outline inner_visiteds &&&& rArPdfDocCommon._get_outlineEsm ?G&&G{{g%-wr{{/CDeZ00"N'u--(e2C 0%/BD'+'C'C'ED $ <N ?eGhG!QZbimn0/ KK 2248K{+4)+ '  !!.X?')" NN;/d"($w-8DrCc0<V^8dQhRS[S[,/#ra)r r!)r@rNs"rArBrs+.rCc VPp\PV9d"\RV\P,4#R#)u Read-only property for the list of threads. See §12.4.3 from the PDF 1.7 or 2.0 specification. It is an array of dictionaries with "/F" (the first bead in the thread) and "/I" (a thread information dictionary containing information about the thread, such as its title, author, and creation date) properties or None if there are no articles. Since PDF 2.0 it can also contain an indirect reference to a metadata stream containing information about the thread, such as its title, author, and creation date. r!N)rrTHREADSr )rTr-s& rAthreadsPdfDocCommon.threadss4 "" ::  wrzz':; ;rCcR<V^8dQhRS[RS[S[S[3,RS[S[,/#)r9rNr<)r r>r,r*r )r@rNs"rArBrs/  "'c:~(M"N # rCcR#rQrMrs&&rAr)PdfDocCommon._get_page_number_by_indirectrrCc6<V^8dQhRS[RS[S[,/#)r9rr<)rr r>)r@rNs"rArBrs# J JJ J8C= JrCc 8VPVP4#)z Retrieve page number of a given PageObject. Args: page: The page to get page number. Should be an instance of :class:`PageObject` Returns: The page number or None if page is not found )rr)rTrs&&rAget_page_numberPdfDocCommon.get_page_numbers001H1HIIrCc6<V^8dQhRS[RS[S[,/#)r9 destinationr<)r$r r>)r@rNs"rArBrs$ C C{ CxPS} CrCc 8VPVP4#)z Retrieve page number of a given Destination object. Args: destination: The destination to get page number. Returns: The page number or None if page is not found )rr)rTrs&&rAget_destination_page_number(PdfDocCommon.get_destination_page_numbers001A1ABBrCc <V^8dQhRS[S[S[3,RS[S[S[S[S[RS[S[3,,,RS[ /#)r9rgrNr<) r rYr=r r7r-r*r,r%r$)r@rNs"rArBrsXEES%Z E lND*FVVW  E ErCc  RRrC\V\\34'g+\V\4'd\ V4^8XgVf*\4p\ W\ P!44#Vvr4p\ W\ WBR74# \du\R\YR7TP'dhTP^,PpTf \4MTp\ Y\ P!44u#i;i)N)fit_typefit_argsz(Unknown destination: %(title)r %(array)s)rorgr)r\r,rYr!rr$r(rrrrstrictrr)rTrgrrrtmprs&&& rAr+PdfDocCommon._build_destinations$c uz3/ 0 05+..3u:?}. s<`U_PQ[^^U_sz/Frz /%is_open%)r rrrr%r+rSDr\r!r+rYr dest_arrayrrr"r[rrAttributeError)rTrr/rg outline_itemaction action_types&& rAr PdfDocCommon._build_outline_items$($\ X/E 4<*DJ7Fz62E2G2G+HIKg%&((F2!"5"7"78D[[[&)Nth'WXX _=D$ 011ddlDz dK ( (225?L c " " D#6633D9DD  \ 225?L{{{"%`. This property allows to get a page or a range of pages. Note: For PdfWriter only: Provides the capability to remove a page/range of page from the list (using the del operator). Remember: Only the page entry is removed, as the objects beneath can be used elsewhere. A solution to completely remove them - if they are not used anywhere - is to write to a buffer/temporary file and then load it into a new PdfWriter. )rrrrSs&rArPdfDocCommon.pages!sD.. >>rCc0<V^8dQhRS[S[,/#rar7rY)r@rNs"rArBr3sPPT#YPrCc z\\VP44Uu.uFp\W4NK up#uupi)z A list of labels for the pages in this document. This property is read-only. The labels are in the order that the pages appear in the document. )rangerrpage_index2page_label)rTr s& rA page_labelsPdfDocCommon.page_labels2s19>c$**o8NO8N1%d.8NOOOs8c0<V^8dQhRS[S[,/#rarb)r@rNs"rArBr=sXc]rCc \\VP\P,4# \ dR#i;i)a_ Get the page layout currently being used. .. list-table:: Valid ``layout`` values :widths: 50 200 * - /NoLayout - Layout explicitly not specified * - /SinglePage - Show one page at a time * - /OneColumn - Show one column at a time * - /TwoColumnLeft - Show pages in two columns, odd-numbered pages on the left * - /TwoColumnRight - Show pages in two columns, odd-numbered pages on the right * - /TwoPageLeft - Show two pages at a time, odd-numbered pages on the left * - /TwoPageRight - Show two pages at a time, odd-numbered pages on the right N)r r+rr PAGE_LAYOUTrrSs&rA page_layoutPdfDocCommon.page_layout<s5.  D$4$4R^^$DE E  s.1 AAc0<V^8dQhRS[S[,/#ra)r r6)r@rNs"rArBrYs8L1rCc NVPR,# \dR#i;i)a Get the page mode currently being used. .. list-table:: Valid ``mode`` values :widths: 50 200 * - /UseNone - Do not show outline or thumbnails panels * - /UseOutlines - Show outline (aka bookmarks) panel * - /UseThumbs - Show page thumbnails panel * - /FullScreen - Fullscreen view * - /UseOC - Show Optional Content Group (OCG) panel * - /UseAttachments - Show attachments panel z /PageModeN)rrrSs&rA page_modePdfDocCommon.page_modeXs** ##K0 0  s  $$c <V^8dQhRS[RS[RS[S[3,RS[S[S[S[3,,RS[S[,RR/#)r9 list_onlyrNinheritrr<) rr r%rr rrYr r*)r@rNs"rArBrrscT2T2T2T+Z78T2$sCx.) T2 %^4 T2  T2rCc \\P4\\P4\\P4\\P 43pVf/p\ V4'dTVPpVPR4P4p\V\4'g \R4h.Vn VfQR4h\PV9d'\!\"V\P,4pM\P$V9dRpMRpVR8XdVFpW9gK W(,W8&K \'VR\)44p \!\*V\P$,4Fsp \'V R\)44V 8Xd \R4h/p \V \,4'dWR&V P4p V 'gK^VP.!WV3/V BKu R#VR8XdgVP34FwrW9gK WV &K \5W4pV'gVP7V4VPP9V4R#R# \0d \R4hi;i) aJ Process the document pages to ease searching. Attributes of a page may inherit from ancestor nodes in the page tree. Flattening means moving any inheritance data into descendant nodes, effectively removing the inheritance dependency. Note: It is distinct from another use of "flattening" applied to PDFs. Flattening a PDF also means combining all the contents into one single layer and making the file less editable. Args: list_only: Will only list the pages within _flatten_pages. pages: inherit: indirect_reference: Used recursively to flatten the /Pages object. NrzInvalid object in /Pagesrrrz Detected cyclic page references.z7Maximum recursion depth reached during page flattening.)r+PG RESOURCESMEDIABOXCROPBOXROTATEr3rr[rfr\r%rrrTYPEr rYr)getattrobjectr!r*rRecursionErrorr,rrra)rTrrr rinheritable_page_attributesr-tr;pages_referenceraddtrattr_inr.page_objs&&&&& rArPdfDocCommon._flattenrs6 r|| $ r{{ # rzz " ryy ! ' # ?G 5 ! !&&GKK)446Ee%566"#=>>#%D  (&(   5 (S% 4 456A  ! ! .AA =3=$)KGM4&e-A68LO[%0D0D*EF4!5vx@OS&'IJJdN3315-.oo'3 igFFG '\")--/'%*'N #2 "$;H&  ' ' 1 **Us (I11JcD<V^8dQhRS[S[S[S[3,RS[RR/#)r9rcleanr<N)r r>rr*r)r@rNs"rArBrs5*4*4C^34*4*4  *4rCc VPfVPVP4VPfQh\V\4'd<VP 4p\V\ 4'g\R\R7R#Tp\V\4'gVPPV4p^Tu;8:d\VP48gM\R\R7R#VPV,PpVPVV'd#VeVPV\!44R#R#R# \d\R\R7R#i;i)a Remove page from pages list. Args: page: * :class:`int`: Page number to be removed. * :class:`~pypdf._page.PageObject`: page to be removed. If the page appears many times only the first one will be removed. * :class:`~pypdf.generic.IndirectObject`: Reference to page to be removed. clean: replace PageObject with NullObject to prevent annotations or destinations to reference a detached page. Nz(IndirectObject is not referencing a page)rozCannot find page in pageszPage number is out of range)rrrr\r*rfrrrr>rgrrrrrr,)rTrrrinds&&& rA remove_pagePdfDocCommon.remove_pages&    ' MM$.. )##/// dN + +!Aa,,IRZ[D$$$ ++11$7T5C 4 455 8 J jj11 JJt  S_  jl 3%5 :8L s"E E*)E*c<<V^8dQhRS[RS[RS[S[,/#)r9numgenr<)r>r r.)r@rNs"rArBrs';;;#;(9:M;rCc 6\WV4P4#)z Used to ease development. This is equivalent to generic.IndirectObject(num,gen,self).get_object() Args: num: The object number of the indirect object. gen: The generation number of the indirect object. Returns: A PdfObject )r*rf)rTr"r#s&&&rA_get_indirect_object!PdfDocCommon._get_indirect_objectsc-88::rCc<<V^8dQhRS[RS[S[S[3,/#)r9permissions_coder<)r>rrYr)r@rNs"rArBrs%  # c4i rCc \RRRR7R\PR\PR\PR\P R \P R \PR \PR \P/pVP4UUu/uFwr4W1V,^8gbK upp#uuppi) z>Take the permissions as an integer, return the allowed access.decode_permissionsuser_access_permissionsz5.0.0)old_namenew_name removed_inprintmodifyr annotationsforms accessabilityassembleprint_high_quality) rrPRINTMODIFYEXTRACT ADD_OR_MODIFYFILL_FORM_FIELDSEXTRACT_TEXT_AND_GRAPHICS ASSEMBLE_DOCPRINT_TO_REPRESENTATIONr,)rTr(permissions_mappingrXflags&& rAr*PdfDocCommon.decode_permissionss %).  *00 +22 )11 0>> *;; 2LL -:: "7"O"O  1668 8  D(A- -8   s$B?c0<V^8dQhRS[S[,/#ra)r r)r@rNs"rArBr s992G)H9rCc `VPfR#\VPP4#)aR Get the user access permissions for encrypted documents. Returns None if not encrypted. .. warning:: For AES-256 encrypted documents (R=5/R=6), the returned permissions are derived from the ``/P`` field, which is only trustworthy if the ``/Perms`` integrity check passed. Check :attr:`are_permissions_valid` to verify. N) _encryptionrPrSs&rAr+$PdfDocCommon.user_access_permissionss*    #$T%5%5%7%788rCc0<V^8dQhRS[S[,/#ra)r r)r@rNs"rArBr1s77x~7rCc VPfR#VPP4'gR#VPP#)a Whether the ``/Perms`` integrity check passed for this document. For AES-256 encrypted documents (R=5/R=6), the ``/Perms`` field is an encrypted copy of the permissions that can be verified independently. Returns ``False`` if this check fails (the ``/P`` permissions may have been tampered with). Returns ``None`` if the document is not encrypted or has not yet been decrypted via :meth:`decrypt()`. Returns ``True`` for non-AES-256 encryption (no ``/Perms`` to check). N)rC is_decrypted_are_permissions_validrSs&rAare_permissions_valid"PdfDocCommon.are_permissions_valid0s=    #,,..666rCc <V^8dQhRS[/#ra)r)r@rNs"rArBrFs  d rCc R#)z Read-only boolean property showing whether this PDF file is encrypted. Note that this property, if true, will remain true even after the :meth:`decrypt()` method is called. NrMrSs&rArPdfDocCommon.is_encryptedDs rCcF<V^8dQhRS[S[S[S[3,,/#ra)r rrYr )r@rNs"rArBrPs!Xd38n-rCc/pVPpRV9gVR,'gR#\\VR,4pRV9d\\VR,4p\ V4pVFtpTp\ V4p\ V\4'gK(\\\,VP44pV'gK[\VP4p WV&Kv V#)z /AcroFormNz/XFA) rr r0r!iternextr\r*r r&rfr _data) rTr]r-r%rEr rFtagrGess & rAxfaPdfDocCommon.xfaOs!#"" g %W[-A-AJ 45 T>+tF|4FV AGa00 *=!> OEu3EKK@&(s  rCcF<V^8dQhRS[S[S[S[,3,/#ra)rrYr7r=)r@rNs"rArBrgs"  WS$u+%56 rCc v\VP4Uu/uFpWPV3bK up4#uupi)z1Mapping of attachment filenames to their content.)LazyDict_list_attachments_get_attachment_list)rTrs& rA attachmentsPdfDocCommon.attachmentsfsJ!224 4D00$774    s6c6<V^8dQhRS[S[RR3,/#rL)rr4)r@rNs"rArBrqs 88<t+C!D8rCc# b"\P!VP4RjxL R#L5i)zIterable of attachment objects.N)r4_loadrrSs&rAattachment_listPdfDocCommon.attachment_listps! %%d&6&6777s $/-/c0<V^8dQhRS[S[,/#rar)r@rNs"rArBrus  49 rCc .pVPFWpVPVP4VP;q2P8wgK<V'gKFVPV4KY V#)zW Retrieves the list of filenames of file attachments. Returns: list of filenames )rbraralternative_name)rTrentryrs& rAr[PdfDocCommon._list_attachmentsusU))E LL $...::=$$ T"* rCc6<V^8dQhRS[RS[S[,/#)r9rr<)rYr7r=)r@rNs"rArBrserCchVPV4V,p\V\4'dV#V.#rQ)_get_attachmentsr\r7)rTrouts&& rAr\!PdfDocCommon._get_attachment_lists0##D)$/ c4 Ju rCc r<V^8dQhRS[S[,RS[S[S[S[S[S[,3,3,/#)r9filenamer<)r rYrr r=r7)r@rNs"rArBrs9((  ( c5U +,, -(rCc /pVPFp\4pVPpVeEWPV09d1WP8Xd VPMTpVP V4MKaVPV0pVFgpVfK Wb9dK\ W&,\ 4'g W&,.W&&W&,PVP4KYVPW&&Ki K V#)a; Retrieves all or selected file attachments of the PDF as a dictionary of file names and the file data as a bytestring. Args: filename: If filename is None, then a dictionary of all attachments will be returned, where the key is the filename and the value is the content. Otherwise, a dictionary with just a single key - the filename - and its content will be returned. Returns: dictionary of filename -> Union[bytestring or List[ByteString]] If the filename exists multiple times a list of the different versions will be provided. ) rbrrfrrr\r7racontent)rTror]rgrrfrs&& rArkPdfDocCommon._get_attachmentss$=? ))EEE$55 # ,<==)1ZZ)?5::EUDIIdO%56<&%k&7>>-8->,? )%,,U]];(- K%**rCc<V^8dQhRS[RS[S[,3,RS[RS[S[,3,RS[S[S[3,/#)r9includeNexcluder<)r rrYrr )r@rNs"rArBrsM  tXc]*+ tXc]*+  c3h  rCc R#)z Integration into Jupyter Notebooks. This method returns a dictionary that maps a mime-type to its representation. .. seealso:: https://ipython.readthedocs.io/en/stable/config/integrating.html NrM)rTrtrus&&&rA_repr_mimebundle_PdfDocCommon._repr_mimebundle_s rCcz<V^8dQh/S[;R&S[S[S[,,;R&S[S[,;R&S[;R&#)r9rrrCr)rr r7rr )r@rNs"rArBrsH d:./6*%,rC)rr)NN)NNNN)F)NNN)FNNNrQ)?rrrrrrrrCrrrrrrfrrrrrrrrrr"rrHrRrBrhr\rrrsetterrrrrrrr+rrrrrrrr%r*r+rJrrVr]rbr[r\rkrw__annotate_func__rrrs@rArrsT F26O(,KI                 ))*11$##J..DGGX00d / /(8(8T==*##J$$LD D L:DD##88t(  J J C CEE>""rCc <V^8dQhRS[/#rar)r@rNs"rArBrs555rCc<R\VP44 R2#)zLazyDict(keys=))r7r`rSs&rA__str__LazyDict.__str__sTYY[ 12!44rC)rN) rrrrrRrrrrrrrs@rArZrZs7//$$##55rCrZ)OrFabcrcollections.abcrrrrrtypingr r r r rCr _pagerr _page_labelsrr_utilsrrr constantsrrrrrrrrrrrrdrr?rr errorsrrfiltersr genericr!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3generic._filesr4rr5r6xmpr7rHrJrrZrMrCrArs>BB$+> /. ":6+,+*),0]%*]%@B B J&5wsCx 5rC