HAi SSKrSSKrSSKJr SSKJr SSKJrJrJrJ r J r J r J r J r JrJrJr SSKJr SSKJrJr SSKJr SS KJrJrJr SS KJr SS KJ r! SS KJ"r"J#r#J$r$ SS KJ%r& SSKJ'r( SSKJ)r* SSKJ+r, SSKJ-r. SSK/J0r0J1r1 SSK2J3r3J4r4J5r5J6r6J7r7J8r8J9r9J:r:J;r;Jr>J?r?J@r@JArAJBrBJCrCJDrDJErE SSKFJGrG SSKHJIrIJJrJ SSKKJLrL S\MS\NS\\N\\S444SjrO"SS\75rP"SS5rQ"S S!\ \\45rRg)"N)abstractmethod)datetime) AnyDict GeneratorIterableIteratorListMappingOptionalTupleUnioncast) Encryption) PageObject _VirtualList) index2label)deprecate_with_replacementlogger_warningparse_iso8824_date)CatalogAttributes)CatalogDictionary)CheckboxRadioButtonAttributesGoToActionArgumentsUserAccessPermissions)Core)DocumentInformationAttributes)FieldDictionaryAttributes)PageAttributes)PagesAttributes) PdfReadError PyPdfError) ArrayObject BooleanObjectByteStringObject DestinationDictionaryObjectEncodedStreamObjectFieldFit FloatObjectIndirectObject NameObject NullObject NumberObject PdfObjectTextStringObject TreeObjectViewerPreferencescreate_string_objectis_null_or_none) EmbeddedFile) OutlineType PagemodeType)XmpInformationdsizereturn.clUS:a [S5eSU-nUSSn[R"SU5S$)NzInvalid size in convert_to_intsiz>qr)r"structunpack)r;r<s M/var/www/html/land-ocr/venv/lib/python3.13/site-packages/pypdf/_doc_common.pyconvert_to_intrC`s@ ax;<<+a/A "#A ==q !! $$c\rSrSrSrSSjrS\S\\4Sjr\ S\\4Sj5r \ S\\4S j5r \ S\\4S j5r \ S\\4S j5r \ S\\4S j5r\ S\\4S j5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5r\ S\\4Sj5rSrg)DocumentInformationhaY 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. r=Nc0[R"U5 gN)r(__init__selfs rBrJDocumentInformation.__init__ws!!$'rDkeycURUS5n[U[5(aU$[U[5(a [ U5$grI)get isinstancer2r&str)rLrNretvals rB _get_textDocumentInformation._get_textzs@#t$ f. / /M f. / /v; rDcUR[R5(aSUR[R5=(d- UR[R5R 5$S$)z Read-only property accessing the document's title. Returns a ``TextStringObject`` or ``None`` if the title is not specified. N)rPDITITLErT get_objectrKs rBtitleDocumentInformation.titlesSxx!! NN288 $ G(:(E(E(G  rDc@UR[R5$)z>The "raw" version of title; can return a ``ByteStringObject``.)rPrWrXrKs rB title_rawDocumentInformation.title_rawsxx!!rDc@UR[R5$)z Read-only property accessing the document's author. Returns a ``TextStringObject`` or ``None`` if the author is not specified. )rTrWAUTHORrKs rBauthorDocumentInformation.authors~~bii((rDc@UR[R5$)z?The "raw" version of author; can return a ``ByteStringObject``.)rPrWr`rKs rB author_rawDocumentInformation.author_rawsxx ""rDc@UR[R5$)z Read-only property accessing the document's subject. Returns a ``TextStringObject`` or ``None`` if the subject is not specified. )rTrWSUBJECTrKs rBsubjectDocumentInformation.subjects~~bjj))rDc@UR[R5$)z@The "raw" version of subject; can return a ``ByteStringObject``.)rPrWrgrKs rB subject_rawDocumentInformation.subject_rawxx ##rDc@UR[R5$)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. )rTrWCREATORrKs rBcreatorDocumentInformation.creators~~bjj))rDc@UR[R5$)z@The "raw" version of creator; can return a ``ByteStringObject``.)rPrWrorKs rB creator_rawDocumentInformation.creator_rawrmrDc@UR[R5$)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. )rTrWPRODUCERrKs rBproducerDocumentInformation.producers~~bkk**rDc@UR[R5$)zAThe "raw" version of producer; can return a ``ByteStringObject``.)rPrWrvrKs rB producer_raw DocumentInformation.producer_rawxx $$rDcR[UR[R55$)z:Read-only property accessing the document's creation date.)rrTrW CREATION_DATErKs rB creation_date!DocumentInformation.creation_dates"$..1A1A"BCCrDc@UR[R5$)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. )rPrWr~rKs rBcreation_date_raw%DocumentInformation.creation_date_rawsxx(())rDcR[UR[R55$)z| Read-only property accessing the document's modification date. The date and time the document was most recently modified. )rrTrWMOD_DATErKs rBmodification_date%DocumentInformation.modification_dates"$.."=>>rDc@UR[R5$)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. )rPrWrrKs rBmodification_date_raw)DocumentInformation.modification_date_rawsxx $$rDc@UR[R5$)z Read-only property accessing the document's keywords. Returns a ``TextStringObject`` or ``None`` if keywords are not specified. )rTrWKEYWORDSrKs rBkeywordsDocumentInformation.keywordss~~bkk**rDc@UR[R5$)zAThe "raw" version of keywords; can return a ``ByteStringObject``.)rPrWrrKs rB keywords_raw DocumentInformation.keywords_rawr|rD)r=N)__name__ __module__ __qualname____firstlineno____doc__rJrRr rTpropertyrZr]rardrhrkrprsrwrzrrrrrrr__static_attributes__rrDrBrFrFhs (SXc]  x}    "8C="") ))#HSM##*#**$Xc]$$ *# * *$Xc]$$ +(3- + +%hsm%%Dx1DD*8C=**?8H#5??%x}%%+(3-++%hsm%%rDrFcZ\rSrSr%SrSr\\S'Sr\ \ \ \S'Sr \ \ \S'Sr\\S'\\S \4S j55r\\S \4S j55r\S \\\4S \ \4S j5r\S\S\S \4Sj5r\\S \ \4Sj55r\S \ \4Sj5r\S \ \4Sj5r\S \ \ 4Sj5r!S \4Sjr"S\S \ 4Sjr#S\S \$\\44Sjr%\S \&\\'44Sj5r(S \)4Sjr*SYS\\+S4S\ \&\\'4S \&\\'44Sjjr,SZS\ \+S\ \&\-\-4S\ \-S\ \ \S \ \&\\-44 S jjr.S!\S \4S"jr/S#\\+\4S\&\-\-4S\-S$\-S\ \S S4 S%jr0S\\+\4S\-S\-S\ \S S4 S&jr1S\-S#\-S$\-S S4S'jr2S[S(\S \&\\-44S)jjr3S#\\4\\4S \ \ 4S*jr5\S \S\'\6\744S+j5r8\8RrS,\S\\'\ 4S S4S-j5r8\S \:4S.j5r;SYS/\ \S0\ \-S \:4S1jjr<\S \ \)4S2j5r=\S \S\\>\4S \ \4S3j5r?S4\ S \ \4S5jr@S6\'S \ \4S7jrAS8\S9\ \ \\B\S\>\4S \'4S:jrCS/\S \ \'4S;jrD\S \ \ 4S<j5rE\S \ \4S=j5rF\S \ \4S>j5rG\S \ \H4S?j5rIS\S@\SA\S\\ 4SB\ \&\\-4S \ \S S4 SCjjrJS[S4\\\ \4SD\S S4SEjjrKSF\SG\S \ \4SHjrLSI\S \&\\44SJjrM\S \ \N4SKj5rO\\S \4SLj55rP\S \ \&\\-44SMj5rQ\S \R\\ \S44SNj5rT\S \U\VSS44SOj5rWS \ \4SPjrXSQ\S \ \S4SRjrYS]SS\ \S \&\\\S\ \S444STjjrZ\SYSU\S\[\4SV\S\[\4S \&\\-44SWjj5r\SXr]g)^ PdfDocCommoniza Common functions from PdfWriter and PdfReader objects. This root class is strongly abstracted. FstrictNflattened_pages _encryption _readonlyr=cgrIrrKs rB root_objectPdfDocCommon.root_object rDcgrIrrKs rB pdf_headerPdfDocCommon.pdf_headerrrDindirect_referencecgrIrrLrs rBrYPdfDocCommon.get_object! rDindirectobjcgrIr)rLrrs rB_replace_objectPdfDocCommon._replace_object' rDcgrIrrKs rB_infoPdfDocCommon._info+rrDcl[5nURcgURUR5 U$)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)rFrupdate)rLrSs rBmetadataPdfDocCommon.metadata0s.%& ::  djj! rDcgrIrrKs rB xmp_metadataPdfDocCommon.xmp_metadata?rrDcURR[RS5nUcgUR 5n[ U[ 5(dl[ U5n[US5(a+URbURURU5 U$XR[[R5'U$)zCReturns the existing ViewerPreferences as an overloaded dictionary.Nr) rrPCDVIEWER_PREFERENCESrYrQr4hasattrrrr.)rLos rBviewer_preferencesPdfDocCommon.viewer_preferencesCs    !6!6 = 9 LLN!.//!!$Aq.//A4H4H4T$$Q%9%91=GH  B,A,A!BCrDcUR(aURSS$URcURUR5 URce[ UR5$)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_encryptedrr_flattenrlenrKs rB get_num_pagesPdfDocCommon.get_num_pagesRsb   ##H-h7 7    ' MM$.. )##///4''((rD page_numbercURcURUR5 URcS5eURU$)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)rLrs rBget_pagePdfDocCommon.get_pagegsH    ' MM$.. )##/@@/##K00rDc^^^[[URS5mS[S[S[[ [ [44UUU4SjjmT"TS5up#[U[5(dS5eX#4$)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. rnodemir=c>[[URSS55nUSS:XaTU:XaUS4$SUS-4$TU- U:aUT :XaT S4$SX-4$[[[US55HBup4[[ UR 55nT"XA5upVUbUS:aX4s $XV4s $UnMD [S5e) Nrrz/Type/Page/Kidsrz"Unexpectedly cannot find the node.)rintrP enumerater$r(rYr#) rrmaidxkidnirrecursive_calltops rBr6PdfDocCommon._get_page_in_node..recursive_callsc488Ha01BG}'"$8OR!V|#b R'3;7NRW}$%d;W &FG+S^^-=>%c.=1u#y(4KHAB BrDrmypy)rr(rrr r r1rQ)rLrrrrrs ` @@rB_get_page_in_nodePdfDocCommon._get_page_in_nodeys#T%5%5h%?@ C" C(+ C 8I&+ , C C.#3* $ 0119691yrDc"UR5$)z8A read-only dictionary which maps names to destinations.)_get_named_destinationsrKs rBnamed_destinationsPdfDocCommon.named_destinationss++--rDc[5n[RUR;Ga[ UR[R[ 5(GaU[ [ UR[R5n[RU;a[ U[R[ 5(a[ [ U[R5nURn[RU;a#[ [U[R5nU$[5nX[[R5'U$[US5(aQ[ 5nURU5nXB[[R5'X[[R5'U$[US5(a[ 5nURU5nXPR[[R5'[ 5nURU5nXB[[R5'X[[R5'U$)N _add_object) r$CANAMESrrQr(rDESTSrr.rr)rL named_destnamesdests dests_ref names_refs rBget_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& 'rDtreerSc<Uc0nURn[RU;a"[[U[R5nOj[R U;aV[[ U[R 5n[RU;a![[U[R5n[U5(aU$UcS5e[RU;aJ[[U[R5H#nURUR5U5 M% U$[R U;a[[ U[R 5nSnU[U5:aXFR5nUS- n[U[[ 45(dMC[!U5nXFR5n US- n[U [ 5(aSU ;aU Sn OMUR%X5n U bXU'U[U5:aMU$UR'5H`upU R5n [U [ 5(aSU ;aU SR5n OMFUR%X5n U cM\XU 'Mb U$!["a U$f=f)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. rrr/D)rrrrr3rr(r6PAKIDSr$rrYrrQbytesrR IndexError_build_destinationitems)rLrrScatalogrrr original_keyrNvaluedestk__v__vals rBr$PdfDocCommon._get_named_destinationssH >F&&Gxx7"J(9:W$-wrxx/@A88u$ E"((O:EAc%j.$x224 Q!, ==,'!H//1EQe%566u} %d  ..s:#"&3K%c%j.< !JJLnn&c#344s{!$i224 ..s8#"&3K) -"* -s2J JJfileobjstackc^[R"5nUR[R"55 UcN0nURn/n[ R U;a)[[[U[ R 5mOgTcU$UceST;aA[[TS5nUH&nUR5n URXX5U5 M( U$[U4SjU55(aURTX#XT5 U$)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,># UH oT;v M g7frIr).0attrrs rB *PdfDocCommon.get_fields..=s;*:$*:)FAattributes_dictrrrr ACRO_FORMrr r3r$rY _build_fieldany) rLrrSrrfield_attributesrfieldsffields ` rB get_fieldsPdfDocCommon.get_fieldss4--/ = M M OP >F&&GE||w&HZ0'",,2GH <M    +tI7F !!%ER  ;*:; ; ;   dF5E M rDparentc SU;a[[US5$SU;aFUR[[US55S-[[UR SS55-$[[UR SS55$)N/TM/Parent./T)rrR_get_qualified_field_namer(rP)rLrs rBr&PdfDocCommon._get_qualified_field_nameBs F?VE]+ +  ..)6)+<=sFJJtR01 2 CD"-..rDrrc^[U4SjS55(agURT5nU(a$URUTU5 URS5 [ T5X&'X&R R 5nUR[RS5S:Xa*U[[R5X&[S5'UR[RS5S:XaqSU;ak[[USS R555X&[S5'S X&S;a(X&[S5R[S 55 GOtUR[RS5S:XGaOUR[R S 5[R"R$-S :wGa/n[U5X&[S5'UR[R&05Hjn U R 5n [U SS R55Hn X;dM URU 5 M [U5X&[S5'Ml UR[R S 5[R"R(-S :wa'S X&S;aX&SX&SR+S 5 UR-TX#U5 g) Nc3,># UH oT;v M g7frIr)rr rs rBr ,PdfDocCommon._build_field..Ws;]T5 ]r )rr r/Chz /_States_/Btnz/APz/Nz/Offr)allr _write_fieldwriter*rrYrPr FTr.Optr$listkeysappendFfFfBitsRadioKids NoToggleToOffindex _check_kids) rLrrSrrrrNrstateskss ` rBrPdfDocCommon._build_fieldOsN ;]; ; ; ,,U3    gu.> ? MM$ El k,,779 77255"  &36z"&&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 7rDcX;a#[URU5S3[5 gURU5 [R U;a=U[R H%nUR 5nURXRX45 M' gg)Nz already parsed)rrrr.rrrYr)rLrrSrrrs rBr5PdfDocCommon._check_kidsysv = 11$78H(   T 77d?BGG}nn&W<% rDcr[R"5nU[R"5-nUHnU[R[R4;aM)X5nU[R :Xa/SSSSS.nX%U;aUR USXrUS35 MoMqU[R:Xa/X%[RnUR USUS35 MUR USX%S35 M g![a X%[RnNXf=f![a GMf=f)NButtonTextChoice Signature)r&/Txr%z/Sig: r$) r  attributesrr2AAr*r)ParentTMKeyErrorT) rLrrrfield_attributes_tupler  attr_nametypesnames rBr(PdfDocCommon._write_fields;!# "%B%M%M%O O +D(.I 255=!)%' + E {e+  2e$K6H5I&LM,RYY&1${2551MMYKr$r":;MMYKr%+b"AB5+,$1${24401   sB?D'!D'6D D'$D'D$!D'#D$$D'' D65D6full_qualified_namec jS[S[[[4S[4SjnUR5nUc0$0nUR 5HcupVUR S5S:XdMU(aUR S5XE'M8UR S5XB"[ [US5U5'Me U$) 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, ... r7rr=cb^TU;aT$TS-[[U4SjU55S-5-$)Nrc3\># UH!oRTS-5(dMSv M# g7f)rrN) startswith)rkkr7s rBr IPdfDocCommon.get_form_text_fields..indexed_key..s Gf a#g0F!!fs, ,)rRsum)r7rs` rB indexed_key6PdfDocCommon.get_form_text_fields..indexed_keys=cGfGG!KLM rD/FTrAz/Vr)rRrrrrrPr)rLrNrW formfieldsffrrs rBget_form_text_fields!PdfDocCommon.get_form_text_fieldss  3 S#X 3 __&  I &,,.LEyy5(& % $BIBG))D/B{4U4[#92>? /  rDc ^S[S[S[4U4Sjjm[[URR 55n[T"US55(a [S5e/nURS S 5S :XaZS U;aUS R 5/nOURVs/sH'nURURS S 5;dM%UPM) nnOURSS5nUHnUR 5nURS S 5S :XdM+SU;dM3S U;aX6S R 5/- nMQUURVs/sH'nURURS S 5;dM%UPM) sn- nM UVs/sHBn[U[5(aUO'URURUR5PMD sn$![ an[S5UeSnAff=fs snfs snfs snf)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). rrNr=ct>X;aX$SU;a(T"[[USR55U5$g)Nr)rr(rY)rrN_get_inheriteds rBr`._get_inheritedsCzxC%)3y>+D+D+FGrDzField type is invalidNrYzField is not validz/Subtyperz/Widgetz/Pz/Annotsrrr)r(rRrrrrY Exception ValueErrorr6rPpagesrQr_get_page_number_by_indirect) rLrexcretpkidsr7xr`s @rBget_pages_showing_field$PdfDocCommon.get_pages_showing_fields.  0 s s  ?)5+C+C+N+N+PQE >%7 8 812 2 99Z $ 1u}T{--/0"ZZ'//155B3GG' 99Wb)DLLNEE*b)Y6T]qy$ 2 2 455%)ZZ %/ 33quuY7KK%/    !Z(( **T>>q?S?STU W   9 ?453 > ?   s6(G($G2G2 $G75G7A G< G/ G**G/cSUR;agURSn[U[5(aUR5n[U[5(a [ U5$[U[ 5(a&Utp#n[U[U55n[SX%5$g![an[SUSU35eSnAff=f)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 rB) rrQrdecoderRr5r$r+tupler'rb)rLoapagetyparrayfitrfs rBopen_destinationPdfDocCommon.open_destinations  0 0 0""=1 b% B b#  '+ + b+ & & D$&!E#uU|,"<;; D"6rd"SE BCC Ds<$B"" C,B==Crc[S5e)NzNo setter for open_destination)NotImplementedError)rLrs rBrvrw;s!"BCCrDc"UR5$)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_outlinerKs rBoutlinePdfDocCommon.outline?s  ""rDrr|cXUc/nURn[RU;aa[[U[R5n[ U[ 5(aU$[U5(dSU;a[[US5nUR5Ul UcU$URU5nU(aURU5 SU;a=/nUR[[US5U5 U(aURU5 SU;aU$[[US5nM)Nz/Firstz/Next) rCOOUTLINESrr(rQr/r6r_named_destinations_build_outline_itemr.r{)rLrr|rlines outline_obj sub_outlines rBr{PdfDocCommon._get_outlineHs ?G&&G{{g%-wr{{/CDeZ00"N'u--(e2C 0%/BD'+'C'C'ED $ <N2248K{+4)+ !!$'7h"H+VNN;/d"($w-8DrDc~URn[RU;a[SU[R5$g)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)rLrs rBthreadsPdfDocCommon.threadsqs4 "" ::  wrzz':; ;rDcgrIrrs rBre)PdfDocCommon._get_page_number_by_indirectrrDrrc8URUR5$)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 )rer)rLrrs rBget_page_numberPdfDocCommon.get_page_numbers001H1HIIrD destinationc8URUR5$)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 )rerr)rLrs rBget_destination_page_number(PdfDocCommon.get_destination_page_numbers001A1ABBrDrZrtc Sup4[U[[45(d'[U[5(a[ U5S:XdUc)[5n[ X[ R"55$Utp4n[ X[ XBS95$![ar [SUSU3[5 UR(aeURSRnUc [5OUn[ X[ R"55s$f=f)NNNr)fit_typefit_argszUnknown destination:  )rQr/rRr$rr'r+rur"rrrrdr)rLrZrtrrrstmprs rBrPdfDocCommon._build_destinations  uz3/ 0 05+..3u:?}.s<`U_PQ[^^U_sz/Frrz /%is_open%)rrGrr"r(r.rSDrQr$rrRr dest_arrayrrr%rPrrAttributeError)rLrrrZ outline_itemaction action_types rBr PdfDocCommon._build_outline_items$4!\ X/E 4<*DJ7Fz62E2G2G+HIKg%&((F2!"5"7"78D[[&)Nth'WXX _=D$ 011ddlDz dK ( (225?L c " " D#6633D9DD  \ 225?L{{"%=I> JJcB[URUR5$)a Property that emulates a list of :class:`PageObject`. 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. )rrrrKs rBrdPdfDocCommon.pagessD.. >>rDc|[[UR55Vs/sHn[X5PM sn$s snf)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. )rangerrdpage_index2page_label)rLrs rB page_labelsPdfDocCommon.page_labels#s19>c$**o8NO8N1%d.8NOOOs9cz[[UR[R5$![ a gf=f)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)rr.rr PAGE_LAYOUTrGrKs rB page_layoutPdfDocCommon.page_layout-s5.  D$4$4R^^$DE E  s *- ::cBURS$![a gf=f)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)rrGrKs rB page_modePdfDocCommon.page_modeIs** ##K0 0  s   list_onlyrdinheritc:[[R5[[R5[[R5[[R 54nUc0nUcRUR nURS5R5n[U[5(d [S5e/Ul [RU;a"[[ U[R5nO[R"U;aSnOSnUS:XaUHnX;dM X(X8'M [[$U[R"5HLn 0n [U [&5(aXS'U R5n U (dM7UR("XU40U D6 MN gUS:XacUR-5HupX;dM XU 'M [/X5nU(dUR1U5 URR3U5 gg![*a [S5ef=f)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 /Pagesrrz7Maximum recursion depth reached during page flattening.)r.PG RESOURCESMEDIABOXCROPBOXROTATErrPrYrQr(r"rrTYPErrRrr$r-rRecursionErrorrrrr.)rLrrdrrinheritable_page_attributesrtr rraddtrattr_inrpage_objs rBrPdfDocCommon._flattencs6 r|| $ r{{ # rzz " ryy ! ' # ?G =&&GKK)446Ee%566"#=>>#%D 77e S%.)A WWE !AA =3=$)KGM4[%.9dN3315-.oo'3 igFF:'\")--/'%*'N #2 "$;H&  ' ' 1 **Us HHcleancURcURUR5 URce[U[5(a8UR 5n[U[ 5(d[S[5 gUn[U[5(dURRU5nSUs=::a[UR5:dO [S[5 gURURnURU U(aUbURU[!55 ggg![a [S[5 gf=f)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 pagezCannot find page in pagesrzPage number is out of range)rrrrQr-rYrrrrr4rcrrdrrr/)rLrrrrhinds rB remove_pagePdfDocCommon.remove_pages&    ' MM$.. )##/// dN + +!Aa,,I8TD$$$ ++11$7T5C 4 455 8( C jj11 JJt  S_  jl 3%5 :HE sD66EEnumgenc6[XU5R5$)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-rY)rLrrs rB_get_indirect_object!PdfDocCommon._get_indirect_objectsc-88::rDpermissions_codec p[SSSS9 [R[R[R[R [R [R[R[RS.nUR5VVs0sH up4X1U-S:g_M snn$s snnf)z>Take the permissions as an integer, return the allowed access.decode_permissionsuser_access_permissionsz5.0.0)old_namenew_name removed_in)printmodifycopy annotationsforms accessabilityassembleprint_high_qualityr) rrPRINTMODIFYEXTRACT ADD_OR_MODIFYFILL_FORM_FIELDSEXTRACT_TEXT_AND_GRAPHICS ASSEMBLE_DOCPRINT_TO_REPRESENTATIONr)rLrpermissions_mappingrNflags rBrPdfDocCommon.decode_permissionss #). +00+22)110>>*;;2LL-::"7"O"O  1668 8  D(A- -8   sB2c\URcg[URR5$)zWGet the user access permissions for encrypted documents. Returns None if not encrypted.N)rrPrKs rBr$PdfDocCommon.user_access_permissions s*    #$T%5%5%7%788rDcg)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. NrrKs rBrPdfDocCommon.is_encrypteds rDcSn0nURnSU;d US(dg[[US5nSU;a[[US5n[ U5nUHynUn[ U5n[ U[5(dM'[[[UR55nU(dMU[R"UR5n XU'M{ U$)Nz /AcroFormz/XFA)rrr3r$iternextrQr-r r)rYzlib decompress_data) rLrrSrrrrtagress rBxfaPdfDocCommon.xfas%)!#"" g %W[-AJ 45 T>+tF|4FV AGa00 *=!> OEu!__U[[9&(s  rDcx[UR5Vs0sHnXRU4_M sn5$s snf)z1Mapping of attachment filenames to their content.)LazyDict_list_attachments_get_attachment_list)rLrLs rB attachmentsPdfDocCommon.attachments5sJ!224 4D00$774    s7c#`# [R"UR5ShvN gN7f)zIterable of attachment objects.N)r7_loadrrKs rBattachment_listPdfDocCommon.attachment_list?s! %%d&6&6777s $.,.c/nURHUnURUR5 UR=o2R:wdM;U(dMDURU5 MW U$)zW Retrieves the list of filenames of file attachments. Returns: list of filenames )rr.rLalternative_name)rLrentryrLs rBrPdfDocCommon._list_attachmentsDsU))E LL $...::=$$ T"* rDrLc^URU5Un[U[5(aU$U/$rI)_get_attachmentsrQr,)rLrLouts rBr!PdfDocCommon._get_attachment_listSs0##D)$/ c4 Ju rDfilenamec0nURHn[5nURnUbBXRU1;a/XR:Xa UROUnUR U5 OM^URU1nUHXnUcMXb;a=[ X&[ 5(dX&/X&'X&RUR5 MJURX&'MZ M U$)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. ) rsetrrLaddrQr,r.content)rLr rrrrrLs rBrPdfDocCommon._get_attachmentsYs$=? ))EEE$55 # ,<==)1ZZ)?5::EUDIIdO%56<&%k&7>>-8->,? )%,,U]];(- K%**rDincludeexcludecg)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 Nr)rLrrs rB_repr_mimebundle_PdfDocCommon._repr_mimebundle_s rD)rrr)NNNN)F)FNNNrI)^rrrrrrbool__annotations__rr r rrrrrrr(rrRrrrr-r1rYrrrFrr:rr4rrrr rrr'rr$rr3rrrrrr5r(r\r*rkr2r&rvsetterr8r|r{rr/rerrr0rrrdrrr9rrrrrrrrrr rrrr7rrrrrrrrrDrBrrs' FD26OXd:./6(,K*%,It  -   C   "'^(;"< )     Y 9   x 01   (#67   h~6   H->$?  )s)*1C1J1$## $ %#J.Dk)9$:..[H)-37FJ$%Fc;./0F c;  FZ&*+/!%+/ 0z"0c3h(0# 0 Y( 0 $sCx. ! 0d /0@ /S /(8Z!112(8S#X(8 (8  (8 I (8 (8T=J 001== = I =  =&#C##s#t#J$$cSVh$LD 5)^;<D j D L t["24DD E:DU4k:+M%NDSWDD###QU'-.'@H ' 'R+.( "'c:~(M"N #  JJ J8C= J C{ CxPS} CEE lND*FVVW  E E>""rDc<S[UR55S3$)NzLazyDict(keys=))r,r-rKs rB__str__LazyDict.__str__sTYY[ 12!44rD)r)rrrrrrJrRr r r%rr(r,rrrDrBrrsW/c/S/T/ss$(3-$##55rDr)Sr@rabcrrtypingrrrrr r r r r rrrr_pagerr _page_labelsrr_utilsrrr constantsrrrrrrrrrrrWrr r rr!rerrorsr"r#genericr$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6generic._filesr7rKr8r9xmpr:rrrCrFrrrrDrBr8s>     $+> /. ":6+,,*),%e%3%5eCHo1E+F%]%*]%@K K \$5wsCx 5rD