File: //lib/python2.7/site-packages/leapp/models/fields/__init__.pyo
�
9�Egc @ sE d d l Z d d l Z d d l Z d d l Z y d d l m Z Wn! e k
rg d d l m Z n Xd d l Z d e f d � � YZ
d e f d � � YZ d e f d � � YZ
d e
f d
� � YZ d e f d � � YZ d
e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e
f d � � YZ d � Z d e e f d � � YZ d e e f d � � YZ d e e f d! � � YZ d" e e f d# � � YZ d$ e
f d% � � YZ d& e
f d' � � YZ d( e
f d) � � YZ d* e f d+ � � YZ d S(, i����N( t Sequencet ModelViolationErrorc B s e Z d Z RS( sd
ModelViolationError is raised if the data in the instances is not matching its definition.
( t __name__t
__module__t __doc__( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR s t ModelMisuseErrorc B s e Z d Z RS( sJ
ModelMisuseError is raised if the Model definition is not valid.
( R R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR s t Fieldc B s} e Z d Z e d � � Z d � Z d d d � Z d � Z d � Z d � Z
d � Z d � Z d � Z
d
� Z d � Z RS(
s4
Field is the base of all supported fields.
c C s | j p d j t | � j � S( sV
:return: Documentation help string defining what the field is about.
s- No documentation provided for this field `{}`( t _helpt formatt typeR ( t self( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt help s c C s
t | _ | S( sS
Set object` "_nullable_" field to True and return the object back
( t Truet _nullable( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt as_nullable& s c C s@ | | _ t | _ | | _ t | � t k r< t d � � n d S( s�
:param default: Default value to be used if the field is not set
:param help: Documentation string for generating model documentation
:type help: str
s Do not use this type directly.N( R t FalseR
t _defaultR R R ( R
t defaultR ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt __init__- s
c C s5 | d k r1 | j r1 t d j d | � � � n d S( s�
Validates the value in the Model representation
:param value: Value to be checked
:param name: Name of the field (used for a better error reporting only)
:return: None
s< The value of "{name}" field is None, but this is not allowedt nameN( t NoneR
R R ( R
t valueR ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt _validate_model_value: s c C s5 | d k r1 | j r1 t d j d | � � � n d S( s�
Validates the value in the builtin representation
:param value: Value to be checked
:param name: Name of the field (used for a better error reporting only)
:return: None
s< The value of "{name}" field is None, but this is not allowedR N( R R
R R ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt _validate_builtin_valueE s c C s | j d | d | � | S( s
Performs the conversion from a builtin type to the model representation
:param value: Value to convert
:param name: Name of the field (used for a better error reporting only)
:return: Converted value in the model format
R R ( R ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt _convert_to_modelP s c C s | j d | d | � | S( s
Performs the conversion from a model type to the builtin representation
:param value: Value to convert
:param name: Name of the field (used for a better error reporting only)
:return: Converted value in the builtin format
R R ( R ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt _convert_from_model[ s c C sH t j | j | | j � � } | j d | d | � t | | | � d S( s�
Assigns the value to the target model passed through during the model initialization
:param source: Dictionary to extract the value from (usually kwargs)
:type source: dict
:param name: Name of the field (used for a better error reporting only)
:type name: str
:param target: Target model instance
:type target: Instance of a Model derived class
:return: None
R R N( t copyt getR R t setattr( R
t sourceR t targett source_value( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt from_initializationf s c C sl t j | j | | j � � } | d k rB | j | d | �} n | j d | d | � t | | | � d S( s�
Converts the value with the given name to the model representation and assigns the attribute
:param source: Dictionary to extract the value from
:type source: dict
:param name: Name of the field (used for a better error reporting only)
:type name: str
:param target: Target model instance
:type target: Instance of a Model derived class
:return: None
R R N( R R R R R R R ( R
R R R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt to_modelx s
c C s) | j t | | d � d | �| | <d S( s�
Converts the value with the given name to the builtin representation and assigns the field
:param source: Source model to get the value from
:type source: Instance of a Model derived class
:param name: Name of the field (used for a better error reporting only)
:type name: str
:param target: Dictionary to set the value to
:type target: dict
:return: None
R N( R t getattrR ( R
R R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt
to_builtin� s c C s2 i | j d 6t | � j d 6| j d 6| j d 6S( s7
:return: Serialized form of the field
t nullablet
class_nameR R ( R
R R R R ( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt serialize� s
N( R R R t propertyR R R R R R R R R R! R# R& ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR s
t BuiltinFieldc B sG e Z d Z e d � � Z e d � � Z d � Z d � Z d � Z RS( s_
Base class for all builtin types to act as pass-through with an additional validation
c C s t d � � d S( sU
:return: Returns the type to be used as a model type representation
s" _model_type needs to be overriddenN( t NotImplementedError( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt _model_type� s c C s | j S( se
:return: Returns the type to be used as a builtin type representation (e.g. string)
( R* ( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt
_builtin_type� s c C s< t t | � j | | � | j d | d | d | j � d S( NR R t
expected_type( t superR( R t _validateR* ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s c C s< t t | � j | | � | j d | d | d | j � d S( NR R R, ( R- R( R R. R+ ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s c C s� t | t � s | f } n | d k r4 | j r4 d St | | � s� d j g | D] } d j | j � ^ qP � } t d j | t | � j | � � � n d S( Ns , s {}s% Fields {} is of type: {} expected: {}( t
isinstanceR R R
t joinR R R R ( R
R R R, t tt names( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR. � s .( R R R R' R* R+ R R R. ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR( � s t Booleanc B s e Z d Z e d � � Z RS( s
Boolean field
c C s t S( N( t bool( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* � s ( R R R R' R* ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR3 � s t Floatc B s e Z d Z e d � � Z RS( s
Float field
c C s t S( N( t float( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* � s ( R R R R' R* ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR5 � s t Integerc B s e Z d Z e d � � Z RS( s@
Integer field (int, long in python 2, int in python 3)
c C s t j S( N( t sixt
integer_types( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* � s ( R R R R' R* ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR7 � s t Numberc B s e Z d Z e d � � Z RS( s*
Combined Integer and Float field
c C s t j t f S( N( R8 R9 R6 ( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* � s ( R R R R' R* ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR: � s t Stringc B s e Z d Z e d � � Z RS( s
String field
c C s t j t j f S( N( R8 t string_typest binary_type( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* � s ( R R R R' R* ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR; � s t Blobc B s/ e Z d Z e d � � Z d � Z d � Z RS( s
Blob field
c C s t j t j f S( N( R8 R< R= ( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* � s c C s3 | j d | d | � | d k r& d St j | � S( NR R ( R R t base64t b64decode( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR s c C s< | j d | d | � | d k r& d St j | � j d � S( NR R t ascii( R R R? t b64encodet decode( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR
s ( R R R R' R* R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR> � s t DateTimec B s> e Z d Z e d � � Z e d � � Z d � Z d � Z RS( st
DateTime field to handle datetime objects which are converted to the ISO format and parsed back from there
c C s t j S( N( t datetime( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* s c C s t j S( N( R8 R< ( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR+ s c C s� | j d | d | � | d k r& | S| j d � } d } d | k rP d } n y# t j j | d j d | � � SWnf t k
r� y# t j j | d j d | � � SWq� t k
r� t d
j d | d | � � � q� Xn Xd S( NR R t Zt t .s .%fs %Y-%m-%dT%H:%M:%S{fractions}%Zt fractionss %Y-%m-%dT%H:%M:%S{fractions}s> The {name} field contains an invalid datetime value: '{value}'( R R t rstripRE t strptimeR t
ValueErrorR ( R
R R RI ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR " s #
#
c C s> | j d | d | � | s | S| j � s: | j � d Sd S( NR R RF ( R t utcoffsett isoformat( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR : s
( R R R R' R* R+ R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyRD s
t EnumMixinc B s; e Z d Z d � Z d � Z d � Z d � Z d � Z RS( sR
EnumMixin adds the ability to use the field as an Enum type of the field
c K sG t t | � j | � t | t t f � s: t d � � n | | _ d S( s�
:param choices: List of values that are allowed for this field
:type choices: List or tuple of allowed values
s% Choices needs to be a list or a tupleN( R- RO R R/ t tuplet listR t _choices( R
t choicest kwargs( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR H s c C s- t t | � j | | � | j | | � d S( N( R- RO R t _validate_choices( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR R s c C s- t t | � j | | � | j | | � d S( N( R- RO R RU ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR V s c C s[ | d k rW | | j k rW d j t t | j � � } t d j d | d | � � � n d S( Ns , s5 The value of "{name}" field must be one of "{values}"R t values( R RR R0 t mapt strR R ( R
R R RV ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyRU Z s c C s0 t t | � j � } | j i | j d 6� | S( NRS ( R- RO R& t updateRR ( R
t result( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR& ` s ( R R R R R R RU R& ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyRO D s
c C s
| j � S( s2
Helper function to make a field nullable
( R ( t
elem_field( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt Nullableh s t
StringEnumc B s e Z d Z RS( s9
Field that represents an enumeration of Strings
( R R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR] o s t IntegerEnumc B s e Z d Z RS( s:
Field that represents an enumeration of Integers
( R R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR^ u s t FloatEnumc B s e Z d Z RS( s8
Field that represents an enumeration of Floats
( R R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR_ { s t
NumberEnumc B s e Z d Z RS( s9
Field that represents an enumeration of Numbers
( R R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR` � s t Listc B sS e Z d Z d d d � Z d � Z d � Z d � Z d � Z d � Z d � Z
RS( s:
List represents lists of `elem_field` values
c K s� t t | � j | � | j d k r= t j | j � | _ n t | t � s[ t d � � n | | _ | pm d | _
| | _ d S( s
:param elem_field:
:type elem: Instance of :py:class:`Field`
:param minimum: Minimal number of elements
:type minimum: int or None
:param maximum: Maximum number of elements
:type maximum: int or None
:param default: Default value to use if the field is not set
:type default: A list of elements with the value type as specified in `elem_field`
:param help: Documentation string for generating model documentation
:type help: str
s; elem_field must be an instance of a type derived from Fieldi N( R- Ra R R R R R/ R R t
_elem_typet _minimumt _maximum( R
R[ t minimumt maximumRT ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s
c
C sw d } t | � } | j | k o5 | j p/ | k n ss t | j d | d | j d | j pa | d | � � � n d S( Nsb Element count error for field {name} expected between {minimum} and {maximum} elements got {count}R Re Rf t count( t lenRc Rd R R ( R
R R t messageRg ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt _validate_count� s
(c C s� t t | � j | | � t | t t f � r� | j | | � xo t | � D]. \ } } | j j | d d j | | � �qK Wn0 | d k r� t d j t | � j
| � � � n d S( NR s {}[{}]s) Expected list but got {} for the {} field( R- Ra R R/ RQ RP Rj t enumerateRb R R R R R ( R
R R t idxt entry( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s ) c C s� t t | � j | | � t | t t f � r� | j | | � xo t | � D]. \ } } | j j | d d j | | � �qK Wn0 | d k r� t d j t | � j
| � � � n d S( NR s {}[{}]s) Expected list but got {} for the {} field( R- Ra R R/ RQ RP Rj Rk Rb R R R R R ( R
R R Rl Rm ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s ) c sU | j d | d � � | d k r& | S| j j � t � � f d � t | � D� � S( NR R c 3 s3 | ]) \ } } � | d d j � | � �Vq d S( R s {}[{}]N( R ( t .0Rl Rm ( t converterR ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pys <genexpr>� s ( R R Rb R RQ Rk ( R
R R ( ( Ro R s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s
c sU | j d | d � � | d k r& | S| j j � t � � f d � t | � D� � S( NR R c 3 s3 | ]) \ } } � | d d j � | � �Vq d S( R s {}[{}]N( R ( Rn Rl Rm ( Ro R ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pys <genexpr>� s ( R R Rb R RQ Rk ( R
R R ( ( Ro R s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s
c C sJ t t | � j � } | j i | j j � d 6| j d 6| j d 6� | S( Nt elementRf Re ( R- Ra R& RY Rb Rd Rc ( R
RZ ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR& � s
N( R R R R R Rj R R R R R& ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyRa � s t StringMapc B sM e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s>
Map from strings to instances of a given value type.
c K sh t t | � j | � | j d k r= t j | j � | _ n t | t � s[ t d � � n | | _ d S( Ns; value_type must be an instance of a type derived from Field(
R- Rq R R R R R/ R R t _value_type( R
t
value_typeRT ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s c C s� t t t | � | � } | | | � t | t � r� x� | D]w } t | t � sz d } t | j | t | � j � � � n | | } t | j
| � } | | d d j | | � �q; Wn0 | d k r� t d j t | � j | � � � n d S( Ns= Expected a key of type `str`, but got a key `{}` of type `{}`R s {}[{}]s+ Expected a dict but got {} for the {} field( R" R- Rq R/ t dictRX R R R R Rr R ( R
t new_mapR t validation_methodt list_validator_fnt keyt errR t value_validator_fn( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt% _validate_model_value_using_validator� s
$
# c C s | j | | d � d S( NR ( R{ ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s c C s | j | | d � d S( NR ( R{ ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s c sL | j d � d � � � d k r& � S| j j � � � � f d � � D� S( NR R c s5 i | ]+ } � � | d d j � | � �| � q S( R s
{0}["{1}"]( R ( Rn Rx ( Ro R R ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pys
<dictcomp> s ( R R Rr R ( R
R R ( ( Ro R R s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR � s
c sL | j d � d � � � d k r& � S| j j � � � � f d � � D� S( NR R c s5 i | ]+ } � � | d d j � | � �| � q S( R s
{0}["{1}"]( R ( Rn Rx ( Ro R R ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pys
<dictcomp> s ( R R Rr R ( R
R R ( ( Ro R R s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR s
c C s, t t | � j � } | j j � | d <| S( NRs ( R- Rq R& Rr ( R
RZ ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR& s (
R R R R R{ R R R R R& ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyRq � s t Modelc B sD e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s5
Model is used to use other Models as fields
c K sk t t | � j | � d d l m } t | t � sF t | | � r^ t d j | � � � n | | _ d S( s
:param model_type: A :py:class:`leapp.model.Model` derived class
:type model_type: :py:class:`leapp.model.Model` derived class
:param help: Documentation string for generating the model documentation
:type help: str
i����( R| s$ {} must be a type derived from ModelN(
R- R| R t leapp.modelsR/ R t
issubclassR R R* ( R
t
model_typeRT t ModelType( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR s
c C sr t t | � j | | � t | j d | j � } | rn t | | � rn t d j | j | t | � � � � n d S( Nt _resolveds: Expected an instance of {} for the {} attribute but got {}(
R- R| R R" R* R/ R R R R ( R
R R t resolved_model( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR % s
c C sW t t | � j | | � | rS t | t � rS t d j | t | � j � � � n d S( Ns, Expected a value for the {} field and got {}( R- R| R R/ Rt R R R R ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR , s c C s3 | j | | � | d k r | S| j d d | � S( Nt init_methodR! ( R R R* ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR 1 s c C s* | j | | � | d k r | S| j � S( N( R R t dump( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR 7 s c C s3 t t | � j � } | j i | j j d 6� | S( Nt model( R- R| R& RY R* R ( R
RZ ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR& = s ( R R R R R R R R R& ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR| s
t JSONc B s/ e Z d Z e d � � Z d � Z d � Z RS( s�
The JSON field allows to use json encodable python types as a value.
The value will be internally encoded to a JSON string and converted back into, whatever the result of json.loads
is for that value passed.
Note: The value `None`, however follows the same rules as for all fields and requires the field to be nullable,
to allow this value. Within nested values such as lists or dicts, a None value is perfectly valid.
c C s t j t t t t f t j S( N( R8 R9 R6 RP Rt RQ R< ( R
( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR* P s c C s~ | d k r4 | j s0 t d j d | � � � n | Sy t j | d t �SWn, t t f k
ry t d j | � � � n Xd S( Ns< The value of "{name}" field is None, but this is not allowedR t sort_keyss0 Expected a json encodable value for the field {}( R R
R R t jsont dumpsR t TypeErrorRL ( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR T s c C s- | j | | � | d k r | St j | � S( N( R R R� t loads( R
R R ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR _ s ( R R R R' R* R R ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyR� E s ( R? R RE R� t collections.abcR t ImportErrort collectionsR8 t ExceptionR R t objectR R( R3 R5 R7 R: R; R> RD RO R\ R] R^ R_ R` Ra Rq R| R� ( ( ( s@ /usr/lib/python2.7/site-packages/leapp/models/fields/__init__.pyt <module> s:
�( .$ M@1