U c@spdZddlZddlmZddlmZddlmZmZm Z m Z ddl m Z m Z mZmZmZmZddlmZmZdd lmZdd lmZdd lmZd d lmZeeZddddddgZ e e dddZ!e dddZ"GdddZ#eddGddde#Z$eddGddde#Z%Gdd d ej&Z'eddGd!ddZ(Gd"ddZ)Gd#ddZ*Gd$d%d%e)Z+dS)&z Module defining common API types for use by rules and policies. In principle, these aren't relevant to the high-level validation API. N) dataclass)field)IterableOptionalTupleUnion) ArrayObjectDereferenceableDictionaryObjectIndirectObject ReferenceTrailerReference)HistoricalResolver RawPdfPath)misc) PdfHandler)TrailerDictionary)ModificationLevelQualifiedWhitelistRule WhitelistRuleReferenceUpdateContextRelativeContextAbsoluteContextabcCsTt|trt|trdSt|ttfrLt|ttfrL|j|jkoJ|j|jkSdSdS)NTF) isinstancer r r idnum generationrr"H/tmp/pip-unpacked-wheel-0kb_yl26/pyhanko/sign/diff_analysis/rules_api.py _eq_deref#s r$rcCs6t|trtdSt|ttfr2td|j|jfSdS)N)rrrr)rr hashr r r r!r%r"r"r# _hash_deref-s r'c@sdeZdZeeeddddZeeee feee e fddddZ eee e fdd d d Z d S) rr) pdf_handler absolute_pathreturncCs t||dS)N)r(path)r)clsr(r)r"r"r# from_absolute6szContext.from_absoluter)startr+r*c Cs|j}t|ttfrt|}|j|dd}t}t|D]F\}\}}t|trh|t|krh|j }t}q8t|ttfr8||7}q8t ||S)NF)Ztransparent_dereference) Z container_refrintstrrZ walk_nodes enumerater len referencer) r,r.r+Zcur_refwalkrel_pathixnodeobjr"r"r# relative_to;s zContext.relative_tor+r*cCstdSNNotImplementedErrorselfr+r"r"r#descendNszContext.descendN)__name__ __module__ __qualname__ classmethodrrr-rr rr/r0r9r@r"r"r"r#r4s  T)frozenc@sHeZdZUeed<eed<eeeefddddZ ddZ dd Z d S) ranchor relative_pathr:cCsF|j}tttf}t||s2td|jd|j ||j |S)NzAnchor z is not a container object) rFZ get_objectr rrrrZ PdfReadError __class__r9rG)r?r+rootZ containersr"r"r#r@_s    zRelativeContext.descendcCstdt|j|jfS)Nrel)r&r'rFrGr?r"r"r#__hash__hszRelativeContext.__hash__cCs$t|to"|j|jko"t|j|jSr;)rrrGr$rF)r?otherr"r"r#__eq__ks    zRelativeContext.__eq__N) rArBrCr __annotations__rrr/r0r@rLrNr"r"r"r#rRs  c@sZeZdZUeed<edddddZeed<ee dddZ e ee e fdd d d ZdS) rr+FN)reprr&comparedefaultr(r*cCst|jj|jSr;)rr9r(Z trailer_viewr+rKr"r"r# relative_viewszAbsoluteContext.relative_viewr:cCst|j||jSr;)rr+r(r>r"r"r#r@szAbsoluteContext.descend)rArBrCrrOdataclass_fieldr(rpropertyrrTrr/r0r@r"r"r"r#rqs c@seZdZdZdZdZdS) ApprovalTyperrN)rArBrCBLANKET_APPROVEAPPROVE_RELATIVE_CONTEXT APPROVE_PATHr"r"r"r#rWsrWc@sDeZdZUeed<dZeeed<eddZ e e dddZ dS) r updated_refNcontext_checkedc sfddS)Ncsfd|iS)Nr\r")refr,kwargsr"r#z+ReferenceUpdate.curry_ref..r"r_r"r_r# curry_refszReferenceUpdate.curry_refrScCs0|j}t|trtjSt|tr&tjStjSdSr;)r]rrrWrZrr[rY)r?contextr"r"r# approval_types   zReferenceUpdate.approval_type) rArBrCr rOr]rrrDrcrVrWrer"r"r"r#rs  c@s.eZdZdZeeeeeefdddZ dS)ra Abstract base class for a whitelisting rule that outputs references together with the modification level at which they're cleared. This is intended for use by complicated whitelisting rules that need to differentiate between multiple levels. oldnewr*cCstdSz Apply the rule to the changes between two revisions. :param old: The older, base revision. :param new: The newer revision to be vetted. Nr<r?rgrhr"r"r#apply_qualifieds z&QualifiedWhitelistRule.apply_qualifiedN) rArBrC__doc__rrrrrrkr"r"r"r#rsc@s6eZdZdZeeeedddZee dddZ dS) raM Abstract base class for a whitelisting rule that simply outputs cleared references without specifying a modification level. These rules are more flexible than rules of type :class:`.QualifiedWhitelistRule`, since the modification level can be specified separately (see :meth:`.WhitelistRule.as_qualified`). rfcCstdSrir<rjr"r"r#applys zWhitelistRule.apply)levelr*cCs t||S)ae Construct a new :class:`QualifiedWhitelistRule` that whitelists the object references from this rule at the level specified. :param level: The modification level at which the output of this rule should be cleared. :return: A :class:`.QualifiedWhitelistRule` backed by this rule. )_WrappingQualifiedWhitelistRule)r?rnr"r"r# as_qualifieds zWhitelistRule.as_qualifiedN) rArBrCrlrrrrmrrrpr"r"r"r#rs   c@s:eZdZeedddZeeeeee fdddZ dS)rorulerncCs||_||_dSr;rq)r?rrrnr"r"r#__init__sz(_WrappingQualifiedWhitelistRule.__init__rfccs$|j||D]}|j|fVqdSr;)rrrmrn)r?rgrhr^r"r"r#rksz/_WrappingQualifiedWhitelistRule.apply_qualifiedN) rArBrCrrrsrrrrrkr"r"r"r#rosro),rlloggingZ dataclassesrrrUtypingrrrrZpyhanko.pdf_utils.genericrr r r r r Zpyhanko.pdf_utils.readerrrZ pdf_utilsrZpdf_utils.rw_commonrZpdf_utils.xrefrZ policy_apir getLoggerrAlogger__all__r$r'rrrZ OrderedEnumrWrrrror"r"r"r#s>         $