h]^dZddlmZddlmZmZddlmZddlmZdgZ GddZ d S) z2Utilities common to reading and writing PDF files.)Tuple)genericmisc)DocumentMetadata)PdfError PdfHandlerceZdZdZ ddejdefdZedej fdZ ede fdZ edejfd Z edej fd Zedeeeffd Zd Zd ZdZdS)r zfAbstract class providing a general interface for quering objects in PDF readers and writers alike.Frefas_metadata_streamct)aO Retrieve the object associated with the provided reference from this PDF handler. :param ref: An instance of :class:`.generic.Reference`. :param as_metadata_stream: Whether to dereference the object as an XMP metadata stream. :return: A PDF object. NotImplementedError)selfr r s W/var/www/html/Sam_Eipo/venv/lib/python3.11/site-packages/pyhanko/pdf_utils/rw_common.py get_objectzPdfHandler.get_object "!returnct)a Returns a view of the document trailer of the document represented by this :class:`.PdfHandler` instance. The view is effectively read-only, in the sense that any writes will not be reflected in the actual trailer (if the handler supports writing, that is). :return: A :class:`.generic.DictionaryObject` representing the current state of the document trailer. rrs r trailer_viewzPdfHandler.trailer_viewrrctNrrs rdocument_meta_viewzPdfHandler.document_meta_view/!!rct)zS :return: A reference to the document catalog of this PDF handler. rrs rroot_refzPdfHandler.root_ref3s "!rcp|j}t|tjsJ|S)zD :return: The document catalog of this PDF handler. )rr isinstancerDictionaryObject)rroots rr"zPdfHandler.root:s5 }''))$ 899999 rctrrrs r document_idzPdfHandler.document_idCrrc|jd}t|tjsJ|}t|tjsJ |d}n##t$rtj}YnwxYw|d}dkr|zdcxkr|ksntdfdd||tS)N/Pages /Resources/CountrzPage index out of rangec|}|d} |d}n#t$rYnwxYw|}t|D]\}}t |t jstjdt |t jsJ|j |vrtjd|} | d} | dkr:| d} | cxkr || zkrnn |||||j hzcS|| z }| dkrA| kr6r|||fcS | d}n#t$rYnwxYw||fcS|d z }td ) Nz/Kidsr'z0Page tree node children must be indirect objectszCircular reference in page treez/Typer&r(z/PagerzPage not found) rraw_getKeyError enumerater rIndirectObjectr PdfReadError referencer) first_page_ix pages_obj_reflast_rsrc_dict refs_seen pages_objkids cur_page_ix kid_indexkid_refkid node_type desc_count_recursepage_ixretrieve_parents rr<z,PdfHandler._walk_page_tree.._recurseYs%0022IW%D !*!2!2page_tree_root_refpage_tree_rootroot_resources page_countr<s `` @r_walk_page_treezPdfHandler._walk_page_treeHs+!Y..x88,g.DEEEEE+6688.'*BCCCCC 8+L9NN 8 8 8$577NNN 8$H- Q;; 7*GW))))z))))455 5. -. -. -. -. -. -. -`x-~suuEEEs+A44BBc0||dS)a Retrieve the node in the page tree containing the page with index ``page_ix``, along with the necessary objects to modify it in an incremental update scenario. :param page_ix: The (zero-indexed) number of the page for which we want to retrieve the parent. A negative number counts pages from the back of the document, with index ``-1`` referring to the last page. :return: A triple with the ``/Pages`` object (or a reference to it), the index of the target page in said ``/Pages`` object, and a (possibly inherited) resource dictionary. Tr>rDrr=s rfind_page_containerzPdfHandler.find_page_containers ##GT#BBBrc0||dS)a Retrieve the page with index ``page_ix`` from the page tree, along with the necessary objects to modify it in an incremental update scenario. :param page_ix: The (zero-indexed) number of the page to retrieve. A negative number counts pages from the back of the document, with index ``-1`` referring to the last page. :return: A tuple with a reference to the page object and a (possibly inherited) resource dictionary. FrFrGrHs rfind_page_for_modificationz%PdfHandler.find_page_for_modifications##GU#CCCrN)F)__name__ __module__ __qualname____doc__r Referenceboolrpropertyr!rrrrr"rbytesr$rDrIrKrrr r sc))BG""$":>""""  "g6 " " "X ""$4"""X""'+"""X" g.X"U5%<0"""X"AFAFAFFCCC$ D D D D DrN) rOtypingrrrmetadata.modelrr__all__r rTrrrYs88,,,,,, ._D_D_D_D_D_D_D_D_D_Dr