Your IP : 216.73.216.196
0�]* � @ sh d Z d Z Gd d � d e � Z Gd d � d e � Z Gd d � d e � Z Gd d � d e � Z d
S) z�Module to enforce different constraints on flags.
A validator represents an invariant, enforced over a one or more flags.
See 'FLAGS VALIDATORS' in gflags.py's docstring for a usage manual.
z#olexiy@google.com (Olexiy Oryeshko)c @ s e Z d Z d Z d S)�Errorz0Thrown If validator constraint is not satisfied.N)�__name__�
__module__� __qualname__�__doc__� r r �B/opt/alt/python35/lib/python3.5/site-packages/gflags_validators.pyr ' s r c @ sX e Z d Z d Z d Z d d � Z d d � Z d d � Z d d
� Z d d � Z d
S)� Validatorz}Base class for flags validators.
Users should NOT overload these classes, and use gflags.Register...
methods instead.
� c C s1 | | _ | | _ t j d 7_ t j | _ d S)a Constructor to create all validators.
Args:
checker: function to verify the constraint.
Input of this method varies, see SimpleValidator and
DictionaryValidator for a detailed description.
message: string, error message to be shown to the user
� N)�checker�messager �validators_countZinsertion_index)�selfr r r r r �__init__5 s zValidator.__init__c C s1 | j | � } | j | � s- t | j � � d S)z�Verify that constraint is satisfied.
flags library calls this method to verify Validator's constraint.
Args:
flag_values: gflags.FlagValues, containing all flags
Raises:
Error: if constraint is not satisfied.
N)�_GetInputToCheckerFunctionr r r )r � flag_valuesZparamr r r �VerifyD s zValidator.Verifyc C s t d � � d S)znReturn the names of the flags checked by this validator.
Returns:
[string], names of the flags
z This method should be overloadedN)�NotImplementedError)r r r r �
GetFlagsNamesQ s zValidator.GetFlagsNamesc C s t d � � d S)Nz This method should be overloaded)r )r r r r r �PrintFlagsWithValuesY s z Validator.PrintFlagsWithValuesc C s t d � � d S)z�Given flag values, construct the input to be given to checker.
Args:
flag_values: gflags.FlagValues, containing all flags.
Returns:
Return type depends on the specific validator.
z This method should be overloadedN)r )r r r r r r \ s z$Validator._GetInputToCheckerFunctionN)
r r r r r
r r r r r r r r r r + s
r c sL e Z d Z d Z � f d d � Z d d � Z d d � Z d d � Z � S)
�SimpleValidatora Validator behind RegisterValidator() method.
Validates that a single flag passes its checker function. The checker function
takes the flag value and returns True (if value looks fine) or, if flag value
is not valid, either returns False or raises an Exception.c s& t t | � j | | � | | _ d S)a� Constructor.
Args:
flag_name: string, name of the flag.
checker: function to verify the validator.
input - value of the corresponding flag (string, boolean, etc).
output - Boolean. Must return True if validator constraint is satisfied.
If constraint is not satisfied, it should either return False or
raise Error.
message: string, error message to be shown to the user if validator's
condition is not satisfied
N)�superr r � flag_name)r r r r )� __class__r r r m s
zSimpleValidator.__init__c C s
| j g S)N)r )r r r r r } s z SimpleValidator.GetFlagsNamesc C s d | j | | j j f S)Nz flag --%s=%s)r �value)r r r r r r � s z$SimpleValidator.PrintFlagsWithValuesc C s | | j j S)z�Given flag values, construct the input to be given to checker.
Args:
flag_values: gflags.FlagValues
Returns:
value of the corresponding flag.
)r r )r r r r r r � s z*SimpleValidator._GetInputToCheckerFunction)r r r r r r r r r r )r r r g s
r c sL e Z d Z d Z � f d d � Z d d � Z d d � Z d d � Z � S)
�DictionaryValidatora Validator behind RegisterDictionaryValidator method.
Validates that flag values pass their common checker function. The checker
function takes flag values and returns True (if values look fine) or,
if values are not valid, either returns False or raises an Exception.
c s& t t | � j | | � | | _ d S)aX Constructor.
Args:
flag_names: [string], containing names of the flags used by checker.
checker: function to verify the validator.
input - dictionary, with keys() being flag_names, and value for each
key being the value of the corresponding flag (string, boolean, etc).
output - Boolean. Must return True if validator constraint is satisfied.
If constraint is not satisfied, it should either return False or
raise Error.
message: string, error message to be shown to the user if validator's
condition is not satisfied
N)r r r �
flag_names)r r r r )r r r r � s z DictionaryValidator.__init__c s t � f d d � | j D� � S)a Given flag values, construct the input to be given to checker.
Args:
flag_values: gflags.FlagValues
Returns:
dictionary, with keys() being self.lag_names, and value for each key
being the value of the corresponding flag (string, boolean, etc).
c 3 s" | ] } | � | j g Vq d S)N)r )�.0�key)r r r � <genexpr>� s zADictionaryValidator._GetInputToCheckerFunction.<locals>.<genexpr>)�dictr )r r r )r r r � s z.DictionaryValidator._GetInputToCheckerFunctionc C sO d } g } x/ | j D]$ } | j d | | | j f � q W| d j | � S)Nzflags z%s=%sz, )r �appendr �join)r r �prefixZflags_with_valuesr r r r r � s
"z(DictionaryValidator.PrintFlagsWithValuesc C s | j S)N)r )r r r r r � s z!DictionaryValidator.GetFlagsNames)r r r r r r r r r r )r r r � s
r N)r �
__author__� Exceptionr �objectr r r r r r r �<module>" s
<'