o Zh@s4ddlZddlZddlZddlZddlZddlZddlmZmZm Z ddl m Z ddl m Z ddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZddlmZmZdd l m!Z!m"Z"dd l#m$Z$m%Z%dd l&m'Z'dd l(m)Z)m*Z*m+Z+dd l,m-Z-ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5ddl6m7Z8ddl6m9Z:ddl6m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCddl6mDZEddl6mFZGddl6mHZIddl6mJZKddl6mLZMddlNmOZOddlPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZemfZfmgZgddlhmiZimjZjddlmkZkmlZlmmZmmnZnmoZompZpddlqmrZreCsZtdZuGdddejvZwd:d ed!exd"eyfd#d$ZzGd%d&d&e"Z{d'eeeyefeye|eefd"e_fd(d)Z}d*ede[fd+eyd,eee|e|e|feydfd-e~d.e~d"ecf d/d0Zd1eyd2eeyd3eyd4eeyefd5e`d6e|d7e|d"efd8d9ZdS);N)BytesIOFileIOIOBase)compress)Path) TracebackType) IOAnyCallableDictIterableListOptionalPatternTupleTypeUnioncast)_default_fonts_space_widthbuild_char_map_from_dict)DocumentInformation PdfDocCommon)EncryptAlgorithm Encryption) PageObject)nums_clear_range nums_insert nums_next) PdfReader) StrByteType StreamType_get_max_pdf_version_header deprecatedeprecate_no_replacementdeprecation_with_replacementlogger_warning)AnnotationDictionaryAttributes)CatalogAttributes) CatalogDictionary"FileSpecificationDictionaryEntriesGoToActionArguments ImageTypeInteractiveFormDictEntriesOutlineFontFlagPageLabelStyleTypFitArgumentsUserAccessPermissions)Core)FieldDictionaryAttributes)PageAttributes)PagesAttributes) TrailerKeys) PyPdfError)PAGE_FIT ArrayObject BooleanObjectByteStringObject ContentStreamDecodedStreamObject DestinationDictionaryObjectFit FloatObjectIndirectObject NameObject NullObject NumberObject PdfObjectRectangleObject StreamObjectTextStringObject TreeObjectViewerPreferencescreate_string_object hex_to_rgbis_null_or_none) PageRange PageRangeSpec)AnnotationSubtypeBorderArrayType LayoutTypeOutlineItemType OutlineType PagemodeType)XmpInformation c@s\eZdZdZeZeZeZeZ eZ eZ eZ eZ e e Be BZdS)ObjectDeletionFlagrN)__name__ __module__ __qualname__NONEenumautoTEXTLINKS ATTACHMENTS OBJECTS_3DALL_ANNOTATIONSXOBJECT_IMAGES INLINE_IMAGESDRAWING_IMAGESZIMAGESrhrhD/var/www/html/lang_env/lib/python3.10/site-packages/pypdf/_writer.pyrYsrYstream blocksizereturncs4t}tfdddD]}||q|S)Ncs SN)readrhrlrkrhris z#_rolling_checksum..)hashlibmd5iterupdate hexdigest)rkrlhashblockrhrpri_rolling_checksums rzcsT eZdZdZ    ddedeeefdedeeefdeded df d d Z e d efd d Z e d e fddZ e d ee fddZejdeeee fd dfddZe d eefddZejdeed dfddZe d efddZejded dfddZdddZdeeedeedeed dfdd Ze d efd!d"Zejd#eeefd dfd$d"Zd%ed efd&d'Zd(eeefd efd)d*Z d(eeefd%ed efd+d,Z! -dd.e"d/ed0e#ed e"fd1d2Z$dd4ed dfd5d6Z%d e&fd7d8Z' -dd.e"d0e#ed e"fd9d:Z( ; -dd.e"d/ed0e#ed e"fdd?Z+ dd@ee,dAee,d e"fdBdCZ-   ;dd@eee,e.j/fdAeee,e.j/fd/ed e"fdDdEZ0e d ede1e2e3fffdFdG Z4e4jdHedee1e"fd dfdIdGZ4dJed dfdKdLZ5dMedNeeefd dfdOdPZ6 ddQedRee7e"gdfd dfdSdTZ8  UddVe dWe dXedYe,d df dZd[Z9e:;d;Zeeee=ee?eee,fffd]e:j;d^eed df d_d`Z@ dd.ee"d e=e fdadbZAdQed dfdcddZB ddQedRee7e"gdfd dfdedfZCd e3fdgdhZDddidjZEdd3eFfddkdledmeednedoeGdpeed df dqdrZHdseId dfdtduZJdseeefd e?eeKeLffdvdwZMd e=efdxdyZNdseId dfdzd{ZOdseId e?e=ee=effd|d}ZPdseId~e=ede=ed efddZQdseIded dfddZRe d eeSffdd ZTeTjdeeeSe e>eLeLffd dfddZTde>eeLfd dfddZU 3 3ddeded dfddZVdeeWeXe eYeeZee[e2e*f d dfddZ\dNed efddZ]d%ed efddZ^d e_fddZ`d eWfddZae d eWfddZb   3ddeee"e_fdede_efdede_efded ef ddZc   3ddeddede_efdede_efded ef ddZedddddefd3fdedede"eefdede_efdede_efdeee?e,e,e,fefdededegded efddZhdddZide2deeeWfd dfddZjded efddZkdeded efddZldddZmdeeene#enfd dfddZod.eee"e fdee#ed dfddZp dd.ee"e fdeeqe#eqfdee>eeLfd dfddZresjtfdesd dfdd„Zuddee=ed dfddńZv ddededewdeeWd df ddʄZxdZyd eezfdd̈́Z{deeZezfd dfddЄZ|dezd dfdd҄Z}e d eezfddԄZ~e~jdezd dfddԄZ~dZd eefdd؄Ze d eefddڄZejded dfddڄZdeee"fdWe>eeLfd e fddބZd.ee"efd e"fddZdeeeefd e?eeeffddZ   3 d deeeefdeedee?eefe?eeefe=efdedee?eefe?eeefe=ee=e"fdedeee=ee?edffd df ddZ   3 -d!deedeeeefdeedeeee=e"fdedeee=ee?edffd dfddZde de>ee"fdQed efddZdeeeLefde>ee"fdQed dfddZd.edee"e*fde>ee"fdQed eefddZdeee=e dfd.e"de>ee"fdQed e=e1f ddZdeLde>ee"fdQed e=e1fddZdHe1d e_fddZ dde=e1dee_efdede_efd dfddZdddZ dde>eeLfdeed ee=efddZ dde>eeLfdeed dfddZ ddQedeefd dfddZ   ;ddeded eed eed eed df d d Z   ;ddeded eed eed eed df ddZ  ddede#efdede#efd e>eeLffddZZS(" PdfWritera Write a PDF file out, given pages produced by another class or through cloning a PDF file during initialization. Typically data is added from a :class:`PdfReader`. Args: clone_from: identical to fileobj (for compatibility) incremental: If true, loads the document and set the PdfWriter in incremental mode. When writing incrementally, the original document is written first and new/modified content is appended. To be used for signed document/forms to keep signature valid. full: If true, loads all the objects (always full if incremental = True). This parameter may allow loading large PDFs. NFfileobj clone_from incrementalfullrmc Cs|p||_ g|_ g|_ i|_ i|_ | d|_ |jrbt|ttfrCt |d}t | d}Wdn1s>wYt|t rLt |}t|t sUt d||_|j|_d|_nd|_|ttdtdi|_dtdt ttttt fd tdt ttttt fd tdt ttttt ffd d }|||}||_d |_d|_d|_t}|tt j!tdtt j"t#dtt j$t%ig|_&d|_'d|_(|durt|t st |}|)|d|_n$|||_*t|_+|j+tt j!tt,j-tt,j.|j*i||j+|r|sd|_t|jt/rHt|jdt0r1t1|jd2|jd<t|jdt0rJt1|jd2|jd<dSdSdS)Nrbz!Invalid type for incremental modeTs%PDF-1.3z /ProducerZpypdfr}r~rmcSst|ttttfr|dks|dur|Sd}t|ttfr1tt|r/tt|jdkr1d}t|ttfrL| }| dddkrFd}| |d|rP|}|S)Nr|TrF) isinstancestrrrrexistsstatst_sizertellseek)r}r~Zcloningtrhrhri_get_clone_froms" z+PdfWriter.__init__.._get_clone_fromr|F/Pagesrr)3r_objects_original_hash _idnum_hash_id_translated_IDrrropenrrorr7_reader pdf_headerencode_headerZ _readonly _add_objectr?rCrL _info_objrrr temp_fileobjr}_with_as_usage_clonedrvPATYPECOUNTrEKIDSr9flattened_pages _encryption_encrypt_entryclone_document_from_reader_pages _root_objectCOZCATALOGZPAGESlistrIr;Zget_original_bytes)selfr}r~rrfrpagesrhrhri__init__s             zPdfWriter.__init__cCdS)z Read-only boolean property showing whether this PDF file is encrypted. Note that this property, if true, will remain true even after the :meth:`decrypt()` method is called. Frhrrhrhri is_encrypted*szPdfWriter.is_encryptedcCs|jS)zw Provide direct access to PDF Structure. Note: Recommended only for read access. )rrrhrhri root_object4s zPdfWriter.root_objectcCs|jdurdStt|jS)z Provide access to "/Info". Standardized with PdfReader. Returns: /Info Dictionary; None if the entry does not exist N)rrr? get_objectrrhrhri_info?s zPdfWriter._infovaluec Cs|dur!z d|j|jjjd<Wn ttfyYnwd|_dS|jdur-|t|_tt|j }| | tt| dS)Nr) rrindirect_referenceidnumKeyErrorAttributeErrorrr?rrclearrv)rrobjrhrhrirNs  cCstt|jjS)(XMP (Extensible Metadata Platform) data.)rrWr xmp_metadatarrhrhrir]szPdfWriter.xmp_metadatacCs8|durd|jvr |jd=|jjS||jtd<|jjS)rNz /Metadata)rrCrrrrhrhrirbs  cCstdd|jSN with_as_usagez6.0r$rrrhrhrirms zPdfWriter.with_as_usagecCstdd||_dSrrrrhrhrirrs  cCs*|j}|j}|||_d|_||_|S)z*Store how writer is initialized by 'with'.T)rrrrr})rcrrhrhri __enter__wszPdfWriter.__enter__exc_typeexc tracebackcCs$|jr|js||jdSdSdS)zWrite data to the fileobj.N)r}rwrite)rrrrrhrhri__exit__s zPdfWriter.__exit__cCs |jS)aL Read/Write property of the PDF header that is written. This should be something like ``'%PDF-1.5'``. It is recommended to set the lowest version that supports all features which are used within the PDF file. Note: `pdf_header` returns a string but accepts bytes or str for writing )rdecoderrhrhrirs zPdfWriter.pdf_header new_headercCst|tr |}||_dSrn)rrrr)rrrhrhrirs  rcCst|dddur|jj|kr|jSt|tr/t|tjdttfr/| |tj|t tj<|j |t t|j d||_|jS)Nrr)getattrrpdfrr?getPGZCONTENTSr9rrCrappendrBlen)rrrhrhrirs   zPdfWriter._add_objectrcCsPt|tr |j|d}n|j|krtd|j|jd}|dus&Jd|S)NrPDF must be selfmypy)rintrr ValueErrorrrrrrhrhrirs  zPdfWriter.get_objectcCst|tr|j|krtd|j}|j|djj}t|dddur-|jj|kr-| |}||j|d<t||||_t|t sDJd|S)Nrrrr) rrBrrrrrZ generationrclonerF)rrrgenrhrhri_replace_objects    zPdfWriter._replace_objectrhpageindex excluded_keysc Cst|tr|tjdtjkrtd|jdusJd|}t |}|tj dg7}z|j t |j j|j j=Wn ty@Ynwtd||d|}|jdur]|jj}t|j||_||\}}|j |ttj <|dkrtt|tj||j |j||ntt|tj|j |j|d}t|stt|}ttt|tj d|ttj <|tj d}|d7}|dkrt!d t|r|S) NzInvalid page objectfor mypyz/StructParentsrFrrizToo many recursive calls!)"rrrrrrZPAGErrrPARENTridrrr Exceptionrrrrr"Z_get_page_in_noderCr9rinsertrrNr?rErrr7) rrrrZpage_orgothernodeidxrecurserhrhri _add_pagesH   "zPdfWriter._add_pageTstatec Csz'tj|jvr|t|jttj<ttj}t|t t|jtj|<WdSt yE}zt d|d|t WYd}~dSd}~ww)a Sets the "NeedAppearances" flag in the PDF writer. The "NeedAppearances" flag indicates whether the appearance dictionary for form fields should be automatically generated by the PDF viewer or if the embedded appearance should be used. Args: state: The actual value of the NeedAppearances flag. Returns: None zset_need_appearances_writer(z ) catch : N) r) ACRO_FORMrrr?rCr-ZNeedAppearancesr:rrr&rZ)rrZneed_appearancesrrhrhriset_need_appearances_writers"   z%PdfWriter.set_need_appearances_writercCs t}|||jttj<|Srn)rKrrrCr)ZVIEWER_PREFERENCES)rorhrhricreate_viewer_preferencess z#PdfWriter.create_viewer_preferencescCs&|jdus Jd||t|j|S)a Add a page to this PDF file. Recommended for advanced usage including the adequate excluded_keys. The page is usually acquired from a :class:`PdfReader` instance. Args: page: The page to add to the document. Should be an instance of :class:`PageObject` excluded_keys: Returns: The added PageObject. Nr)rrr)rrrrhrhriadd_page&szPdfWriter.add_pagercCs`|jdus Jd|dkrt|j|}|dkrtd|t|jkr)|||S||||S)a] Insert a page in this PDF file. The page is usually acquired from a :class:`PdfReader` instance. Args: page: The page to add to the document. index: Position at which the page will be inserted. excluded_keys: Returns: The added PageObject. NrrzInvalid index value)rrrrr)rrrrrhrhri insert_page?s zPdfWriter.insert_pagecCsNt|rdS|dusJdt|trt|d|}|}t|tr%|jSdS)z Generate _page_id2num. Args: indirect_reference: Returns: The page number or None Nrr)rNrrrBrr page_numberrrhrhri_get_page_number_by_indirect[s   z&PdfWriter._get_page_number_by_indirectwidthheightcCst|||}||S)a( Append a blank page to this PDF file and return it. If no page size is specified, use the size of the last page. Args: width: The width of the new page expressed in default user space units. height: The height of the new page expressed in default user space units. Returns: The newly appended page. Raises: PageSizeNotDefinedError: if width and height are not defined and previous page does not exist. )rcreate_blank_pager)rrrrrhrhriadd_blank_pagess zPdfWriter.add_blank_pagecCsT|dus|dur||kr|j|}|jj}|jj}t|||}||||S)aU Insert a blank page to this PDF file and return it. If no page size is specified, use the size of the last page. Args: width: The width of the new page expressed in default user space units. height: The height of the new page expressed in default user space units. index: Position to add the page. Returns: The newly inserted page. Raises: PageSizeNotDefinedError: if width and height are not defined and previous page does not exist. N)Z get_num_pagesrZmediaboxrrrrr)rrrrZoldpagerrhrhriinsert_blank_pages  zPdfWriter.insert_blank_pagectjSrn)superopen_destinationr __class__rhrirszPdfWriter.open_destinationdestcCs|durz|jd=WdStyYdSwt|tr&t||jtd<dSt|tr5|j|jtd<dSt|trQtd|j durD|j nt t j|jtd<dSdS)Nz /OpenActionZOpening) rrrrrIrCr> dest_arrayrrrDr8)rrrhrhrirs*      javascriptc Csd|jvrt|jttj<tt|jtj}d|vr(ttdti|td<tttt|dd}t}|ttj tdtdtdtdt |i| t t t| ||dS)a% Add JavaScript which will launch upon opening this PDF. Args: javascript: Your JavaScript. >>> output.add_js("this.print({bUI:true,bSilent:false,bShrinkToFit:true});") # Example: This will launch the print window when the PDF is opened. /Namesz /JavaScriptz/Action/Sz/JSN)rr?rCCANAMESrr9rvrrrIrrLruuiduuid4r)rrnamesZjs_listjsrhrhriadd_jss&     zPdfWriter.add_jsfilenamedatacCs>t|tr |d}t}|||ttjtdit }|td| |it }|ttjtdtt j t |tt j|itj|jvrZ| t |jttj<dtt |jtjvrt ttjti}| |tt |jtjtd<ntt tt |jtjd}tt|tjt ||gdS)a Embed a file inside the PDF. Reference: https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf Section 7.11.3 Args: filename: The filename to display. data: The data in the file. zlatin-1z /EmbeddedFile/Fz /Filespecz/EmbeddedFilesN)rrrr=set_datarvrCrrr?rr*FrLZEFrrrrr9extend)rrrZ file_entryZef_entryZfilespecZembedded_files_names_dictionaryrhrhriadd_attachmentsF        zPdfWriter.add_attachmentreaderafter_page_appendcCs@t|j}t|D]}|j|}||}t|r||q dS)a Copy pages from reader to writer. Includes an optional callback parameter which is invoked after pages are appended to the writer. ``append`` should be preferred. Args: reader: a PdfReader object from which to copy page annotations to this writer object. The writer's annots will then be updated. after_page_append: Callback function that is invoked after each page is appended to the writer. Signature includes a reference to the appended page (delegates to append_pages_from_reader). The single parameter of the callback is a reference to the page just appended to the document. N)rrrangercallable)rr r Zreader_num_pagesZreader_page_numberZ reader_pageZ writer_pagerhrhriappend_pages_from_readerHs    z"PdfWriter.append_pages_from_readerrfield annotation font_name font_sizec stt|tj}tddt|d|dt|d|df}|tjtt|jt j  tjd}|dursz6PdfWriter._update_field_annotation..ZTfz/DR/Fontrcsi|] \}}||qSrh)rrkvZ font_encodingrhri sz6PdfWriter._update_field_annotation..cSi|] \}}|t|fqSrhbytesrrhrhrir!cSr"rhr#rrhrhrir!r%zFont dictionary for z not found./Tx/Ch/Vr|\z\\(z\()z\)/Type/XObject/Subtype/Form/BBox__streamdata__/Length/N>r.r,r0r2/Filterr /Resources)4rrGAARectabsZ get_inheritedZDAr?rr)rrrIrreplacesplitrfloatFAFfFfBits Multiline DEFAULT_FONT_HEIGHT_IN_MULTILINErrjoinrr r rNrrritemsr&rZFTZComboZOptrgenerate_appearance_streamr=initialize_from_dictionaryrCr;APrrrrrrB)rrrrrZ_rctrctdaZfont_properties font_heighty_offsetZdrZfont_resZ font_subtype_Zfont_map font_full_revZfont_encoding_revkeyrZ field_flagstxtsel ap_streamdctrrnrhr ri_update_field_annotationhs0              &      $   z"PdfWriter._update_field_annotationfieldsflagsauto_regeneratec Cstj|jvr tdtt|jtj}tj|vrtdt|t r&| ||dur/t |j }t|t rH|D]}t j|vrE||||dq6dSt j|vrTtdtdS|t jD]}tt|}|dddkrkqYd|vrvd |vrv|}n |t jt}|D]\} } ||| ks|d d| ksq|ddd krd |vr|d =|rt||ttj<t| t rtd d | D} | |ttj<nt| trt| d|ttj<n t| |ttj<|tjdvrt| } | |tt j!tdvrtd} | |tt j"<| |ttj<q|tjdks"|tjd krJz:PdfWriter.update_page_form_field_values..rz/Btnr3z/Offr&rrz/Sigz#Signature forms not implemented yet)$r)rrr7rr?r-FieldsrboolrrrrANNOTSupdate_page_form_field_valuesr&rZrrrrBZ_get_qualified_field_namerErCr<r=r9VtuplerIrCr6rFZASrS) rrrTrUrVafprZparent_annotationrrlstrrhrhrirbs !            z'PdfWriter.update_page_form_field_valuesc CsDg}|dur|jD] }|||7}q |Sz tt|jtj}Wnty4t}||jttj<Ynwz tt |t j }WntyRt }||tt j <Ynwd|vrY|Stt |d}t |D];\}}t |t} tt|}|dddkrd|vrd|jvr|j|vrqd| s||||<||j||qd|S)a1 Parse annotations within the page looking for orphan fields and reattach then into the Fields Structure. Args: page: page to analyze. If none is provided, all pages will be analyzed. Returns: list of reattached fields. N/Annotsr.r|rWrXr)rreattach_fieldsrr?rr)rrrCr9r-r_ enumeraterrBrr__dict__rrr) rrrgrfrerT annotationsrrZ is_indirectrhrhririjsB        zPdfWriter.reattach_fieldscCsBd|_|jr2dgtt|jdd|_tt|jD]}||d}|dur0| ||j|<qn|j |j ||_ |j d|_t|jtt|jdksTJ|jr`dd|jD|_||jduskJ|jD]}|tt|jj||js|j|td<qn|jstdd|jDtt|jtd <dSdS) a Copy the reader document root to the writer and all sub-elements, including pages, threads, outlines,... For partial insertion, ``append`` should be considered. Args: reader: PdfReader from which the document root should be copied. N/SizerrcSs g|] }|dur |ndqSNr)hash_bin)rrrhrhrirsz8PdfWriter.clone_reader_document_root../ParentcSsg|]}|jqSrh)r)rrfrhrhrirs/Kids)rrrrtrailerrr rrZ replicaterrrrZraw_getrr_flattenrrrBrrrCr9r?)rr irrfrhrhriclone_reader_document_roots<   z$PdfWriter.clone_reader_document_rootcCs|||j}|jr1|dur0tt||j|_t|jt s#Jd|j |j |jjj d<n|durB| t tt ||_z tt|j||_Wn tyWYnwt|rrtttt |jdD] }||qidSdS)a{ Create a copy (clone) of a document from a PDF file reader cloning section '/Root' and '/Info' and '/ID' of the pdf. Args: reader: PDF file reader instance from which the clone should be created. after_page_append: Callback function that is invoked after each page is appended to the writer. Signature includes a reference to the appended page (delegates to append_pages_from_reader). The single parameter of the callback is a reference to the page just appended to the document. Nrrrq)rurrrrBrrrrr?rorrrrr9rrr r)rr r infrrhrhrirs:    z$PdfWriter.clone_document_from_readercCs,t}|||dtt|dS)Nrutf8)r_write_pdf_structurerr;rzr)rrkrhrhri_compute_document_identifiers  z&PdfWriter._compute_document_identifiercCs8|jr |jd}|}n|}|}t||f|_dS)u" Generate an identifier for the PDF that will be written. The only point of this is ensuring uniqueness. Reproducibility is not required. When a file is first written, both identifiers shall be set to the same value. If both identifiers match when a file reference is resolved, it is very likely that the correct and unchanged file has been found. If only the first identifier matches, a different version of the correct file has been found. see §14.4 "File Identifiers". rN)rryr9)rZid1Zid2rhrhrigenerate_file_identifierss   z#PdfWriter.generate_file_identifiers) algorithm user_passwordowner_password use_128bitpermissions_flagr{cCs|dur|}|dur%z tt|dd}Wnty$td|dwtj}|s-tj}||js6Jt |||jd|_ |j ||}|j rb|j jdusSJ|j j|_||j|jjd<n||||_ dS)a Encrypt this PDF file with the PDF Standard encryption handler. Args: user_password: The password which allows for opening and reading the PDF file with the restrictions provided. owner_password: The password which allows for opening the PDF files without any restrictions. By default, the owner password is the same as the user password. use_128bit: flag as to whether to use 128bit encryption. When false, 40bit encryption will be used. By default, this flag is on. permissions_flag: permissions as described in Table 3.20 of the PDF 1.7 specification. A bit value of 1 means the permission is granted. Hence an integer value of -1 will set all flags. Bit position 3 is for printing, 4 is for modifying content, 5 and 6 control annotations, 9 for form fields, 10 for extraction of text and graphics. algorithm: encrypt algorithm. Values may be one of "RC4-40", "RC4-128", "AES-128", "AES-256-R5", "AES-256". If it is valid, `use_128bit` will be ignored. N-rKz Algorithm 'z' NOT supportedrr)rrr9rrZRC4_128ZRC4_40rzrrmakerZ write_entryrrrrr)rr|r}r~rr{algentryrhrhriencrypt s*!     zPdfWriter.encryptrkcCst|drd|jvrtd|jdt|jr9|jjd| |jj dt | dkr7| |dSdS||\}}||||}|||dS)NmodebzFile to write to is not in binary mode. It may not be written to correctly.rr)hasattrrr&namerZrrrkrrrorlist_objects_in_increment_write_incrementrx_write_xref_table_write_trailer)rrkobject_positions free_objects xref_locationrhrhri write_streamHs   zPdfWriter.write_streamcCsfd}|dkrtd|dt|ttfrt|d}d}|||r+|||fS|||fS)a Write the collection of pages added to this object out as a PDF file. Args: stream: An object to write the file to. The object can support the write method and the tell method, similar to a file object, or be a file path, just like the fileobj, just named it stream to keep existing workflow. Returns: A tuple (bool, IO). Fr|zOutput(stream=z ) is empty.wbT)rrrrrrcloseflush)rrkZmy_filerhrhrir`s  zPdfWriter.writecs$tjfddtjDS)a For analysis or debugging. Provides the list of new or modified objects that will be written in the increment. Deleted objects will not be freed but will become orphans. Returns: List of new or modified IndirectObjects cs>g|]\}}|dur|ks|j|krtt|jqSrn)rorrrBr)rrtroriginal_hash_countrrhrirs z7PdfWriter.list_objects_in_increment..)rrrjrrrhrrirs z#PdfWriter.list_objects_in_incrementcCs\i}g}d}d}t|j}t|jD]T\}}|durf||ks'||j|krf|d} t|ts4Jd||| <|| d  | ||d| |krb|dkr`| |||g| }| d}q|dksoJd| |||g|} t|jd} || d  t d t d t d t | dt d |jjt dt dt dtdd|Dt dtt dt dt dgddi} |jdur|jjjdt|jkstt|j|j|jjjdkr|jj| t tj<t |jj| t tj<|jr|j| t tj<t| } | ddd| D| ||d| d dS)Nrrr 0 obj  endobj rzfor pytest onlyz 0 objr,z/XRefrmz/Rootr4z /FlateDecodez/IndexcSsg|] }|D]}t|qqSrhrE)rZ_suZ_itrhrhrirz.PdfWriter._write_increment..z/Wr1rrcSsg|] }tdd|dqS)s>BIBrr)structpack)r_posrhrhrirr% startxref  %%EOF )!rrrjrrorrFrrrwrite_to_streamrrCrErrr9rrrrBTKINFOrZ _startxrefZPREVrIDrHrErrAvalues)rrkrZ object_blocksZ current_startZ current_stoprrtrrrZxr_idZ init_dataZxrrhrhrirs|             zPdfWriter._write_incrementcCsg}g}||jd|dt|jddD]>\}}|durN||||d|jrC||jkrC|j ||d}| ||dq|d||q|d||fS) N s% r)startrrrr) rrrrjrrrrrZencrypt_objectr)rrkrrrrrhrhrirxs       zPdfWriter._write_pdf_structurerrcCs|}|d|dt|jdd||ddddd d d}|D]+}|dkrD||dddd d q.|||dddd d |d7}q.|S) Nsxref 0 rrrz0>10riz0>5z f z n )rrrrr)rrkrrrZfree_idxoffsetrhrhrirs  " " zPdfWriter._write_xref_tablercCs|dtttjtt|jdttj|j j i}|j dur*|j j |ttj <|j dur7|j |ttj<|jrC|jj |ttj<|||d|ddS)z Write the PDF trailer to the stream. To quote the PDF specification: [The] trailer [gives] the location of the cross-reference table and of certain special objects within the body of the file. strailer rNrr)rr?rCrZSIZErErrROOTrrrrrrrZENCRYPTrr)rrkrrrrhrhrirs    zPdfWriter._write_trailercr)a Retrieve/set the PDF file's document information dictionary, if it exists. Args: value: dict with the entries to be set. if None : remove the /Info entry from the pdf. Note that some PDF files use (XMP) metadata streams instead of document information dictionaries, and these metadata streams will not be accessed by this function, but by :meth:`~xmp_metadata`. )rmetadatarrrhrirs zPdfWriter.metadatacCs4|dur d|_dS|jdur|j||dSrn)rr add_metadatarrhrhrir*s    infoscCszi}t|trtt|}t|D]\}}t|tr!|}tt||t |<q|j dur5t|_ |j |dS)z Add custom metadata to the output. Args: infos: a Python dictionary where each key is a field and each value is your new metadata. N) rrFrr?rrrBrLrrCrrv)rrargsrMrrhrhrir7s   zPdfWriter.add_metadataremove_identicalsremove_orphansc sdtdtttfddffdd i|_dgt|jt|jD]=\}}t|r+q"|dus3Jdt|j ts;J| }|rW||jvrW|j|d  |j d|j|<q"|j gf|j|<q"d d |j D}i}| D]\}} |t| |ft| qp|jD]}t|ttfr||qd |jj jd <d |jj jd <z d |jj jd <Wn tyYnwttt|jD]} d|j| <qdS) aE Parse the PDF file and merge objects that have the same hash. This will make objects common to multiple pages. Recommended to be used just before writing output. Args: remove_identicals: Remove identical objects. remove_orphans: Remove unreferenced objects. rcrossrefrmNcst|tr |}n t|trt|}ndSt|ttfsJ|D]!\}}t|tr.replace_in_objTrrcSs*i|]}t|ddkr|d|dqS)rrrr\rhrhrir!s*z8PdfWriter.compress_identical_objects..F)rFr rBrrrrjrNrr hash_valuerrrBrvzipr?r9rrrrrrr ) rrrrrhZcnvZcnv_revrrrtrhrricompress_identical_objectsKsJ      z$PdfWriter.compress_identical_objectsrootcCs tddS)a Resolving any circular references to Page objects. Circular references to Page objects can arise when objects such as annotations refer to their associated page. If these references are not properly handled, the PDF file will contain multiple copies of the same Page object. To address this problem, Page objects store their original object reference number. This method adds the reference number of any circularly referenced Page objects to an external reference map. This ensures that self-referencing trees reference the correct new object location, rather than copying in a new copy of the Page object. Args: root: The root of the PDF object tree to sweep. zb_sweep_indirect_references has been removed, please report to dev team if this warning is observedN)r#)rrrhrhri_sweep_indirect_referencessz$PdfWriter._sweep_indirect_referencescCstdtdd|S)a Resolves an indirect object to an indirect object in this PDF file. If the input indirect object already belongs to this PDF file, it is returned directly. Otherwise, the object is retrieved from the input object's PDF file using the object's ID number and generation number. If the object cannot be found, a warning is logged and a `NullObject` is returned. If the object is not already in this PDF file, it is added to the file's list of objects and assigned a new ID number and generation number of 0. The hash value of the object is then added to the `_idnum_hash` dictionary, with the corresponding `IndirectObject` reference as the value. Args: data: The `IndirectObject` to resolve. Returns: The resolved `IndirectObject` in this PDF file. Raises: ValueError: If the input stream is closed. z`_resolve_indirect_object has been removed, please report to dev team if this warning is observedr)r#rB)rrrhrhri_resolve_indirect_objects z"PdfWriter._resolve_indirect_objectcCs0|j|d}t|d|}||ksJ|SNrr)rrrBr)rrrrefrhrhri get_references zPdfWriter.get_referencecCstj|jvr:tt|jtj}t|ts"t|}||jj||}|j |d}t |d|}| |ks8J|St}| i||}||jttj<|Sr)rOUTLINESrrrJrrrrrrrBrrvrrC)routlinerrZ outline_refrhrhriget_outline_roots     zPdfWriter.get_outline_rootcCs<tj|jvrtt|jtj}|St}||jttj<|S)u The list of threads. See §12.4.3 of the PDF 1.7 or PDF 2.0 specification. Returns: An array (possibly empty) of Dictionaries with an ``/F`` key, and optionally information about the thread in ``/I`` or ``/Metadata`` keys. )rZTHREADSrrr9rC)rthreadsrhrhriget_threads_roots zPdfWriter.get_threads_rootcC|S)u  Read-only property for the list of threads. See §12.4.3 of the PDF 1.7 or PDF 2.0 specification. Each element is a dictionary with an ``/F`` key, and optionally information about the thread in ``/I`` or ``/Metadata`` keys. )rrrhrhrirs zPdfWriter.threadspage_destinationparentbeforeis_opencCstt|}t|tr|td|jtt|jt S|dur'| }t ||t d<tt|}||}|durB|j}|||||rL|jnddd|vr]td|t d<|S)Nzpage #z /%is_open%cSrrnrh)ryrhrhrirq1sz8PdfWriter.add_outline_item_destination..z/Countr)rrrradd_outline_item_destinationr>rrBrr@fitrr:rCrJr insert_childZinc_parent_counter_outlinerE)rrrrrpage_destination_refrhrhrirs6    z&PdfWriter.add_outline_item_destination outline_itemcCs"t}|| |||||Srn)rJrvr)rrrrrZoutline_item_objectrhrhriadd_outline_item_dict8s   zPdfWriter.add_outline_item_dicttitlercolorbolditalicrc  Cs4t|tr|dur|dur|}|j|||d||||| d S|dur$d} n[t|tr,|} n$t|tr5|j} nt|trPz|j|j} Wn tyOt |} Ynw| dur_t d|t t } t td|d| |} |tttj| jttjtdi} |t| ||||} |dur|}|| ||| S)a Add an outline item (commonly referred to as a "Bookmark") to the PDF file. Args: title: Title to use for this outline item. page_number: Page number this outline item will point to. parent: A reference to a parent outline item to create nested outline items. before: color: Color of the outline item's font as a red, green, blue tuple from 0.0 to 1.0 or as a Hex String (#RRGGBB) bold: Outline item font is bold italic: Outline item font is italic fit: The fit of the destination page. Returns: The added outline item as an indirect object. N)rzcan not find reference of page /z outline item/GoTo)rr@add_outline_itemrBrrrr IndexErrorrEr&rZrDr>rCrr?r+DrS_create_outline_itemrr)rrrrrrrrrr action_refpage_refrrrhrhrirOsT       zPdfWriter.add_outline_itemcCstd)NzIThis method is not yet implemented. Use :meth:`add_outline_item` instead.)NotImplementedErrorrrhrhri add_outlineszPdfWriter.add_outline destinationcCsn|}d}|t|kr,|||kr"|||||t|dS|d7}|t|ks |t||gdS)Nrr)get_named_dest_rootrrrIr)rrrZ named_destrtrhrhriadd_named_destination_arrays    z%PdfWriter.add_named_destination_arraycCs&||j}|td|d||S)NrI/Title)rrrr)rrrrhrhriadd_named_destination_objects z&PdfWriter.add_named_destination_objectcCs||jtj|}t}|ttjt |tt j t dgttj tdi||}t|ts9tt|}||||S)Ni:r)rrrrr?rvrCr+rr9r0ZFIT_HrErrrrIrr)rrrrrZdest_refrhrhriadd_named_destinations    zPdfWriter.add_named_destinationcCs|jD] }||tjqdS)z.Remove links and annotations from this output.N)rremove_objects_from_pagerYrd)rrrhrhri remove_linkss zPdfWriter.remove_linkssubtypescCs|jD]}|||qdS)aC Remove annotations by annotation subtype. Args: subtypes: subtype or list of subtypes to be removed. Examples are: "/Link", "/FileAttachment", "/Sound", "/Movie", "/Screen", ... If you want to remove all annotations, use subtypes=None. N)r_remove_annots_from_page)rrrrhrhriremove_annotationss zPdfWriter.remove_annotationscCstt|}tj|vr_d}|ttt|tjkratt|tj|}tt|}|dus8tt|d|vrMt|t rFt |j |j d<|tj|=n|d7}|ttt|tjksdSdSdS)Nrr.r) rr?rrrarr9rrrBrDrr)rrrrtanrrhrhrirs  z"PdfWriter._remove_annots_from_page to_delete text_filtersc stttfrD]}||q dSttsJtj@r&|dStj@r1|dStj@r<|dStj @rG|dSgtj @rRgdtj @r[gd ddt dt td t td ttttfd df fd d dtdt td tt tt tfffdd t|tst|j}d|vrtt |}|g\}}|||||dSdS)a Remove objects specified by ``to_delete`` from the given page. Args: page: Page object to clean up. to_delete: Objects to be deleted; can be a ``ObjectDeletionFlag`` or a list of ObjectDeletionFlag text_filters: Properties of text to be deleted, if applicable. Optional. This is a Python dictionary with the following properties: * font_ids: List of font resource IDs (such as /F1 or /T1_0) to be deleted. N)/Link)z/FileAttachmentz/Soundz/Moviez/Screen)z/3D)wJjMdiWsW*bsb*BsB*Ssfsf*Fnmlcvyhsressh)sTjsTJ'"contentimagesformsrrmc sd}g}|rtj@r|dg}d}|t|jkro|j|\}}|dkr)|d}|dkr2tj@sE|vsE|dkrdtj@rd|d|vrdtj@rZtj@rQ|rZtj@r_||vr_|j|=n |d7}n|d7}|t|jks|dS)Nfont_idsrsTfs INLINE IMAGEsDor)rYr`rr operationsrfreget_data) rrrrZfont_idZfont_ids_to_deletertZoperandsoperator)jump_operatorsrrhriclean+s>     z1PdfWriter.remove_objects_from_page..cleaneltstackc s|vstdrtfdd|DrggfSzttttfttdd}Wn ty5i}Ynwg}g}|D]\}}|}znd}t j @r\|ddkr\t }| ||ddkr| |t |tro|}n!t|}|d d |Dz|j|_Wn tyYnw| |||durt |tr|j|jd <n|||<Wq>ttfyYq>w|D]} || =qt trt tst} | | ||||fS) Nrc3s"|] }jt|ddkVqdS)rrN)rrrr rhrir]\s  zJPdfWriter.remove_objects_from_page..clean_forms..r5r-r.z/Imager/cSsi|] \}}|dvr||qS))r2r4z /DecodeParmsrh)rZk1Zv1rhrhrir!}s zKPdfWriter.remove_objects_from_page..clean_forms..r)ranyrr r r?rrBrrYrerDrrr<rvrrrBrrr TypeErrorrH) r rdrrrrrrZime)r  clean_formsrrrrrirUsz                 z7PdfWriter.remove_objects_from_page..clean_formsz /Contentsrn)rrrdrrYrarrbrcrdrgr`r<r rrr r r?rrrrZ get_contentsZreplace_contents)rrrrZto_drrrrh)r rr rrrrirs`         * G z"PdfWriter.remove_objects_from_pagecCsTt|trtj}tj}dD]}|t|@r|t|O}q |jD]}|||qdS)z Remove images from this output. Args: to_delete: The type of images to be deleted (default = all images types) )rerfrgN)rr`r,ALLrYr]rr)rrrtimagerrhrhri remove_imagess    zPdfWriter.remove_images font_namesc s|sg}|jD]N}g}|rD  d dtdttttfdttdtttfffdd |d}|D]}||vrC|||d q4i}|rL||d <|j|tj |d qdS) z Remove text from the PDF. Args: font_names: List of font names to remove, such as "Helvetica-Bold". Optional. If not specified, all text will be removed. Nr font_inforMrmcs|duri}t|tr|}t|trV|ddkrG|dd}|ddd}||vr6|gd||<|||d vrG||d ||D] }||||}qI|St|tt frg|D]}||}q_|S) Nr,rz /BaseFontr|r+r)normalized_font_name resource_idsr) rrBrdictrlstripr:rrr9)rrrMrrrZ child_obj get_font_inforhrir s*     z,PdfWriter.remove_text..get_font_infor5rr)rNN) rr rr rrrrrYr`)rrrZresource_ids_to_removerrrrhrri remove_texts4  zPdfWriter.remove_texturirectborderc Cs||jtj|}ttttf||}|dur=dd|ddD}t|dkr` or array of four integers specifying the clickable rectangular area ``[xLL, yLL, xUR, yUR]``, or string in the form ``"[ xLL yLL xUR yUR ]"``. border: if provided, an array describing border-drawing properties. See the PDF spec for details. No border will be drawn if this argument is omitted. NcSg|]}t|qSrhrrrRrhrhrir z%PdfWriter.add_uri..rrcSr&rhrr'rhrhrir r(rrz/URIz/Annotrz/HrZ/A)rrrrrr rr rr9rrErrGr?rvrCrIr6rZSubtypePr7ZBorderrrra) rrr#r$r%Z page_linkrZ border_arrZ dash_patternZlnk2ZlnkZlnk_refrhrhriadd_urisF           zPdfWriter.add_uri)z /NoLayoutz /SinglePagez /OneColumnz/TwoColumnLeftz/TwoColumnRightz /TwoPageLeftz /TwoPageRightcC(z tt|jdWStyYdSw)N /PageLayout)rrSrrrrhrhri_get_page_layoutD  zPdfWriter._get_page_layoutlayoutcCsPt|ts||jvrtddd|jftt|}|jtd|idS)a Set the page layout. Args: layout: The page layout to be used. .. list-table:: Valid ``layout`` arguments :widths: 50 200 * - /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 zLayout should be one of: r|r-N)rrC_valid_layoutsr&rArZrrvrr0rhrhri_set_page_layoutJ s  zPdfWriter._set_page_layoutcCs||dS)a Set the page layout. Args: layout: The page layout to be used .. list-table:: Valid ``layout`` arguments :widths: 50 200 * - /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 Nr3r2rhrhriset_page_layoutm szPdfWriter.set_page_layoutcCr)a Page layout property. .. list-table:: Valid ``layout`` values :widths: 50 200 * - /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 )r.rrhrhri page_layout szPdfWriter.page_layoutcCs||dSrnr4r2rhrhrir6 s)z/UseNonez /UseOutlinesz /UseThumbsz /FullScreenz/UseOCz/UseAttachmentscCr,)N /PageMode)rrVrrrrhrhri_get_page_mode r/zPdfWriter._get_page_modecCr)a Page mode property. .. list-table:: Valid ``mode`` values :widths: 50 200 * - /UseNone - Do not show outline or thumbnails panels * - /UseOutlines - Show outline (aka bookmarks) panel * - /UseThumbs - Show page thumbnails panel * - /FullScreen - Fullscreen view * - /UseOC - Show Optional Content Group (OCG) panel * - /UseAttachments - Show attachments panel )r8rrhrhri page_mode szPdfWriter.page_modercCsRt|tr|}n||jvrtdd|jtt|}|jtd|idS)NzMode should be one of: z, r7)rrC _valid_modesr&rArZrrv)rrZ mode_namerhrhrir9 s  cCs |}t|tr |j|}n t|tstdttt|}|j|t d<|j dur0t |t d<|j dus7J| ddkrjd|vrjtt ttf|t d}tt d|d t|d t|d d }|j|t d<|j ||| dd krt d|vr|jtt|dt d <|S)a Add a single annotation to the page. The added annotation must be a new annotation. It cannot be recycled. Args: page_number: PageObject or page index. annotation: Annotation to be added (created with annotation). Returns: The inserted object. This can be used for popup creation, for example. zpage: invalid type/PNrhr.r/Destz /LinkNameZtarget_page_indexrfit_args)Zfit_typer=z/Popuprp)rrrrrrr?_pdf_objectifyrrCrlr9rr r r>r@rrrrr)rrrrto_addtmprrhrhriadd_annotation s6    zPdfWriter.add_annotationcCstd|}|dgD];}|}|dd}|dd}t|tr-t||td<q |durH|}|dd}t|trHt||td<q |S)z Perform some clean up in the page. Currently: convert NameObject named destination to TextStringObject (required for names/dests list) Args: page: Returns: The cleaned PageObject rrhr<Nr)/D)rrrrrCrI)rraZa_objrZactrhrhri clean_page s      zPdfWriter.clean_pagecCsd}t|ttfr+t|d}t|}Wd||fS1s"wY||fSt|trR|jr6|j}|j }|j dt|j}|j |||fSt |drmt |drm| d|}t|}||fSt d)NrrrrozMerging requires an object that PdfReader can parse. Typically, that is a Path or a string representing a Path, a file object, or an object implementing .seek and .read. Passing a PdfReader directly works as well.) rrrrrrorrrkrrrr)rr}encryption_objrrkZ orig_tellZ filecontentrhrhri_create_stream) s0         zPdfWriter._create_streamrimport_outlineexcluded_fields.cCsl|durd}t|tttfr*t|trt|ts|}|}|}|d|d|||dS|d|||||dS)aQ 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. Args: 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. outline_item: Optionally, you may specify a string to build an outline (aka 'bookmark') to identify the beginning of the included file. pages: Can be a :class:`PageRange` or a ``(start, stop[, step])`` tuple or a list of pages to be processed to merge only the specified range of pages from the source document into the output document. import_outline: You may prevent the source document's outline (collection of outline items, previously referred to as 'bookmarks') from being imported by specifying this as ``False``. excluded_fields: Provide the list of fields/keys to be ignored if ``/Annots`` is part of the list, the annotation will be ignored if ``/B`` is part of the list, the articles will be ignored Nrh)rrdrrOr`merge)rr}rrrGrHrhrhrirM s0*   zPdfWriter.appendpositionc st|tr|n |\}}t|dd|durd}|dur)tttj}n3t|tr;tt| tj}n!t|trAnt|t rSt|dkrStt|}n t|t s\t di|D]S} t| t rj| } nj| } | j dusvJ|dur| gt|dddd | j j<n| |gt|dddd | j j<|d7}| | j j_q`j_d td dffd d } jD]} | | q|durtdjt|ttj td} n} j}|rtj |vr!|"tj d}#|| dd |vr;D]"}$|j"d d|}t|dkr4||t%d <&|qd|vr|ddurdj'vrf(tt)jd*ddj't%d<t+}n tt+tt)j'dd}j,t-}z-jddD]#}zt.||jd}||vr|/|Wqt0yYqwWnt0y(t+}Ynw|tt)j'dt%d<d|vr҈1ddSdS)a Merge the pages from the given file into the output file at the specified page number. Args: position: The *page number* to insert this file. File will be inserted after the given number. 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. outline_item: Optionally, you may specify a string to build an outline (aka 'bookmark') to identify the beginning of the included file. pages: can be a :class:`PageRange` or a ``(start, stop[, step])`` tuple or a list of pages to be processed to merge only the specified range of pages from the source document into the output document. import_outline: You may prevent the source document's outline (collection of outline items, previously referred to as 'bookmarks') from being imported by specifying this as ``False``. excluded_fields: provide the list of fields/keys to be ignored if ``/Annots`` is part of the list, the annotation will be ignored if ``/B`` is part of the list, the articles will be ignored Raises: TypeError: The pages attribute is not configured properly F)strictNrhrz:"pages" must be a tuple of (start, stop[, step]) or a listr/Brhrrmc s:|j}djvr(|dtttttttjddtdtvr(dS|ddus5t|dtr7dSt|dt r|z j |d}Wn t yQYdSw|j dusYJzt |j jj|t d<|d|WdSty{YdSw|dj jvr|dj jj |t d<|d|dSdS)Nrrz/Dests/Pager)rrrr r r?rrrDrrrrrErrrr)rarrrfr rZsrcpagesrhri_process_named_dests sF       z-PdfWriter.merge.._process_named_destsrJ)rrz /AcroForm)/FieldsrQr|)2rrrFrrr rrrOindicesrdrrrrrr original_pageZnamed_destinationsZ_named_destinationsr rrrrInextrur8rrrrr_get_filtered_outliner_insert_filtered_outline_insert_filtered_annotationsrCrDrrr?rr9rrrBrradd_filtered_articles)rrJr}rrrGrHrkrErZpgrPrZoutline_item_typZ_rorpagrgrNZtrslatrindrhrOrirI s &       "           zPdfWriter.mergethreadc Csx|j|ddd}|j|jtd|d}|}d}|dur|td|d||}|dur|durGtd|t}|} |j|t d<ntd|tt d |ji} | j|t d <| }||t d<|j|t d <|d |t d <td|} d | vrt | t d <td| d |jtd|d }||kr| j|t d <|j| t d <d}|dus|jdusJ|jS)z Clone the thread with only the applicable articles. Args: thread: pages: reader: Returns: The added thread as an indirect reference T)r)Zforce_duplicate ignore_fieldsr?rNrr;r(r3rYz/RrLr9) rrrrr_get_cloned_pagerr?rrCr9) rr[rr ZnthreadZ first_articleZcurrent_articleZ new_articlerYZ new_firstZ new_article2Zpag_objrhrhri_add_articles_threadO s^  %zPdfWriter._add_articles_threadfltrcCst|tr t|}n t|tstd}|D]=}|j}|ddD]1}|d}|dur2q$|}|j j |j t |vrU| |diddrU||||q$qdS)z Add articles matching the defined criteria. Args: fltr: pages: reader: r|rLrhrYNrZr)rrrecompilerrrSrrrrrrsearchr^)rr_rr rfpprCZthrrhrhrirX s(      zPdfWriter.add_filtered_articlescCsbt|trdSt|tr|dddkr|j}nt|tr|}z||jjWSty0YdSw)Nr,r|rM)rrDr?rrrBrr)rrrr Z_irhrhrir] s   zPdfWriter._get_cloned_pageannotsc Cst}t|trtd|}|dur|S|D]}td|}|ddks9d|vs9td|dddks9d|vrd|vrI||||q|d}t|trdt|| vrc|||j qtd |}| |d ||} | dur|j|d d } t| g|d d| t d<||| qtd|d dt}|dust|trqt|trt|| vr|||j qtd |}| |d ||} | dur|j|dd } t| g|d dtd| dt d<||| q|S)Nz List[Any]r?r.rr)rrr<r9r)r<)r\rrB)rB)r9rrBrrrrrrrrr]rCrrD) rrdrrr ZoutlistrZanorrfZancrhrhrirW sV       z&PdfWriter._insert_filtered_annotationsrcCs&g}|dur t}|}t|rt}|dddks d|vr9|dd}|dur7|}|||||7}|S|dur|}td||}|td|d ||}|dur\t}||t d <d|vrq||d|||_ ng|_ t |d trt |j d kr| ||d d}|dus=|S) z Extract outline item entries that are part of the specified page set. Args: node: pages: reader: Returns: A list of destination objects. Nr,r| /Outlinesr/Firstr>rrMr/Next)rDrrNr?rrUrZ_build_outline_itemr]rC_filtered_childrenrrr)rrrr Z new_outlinerrrhrhrirU s>      zPdfWriter._get_filtered_outlinecCst}||t|d|td<t|dts7|jdur0d|jvr0|jd||td<n|j|td<|jdur_t |j dd|td<t |j dt dt dt dg|td<|S) NrrMr)r<rr/Cg) rJrrIrCrrDrrrrErr9rA)rrZn_olrhrhri_clone_outline, s   zPdfWriter._clone_outlineoutlinescCs^|D]*}|dddksd|vr|}n||}tt||||||j|dqdS)Nr,r|rer)rrjrrJrrrVrh)rrkrrrnprhrhrirV? s z"PdfWriter._insert_filtered_outlinecCr)z"Implemented for API harmonization.NrhrrhrhrirO szPdfWriter.closecCs|dur |}ntd|}d}|durZ|j|ks!|dd|kr$|gSd|vrB||tt|d}|rBd|vr>|g|Sg|Sd|vrR|d7}tt|d}ndS|dusdSdS)NrJrrrfrgr)rrrrfind_outline_itemrUrJ)rrrrrtresrhrhrirmS s&   zPdfWriter.find_outline_itemcCstddddS)zZ .. deprecated:: 2.9.0 Use :meth:`find_outline_item` instead. find_bookmarkrmz5.0.0N)r%)rrrrhrhrirop s zPdfWriter.find_bookmarkcCs|dur i|_dSt|tr"z |jt|=WdSty!YdSwt|tr.csi|] \}}|vr||qSrhrhr)rxrhrir!& r)rrrB)rrwrxZpdf_datarrh)rxrwri_repr_mimebundle_ s zPdfWriter._repr_mimebundle_)r|NFF)rmr{)rh)T)rrhr!)NNrrn)r|r)rmN)TT)NNT)NNTN)NNTrh)rZr[r\__doc__rrr rr`rpropertyrr?rrrsetterrBrWrrrr BaseExceptionrrrrr$rFrrrrrr rrrKrrrrDrr;rdecimalDecimalrr>rIr;rrr r rrSr<r>Z FFBITS_NULr r rrbrirurryrzALL_DOCUMENT_PERMISSIONSr1rr!rrr rrrrxrrrrrrr9r:rArCrErrrrJrrrrrTrr8r@rrrrrrrQrrrYrr,rrr"rGr+r1rSr.r3r5r6r:rVr8r9rArDrrrFrOrrPrIr^rrXr]rWrUrjrVrrUrmrorpr/rvrury __classcell__rhrhrrir{sz               /!      " $_ $  " m 2* 0  ;& "G    K # !    )        N           0 > C #    6  ) $   H  ?  A   !    6  4          7C r{rcCst|tr|St|tr"t}|D] \}}t||t|<q|St|tr4|dr0t|St |St|t t fr?t |St|t rMtdd|DStdt|d)Nrcsr[rn)r>)rrtrhrhrir]: r^z!_pdf_objectify..z type(obj)=z! could not be cast to a PdfObject)rrFrr?rBr>rCr startswithrIr;rrArr9rtype)rr?rMrrhrhrir>+ s$     r>rrrrrcCst}|dur ||td<|tdt|i|r3t|tr#t|}|tdtdd|Di|s7|rRd}|r@|tj 7}|rG|tj 7}|tdt |i|S)Nr)rricSr&rh)rArrrhrhrirS r(z(_create_outline_item..rr) rJrCrvrLrrrMr9r.rrrE)rrrrrrZ format_flagrhrhrir@ s*     rrNrOrHrLrGrIrJc s.d|jdd|jdd|d}t|dddD]q\}} | |vrG|d|||ddd|jd d|d d |d 7}|d krV|d |d 7}n |d| dd 7}fdd| D} tdd| Dr|dd| d7}q|dd| d7}q|d7}|S)Nzq /Tx BMC q 1 1 rrz re W BT rrz1 gffffff?rz re 0.5 0.5 0.5 rg s rz2 z Td rcsg|] }||dqS)z utf-16-be)rrrrLrhriru sz.generate_appearance_stream..css|] }t|dkVqdS)rNrrrhrhrir]x sz-generate_appearance_stream.. Tj (s) Tj s ET Q EMC Q ) rrrrjr9r:rrAhex) rNrOrHrLrGrIrJrP line_numberlineZenc_linerhrrirD_ s(( .  rD)rj)r~r^rsr`rriorrr itertoolsrpathlibrtypesrtypingrr r r r r rrrrrrZ_cmaprrZ _doc_commonrrrrrZ_pagerZ _page_labelsrrrrrZ_utilsr r!r"r#r$r%r& constantsr'r6r(rr)r*r+r,r-r.r/r0r1r2rr3r<r4rr5rr6rerrorsr7Zgenericr8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNZ pagerangerOrPrQrRrSrTrUrVZxmprWallrr@IntFlagrYrrrzr{r;r>r`rr$rDrhrhrhris   8  $ ,     d   */