ó ø`9Sc@sfddlTddlmZdddgZdd d„ƒYZdd d„ƒYZdd d„ƒYZd S( iÿÿÿÿ(t*(tutilstParamsCollectiont ParameterInfotParameterHeadercBs>eZdZdddeeddd„Zd„Zd„ZRS(sôDescription of a parameter to be stored in an INI file and possibly edited via a dialog box. Attributes: - 'groupName': INI file group name for the parameter (an ASCII string). - 'dialogLabel': label to denote the parameter in a settings dialog box, or 'None' if there should be no label for this parameter. - 'attributeName': name of the attribute of a parameters collection class instance to store the data in. This same string will be used as the parameter's name in the INI file. - 'dataType': Python datatype of the attribute that will hold the data: 'int', 'float', 'bool', 'str' or 'unicode'. - 'defaultValue': parameter's default value (may be 'None'). - 'admissibleValues': a complete sequence of allowable parameter values or 'None' if the set of values is not fixed. - 'minValue', 'maxValue': minimum and maximum values for numeric data types or 'None' for boundaries that are not defined. - 'isMinStrict', 'isMaxStrict': 'True' if the respective boundary values themselves are not acceptable. - 'minLength', 'maxLength': minimum and maximum lengths for 'str' and 'unicode' data types or 'None' if string length is not restricted.c sßt|tƒr!t|ƒdks't‚t|tƒrHt|ƒdksNt‚|dksot|ˆƒsot‚|dkst‡fd†|Dƒƒst‚|dksÇ|dksÇ||ksÇt‚|dksèt|ˆƒsèt‚|dks t|ˆƒs t‚| dks'| dks't‚| dksE| dksEt‚| dkso| dkso| | ksot‚||_||_||_ˆ|_ ||_ ||_ ||_ ||_ | |_| |_| |_| |_dS(Nic3s|]}t|ˆƒVqdS(N(t isinstance(t.0titem(tdataType(scode\common\ParamsCollection.pys ;s(RtstrtlentAssertionErrortNonetallt groupNamet dialogLabelt attributeNameRt defaultValuetadmissibleValuestminValuetmaxValuet isMinStrictt isMaxStrictt minLengtht maxLength( tselfRRRRRRRRRRRR((Rscode\common\ParamsCollection.pyt__init__0s.''!*!!*           cCs3tj||jƒ|j|j|ƒWdQXdS(sŠSave a parameter specified by 'value' in the given 'QSettings' instance in an appropriate way as specified by the 'self' instance.N(RtSettingsGrouperRtsetValueR(Rtsettingstvalue((scode\common\ParamsCollection.pytsaveToSettingsQsc CsZtj||jƒ0|j|jƒs/|jS|j|jƒ}WdQX|jtkrk|j ƒ\}}nÌ|jt kr|j ƒ\}}n¨|jt kr³|j ƒ}t}n„|jtkrÝt|jƒƒ}t}nZ|jtkr%yt|jƒƒ}Wntk rt}q7Xt}nts7tdƒ‚|rE|jdk rd||jkrdt}n|jdk r¦||jksš|jr¦||jkr¦t}q¦n|jdk rè||jksÜ|jrè||jkrèt}qèn|jdk rt|ƒ|jkrt}n|jdk rEt|ƒ|jkrEt}qEn|rO|S|jSdS(sûLoad a parameter from the given 'QSettings' instance and return its value converted to the required data type. If the value is missing from the 'QSettings' instance or does not meet the constraints, return 'self.defaultValue'.NsThe data type is not supported(RRRtcontainsRRRRtfloatttoDoubletintttoInttboolttoBooltTruetunicodettoStringR tUnicodeEncodeErrortFalseR RR RRRRRR R(RRt variantValueRtconversionResult((scode\common\ParamsCollection.pytloadFromSettingsXsP         $ $ N(t__name__t __module__t__doc__R R+RRR.(((scode\common\ParamsCollection.pyRs cBseZdZd„ZRS(s.Description of a settings dialog box header to be used to denote a subgroup of parameters within a group of the given name. Attributes: - 'groupName': INI file group name (an ASCII string). - 'dialogLabel': label to denote a subgroup of parameters in a settings dialog box.cCsOt|tƒr!t|ƒdks't‚|dk s9t‚||_||_dS(Ni(RR R R R RR(RRR((scode\common\ParamsCollection.pyR¡s' (R/R0R1R(((scode\common\ParamsCollection.pyR˜scBs€eZdZed„ƒZed„ƒZd„Zd„Zd„Zed d„ƒZ ed„ƒZ d„Z ed „ƒZ RS( såBase class for parameter collections to be stored in text INI files and possibly edited via a dialog box. Redefine 'getParameterList' virtual method to specify the list of the parameters along with constraints that may apply. Specify the name of the INI file to hold the data by redefining 'getSettingsFilePath', and then use 'saveToFile' and 'loadFromFile' methods for persistent data storage. Use ordinary attributes of the derived class to access the data.cCsgS(s­Return an ordered list of 'ParameterInfo' instances (possibly intervened by a number of 'ParameterHeader's) describing properties of the parameters (to be stored as attributes in instances of the derived class), as well as their appearance and order in a settings dialog box. In a dialog box, as well as in an INI file, parameters will be grouped according to 'groupName's specified in 'ParameterInfo's and 'ParameterHeader's (so that parameters with a common 'groupName' are displayed side by side). Within a group, parameter order is determined by the order of elements in the list returned by this function. In the dialog box, each parameter may be denoted with a separate label, as specified by 'ParameterInfo.dialogLabel'. By means of introducing intervening 'ParameterHeader' instances into the list, it's also possible to insert informative labels between consecutive parameter fields in the dialog box. Otherwise, 'ParameterHeader' elements of the list will be ignored. Use 'ParamsDialog' to interactively edit attributes of the derived class in a dialog box.((tcls((scode\common\ParamsCollection.pytgetParameterList¸scCsdS(sKReturn INI file path to be used by 'saveToFile' and 'loadFromFile'.N(R (R2((scode\common\ParamsCollection.pytgetSettingsFilePathÐscCs|jƒdS(s)Construct an all-default params instance.N(treset(R((scode\common\ParamsCollection.pyRØscCsCx<|jƒD].}t|tƒr t||j|jƒq q WdS(s+Set the parameters to their default values.N(R3RRtsetattrRR(Rtparam((scode\common\ParamsCollection.pyR5ÝscCs@|jƒ}x-|jƒD]}t||t||ƒƒqW|S(s<Return a new instance of this class holding the same values.(t __class__tgetAttributeNamesR6tgetattr(RtcopyR((scode\common\ParamsCollection.pyR;äs cCsag}xT|jƒD]F}t|tƒr|dksC|j|krY|j|jƒqYqqW|S(sQReturn the list of class instance attribute names that belong to the specified INI file group, or the complete list of class instance attributes if 'groupName' is 'None'. Order of the returned attribute names will correspond to the required parameter sequence in a dialog box (as well as in an INI file).N(R3RRR RtappendR(R2RtattributeNamesR7((scode\common\ParamsCollection.pyR9îs cCs@x9|jƒD]+}t|tƒr |j|kr8|Sq q WdS(s_Return 'ParameterInfo' instance that corresponds to the given class instance attribute.N(R3RRR(R2RR7((scode\common\ParamsCollection.pytgetParameterInfoByNamescCsgt|jƒtjƒ}xH|jƒD]:}t|tƒr%t||jƒ}|j||ƒq%q%WdS(sfSave the current settings in a text file located at the path defined by 'getSettingsFilePath'.N( t QSettingsR4t IniFormatR3RRR:RR(RRR7t paramValue((scode\common\ParamsCollection.pyt saveToFile s cCspt|jƒtjƒ}|ƒ}xH|jƒD]:}t|tƒr.|j|ƒ}t||j|ƒq.q.W|S(s³Return params instance loaded from a text file located at the path defined by 'getSettingsFilePath'. Invalid or absent values, if any, are replaced with defaults.( R?R4R@R3RRR.R6R(R2RtparamsR7R((scode\common\ParamsCollection.pyt loadFromFiles N(R/R0R1t classmethodR3R4RR5R;R R9R>RBRD(((scode\common\ParamsCollection.pyR¬s     N((((t PyQt4.QtCoret common.utilsRt__all__RRR(((scode\common\ParamsCollection.pyts