g-:dZddlZddlmZGddeZdS)z$Container class for backend options.N)MappingceZdZdZdZdZdZdZdZe dZ dZ d Z d Z fd Zd Zfd ZdZdZdZdZfdZxZS)OptionsaYBase options object This class is what all backend options are based on. The properties of the class are intended to be all dynamically adjustable so that a user can reconfigure the backend on demand. If a property is immutable to the user (eg something like number of qubits) that should be a configuration of the backend class itself instead of the options. Instances of this class behave like dictionaries. Accessing an option with a default value can be done with the `get()` method: >>> options = Options(opt1=1, opt2=2) >>> options.get("opt1") 1 >>> options.get("opt3", default="hello") 'hello' Key-value pairs for all options can be retrieved using the `items()` method: >>> list(options.items()) [('opt1', 1), ('opt2', 2)] Options can be updated by name: >>> options["opt1"] = 3 >>> options.get("opt1") 3 Runtime validators can be registered. See `set_validator`. Updates through `update_options` and indexing (`__setitem__`) validate the new value before performing the update and raise `ValueError` if the new value is invalid. >>> options.set_validator("opt1", (1, 5)) >>> options["opt1"] = 4 >>> options["opt1"] 4 >>> options["opt1"] = 10 # doctest: +ELLIPSIS Traceback (most recent call last): ... ValueError: ... _fields validatorc|j|SNr)selfkeys N/granary/edev/quantum/lib/python3.11/site-packages/qiskit/providers/options.py __getitem__zOptions.__getitem__is|C  c*t|jSr )iterrr s r__iter__zOptions.__iter__lsDL!!!rc*t|jSr )lenrrs r__len__zOptions.__len__os4<   rc$|jdi||idS)N)update_optionsr r values r __setitem__zOptions.__setitem__ts%++sEl+++++rc|jSr r rs r__dict__zOptions.__dict__ys |rcj |j|S#t$r}td|d|d}~wwxYw)NzOption z is not defined)rKeyErrorAttributeError)r nameexs r __getattr__zOptions.__getattr__sT  J<% % J J J !@4!@!@!@AAr I Js  2-2c||j|<dSr r rs r __setattr__zOptions.__setattr__s! Src|j|jfSr rrs r __getstate__zOptions.__getstate__s dn--rc|\}}td|td|dSNrrsuperr')r staterr __class__s r __setstate__zOptions.__setstate__sG" Iw/// K33333rc|t|}||j|jf|S)z}Return a copy of the Options. The returned option and validator values are shallow copies of the originals. )__new__typer0rcopyr)r outs r__copy__zOptions.__copy__sU ll4::&& $,++--t~/B/B/D/DEFFF rc td|tdidSr+r,)r kwargsr/s r__init__zOptions.__init__s= Iv... K,,,,,rcd|jD}t|jdd|dS)Nc3*K|]\}}|d|VdS)=Nr).0kvs r z#Options.__repr__..s0??$!QA??????r(z, ))ritemsr3__name__join)r rCs r__repr__zOptions.__repr__sO??$,*<*<*>*>???t**%;; %(8(8;;;;rct|tr%t|tr|j|jkStSr ) isinstancerrNotImplemented)r others r__eq__zOptions.__eq__s: dG $ $ 1E7)C)C 1<5=0 0rc||jvrtd|dt|tr#t |dkrt dnmt|t r#t |dkrt dn5t|trntt|d||j |<dS) apSet an optional validator for a field in the options Setting a validator enables changes to an options values to be validated for correctness when :meth:`~qiskit.providers.Options.update_options` is called. For example if you have a numeric field like ``shots`` you can specify a bounds tuple that set an upper and lower bound on the value such as:: options.set_validator("shots", (1, 4096)) In this case whenever the ``"shots"`` option is updated by the user it will enforce that the value is >=1 and <=4096. A ``ValueError`` will be raised if it's outside those bounds. If a validator is already present for the specified field it will be silently overridden. Args: field (str): The field name to set the validator on validator_value (list or tuple or type): The value to use for the validator depending on the type indicates on how the value for a field is enforced. If a tuple is passed in it must have a length of two and will enforce the min and max value (inclusive) for an integer or float value option. If it's a list it will list the valid values for a field. If it's a ``type`` the validator will just enforce the value is of a certain type. Raises: KeyError: If field is not present in the options object ValueError: If the ``validator_value`` has an invalid value for a given type TypeError: If ``validator_value`` is not a valid type zField 'z'' is not present in this options objectzA tuple validator must be of the form '(lower, upper)' where lower and upper are the lower and upper bounds inclusive of the numeric valuerz-A list validator must have at least one entryzG is not a valid validator type, it must be a tuple, list, or class/typeN) rr!rHtupler ValueErrorlistr3 TypeErrorr)r fieldvalidator_values r set_validatorzOptions.set_validatorsB  $ $SUSSSTT T ou - - ?##q(( 5)  . . ?##q(( !PQQQ)  . .  ((777 !0urc |D]\}}|j|d}t|tr=||dks ||dkr$t d|d|dd|drt|t r||vrt d|d|t|tr%t||std|d ||j |dS) zUpdate options with kwargsNrzSpecified value for 'z"' is not a valid value, must be >=z or <=zSpecified value for z' is not a valid choice, must be one of z is not of required type ) rCrgetrHrNrOrPr3rQrupdate)r fields field_namerRfield_validators rrzOptions.update_optionssy!'   J"n00TBBO/511 ?1---9K1K1K$T TT%4Q%7TT?Nq?QTT2L OT22 //$= rz and <= rV z is one of z is of type ) r-__str__rioStringIOwriterCrHrNrPr3getvalue)r no_validatorout_strrRrr/s rr_zOptions.__str__sLww(( ~ & kmmG MM, ' ' ' MM, ' ' ' $ 4 4 6 6 E E ueU++EMM"Su"S"SU1X"S"SuQx"S"S"STTTTt,,EMM"Bu"B"B"B"B"BCCCCt,,EMM"Cu"C"C%"C"C"CDDD##%% %r)rD __module__ __qualname____doc__ __slots__rrrrpropertyrr%r'r)r0r6r9rFrKrTrr_ __classcell__)r/s@rrrsO**b)I!!!"""!!! ,,, X J J J""" ...44444 -----<<< 404040l$$$0&&&&&&&&&rr)rhr`collections.abcrrrrrrmsf+* ######~&~&~&~&~&g~&~&~&~&~&r