U ._objs_to_check)Zsince_revision) explicit_refs_in_revisionreaderget_historical_resolverrevisionsetZis_ref_availableaddrr PdfObjectnext StopIterationZcollect_dependencies)r#Znew_refspreviousZcandidate_orphansrefr*Zobj_iterobjr(r'r) _find_orphans1s(      r7) old_object new_objectcs0tjtjtjtjtjtjf}|D]$}t|r t|o>kSq tjtj f}t|rrt|opj j kSttj rttj ot t kot ddtDSttjrttjrֈjjksdSttjr(ttjrks dSt fddDStdS)Ncss|]\}}t||VqdSr%)_is_id).0xyr(r(r) }sz_is_id..Fc3s$|]}t||VqdSr%)r:Zraw_get)r;kr9r8r(r)r>s)rZ NumberObjectZ FloatObjectZ BooleanObjectZ NameObjectZ NullObjectZIndirectObject isinstanceZTextStringObjectZByteStringObjectoriginal_bytesZ ArrayObjectlenallzipZ StreamObjectZ encoded_dataZDictionaryObjectkeysNotImplementedError)r8r9 primitivesZprimstringsr(r@r)r:esJ           r:c@szeZdZdZd eeeedddZde e ee ee e ddd Z deeee fee ee ee efd d d ZdS)r a Run a list of rules to analyse the differences between two revisions. :param global_rules: The :class:`.QualifiedWhitelistRule` objects encoding the rules to apply. :param form_rule: The :class:`.FormUpdatingRule` that adjudicates changes to form fields and their values. :param reject_object_freeing: Always fail revisions that free objects that existed prior to signing. .. note:: PyHanko resolves freed references to the ``null`` object in PDF, and a freeing instruction in a cross-reference section is always registered as a change that needs to be approved, regardless of the value of this setting. It is theoretically possible for a rule to permit deleting content, in which case allowing objects to be freed might be reasonable. That said, pyHanko takes the conservative default position to reject all object freeing instructions as suspect. :param ignore_orphaned_objects: Some PDF writers create objects that aren't used anywhere (tsk tsk). Since those don't affect the "actual" document content, they can usually be ignored. If ``True``, newly created orphaned objects will be cleared at level :attr:`.ModificationLevel.LTA_UPDATES`. Default is ``True``. :param ignore_orphaned_objects: Some PDF writers overwrite objects with identical copies. Pointless and annoying, but also more or less harmless. T global_rules form_rulecCs"||_||_||_||_||_dSr%)rKrLreject_object_freeingignore_orphaned_objectsignore_identical_objects)selfrKrLrMrNrOr(r(r)__init__s zStandardDiffPolicy.__init__N)oldnewfield_mdp_specdoc_mdpr$cs|tjkrtd|jr6}|r6td|dtt fdd}|j rxt D]}t j |qbt|t tdfdd }|jD]$} | D]\} } || | qqt } |jrh|j} fd d }| D]v\} }|| ||j}|dk rF|jsF||rszDStandardDiffPolicy.apply.._init_multi_lut..)Z_load_reverse_xref_cacheZ_get_usages_of_refrNONE)Znew_refusagesZcontexts) new_xrefsrRr(r)_init_multi_luts  z1StandardDiffPolicy.apply.._init_multi_lut)_level_updcsj}zv|\}}j}|tjkr,t}n.|tjkrNtfdd|D}n |jt||}||f|<|rzWdSWnt k rYnX| |dS)Nc3s|]}|jjkr|VqdSr%)Z relative_viewcontext_checked)r;ctxr^r(r)r>s z?StandardDiffPolicy.apply..ingest_ref..) updated_refZ approval_typerZBLANKET_APPROVEr/ZAPPROVE_RELATIVE_CONTEXTdiscardr_maxKeyErrorr0)r]r^r5Zcurrent_max_levelrZZupd_type) explainedold_usages_to_clearrar) ingest_refs$        z,StandardDiffPolicy.apply..ingest_refcsdk o|Sr%) is_locked)Zfq_name)rTr(r)ri!s z+StandardDiffPolicy.apply..is_lockedz Update of z' is not allowed because the form field z is locked.zL is only allowed after an approval signature, not a certification signature.c3s6|].}|jdk rt||r|VqdSr%)Zget_historical_refr.r:)r;Zunex_ref)rSrR xref_cacher(r)r>As  z+StandardDiffPolicy.apply..z5Found identical overridden objects between revisions  and z+; following no-op changes will be ignored:  css.|]&}dt|t|ddfVqdS)z%s:%s...Ni,)reprZ get_objectr;r<r(r(r)r>Usz$Unexplained xrefs in revision %d: %sc Ss>g|]6\}\}}|rdt|dddd|DdqS)z - z is also used in , css|]}t|VqdSr%)strrVr(r(r)r>^sz6StandardDiffPolicy.apply...z in the prior revision.)rmjoin)r;r5_Zpaths_remainingr(r(r) ]s z,StandardDiffPolicy.apply..z(There are unexplained xrefs in revision z: rocss|]}t|VqdSr%)rmrnr(r(r)r>es.zSome objects from revision z were replaced in revision z without precise justification: z%s %s)modification_levelchanged_form_fields)&r ZANNOTATEloggerwarningrMZrefs_freed_in_revisionrr+rr/rNr7r LTA_UPDATESr0dictrrKZapply_qualifiedrLapply field_nameZvalid_when_lockedrbZvalid_when_certifyingZ FORM_FILLINGZ ANNOTATIONSr,xrefsrOdebugr.difference_updaterZLazyJoinitemsrqr)rPrRrSrTrUZfreedr\r&rhZrulelevelZupdrvZ form_changesriZfur|Zunexplained_ltaZunexplained_formfillZunexplained_annotZidentical_objsmsgZunexplained_overrideserr_msgZunchecked_paths_msgr()rfrTrSr[rRrgrjr)r{s                 "   zStandardDiffPolicy.apply)r, base_revisionrTrUr$c Cst}|jj}tj}t|tr.||}|} n |}|j} t | d|D]} z|j ||| ||d} WnHt k r} z*t j d| d| | d| WYSd} ~ XYnXt|| j}|| jO}qFt||S)z Implementation of :meth:`.DiffPolicy.review_file` that reviews each intermediate revision between the base revision and the current one individually. r )rRrSrTrUz)Error in diff operation between revision rk)exc_infoN)r/r}Ztotal_revisionsrrYrAintr-r.ranger{rrwrxrdrurvr) rPr,rrTrUrvZ rev_countZ current_maxZbase_rev_resolverZbase_revision_nor.Z diff_resulter(r(r) review_file}s2      zStandardDiffPolicy.review_file)TTT)NN)NN)__name__ __module__ __qualname____doc__rrrrrQr r r rr{r rrrrr(r(r(r)r s6%  =  )Z field_rulesrJ)6rlogging collectionsrtypingrrrrZpyhanko.pdf_utilsrrZpyhanko.pdf_utils.readerr r Zpyhanko.sign.fieldsr r Zform_rules_apirZ policy_apirrrrZrules.file_structure_rulesrrrZrules.form_field_rulesrrrrZrules.metadata_rulesrrZ rules_apirrrr getLoggerrrw__all__r7r1r:r Z as_qualifiedryr!r"r(r(r(r)sN   40%     &