z i SrSSKrSSKrSSKrSSKJrJr S1rSS1r"SS5r "S S 5r SSS .S \S \ S\S\4Sjjr g)zETools useful for creating decorators, and other high-level callables.N)TypeCallable__new____init_subclass__ __prepare__c<^\rSrSrSrSrU4SjrSrSrSr U=r $)_lift_to_methodaAA decorator that ensures that an input callable object implements ``__get__``. It is returned unchanged if so, otherwise it is turned into the default implementation for functions, which makes them bindable to instances. Python-space functions and lambdas already have this behavior, but builtins like ``print`` don't; using this class allows us to do:: wrap_method(MyClass, "maybe_mutates_arguments", before=print, after=print) to simply print all the arguments on entry and exit of the function, which otherwise wouldn't be valid, since ``print`` isn't a descriptor. _methodcH>[US5(aU$[TU] U5$)N__get__)hasattrsuperr)clsmethod __class__s Q/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/utils/classtools.pyr_lift_to_method.__new__-s$ 69 % %Mws##cXLagXlgNr )selfrs r__init___lift_to_method.__init__2s >  rcbUc UR$[R"URU5$r)r types MethodType)robjobjtypes rr_lift_to_method.__get__8s* ;<<  c22r) __name__ __module__ __qualname____firstlineno____doc__ __slots__rrr__static_attributes__ __classcell__)rs@rr r s# I$  33rr c0\rSrSrSrSrSSjrS SjrSrg) _WrappedMethodAalDescriptor which calls its two arguments in succession, correctly handling instance- and class-method calls. It is intended that this class will replace the attribute that ``inner`` previously was on a class or instance. When accessed as that attribute, this descriptor will behave it is the same function call, but with the ``function`` called before or after. )_method_decorator_method_has_getr _before_afterNc[U[[45(a[U5UlOy[U[U55(aURUlOM[ USS5[ ;a [UlO,[ USS5[;a [UlO [UlUbUR U54OSnUbUR U54OSn[U[U55(a9URUl X!R-Ul URU-Ul OX l X0l Xl [URS5Ul g)Nr"r) isinstance classmethod staticmethodtyper-getattr_MAGIC_STATICMETHODS_MAGIC_CLASSMETHODSr r r/r0rr.)rrbeforeafters rr_WrappedMethod.__init__Ls  f{L9 : :%)&\D " T + +%+%=%=D " VZ .2F F%1D " VZ .2E E%0D "%4D "6<6H$((02b494E''.02 fd4j ) )!>>DL!NN2DL --%/DK!LK!L 't||Y?rc^^^^TR(aTRRTT5O TRm[R"T5UUUU4Sj5nU$)Nc>TRHnURTT5"U0UD6 M T"U0UD6nTRHnURTT5"U0UD6 M U$r)r/rr0)argskwargscallbackretvalrrr rs rout#_WrappedMethod.__get__..outlsg LL  g.??)T,V,F KK  g.??(Mr)r.r r functoolswraps)rrr rCrs``` @rr_WrappedMethod.__get__fsN8<7K7K%%c73QUQ]Q]    !  r)r0r/r r-r.)NNr) r"r#r$r%r&r'rrr(r2rrr+r+AsYI@4rr+)r:r;rnamer:r;c \[R"X5n[X[XBU55 g)aWrap the functionality the instance- or class method ``cls.name`` with additional behavior ``before`` and ``after``. This mutates ``cls``, replacing the attribute ``name`` with the new functionality. This is useful when creating class decorators. The method is allowed to be defined on any parent class instead. If either ``before`` or ``after`` are given, they should be callables with a compatible signature to the method referred to. They will be called immediately before or after the method as appropriate, and any return value will be ignored. Args: cls: the class to modify. name: the name of the method on the class to wrap. before: a callable that should be called before the method that is being wrapped. after: a callable that should be called after the method that is being wrapped. Raises: ValueError: if the named method is not defined on the class or any parent class. N)inspectgetattr_staticsetattrr+)rrHr:r;rs r wrap_methodrMxs%2 # #C .F C~fe<=r) r&rErJrtypingrrr8r9r r+strrMr2rrrPslL !"{*M:!3!3H44n=ATX>T>>>>r