z i8SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJ r J r J r J r J r Jr SSKJrJr SSKJr "SS5r"S S \R*5r"S S \5r"S S\5rg)z#Lazy testers for optional features.N)UnionIterableDictOptionalCallableType)MissingOptionalLibraryErrorOptionalDependencyImportWarning) wrap_methodc(\rSrSrSrSrSrSrSrg) _RequireNowzHelper callable that accepts all function signatures and simply calls :meth:`.LazyDependencyManager.require_now`. This helpful when used with :func:`.wrap_method`, as the callable needs to be compatible with all signatures and be picklable._tester_featurecXlX lgNr)selftesterfeatures R/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/utils/lazy_tester.py__init___RequireNow.__init__$s   cNURRUR5 gr)r require_nowr)r_args_kwargss r__call___RequireNow.__call__(s   /r)rrN) __name__ __module__ __qualname____firstlineno____doc__ __slots__rr __static_attributes__rrrrsT(I 0rrcx\rSrSrSrSrSSSSS.Sjr\RS\ 4Sj5r S r \ RS \S\4S j5r\ RS \S\\/\44S j5rS r\ RS\S\4Sj5r\ RS\S\\/\44Sj5rSrS\4Sjr\R*S5rSrg)LazyDependencyManager,aA mananger for some optional features that are expensive to import, or to verify the existence of. These objects can be used as Booleans, such as ``if x``, and will evaluate ``True`` if the dependency they test for is available, and ``False`` if not. The presence of the dependency will only be tested when the Boolean is evaluated, so it can be used as a runtime test in functions and methods without requiring an import-time test. These objects also encapsulate the error handling if their dependency is not present, so you can do things such as:: from qiskit.utils import LazyImportManager HAS_MATPLOTLIB = LazyImportManager("matplotlib") @HAS_MATPLOTLIB.require_in_call def my_visualisation(): ... def my_other_visualisation(): # ... some setup ... HAS_MATPLOTLIB.require_now("my_other_visualisation") ... def my_third_visualisation(): if HAS_MATPLOTLIB: from matplotlib import pyplot else: ... In all of these cases, ``matplotlib`` is not imported until the functions are entered. In the case of the decorator, ``matplotlib`` is tested for import when the function is called for the first time. In the second and third cases, the loader attempts to import ``matplotlib`` when the :meth:`require_now` method is called, or when the Boolean context is evaluated. For the ``require`` methods, an error is raised if the library is not available. This is the base class, which provides the Boolean context checking and error management. The concrete classes :class:`LazyImportTester` and :class:`LazySubprocessTester` provide convenient entry points for testing that certain symbols are importable from modules, or certain command-line tools are available, respectively. _bool _callback_name_install_msgNnamecallbackinstallmsgcBSUlX lXlX0lX@lg)a Args: name: the name of this optional dependency. callback: a callback that is called immediately after the availability of the library is tested with the result. This will only be called once. install: how to install this optional dependency. Passed to :class:`.MissingOptionalLibraryError` as the ``pip_install`` parameter. msg: an extra message to include in the error raised if this is required. Nr-)rr4r5r6r7s rrLazyDependencyManager.__init__Xs !   rreturncg)aSubclasses of :class:`LazyDependencyManager` should override this method to implement the actual test of availability. This method should return a Boolean, where ``True`` indicates that the dependency was available. This method will only ever be called once. :meta public: Fr)rs r _is_available#LazyDependencyManager._is_availablehsrcURc=UR5UlURbURUR5 UR$r)r.r=r/r<s r__bool__LazyDependencyManager.__bool__rs@ :: ++-DJ~~)tzz*zzrfeature_or_callablecgrr)rrBs rrequire_in_call%LazyDependencyManager.require_in_callysJMrcgrr)rDs rrErF|s[^rc^^^[U[5(a UmUU4SjnU$Um[TSS5=(d [TSS5=(d [T5m[R"T5UUU4Sj5nU$)ayCreate a decorator for callables that requires that the dependency is available when the decorated function or method is called. Args: feature_or_callable (str or Callable): the name of the feature that requires these dependencies. If this function is called directly as a decorator (for example ``@HAS_X.require_in_call`` as opposed to ``@HAS_X.require_in_call("my feature")``), then the feature name will be taken to be the function name, or class and method name as appropriate. Returns: Callable: a decorator that will make its argument require this dependency before it is called. cL>^[R"T5UUU4Sj5nU$)Nc6>TRT5 T"U0UD6$rrargskwargsrfunctionrs routELazyDependencyManager.require_in_call..decorator..outs!$$W-#T4V44r) functoolswraps)rOrPrrs` r decorator8LazyDependencyManager.require_in_call..decorators%*5+5 rr$Nr"c6>TRT5 T"U0UD6$rrKrLs rrP2LazyDependencyManager.require_in_call..outs!   W %T,V, ,r) isinstancestrgetattrrRrS)rrBrTrPrrOs` @@rrErFs| )3 / /)G  & Hnd 3 xT2 8}   " - # - rfeature_or_classcgrr)rr[s rrequire_in_instance)LazyDependencyManager.require_in_instancesCFrcgrr)r]s rr^r_sTWrc^^[U[5(a UmUU4SjnU$Un[USS5=(d [USS5=(d [U5m[US[ TT5S9 U$)aA class decorator that requires the dependency is available when the class is initialized. This decorator can be used even if the class does not define an ``__init__`` method. Args: feature_or_class (str or Type): the name of the feature that requires these dependencies. If this function is called directly as a decorator (for example ``@HAS_X.require_in_instance`` as opposed to ``@HAS_X.require_in_instance("my feature")``), then the feature name will be taken as the name of the class. Returns: Callable: a class decorator that ensures that the wrapped feature is present if the class is initialized. c2>[US[TT5S9 U$)Nrbefore)r r)class_rrs rrT.decoratorsFJ{47QR rr$Nr"rrc)rXrYrZr r)rr[rTrers` @rr^r_sr & , ,&G  ! FND 1 vz40 6{  FJ{4/IJ rrcdU(ag[URXRURS9e)aEagerly attempt to import the dependencies in this object, and raise an exception if they cannot be imported. Args: feature: the name of the feature that is requiring these dependencies. Raises: MissingOptionalLibraryError: if the dependencies cannot be imported. N)libnamer4 pip_installr7)r r0r1r2)rrs rr!LazyDependencyManager.require_nows*  )JJW--TYY  rc#^# URnSUlSv Xlg!Xlf=f7f)a\ Create a context, during which the value of the dependency manager will be ``False``. This means that within the context, any calls to this object will behave as if the dependency is not available, including raising errors. It is valid to call this method whether or not the dependency has already been evaluated. This is most useful in tests. FN)r.)rpreviouss rdisable_locally%LazyDependencyManager.disable_locallys)::  " !JJs-"-*-)r.r/r1r2r0)r"r#r$r%r&r'rabcabstractmethodboolr=r@typingoverloadrrErYrr^r contextlibcontextmanagerrmr(r)rrr+r+,s'RDI#dDd  t __M8MMM __^3^8XJPXDX;Y^^(T __FDFTFF __WCWHdVT\[U[5(a5UR5VVs0sHupgU[U5_M snnUlO7[U[ 5(a US0UlOUVs0sHofS_M snUlUR(d [ S5eUbOu[UR5S:XaURR5unO?[URR55nSRUSS5SUS3n[T U]-X#XES9 gs snnfs snf) a Args: name_map_or_modules: if a name map, then a dictionary where the keys are modules or packages, and the values are iterables of names to try and import from that module. It should be valid to write ``from import , , ...``. If simply a string or iterable of strings, then it should be valid to write ``import `` for each of them. Raises: ValueError: if no modules are given. r)zno modules suppliedNr z, z and r3) rXdictitemstupleryrY ValueErrorlenkeysjoinsuperr) rrzr4r5r6r7modulenames all_names __class__s rrLazyImportTester.__init__s ( )4 0 0GZG`G`GbcGbmfVU5\1GbcDM +S 1 10"5DM6IJ6IFRZ6IJDM}}23 3     1 $mm((*GTdmm0023Iii #2/0im_ED dwPdKs D'/ D-c 0n[R"[5nURR 5H1up4[ R "U5nUHn [XY5n M M3 U(dU(aUR(aSURS3OSn SU S3n UR 5H up6U SR!SUS U<35- n M" UR 5H=up4[U5S :Xa S US S3OS U3n U SR!SUSU S35- n M? ["R$"U [&S9 gg![aSnURRS5nURS5nXxS[U5:XaSnA gXaU'SnAGMdSnAf[anXaU'SnAGM|SnAff=f![a X#RU 5 GMf=f)N.F'zoptional packageszWhile trying to import z, some components were located but raised other errors during import. You might have an incompatible version installed. Qiskit will continue as if the optional is not available.z - module 'z' failed to import with: r z attribute 'rz attributes z - 'z' imported, but z couldn't be found)categoryT) collections defaultdictlistryr~ importlib import_moduleModuleNotFoundErrorr4splitr ImportErrorrZAttributeErrorappendr0rwarningswarnr )rfailed_modules failed_namesrrimportedexc failed_parts target_partsr4_package_descriptionmessage attributess rr=LazyImportTester._is_availables"..t4 !]]002MF $226:6/A!3* \7;zzAdjj\"3GZ )*=)>?MM  .335 277]6(:STWSZ#[\\ 6!-!3!3!5 :=e*/{58*A6Q\]b\cOd 277VF83CJ[U[5(aU4O [U5UlUR(d [ S5e[ TU]U=(d URSX4US9 g)z Args: command: the strings that make up the command to be run. For example, ``["pdflatex", "-version"]``. Raises: ValueError: if an empty command is given. zno command suppliedrr3N)rXrYrrrrr)rrr4r5r6r7rs rrLazySubprocessTester.__init__MsV"'1#&>&> E'N }}23 3 d6dmmA&6`cdrc[R"URS[R[RS9 g![[R 4a gf=f)NT)checkstdoutstderrF) subprocessrunrDEVNULLOSErrorSubprocessErrorr<s rr="LazySubprocessTester._is_availablecsP  NN T*2D2DZM_M_  334  s=AAA)r"r#r$r%r&r'rrYrrrrqrr=r(rrs@rrrFsI #59!%!esHSM)*esm e 8TFDL12 e # ec]ee,rr)r&rorrtrRrrrrrrrrrrrqiskit.exceptionsr r classtoolsr rABCr+rwrr)rrrsh*  BBZ# 0 0B"CGGB"JR,Rj%0%r