o ` (or :meth:`append()`) and :meth:`write()` for usage information. :param bool strict: Determines whether user should be warned of all problems and also causes some correctable problems to be fatal. Defaults to ``True``. TcCs0g|_g|_t|_g|_g|_d|_||_dS)Nr)inputspagesroutput bookmarks named_destsid_countstrict)rr#rrrrFs zPdfFileMerger.__init__NcCsd}d}t|rt|d}d}n>t|tr%|d|}t|}d}n)t|trN|j} |jdt|j}|j| |}t |drL|j }d}t||j d} |dur\|| _ |dkrgd| f}nt|t rt|| }n t|ts}tdg} |rtt|t|jtd }g} |r| } || | |} |r|j|| g7_n|j| 7_| j} || | |} |j| 7_t|D]}| |}|j}|jd 7_t|| |}| |q| | |!| | |j"||<|j#|| |fdS) a Merges the pages from the given file into the output file at the specified page number. :param int position: The *page number* to insert this file. File will be inserted after the given number. :param fileobj: A File Object or an object that supports the standard read and seek methods similar to a File Object. Could also be a string representing a path to a PDF file. :param str bookmark: Optionally, you may specify a bookmark to be applied at the beginning of the included file by supplying the text of the bookmark. :param pages: can be a :ref:`Page Range ` or a ``(start, stop[, step])`` tuple to merge only the specified range of pages from the source document into the output document. :param bool import_bookmarks: You may prevent the source document's bookmarks from being imported by specifying this as ``False``. FNrbTr_decryption_key)r#z0"pages" must be a tuple of (start, stop[, step])z/Fitr)$rfile isinstanceseekreadStreamIOrstreamtellhasattrr%r# getNumPagesrindicestuple TypeErrorBookmarkTextStringObject NumberObjectr" NameObject getOutlines _trim_outliner namedDestinations _trim_destsr!rangegetPagerappend_associate_dests_to_pages_associate_bookmarks_to_pagesrr)rpositionfileobjbookmarkrimport_bookmarksmy_filedecryption_key filecontent orig_tellpdfrsrcpagesoutlinedestsipgrmprrrmergeOsf                zPdfFileMerger.mergecCs|t|j||||dS)a Identical to the :meth:`merge()` method, but assumes you want to concatenate all pages onto the end of the file instead of specifying a position. :param fileobj: A File Object or an object that supports the standard read and seek methods similar to a File Object. Could also be a string representing a path to a PDF file. :param str bookmark: Optionally, you may specify a bookmark to be applied at the beginning of the included file by supplying the text of the bookmark. :param pages: can be a :ref:`Page Range ` or a ``(start, stop[, step])`` tuple to merge only the specified range of pages from the source document into the output document. :param bool import_bookmarks: You may prevent the source document's bookmarks from being imported by specifying this as ``False``. N)rNlenr)rr@rArrBrrrr<szPdfFileMerger.appendcCsd}t|r t|d}d}|jD]}|j|j|j|jjdd|_ q| | |j ||rA| dSdS)z Writes all data that has been merged to the given output file. :param fileobj: Output file. Can be a filename or any kind of file-like object. FwbT/KidsN)rr&rraddPager getReference_pages getObjectr _write_dests_write_bookmarkswriteclose)rr@rCpagerrrrYs  $  zPdfFileMerger.writecCs4g|_|jD] \}}}|r|qg|_d|_dS)zd Shuts all file descriptors (input and output) and clears all memory usage. N)rrrZr)rforGminerrrrZs zPdfFileMerger.closecC|j|dS)z Add custom metadata to the output. :param dict infos: a Python dictionary where each key is a field and each value is your new metadata. Example: ``{u'/Title': u'My title'}`` N)r addMetadata)rinfosrrrr_szPdfFileMerger.addMetadatacCr^)a Set the page layout :param str layout: The page layout to be used Valid layouts are: /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)r setPageLayout)rlayoutrrrraszPdfFileMerger.setPageLayoutcCr^)a Set the page mode. :param str mode: The page mode to use. Valid modes are: /UseNone Do not show outlines or thumbnails panels /UseOutlines Show outlines (aka bookmarks) panel /UseThumbs Show page thumbnails panel /FullScreen Fullscreen view /UseOC Show Optional Content Group (OCG) panel /UseAttachments Show attachments panel N)r setPageMode)rmoderrrrcszPdfFileMerger.setPageModec Csg}d}t|D]5\}}t|D],}|||dkr>|d|td<t|t|dks7J||nqq |S)zg Removes any named destinations that are not a part of the specified page set. T/Page/Title)listitemsr:r;rVr5rr<) rpdfrJr new_destsprev_header_addedkojrrrr9#s  zPdfFileMerger._trim_destsc Csg}d}t|D]L\}}t|tr+||||}|r*|s%|||d||qd}t|D]"} || |dkrS|d|td<||d}nq1q|S)zm Removes any outline/bookmark entries that are not a part of the specified page set. TrFre) enumerater'rgr7r<r:r;rVr5) rrirIr new_outlinerkrKrmsubrnrrrr73s(    zPdfFileMerger._trim_outlinecCsv|j}|D]3}d}d}d|vr.t|jD]\}}|j|dkr-|j|td<|}|j}nq|dkr8|j|qdS)Nre) r!rorrrr5rraddNamedDestinationObject)rrJvpagenorirKprrrrWKs  zPdfFileMerger._write_destsc Csr|dkr|j}d}|D]}t|tr|||q d}d}d|vrt|jD]z\}}|j|dkrt|jt|dg} |ddksL|ddkrmd|vrat|dt sa| t |dn| t d|d=n|ddksy|ddkrd |vrt|d t s| t |d n| t d|d =n|dd krd |vrt|d t s| t |d n| t dd|vrt|dt s| t |dn| t dd |vrt|d t s| t |d n| t d|d=|d =|d =n|dd krd |vrt|d t s| t |d n| t dd |vr9t|d t s9| t |d n| t dd|vrWt|dt sW| t |dn| t dd|vrut|dt su| t |dn| t d|d =|d=|d =|d=t tdtdtdt | i|td<|}|j}nq(|dkr|d=|d=|j||}q dS)Nrez/Type/FitHz/FitBHz/Toprz/FitVz/FitBVz/Leftz/XYZz/Zoomz/FitRz/Bottomz/Right/S/GoTo/D/A)r r'rgrXrorrr4r5 NullObjectr< FloatObjectDictionaryObject ArrayObjectrraddBookmarkDict) rr parent last_addedbrtrirKruargsrrrrX[st      ( 7 zPdfFileMerger._write_bookmarkscCst|jD]4}d}|d}t|trq|D]}||jkr!|j}q|dkr/t||td<qtd|dfdS)Nrez!Unresolved named destination '%s'rf)r!r'r4rVrrr5 ValueError)rrndrtnprurrrr=s  z'PdfFileMerger._associate_dests_to_pagescCs|dkr|j}|D]@}t|tr|||q d}|d}t|tr#q |D]}||jkr3|j}q%|dkrAt||td<q t d|dfdS)NrezUnresolved bookmark '%s'rf) r r'rgr>r4rVrrr5r)rrr rrtbprurrrr>s$   z+PdfFileMerger._associate_bookmarks_to_pagescCsl|dkr|j}t|D](\}}t|tr$|||}|r#|g|Sq ||ks.|d|kr3|gSq dS)Nrf)r ror'rg findBookmark)rrArootrKrresrrrrs   zPdfFileMerger.findBookmarkc Cs|dkr t|jdg}n t|tr|}n||}tt|t|tdtd}|dkr5|j ||S|j}|ddD]}||}q>|dd}|t|krat||tra|| ||S| ||g|S)a Add a bookmark to this PDF file. :param str title: Title to use for this bookmark. :param int pagenum: Page number this bookmark will point to. :param parent: A reference to a parent bookmark to create nested bookmarks. Nrrv:rR) rOr r'rgrr2r3r4r5r<insert) rtitlepagenumrilocdestbmparentrKnposrrr addBookmarks$       zPdfFileMerger.addBookmarkcCs.tt|t|tdtd}|j|dS)z Add a destination to the output. :param str title: Title to use :param int pagenum: Page number this destination points at. rvrN) Destinationr3r4r5r!r<)rrrrrrraddNamedDestinationsz!PdfFileMerger.addNamedDestination)T)NNT)NNr)rrrrrrNr<rYrZr_rarcr9r7rWrXr=r>rrrrrrrr8s& h   J    rc@s.eZdZd ddZddZddZdd ZdS) OutlinesObjectNcCs t|||_||_||_dSr)rgrtreerir)rrirrrrrrs  zOutlinesObject.__init__cCs||}||=|j|dSr)r removeChild)rindexobjrrrremoveszOutlinesObject.removecCs|j|jjd|}t}|tdt|tdtdgtdtdi|j|}t }|td|tdt |i|j||j |dS) NrQryrvrrwrxrzrf) rirVrUr}updater5r~r4 _addObject TreeObjectcreateStringObjectraddChild)rrrpageRefaction actionRefrArrradds    zOutlinesObject.addcCs2dd|jDD] }|j||q dS)NcSsg|]}|qSrr).0xrrr 'sz,OutlinesObject.removeAll..)rchildrenrpop)rchildrrr removeAll&s  zOutlinesObject.removeAllr)rrrrrrrrrrrrs   rN)genericutilsrrrirr pagerangersysr cStringIOr r*ior r r&objectrrrgrrrrrs"      R