Wwg^VdZddlmZddlmZmZddlmZddlmZdgZ GddZ y ) z2Utilities common to reading and writing PDF files.)Tuple)genericmisc)DocumentMetadata)PdfError PdfHandlerceZdZdZ ddej defdZedejfdZ ede fdZ edej fdZ edejfd Zedeeeffd Zd Zd Zd Zy)r zfAbstract class providing a general interface for quering objects in PDF readers and writers alike.refas_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 R/var/www/horilla/myenv/lib/python3.12/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_view rrctNrrs rdocument_meta_viewzPdfHandler.document_meta_view0!!rct)zS :return: A reference to the document catalog of this PDF handler. rrs rroot_refzPdfHandler.root_ref4s "!rcr|jj}t|tjsJ|S)zD :return: The document catalog of this PDF handler. )rr isinstancerDictionaryObject)rroots rr"zPdfHandler.root;s1 }}'')$ 8 8999 rctrrrs r document_idzPdfHandler.document_idDrrc|jjd}t|tjsJ|j }t|tj sJ |d}|d}dkr|zdcxkr|kstdtdfdd||tS#t$rtj }YjwxYw)N/Pages /Resources/CountrzPage index out of rangec|j}|d} |jd}|}t|D]\}}t |t j stjdt |t j sJ|j|vrtjd|j} | d} | dk(r7| d} | cxkr|| zkrnn |||||jhzcS|| z }| dk(s| k(r!r|||fcS | jd}||fcS|d z }td #t$rYwxYw#t$rY3wxYw) 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.._recurseZs%002IW%D !*!2!2page_tree_root_refpage_tree_rootroot_resources page_countr<s `` @r_walk_page_treezPdfHandler._walk_page_treeIs!YY..x8,g.D.DEEE+668.'*B*BCCC 8+L9N$H- Q; 7*GW)z)45 5*45 5. -`-~suEEs 8$557N 8s(B88CCc(|j|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#BBrc(|j|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#CCrN)F)__name__ __module__ __qualname____doc__r Referenceboolrpropertyr!rrrrr"rbytesr$rDrIrKrrr r s)BG"$$":>"  "g66 " ""$4"""'++"" g.."U5%<0""AFFC$ DrN) rOtypingrrrmetadata.modelrr__all__r rTrrrYs)8, ._D_Dr