h5jB dZddlmZddlmZddlmZddlmZddl m Z ddl m Z m Z ddlmZmZmZmZmZGd d eZej*d ej,d ej.d ej0dej2d ej4d iZeej:ej=Z ddddddd ddZ d ddZ!Gdde"Z#GddZ$GddZ%y)z7Support for document outlines (e.g. table of contents).) annotations)Iterable)Enum)chain)cast)PagePdf)Array DictionaryNameObjectStringc0eZdZdZdZdZdZdZdZdZ dZ d Z y ) PageLocationz.Page view location definitions, from PDF spec.N) __name__ __module__ __qualname____doc__XYZFitFitHFitVFitRFitBFitBHFitBVM/var/www/html/qr/venv/lib/python3.12/site-packages/pikepdf/models/outlines.pyrrs-8 C C D D D D E Er&r)lefttopzoom)r))r()r(bottomrightr)Nr(r)r,r+r*c (t||||||||S)auCreate a destination ``Array`` with reference to a Pdf document's page number. Arguments: pdf: PDF document object. page_num: Page number (zero-based). page_location: Optional page location, as a string or :enum:`PageLocation`. left: Specify page viewport rectangle. top: Specify page viewport rectangle. right: Specify page viewport rectangle. bottom: Specify page viewport rectangle. zoom: Specify page viewport rectangle's zoom level. left, top, right, bottom, zoom are used in conjunction with the page fit style specified by *page_location*. ) page_locationr(r)r,r+r*)_make_page_destination)pdfpage_numr/r(r)r,r+r*s r'make_page_destinationr3*s)4 " #     r&c *jDcic] \}}| || c}}|j|jg}|rt|tr|}|j }n |} t|}|jtd|tj|} | rD|jfd| Dt|S|jtjt|Scc}}w#t $rtd|dwxYw)Nz*Invalid or unsupported page location type /c3BK|]}j|dyw)rN)get).0kkwargss r' z)_make_page_destination..hs@Avzz!Q'@s)itemspagesobj isinstancernameKeyError ValueErrorappendr PAGE_LOCATION_ARGSr7extendrr ) r1r2r/r:r9vresloc_keyloc_strdest_arg_namess ` r'r0r0Ps &||~ ?tq!ad ?F$'IIh$7$;$;#||_||_||_i|_||_|j|j t d||_t|||| | } | jD cic] \} } |  | |  c} } |_d|_ g|_ ycc} } w)zInitialize OutlineItem.Nz-Only one of destination and action may be setr-F) title destinationr/page_location_kwargsactionrBr>dictr< is_closedchildren)selfrPrQr/rSr>r(r)r,r+r*r:r9rFs r'__init__zOutlineItem.__init__s &*$&!    'DKK,CLM M4Sf4P6z7 z -> ) rVrUrQr?r rlabelrr intrP)rW oc_indicatorraw_pagepagedests r'__str__zOutlineItem.__str__s ==~~$ $  L    '$**E2 ++A.H~zzD,,f5N''(+D,,d3N''(+D,,c2 0 013Dq D77r&cPd|jjd|jdS)N ) __class__rrPrWs r'__repr__zOutlineItem.__repr__s&4>>2233tzzl"EEr&Fstrictc t|j}|j t j }|,t|ttzt zstd||j t j}|t|tstd||||||S#t$r}|r td|d}Yd}~d}~wwxYw)aCreate a ``OutlineItem`` from a ``Dictionary``. Does not process nested items. Arguments: obj: ``Dictionary`` object representing a single outline node. strict: If ``True``, raise :class:`OutlineStructureError` on any structural problem (such as a missing required ``/Title``). If ``False`` (default), quietly correct such problems where the repair is known; a missing ``/Title`` becomes an empty string. z'Outline node is missing required /TitleNz+Unexpected object type in Outline's /Dest: z(Unexpected object type in Outline's /A: )rQrSr>) strTitleAttributeErrorrLr7r Destr?r rAr )clsr>rirPerQrSs r'from_dictionary_objectz"OutlineItem.from_dictionary_objects  NEggdii(  ": $., (=k_M   j&D':6*E 5k&cJJ) +=E  sB// C8C  Cc|s |j!|jtx|_}n |j}|j|_|j rt |j tr1t||j |jfi|j|_|j |_ tj|vr|` |S|j%|j|_ tj|vr|` |S)a\Create/update a ``Dictionary`` object from this outline node. Page numbers are resolved to a page reference on the input ``Pdf`` object. Arguments: pdf: PDF document object. create_new: If set to ``True``, creates a new object instead of modifying an existing one in-place. )r> make_indirectr rPrmrQr?r]r3r/rRror rprS)rWr1 create_newr>s r'to_dictionary_objectz OutlineItem.to_dictionary_objects ) ..z|< ryr( float | Noner)rzr,rzr+rzr*rz)r>r ribool)F)r1r rvr{returnr ) rrrrrXrbrg classmethodrsrwr%r&r'rNrNrsF;?37$(!% ." "#!..8.1 . " .  ......8 8DFGL"K"KHr&rNceZdZdZdddZdZdZdZdZdZ ddZ dd Z d Z d Z dd Zedd Zej"ddZy)OutlineaMaintains a intuitive interface for creating and editing PDF document outlines. See {{ pdfrm }} section 12.3. Arguments: pdf: PDF document object. max_depth: Maximum recursion depth to consider when reading the outline. strict: When ``False`` (default), pikepdf quietly corrects minor structural problems in the outline where the correct repair is known. For example, a missing required ``/Title`` is treated as an empty string, and object references that re-occur while reading or writing are recovered without raising. When ``True``, any such structural problem raises a :class:`pikepdf.OutlineStructureError`. See Also: :meth:`pikepdf.Pdf.open_outline` cJd|_||_||_||_d|_y)zInitialize Outline.NF)_root_pdf _max_depth_strict _updating)rWr1 max_depthris r'rXzOutline.__init__.s%/3  # r&c,t|jSN)rlrootrfs r'rbzOutline.__str__6s499~r&cbd|jjdt|jdS)Nrdz: z items>)rerlenrrfs r'rgzOutline.__repr__9s+4>>2232c$))n5EWMMr&c |r|jdy|jddd5t|jD]/\}}|j |j t |1 dddy#1swYyxYw)Nz...rz!pikepdf.models.outlines.Outline< z >)textgroup enumerater breakableprettyrl)rWpcycle_items r' _repr_pretty_zOutline._repr_pretty_<sk  FF5M@%H ((3(GAtKKMHHSY'( ( ( (s AA::Bcd|_|S)NT)rrfs r' __enter__zOutline.__enter__Es r&cb | d|_y|jd|_y#d|_wxYw)NF)r_save)rWexc_typeexc_valexc_tbs r'__exit__zOutline.__exit__Is3 ###DN JJL"DNUDNs %% .c8d}d}d}|D]-}|j|j} | j} | |vr9|jrt d| d|j|jd} n|j | || _|dz }|| |_|| _n| }tj| vr| `| }||jkr |j} nd} |j| | |dz||jr"tt| j  | _|tt| j z }0|r0||Jtj|vr|`||_||_||_ytj"|vr|`tj$|vr|`||_y)NrOutline object  reoccurred in structureT)rvrr%)rwrobjgenrrLaddParentNextPrevr rrV_save_level_outlinerUrr]CountFirstLast) rWparent outline_itemslevel visited_objscountprevfirstrout_objr sub_itemss r'rzOutline._save_level_outlineQs"&#'! 2D// :G^^F%<</)&1IJ33DII$3O  (#GN QJE# # 99' Dt&37==   $ $WiL Q~~!%c7==!9 9 c7==11= 2> #(9 99yyD I FLFK  zzV#LyyF"K r&c|}|rQ|j}||vr|jrtd|dy|j|tj ||j}|j tj}t|trk||jkr\|j||j|dz||j tj} t| tr | dkrd|_|j#||j tj$} | t| tr| }ntd|d|rPyy)NrrrhrrTz points to non-dictionary)rrrLrrNrsr7r rr?r r_load_level_outlinerVrr]rUrCr) rW first_objrrr current_objrr first_childrnext_objs r'rzOutline._load_level_outlines0*3  ''F%<</)&1IJ   V $55k$,,5WD%//$**5K+z2ut7N(( <$ 3eS)eai%)DN   &"tyy1H:h #C& +%fX-FG1r&c|jytj|jjvr!|jjj}nN|jj t tjx|jj_}|j||jdty)N)Typer) rr OutlinesrRootrur rset)rWoutliness r'rz Outline._saves ::   ==DIINN *yy~~..H151H1H .2 DIINN #h   4::q#%@r&c(gx|_}tj|jjvry|jjjxsi}|j tj }|r|j||dtyy)Nr) rr rrrr7rrr)rWrrrs r'_loadz Outline._loadsm T ==  . 99>>**0bLL,   $ $Ya ? r&c|j|jt||}|j |g|_n|jj||js|j |S)zAdd an item to the outline. Arguments: title: Title of the outline item. destination: Destination to jump to when the item is selected. Returns: The newly created :class:`OutlineItem`. )rrrNrCrr)rWrPrQrs r'rz Outline.adds] ::  JJL5+. :: DJ JJ  d #~~ JJL r&c||j|jttt|jS)z$Return the root node of the outline.)rrrlistrNrfs r'rz Outline.roots- ::  JJLD%tzz22r&ct|ts td|D]}t|trtd||_y)z!Set the root node of the outline.z+Root must be a list of OutlineItem objects.z)Each item in root must be an OutlineItem.N)r?rrBrNr)rWnew_rootrs r'rz Outline.rootsJ(D)JK K NDdK0 !LMM N r&N)F)r1r rr]rir{)rr rzIterable[OutlineItem]rr]rset[tuple[int, int]])rr rz list[Object]rr]rr)rPrlrQzArray | int | Noner|rN)r|list[OutlineItem])rr)rrrrrXrbrgrrrrrrrrpropertyrsetterr%r&r'rrs$N(#44-4 4 + 4l""$" " + "H A@*33  [[r&rr)r1r r2r]r/rxr(rzr)rzr,rzr+rzr*rzr|r )r1r r2r]r/rxr|r )&r __future__rcollections.abcrenumr itertoolsrtypingr pikepdf._corerr pikepdf.objectsr r r r rrrrr r!r#r$rDr from_iterablevaluesALL_PAGE_LOCATION_KWARGSr3r0 ExceptionrLrNrr%r&r'rsk >"$#CC 4 -xy9 2u223E3L3L3NOP 04# # ##-#  #  # # # # #R04 -  <