NgdZddlmZddlZddlZddlmZmZmZm Z GddeZ dd Z dd Z ddZ ddZe dZe dZddZdS)zLA peculiar method of monkeypatching C++ binding classes with Python methods.) annotationsN)AnyCallableProtocolTypeVarc0eZdZUdZded<ded<d dZdS) AugmentedCallablez0Protocol for any method, with attached booleans.bool_augment_override_cpp_augment_if_no_cppreturnrcdS)z Any function.N)selfargskwargss M/var/www/html/ai-engine/env/lib/python3.11/site-packages/pikepdf/_augments.py__call__zAugmentedCallable.__call__sN)r r)__name__ __module__ __qualname____doc____annotations__rrrrr r sH::rr fnr cd|_|S)z0Replace the C++ implementation, if there is one.T)r rs raugment_override_cpprs#B Ircd|_|S)z@Provide a Python implementation if no C++ implementation exists.T)r rs raugment_if_no_cppr s B Irmethrr c6|jdS)Nzobject.)r startswith)r!s r_is_inherited_methodr$#s   ' ' 2 22rmrcrtj|ot| ptj|S)N)inspect isfunctionr$isdatadescriptor)r%s r_is_augmentabler*)s91=&:1&=&="= %  !! $ $%rTcppTcls_cpp type[Tcpp]cZhdtjdkrdhz|fd fd }|S) aAttach methods of a Python support class to an existing class. This monkeypatches all methods defined in the support class onto an existing class. Example: .. code-block:: python @augments(ClassDefinedInCpp) class SupportClass: def foo(self): pass The Python method 'foo' will be monkeypatched on ClassDefinedInCpp. SupportClass has no meaning on its own and should not be used, but gets returned from this function so IDE code inspection doesn't get too confused. We don't subclass because it's much more convenient to monkeypatch Python methods onto the existing Python binding of the C++ class. For one thing, this allows the implementation to be moved from Python to C++ or vice versa. It saves having to implement an intermediate Python subclass and then ensures that the C++ superclass never 'leaks' to pikepdf users. Finally, wrapper classes and subclasses can become problematic if the call stack crosses the C++/Python boundary multiple times. Any existing methods may be used, regardless of whether they are defined elsewhere in the support class or in the target class. For data fields to work, the target class must be tagged ``py::dynamic_attr`` in pybind11. Strictly, the target class does not have to be C++ or derived from pybind11. This works on pure Python classes too. THIS DOES NOT work for class methods. (Alternative ideas: https://github.com/pybind/pybind11/issues/1074) >__eq____hash____repr__PyPy __getattr__clstype[T]r-r.r c\tj|tD]\}}|dkr t||rt||r|t |dt vr|vr{t t ||dds\t t ||ddrt d|d|d |d t ||d d t ||d  tj|rt||r"t|d |t ||t|||t ||}|j |j |j |_ ^tj |rt|||d}||_ |S)N) predicate __weakref____abstractmethods__r Fr zC++ z and Python z* both define the same non-abstract method z: z, _cppc:t|jjdz)Nz .__init__)NotImplementedError __class__r)rs r disable_initz5augments..class_augment..disable_inits%dn&= &KLL Lr)r' getmembersr*hasattrgetattrset RuntimeErrorr(setattrrreplacerr)__init__)r5r-namememberinstalled_memberr@OVERRIDE_WHITELISTs r class_augmentzaugments..class_augment^s$.soNNN* /* /LD&}$$&& C&& -BCEE J JJJ 222T 2 24KUSS373--/CUKK #272222+/22wb1122sD"--22 !&)) /7D))LG]D]]GGT4J4JKKKv...#*7D#9#9 060C0K0KL'"211 --)&11 /v... M M M$  r)r5r6r-r.r r6)platformpython_implementation)r-rMrLs @raugmentsrP3sbL<;;%''611}o-:A5555555n r)rr r r )r!rr r )r%rr r )r-r.)r __future__rr'rNtypingrrrrr rr r$r*r+r,rPrrrrSsSR""""""333333333333  3333 %%%% wv GCLLbbbbbbr