j ddlZddlmZmZddlmZmZmZmZddl m Z ddl m Z m Z m Z mZmZmZddlmZddlmZdd lmZmZdd lmZdd lmZmZmZmZm Z dd l!m"Z#dd l!m$Z$m%Z%m&Z&m'Z'm(Z(ddl!m)Z*ddl!m+Z,ddl!m-Z.ddl/m0Z0m1Z1m2Z2ddl3m4Z4ddl5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGddlHmIZIddlJmKZKmLZLddlMmNZNdeOdePdeePeQe dfffdZRe@e.jSe@e.jTe@e.jUe@e.jVfZWGdde ZXeQeXeeBfZYeZZ[Gdde:Z\Gd d!eZ]Gd"d#ee e fZ^dS)$N)ABCabstractmethod)IterableIteratorMappingSequence)datetime)Any NamedTupleNoReturnOptionalUnioncast)get_configuration) Encryption) PageObject _VirtualList) index2label)_TraversalStatedeprecate_no_replacementdeprecation_with_replacementlogger_warningparse_iso8824_date)CatalogAttributes)CheckboxRadioButtonAttributesCoreGoToActionArgumentsPagesAttributesUserAccessPermissions)DocumentInformationAttributes)FieldDictionaryAttributes)PageAttributes)LimitReachedError PdfReadError PyPdfError)_decompress_with_limit) ArrayObject BooleanObjectByteStringObject DestinationDictionaryObjectEncodedStreamObjectFieldFit FloatObjectIndirectObject NameObject NullObject PdfObjectTextStringObject TreeObjectViewerPreferencescreate_string_objectis_null_or_none) EmbeddedFile) OutlineType PagemodeType)XmpInformationdsizereturn.c|dkrtdd|z}|dd}tttjd|dS)NzInvalid size in convert_to_intsiz>Qr)r%rintstructunpack)r>r?s /Users/tedpeters/Documents/Projects/Claude Projects/TPC Houses/house-viewer/.venv/lib/python3.11/site-packages/pypdf/_doc_common.pyconvert_to_intrG]sR axx;<<<+a/A "##A V]4++A. / //cXeZdZUdZeed<eeefed<e e ed<e ed<dS) _PageTreeItemzJA page tree node waiting to be flattened by :meth:`PdfDocCommon._flatten`.nodeinheritindirect_referencedepthN) __name__ __module__ __qualname____doc__r,__annotations__dictstrr r r1rCrHrFrJrJnsPTT  #s(^ 0000 JJJJJrHrJceZdZdZddZdedeefdZedeefdZ edeefdZ edeefd Z edeefd Z edeefd Z edeefd Zedeefd ZedeefdZedeefdZedeefdZedeefdZedeefdZedeefdZedeefdZedeefdZedeefdZdS)DocumentInformationa 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@Nc.tj|dSN)r,__init__selfs rFr[zDocumentInformation.__init__s!$'''''rHkeyc||d}t|tr|St|trt |SdSrZ)get isinstancer5r*rU)r]r^retvals rF _get_textzDocumentInformation._get_textsQ#t$$ f. / / M f. / / v;; trHc|tjrP|tjp0|tjndS)z Read-only property accessing the document's title. Returns a ``TextStringObject`` or ``None`` if the title is not specified. N)r`DITITLErc get_objectr\s rFtitlezDocumentInformation.titlesRxx!! DNN28 $ $ G(:(:(E(E(G(G rHc@|tjS)z>The "raw" version of title; can return a ``ByteStringObject``.)r`rerfr\s rF title_rawzDocumentInformation.title_rawsxx!!!rHc@|tjS)z Read-only property accessing the document's author. Returns a ``TextStringObject`` or ``None`` if the author is not specified. )rcreAUTHORr\s rFauthorzDocumentInformation.authors~~bi(((rHc@|tjS)z?The "raw" version of author; can return a ``ByteStringObject``.)r`rerlr\s rF author_rawzDocumentInformation.author_rawsxx """rHc@|tjS)z Read-only property accessing the document's subject. Returns a ``TextStringObject`` or ``None`` if the subject is not specified. )rcreSUBJECTr\s rFsubjectzDocumentInformation.subjects~~bj)))rHc@|tjS)z@The "raw" version of subject; can return a ``ByteStringObject``.)r`rerqr\s rF subject_rawzDocumentInformation.subject_rawxx ###rHc@|tjS)ac 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. )rcreCREATORr\s rFcreatorzDocumentInformation.creators~~bj)))rHc@|tjS)z@The "raw" version of creator; can return a ``ByteStringObject``.)r`rerwr\s rF creator_rawzDocumentInformation.creator_rawrurHc@|tjS)aI 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. )rcrePRODUCERr\s rFproducerzDocumentInformation.producers~~bk***rHc@|tjS)zAThe "raw" version of producer; can return a ``ByteStringObject``.)r`rer|r\s rF producer_rawz DocumentInformation.producer_rawxx $$$rHcZt|tjS)z:Read-only property accessing the document's creation date.)rrcre CREATION_DATEr\s rF creation_datez!DocumentInformation.creation_dates!"$..1A"B"BCCCrHc@|tjS)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`rerr\s rFcreation_date_rawz%DocumentInformation.creation_date_rawsxx()))rHcZt|tjS)z Read-only property accessing the document's modification date. The date and time the document was most recently modified. )rrcreMOD_DATEr\s rFmodification_datez%DocumentInformation.modification_dates "$.."="=>>>rHc@|tjS)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`rerr\s rFmodification_date_rawz)DocumentInformation.modification_date_rawsxx $$$rHc@|tjS)z Read-only property accessing the document's keywords. Returns a ``TextStringObject`` or ``None`` if keywords are not specified. )rcreKEYWORDSr\s rFkeywordszDocumentInformation.keywordss~~bk***rHc@|tjS)zAThe "raw" version of keywords; can return a ``ByteStringObject``.)r`rerr\s rF keywords_rawz DocumentInformation.keywords_rawrrH)r@N)rOrPrQrRr[rUr rcpropertyrhrjrmrorrrtrxrzr}rr rrrrrrrVrHrFrXrXs  ((((SXc]  x}    X  "8C="""X") )))X)#HSM###X#*#***X*$Xc]$$$X$ *# * * *X *$Xc]$$$X$ +(3- + + +X +%hsm%%%X%Dx1DDDXD*8C=***X*?8H#5???X?%x}%%%X%+(3-+++X+%hsm%%%X%%%rHrXc eZdZUdZdZeed<dZee e ed<dZ ee ed<dZ eed<eedefd Zeedefd Zed eeefdeefd Zed ed edefdZeedeefdZedeefdZeedeefdZedeefdZ defdZ!dede fdZ"dede#eeffdZ$ede%ee&ffdZ'de(fdZ)dddddeedee%ee&fdee*ede%ee&ffdZ+ddde,fdddddeedee%e-e-fd ee-d!e-d"ee*ed#ed$ee.dee%ee-ffd%Z/dd&d'edee*edefd(Z0e1d)e-defd*Z2d+ee3efde%e-e-fd e-d,e-de*ed-ed.e.ddfd/Z4dee3efde-d e-de*ed-ed.e.ddfd0Z5d e-d+e-d,e-ddfd1Z6ddd2ede%ee-ffd3Z7d+ee8eefde e fd4Z9edee&e:e;dffd5Zfd8Z?dddddd9d:eed;ee-dee*ed-ed.ee.de>f d<Z@edee(fd=ZAed eeeBedfdeefd>ZCd?e deefd@ZDdAe&deefdBZEdCeeeFfdDee(de&fdEZGd:edee&fdFZHedeIe fdGZJede efdHZKedeefdIZLedeeMfdJZNdddKeddfdLZOdMePdeQfdNZRd!e eQdOe*ed.e.deePfdPZSdMePdKede fdQZT ddd?eee efdReddfdSZUdTedUedeefdVZVdWedeWfdXZXedeeYfdYZZedeefdZZ[eedefd[Z\edee%ee-ffd\Z]ede^ee eFffd]Z_e`d^e eade eFfd_Zbedeceafd`Zde dedaeeeedfdbeeeedfde%ee-ffdcZfdS)f PdfDocCommonzm Common functions from PdfWriter and PdfReader objects. This root class is strongly abstracted. FstrictNflattened_pages _encryption _readonlyr@cdSrZrVr\s rF root_objectzPdfDocCommon.root_object.  rHcdSrZrVr\s rF pdf_headerzPdfDocCommon.pdf_header3rrHrMcdSrZrVr]rMs rFrgzPdfDocCommon.get_object8  rHobjcdSrZrV)r]rMrs rF_replace_objectzPdfDocCommon._replace_object>s rHcdSrZrVr\s rF_infozPdfDocCommon._infoBrrHcht}|jdS||j|S)a 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)rXrupdate)r]rbs rFmetadatazPdfDocCommon.metadataGs5%&& : 4 dj!!! rHcdSrZrVr\s rF xmp_metadatazPdfDocCommon.xmp_metadataVrrHc|jtjd}|dS|}t |t stdt|dSt |tsct|}t|dr#|j | |j |n!||jttj<|S)zCReturns the existing ViewerPreferences as an overloaded dictionary.Nz8Viewer preferences are not a dictionary: %(preferences)s)source preferencesrM)rr`CAVIEWER_PREFERENCESrgrar,rrOr7hasattrrMrr2)r]os rFviewer_preferenceszPdfDocCommon.viewer_preferences[s   !6 = = 94 LLNN!-..  J     4!.// H!!$$Aq.// HA4H4T$$Q%91====FG B,A!B!BCrHc|jr|jddS|j||j|jJt |jS)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_flattenrlenr\s rF get_num_pageszPdfDocCommon.get_num_pagesqs_   8#H-h7 7   ' MM$. ) ) )#///4'(((rH page_numberc|j||j|j Jd|j|S)a? 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. Nmypy)rrr)r]rs rFget_pagezPdfDocCommon.get_pagesF   ' MM$. ) ) )#/////#K00rHc@tt|jdtdtdtdt t ttfffd d\}}t|ts Jd||fS)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. r_nodemir@c^t|}| vrtd |tt|dd}|ddkr|kr|dfSd|dzfS|z |kr| kr dfSd||zfSt tt|dD]Q\}}tt| } ||\}}||dkr||fcS||fcS|}Rtd ) Nz8Detected cycle in /Pages hierarchy when retrieving page.rrz/Type/Page/Kidsrz"Unexpectedly cannot find the node.) idr$addrrCr` enumerater(r,rgr&) rr_node_idma_idxkidnirrecursive_calltopvisiteds rFrz6PdfDocCommon._get_page_in_node..recursive_calls\%yyH7""'(bccc KK ! ! !c599Xq1122Byy!!W,,"$$ "9$R!V|#b R''C<<7NR"W}$&tKw'H'HII   c+S^^-=-=>>%~c2..1=1uu$d{***a4KKKABB BrHrr) rr,rsetrCtupler r4ra)r]rrKidxrrrs ` @@@rF_get_page_in_nodezPdfDocCommon._get_page_in_nodes#T%5h%?@@EE C# C), C 8I&+ , C C C C C C C C C6#N3** c$ 011996991SyrHc*|S)z8A read-only dictionary which maps names to destinations.)_get_named_destinationsr\s rFnamed_destinationszPdfDocCommon.named_destinationss++---rHct}tj|jvrzt |jtjt rOt t |jtj}tj|vrt |tjt rt t |tj}tj|vr't t|tj}nGt}||ttj<nt|dr[t }| |}||ttj<||ttj<nt|drt }| |}||jttj<t }| |}||ttj<||ttj<|S)N _add_object) r(rNAMESrrar,rDESTSr2rr)r] named_destnamesdests dests_ref names_refs rFget_named_dest_rootz PdfDocCommon.get_named_dest_roots ]] 8t' ' 'J  RX &(8- - ')4+;BH+EFFEx5  ZbhAQ%R%R -uRX??8u$$!%k5?!C!CJJ!,J2D Z11 2$&&E((//I*3E*RX&& '*4E*RX&& 'rHtreerbrrrbrc|t}|i}|j}d}tj|vr%|tj}nytj|vrk|tj}t |tr2tj|vr$|tj}|.t |tstdt||S||}t|r|S| Jdt|}||vrtdt|S| |tj|vr|tj}t |tstdt||S|D],} || || -ntj|vrS|tj}t |tstd t| |Sd } | t#|kr|| } | d z } t | t$t&fsO || } n#t($rYnwxYw| d z } t | trd| vr | d} n|| | } | 0| |t-t&| d<| |t'| <| t#|kn|D]k\}}|}t |tr d|vr|d}nN|||} | | ||<l|S)aK Retrieve the named destinations present in the document. Args: tree: The current tree. retval: The previously retrieved destinations for nested calls. visited: Already known/visited objects. Returns: A dictionary which maps names to destinations. Nz.Destination tree is not a dictionary: %(tree)s)rrrz#Detected cycle in destination tree.rz0Destination tree kids are not an array: %(kids)s)rkidsrz2Destination tree names are not an array: %(names)s)rrrr/D/Title)rrrrrgrrar,rrOr9rrrKIDSr(rrbytesrU IndexError_build_destinationritems)r]rrbrcatalog candidatertree_idrrrr^valuedestk__v__vals rFrz$PdfDocCommon._get_named_destinationss& ?eeG >F&G.2Ix7""#BH-88:: W$$)4466e%566=28u;L;L %bh : : < ` object. By default, the mapping name is used for keys. ``None`` if form data could not be located. rz7.0.0)name removed_inNz)Reached maximum allowed form field depth. _incrementr@cfxj|z c_jjkrtddS)Nz*Exceeded maximum number of fields allowed.) entry_countform_fields_maximum_entriesr$)rr configurations rF_check_field_limitz3PdfDocCommon.get_fields.._check_field_limits@  ( (J 6 ( (+m.WWW'(TUUUXWrHz+AcroForm is not a dictionary: %(acro_form)s)r acro_formz/Fieldsz,AcroForm /Fields is not an array: %(fields)srfields)fieldrbrfield_attributesrrNtraversal_statec3 K|]}|vV dSrZrV).0attrrs rF z*PdfDocCommon.get_fields..s';;$;;;;;;rHr)_UNSETrrrmaprrform_fields_maximum_depthr$rrCFAattributes_dictrrr ACRO_FORMrgrar,rrOr(r _build_fieldany)r]rrbrrrrrrrrentryrrfrrs ` ` @rF get_fieldszPdfDocCommon.get_fieldsXsB    $'g F F F F!#"uuHCEKR$8$8 9 9:::)++ ]< < <#$OPP P  #.00  V3 V4 V V V V V V V -// = M O OPPP >F&GuuH|w&& -$)MDDu7G7G7I7I (/22(#E'"+  4 t <M###   )_//11Ffk22 B#!   s6{{ + + +   !!Rb$FDT"  ;;;;*:;;; ; ;   q ! ! !   67M] @P     rH)rparentc|t}t|}||vrtd||d|vrt t |dSd|vr]|t t|d|dzt t |ddzSt t |ddS)NzIDetected cycle in /Parent hierarchy when retrieving qualified field name./TMz/Parent)rr./T) rrr$rrrU_get_qualified_field_namer,r`)r]rr parent_ids rFrz&PdfDocCommon._get_qualified_field_names ?eeGvJJ   #$opp p I F??VE]++ +   .. 0&2CDD#/  sFJJtR0011 2 CD"--...rH appearancec |}t|tstd||d}||}t|tstd||S)z?Return the /N normal-appearance sub-dictionary of an /AP entry.z$Expected appearance dictionary, got z/NNz'Expected /N appearance dictionary, got )rgrar,r%r`)rnormals rF_normal_appearancezPdfDocCommon._normal_appearances **,, *&677 VTjTTUU U%%  &&((F&"233 USSSTT T rHrrrNrcttstdtdSt fddDrdS|}|r,||||dt||<||j } | tj ddkra| ttjr5| ttj||td <| tj dd krd | vr|| d } t#t%| ||td <d ||d vr;||td td n| tj dd kr| tjd tjjzd kreg} t#| ||td <| tjiD]} | } d | vrt3d| || d } t%| D]} | | vr| | t#| ||td <| tjd tjjzd kr>d ||d vr.||d ||d d =||||||dS)Nz)Form field is not a dictionary: %(field)s)rrc3 K|]}|vV dSrZrV)r r rs rFr z,PdfDocCommon._build_field..s(;;Tt5 ;;;;;;rH)rrr r/Chz /_States_/Btnz/APz/OffrzButton field kid missing /AP: )rrbrrrNr)rar,rrOallr _write_fieldwriter.rMrgr`rFTr2Optr"r(listkeysappendFfFfBitsRadioKidsr% NoToggleToOffindex _check_kids)r]rrbrrrrNrr^rr!stateskss ` rFrzPdfDocCommon._build_fields%!122  ;     F ;;;;];;; ; ;  F,,E,::    gu.> ? ? ? MM$   Ells Sk,7799 7725"   & &377:bf3E3E+F+F &36z"&7I7I3JF3K ;// 0 7725"   ' 'ESLL,,SZ88F3>tFKKMM?R?R3S3SF3K ;// 0VC[555s J{334;;Jvv3F3FF3K ;// 0WWRWb)) K KLLNN>>&'M'M'MNNN005::fkkmm,,))A a(((7B67J7Js J{3344q!!BI$;;q@@fSk+6663K ,VC[-E-K-KF-S-ST vwufu      rHc ^t|}||vr-tdt||dS||t j|vrG|t jD]6}|}||||||dz|5dSdS)Nz%(field_name)s already parsedr%)r field_namer)rrbrrrr) rrrOrrrrrgr) r]rrbrrrNrrrs rFr7zPdfDocCommon._check_kidssT(( g   /999FF     F G  4 ' 'O01  nn&&VW$UQY  ( '  rHctj}|tjz}|D]}|tjtjfvr||} |tjkr9ddddd}|||vr'||d|||dn|tjkr^ ||tj}n(#t$r||tj }YnwxYw||d|dn!||d||d#t$rYwxYwdS)NButtonTextChoice Signature)r(/Txr'z/Sig: r&) r attributesrr4AAr,r+ParentTMKeyErrorT) r]rrrfield_attributes_tupler  attr_nametypesrs rFr*zPdfDocCommon._write_field8s!# "%B%M%O%O O +  D(.I 25==!)%' + E T{e++ &L&LeE$K6H&L&L&LMMMRY&&1$T{251#111$T{2401MMY":":$":":":;;;;MMY"A"A%+"A"A"ABBB    7  s8AD--CD-"C+(D-*C++AD-- D;:D;full_qualified_namec dtdtttfdtfd}|}|iSi}|D]\}}|ddkrd|r|d||<9|d||t t|d ||<|S) 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, ... r9rr@cr|vrSdzttfd|DdzzS)Nrc3LK|]}|dzdVdS)rrN) startswith)r kkr9s rFr zIPdfDocCommon.get_form_text_fields..indexed_key..ss8GG a#g0F0FG!GGGGGGrH)rUsum)r9rs` rF indexed_keyz6PdfDocCommon.get_form_text_fields..indexed_keymsTcGGGGfGGGGG!KLLM rHN/FTrBz/Vr)rUrTr rrr`r)r]rMrU form_fieldsffrrs rFget_form_text_fieldsz!PdfDocCommon.get_form_text_fields]s  3 S#X 3    oo''  I '--// ] ]LE5yy5((&] % $BuIIMRYYW[__B{{4UYYtU-C-C#D#DbIIJ rHc ttjn"#t$r}t d|d}~wwxYwt ddrt dg}dddkr4d vrd g}nfd j D}nd d }|D]mdddkr=d vr9d vr|d gz }W|fdj Dz }nfd|DS)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). zField type is invalidNrV)r^defaultzField is not validz/Subtyperz/Widgetz/PcNg|]!}j|ddv|"Sz/AnnotsrrMr`)r prs rF z8PdfDocCommon.get_pages_showing_field..s?/155B3G3GGGGGGrHrrVrcNg|]!}j|ddv|"Sr]r^)r r_r9s rFr`z8PdfDocCommon.get_pages_showing_field..s?    ! 3quuY7K7KKKKKKrHcg|]>}t|tr|n$j|j?SrV)rarpages_get_page_number_by_indirectrM)r xr]s rFr`z8PdfDocCommon.get_pages_showing_field..sZ   !Z(( WAA*T>>q?STTU   rH) rr,rMrg Exception ValueErrorr9 get_inheritedr`rc)r]rexcretrr9s`` @rFget_pages_showing_fieldz$PdfDocCommon.get_pages_showing_fields, ?)5+C+N+N+P+PQQEE ? ? ?4553 > ? 5..5$.GG H H 3122 2 99Z $ $ 1 1u}}T{--//0!Z 99Wb))D  LLNNEE*b))Y66T]]qyy$ 2 2 4 455    %)Z             s,2 AA  Acd|jvrdS|jd}t|tr|}t|trt |St|t r\ |^}}}t|t|}td||S#t$r}td|d||d}~wwxYwdS)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 rC) rrardecoderUr8r(r/rr+rf)r]oapagetyparrayfitris rFopen_destinationzPdfDocCommon.open_destinations  0 0 04"=1 b%  B b#   ,'++ + b+ & &  M$&!cE#uU||,,"<s;;; M M M Br B BS B BCCL M4s<2B// C9CCrc td)NzNo setter for open_destination)NotImplementedError)r]rs rFrtzPdfDocCommon.open_destinations!"BCCCrHc*|S)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_outliner\s rFoutlinezPdfDocCommon.outlines  """rHrKryrrNrrKryc|t}|g}|j}tj|vrp|tj}t |r|St |t stdt||Sd|vrtt |d}| |_ ||St}||j krtd|d|j d|t} t!|} | |vrtdt| n7|| |xjd z c_|j|jkr td |jd|jdt |t std t| n||} | r|| d|vrcg} |} |tt |d| | |d z| | r|| d|vrntt |d}c|S)Nz(Outlines are not a dictionary: %(lines)s)rlinesz/FirstzMaximum outline depth reached:  > rTz0Detected cycle in outline structure for %(node)s)rrKrz%Maximum outline entry limit reached: z*Outline node is not a dictionary: %(node)srzz/Next)rrrOUTLINESr9rar,rrOrr_named_destinationsroutline_maximum_depthr$rrrroutline_maximum_entries_build_outline_itemr0copyrx) r]rKryrrNrrr|rnode_id outline_obj sub_outline inner_visiteds rFrxzPdfDocCommon._get_outlines  "-//O ?G&G}'' .#5))#"N!%)9::#"B'# #Nu$$ 0%/BBD'+'C'C'E'ED $ <N)++ =6 6 6#$ve$v$vP]Ps$v$v$vww w ?eeG* 9hhG'!!QZbimnnnn KK  ' '1 , ' '*]-RRR'`&2``7D7\``` d$455 @# 22488K ,{+++4)+ '  !!.X??')!)$3 "0NN;///d""($w-88DU* 9XrHcp|j}tj|vr td|tjSdS)uN 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)r]rs rFthreadszPdfDocCommon.threadsHs5 " <7 " " wt|'<== =trHcdSrZrVrs rFrdz)PdfDocCommon._get_page_number_by_indirect]rrHrpc6||jS)a 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 )rdrM)r]rps rFget_page_numberzPdfDocCommon.get_page_numbercs001HIIIrH destinationc6||jS)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 )rdrp)r]rs rFget_destination_page_numberz(PdfDocCommon.get_destination_page_numberqs001ABBBrHrhrrcd\}}t|trt|dkr0t}t ||t jS|^}}} t ||t ||S#t$ritdt|||j r|j dj }|tn|}t ||t jcYSwxYw)NNNrS)fit_typefit_argsz+Unknown destination: %(title)r %(fit_args)s)rrhrr) rar(rr3r+r/rsr%rrOrrcrM)r]rhrrrprqrtmprMs rFrzPdfDocCommon._build_destination~s  c%-- 7Ua<.s)@_@_TUQ@_@_@_@_@_@_rHz*Ignoring non-array outline color %(color)r)rcolorz/Frrz /%is_open%)rrr%r,rSr2Drar(rrUr dest_arrayrHrrOr.r)r`rKrMAttributeError)r]rKrrh outline_itemaction action_typers rFrz PdfDocCommon._build_outline_items$4!e\ t  X//EE{ X"#Vd#V#VWWWE 4<<*DJ77F"$..":v6I6K/LMM '))*,66%&9&;<]*+[SW+[+[\\\ U"#S4#S#STTT U __=D$ 011 "ddllDz dK ( ( @225$??LL c " " @ D#6643D9D    D D D#66udCC  D\ 225$??LL{ G"#ET#E#EFFF J      225$??L  t||T eT**5@@_@_Y^@_@_@_5_5_LD!1!122"D'# t||26d Z--.46:(^ Z1125B1%%*66LL11 2!  .2.EL + +    D s$&F F#"F# K-- K:9K:c6t|j|jS)a Property that emulates a list of :class:`PageObject`. This property allows to get a page or a range of pages. The returned object supports indexing, slicing, ``len()``, iteration and (for PdfWriter) ``del``, but it is not a :class:`list` - pages are looked up on demand rather than materialised up front, so list-only operations such as ``append()`` or concatenation with ``+`` are not available. 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. )rrrr\s rFrczPdfDocCommon.pagess(D. >>>rHc^fdttjDS)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. c0g|]}t|SrV)page_index2page_label)r rr]s rFr`z,PdfDocCommon.page_labels..s$OOO1%dA..OOOrH)rangerrcr\s`rF page_labelszPdfDocCommon.page_labels s0POOOc$*oo8N8NOOOOrHcz tt|jtjS#t $rYdSwxYw)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)rr2rr PAGE_LAYOUTrHr\s rF page_layoutzPdfDocCommon.page_layoutsC.  D$4R^$DEE E   44 s ), ::c@ |jdS#t$rYdSwxYw)a2 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)rrHr\s rF page_modezPdfDocCommon.page_mode0s7* #K0 0   44 s   list_onlyc@ t}d|_|jdt }t |tstdg}t}t}g}t|idd}|m|j |j kr td|j d|j d|j t j vr&t%t& t j} nht j vrX|jrNt- fd t.jt.jt.jfDstd d } nd} | dkrK|t9 |||n/| d kr)||||| |||}|m||_dS) a 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. The result is stored in ``self.flattened_pages``. 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. The page tree is walked with an explicit stack instead of recursion, so the traversal is bound by ``Configuration.page_tree_maximum_depth`` and ``Configuration.page_tree_maximum_entries`` only, not by the interpreter recursion limit. Args: list_only: If True, the page's own entries are not copied into the generated :class:`PageObject`. Attributes inherited from ancestor nodes are applied either way. Note that a page reached through an indirect reference is already populated by :class:`PageObject` itself, so this only has an effect for ``/Kids`` entries that are inline dictionaries. NrzInvalid object in /PagesrrKrLrMrNz!Maximum page tree depth reached: r}rc3 K|]}|vV dSrZrV)r r^rKs rFr z(PdfDocCommon._flatten..s'*h*h33$;*h*h*h*h*h*hrHz'Non-page object reached through /Kids: r)!rrrr`r3rgrar,r%rrrJrNpage_tree_maximum_depthr$rKrTYPErrUrrrPGCONTENTSMEDIABOXPARENTrrr0_enter_page_tree_node_flatten_leaf_page_pop_next_page_tree_kid) r]rrrcrr ancestor_idsritem node_typerKs @rFrzPdfDocCommon._flattenJs/8*++ # $$Xz||<<GGII%!122 ;9:: :,.)++"% &((5t1) ) ) zMAAA'o oo}Glooo 9D#t++ d?+?&@AA  %T11;[s*h*h*h*h2;PRP[]_]fBg*h*h*h'h'h[&'YQU'Y'YZZZ# $ H$$  D*** T77==>>>>g%%&&t'>'>tY'O'OPPP//|_UUD5: /rHrc|j}t|j}tD]}||vr ||||<|t jt}t|trt}n:t|ts%tdt|j d||t|fS)z Start walking an intermediate ``/Pages`` node: propagate its inheritable attributes and pair it with an iterator over its ``/Kids``. z#Expected /Kids to be an array, got r)rL)rKrTrL_INHERITABLE_PAGE_ATTRIBUTESr`rrr(rgrar3r%typerO_replaceiter)r]rrcrLr rs rFrz"PdfDocCommon._enter_page_tree_nodes  t|$$0 , ,Du}} %d  yy-{}}==HHJJ dJ ' ' ]==DDD+.. ][T$ZZEX[[[\\ \}}W}--tDzz99rHrc @t}|r|d\}}t|jdt}|D]}t|dt|krt d|} t | ts't| stdt| | st| |vrt d|xj dz c_ |j |j kr td|j d|j d t| |jt |t"r|nd |jdz cS||t|j|d S) a Return the next page tree node to flatten, leaving the ``/Pages`` nodes whose ``/Kids`` are exhausted, or ``None`` when the traversal is complete. Cyclic references and the configured page-tree entry limit are enforced here. rrMz Detected cyclic page references.zTake the permissions as an integer, return the allowed access.decode_permissionsuser_access_permissionsz5.0.0)old_namenew_namerN)r)r]rs rFrzPdfDocCommon.decode_permissions-s. %).      rHcF|jdSt|jjS)a 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)rr Pr\s rFrz$PdfDocCommon.user_access_permissions7s&   #4$T%5%7888rHcb|jdS|jsdS|jjS)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)r is_decrypted_are_permissions_validr\s rFare_permissions_validz"PdfDocCommon.are_permissions_validHs:   #4,,.. 466rHcdS)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. NrVr\s rFrzPdfDocCommon.is_encrypted\s  rHci}|j}d|vs|dsdStt|d}d|vr|d}t |t st dt||St|}|D]v}|}t|d}t |trMttt|}|rt|j} | ||<w|S)Nz /AcroFormz/XFAz%XFA entry is not an array: %(fields)sr)rrr6rgrar(rrOrnextr1r r-r'_data) r]rbrrrrrtagress rFxfazPdfDocCommon.xfags!#" g % %W[-A %4J 455 T>>&\,,..Ffk22 ;#!  V A ) )DMMa00) *=!> OOE)3EK@@&(s  rHci}jD]5}|jD]+}||g|,6t fd|DS)z1Mapping of attachment filenames to their content.c*i|]\}}|j|fSrV)_get_attachment_contents)r rattachment_entriesr]s rF z,PdfDocCommon.attachments..s9   ,D,t46HI   rH)attachment_list_names setdefaultr0LazyDictr)r]entriesrrs` rF attachmentszPdfDocCommon.attachmentss24) ; ;E  ; ;""4,,33E:::: ;    07       rHrcd|DS)Ncg|] }|j SrV)content)r rs rFr`z9PdfDocCommon._get_attachment_contents..s333% 333rHrV)clsrs rFrz%PdfDocCommon._get_attachment_contentss3373333rHc#VKtj|j|jEd{VdS)zIterable of attachment objects.)rN)r:_loadrrr\s rFrzPdfDocCommon.attachment_lists; %d&6t{KKKKKKKKKKKKrHincludeexcludecdS)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 NrV)r]rrs rF_repr_mimebundle_zPdfDocCommon._repr_mimebundle_s rH)Fr)grOrPrQrRrboolrSrr r.rrrrrrr,rrUrrrCr1r4rgrrrXrr=rr7rrrrrrTr+rr(rrrr r rrr staticmethodr"r6rr7r*rYr.rkr5r*rtsetterr;ryrxrr3rdrrrrrrrcrrr<rrrJ_PageTreeFramerrrrrr rr rrrrrr classmethodr:rrrrrrVrHrFrrsW  FD26OXd:./666(,K*%,,,It  -   ^X  C   ^X  "'^(;"< )    ^  . y U^   ^  x 01   ^X  (#67   X  h~6   ^X H->$?X*)s))))*1C1J1111$(( $ %((((T.Dk)9$:...X.[H,037&* kkk'(kc;./0 k #c(# k c;  kkkkd,0+/!% c(,6:ccc'(cc3h(c# c  c3s8$cc#?3c $sCx. !ccccR+/ ///%/c#h' / ////4 s /?   \ 6 Z!1126 S#X 6  6  6 S6 6 )6  6 6 6 6 pJ 001    S ) 8#C##s#t####J$$$cSVh$$$$L: 5)^;<: j : : : : x {,.>D EX:DU3 Z+M%NDSWDDDD####X#,0!%&*59\\\'(\# \ #c(# \  \"/2\ \\\\|+.X( "'Z(M"N #   ^ JJ J8C= J J J J C{ CxPS} C C C CES%Z E $E  EEEE:W(8WXk=RWWWWr?x +???X?*PT#YPPPXPXc]X68L1X2I/I/$I/4I/I/I/I/V:-:N::::(1N#1#h1) 1 - 1111f}*,,4,4C^34,4,4  ,4,4,4,4\;;#;(9:M;;;;  #     92G)H999X9 7x~777X7& d   ^X Xd38n-X:  WS$u+%56    X  4tL/A4d5k444[4L,!7LLLXL/3.2  x}d*+ x}d*+  c3h    ^   rHrcbeZdZdededdfdZdedefdZdeefdZde fd Z defd Z dS) rargskwargsr@Nc(t|i||_dSrZ)rT _raw_dict)r]rrs rFr[zLazyDict.__init__st.v..rHr^cR|j|\}}||SrZ)r __getitem__)r]r^funcargs rFrzLazyDict.__getitem__s)N..s33 ctCyyrHc*t|jSrZ)rrr\s rF__iter__zLazyDict.__iter__sDN###rHc*t|jSrZ)rrr\s rF__len__zLazyDict.__len__s4>"""rHcLdt|dS)NzLazyDict(keys=))r.r/r\s rF__str__zLazyDict.__str__s#4TYY[[ 1 14444rH) rOrPrQr r[rUrrr rCr rrVrHrFrrs/c/S/T////ss$(3-$$$$#####5555555rHr)_rDabcrrcollections.abcrrrrr typingr r r r rr_configurationrrr_pagerr _page_labelsrr_utilsrrrrr constantsrrrrrrr r!rer"rr#rerrorsr$r%r&filtersr'genericr(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9generic._filesr:rLr;r<xmpr=rrCrrG RESOURCESrCROPBOXROTATErrJrrr rXrrrVrHrFrs|> ########AAAAAAAAAAAA.-----######++++++++>>>>>>/.....;:::::666666++++++??????????++++++()(((((,,,,,,,,0e0305eCHo1E+F0000Jr|Jr{JrzJry  J}hy&99: ]%]%]%]%]%*]%]%]%@O O O O O 3O O O d,55555wsCx 55555rH