o vh^@sPdZddlmZddlmZmZddlmZddlmZdgZ GdddZ d S) z2Utilities common to reading and writing PDF files.)Tuple)genericmisc)DocumentMetadata)PdfError PdfHandlerc@seZdZdZ ddejdefddZedej fdd Z ede fd d Z edejfd d Z edej fddZedeeeffddZddZddZddZdS)rzfAbstract class providing a general interface for quering objects in PDF readers and writers alike.Frefas_metadata_streamcCt)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 rY/var/www/html/hyperkenya/venv/lib/python3.10/site-packages/pyhanko/pdf_utils/rw_common.py get_objectzPdfHandler.get_objectreturncCr )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. r rrrr trailer_view rzPdfHandler.trailer_viewcCr Nr rrrrdocument_meta_view0zPdfHandler.document_meta_viewcCr )zS :return: A reference to the document catalog of this PDF handler. r rrrrroot_ref4szPdfHandler.root_refcCs|j}t|tjs J|S)zD :return: The document catalog of this PDF handler. )rr isinstancerDictionaryObject)rrootrrrr;s zPdfHandler.rootcCr rr rrrr document_idDrzPdfHandler.document_idcs|jd}t|tjsJ|}t|tjsJz|d}Wn ty-t}Ynw|d}dkr:|dkrG|ksLtdtdfddd||t S)N/Pages /Resources/CountrzPage index out of rangec sB|}|d}z|d}Wn tyYnw|}t|D]}\}}t|tjs.tdt|tjs6J|j |vr@td|} | d} | dkrp| d} |kr\|| krknn |||||j hBS|| 7}q| dkr|krr|||fSz| d}Wn tyYnw||fS|d 7}qt d ) Nz/Kidsrz0Page tree node children must be indirect objectszCircular reference in page treez/Typerr z/PagerzPage not found) rraw_getKeyError enumeraterrIndirectObjectr 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_parentrrr4ZsR        z,PdfHandler._walk_page_tree.._recurse) rr!rrr$rrr"rset)rr5r6page_tree_root_refpage_tree_rootroot_resources page_countrr3r_walk_page_treeIs$    0zPdfHandler._walk_page_treecC|j|ddS)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. Tr6r<rr5rrrfind_page_containerszPdfHandler.find_page_containercCr=)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. Fr>r?r@rrrfind_page_for_modifications z%PdfHandler.find_page_for_modificationN)F)__name__ __module__ __qualname____doc__r Referenceboolrpropertyrrrrrrrbytesrr<rArBrrrrr s* C N) rFtypingrrrmetadata.modelrr__all__rrrrrs