B `1@sfddlZddlmZmZddlmZdZeddZGdd d ZGd d d ZGd d d e edZ dS)N)datetime timedelta)FilterableMetaclassz%Y-%m-%dT%H:%M:%S)secondsc @seZdZdddZdS)PropertyFNc Cs:||_||_||_||_||_||_||_||_| |_dS)a A Property is an attribute returned from the API, and defines metadata about that value. These are expected to be used as the values of a class-level dict named 'properties' in subclasses of Base. mutable - This Property should be sent in a call to save() identifier - This Property identifies the object in the API volatile - Re-query for this Property if the local value is older than the volatile refresh timeout relationship - The API Object this Property represents derived_class - The sub-collection type this Property represents is_datetime - True if this Property should be parsed as a datetime.datetime filterable - True if the API allows filtering on this property id_relationship - This Property should create a relationship with this key as the ID (This should be used on fields ending with '_id' only) slug_relationship - This property is a slug related for a given type. N) mutable identifiervolatile relationship derived_class is_datetime filterableid_relationshipslug_relationship) selfr r r r r rrrrrG/home/dcms/DCMS/lib/python3.7/site-packages/linode_api4/objects/base.py__init__szProperty.__init__) FFFNNFFFF)__name__ __module__ __qualname__rrrrrr src@s4eZdZdZddZddZddZedd Zd S) MappedObjectz Converts a dict into values accessible with the dot notation. object = { "this": "that" } becomes object.this # "that" cKs|j|jf|dS)N) _expand_vals__dict__)rvalsrrrr8szMappedObject.__init__cKsfxV|D]N}t||tkr.tf||||<qt||tkrdd||D||<qW||dS)NcSs&g|]}t|tkrtf|n|qSr)typedictr).0irrr Asz-MappedObject._expand_vals..)rrrlistupdate)rtargetrvrrrr;s  zMappedObject._expand_valscCsdt|S)NzMapping containing {})formatvarskeys)rrrr__repr__DszMappedObject.__repr__cCs t|jS)N)rr)rrrrrGszMappedObject.dictN) rrr__doc__rrr)propertyrrrrrr,s   rc@seZdZdZiZifddZddZddZdd Zd d Z d d Z ddZ ddZ ddZ ddZddZeddZedddZed ddZdS)!Basez\ The Base class knows how to look up api properties of a model, and lazy-load them. cCs|dd|dtj|d||ddxt|jD]}||dq>W|d|tt|dr|tt|d|||dS)N _populatedF _last_updated_client _raw_jsonidZ id_attribute)_setrminr propertieshasattrgetattr _populate)rclientr1jsonproprrrrQs    z Base.__init__c CsL|t|jkrt|j|jr$nt||dkr:|jrrt|j|jsrt|j|jrt|dt t krt|j|jr| |t|j|j |t|dn|nd|t|jkr@t|jd|j}|r@t|d|sdSd|}t||s4| |||jt|d|t||St||S)z Handles lazy-loading/refreshing an object from the server, and getting related objects, as defined in this object's 'properties' Nr.r/z{}_idz _{}_relcache)rr4r(r object__getattribute__r-r r volatile_refresh_timeoutrnowr2Z_api_get_derivedr6_api_getr&rr5r/)rnameZ related_typeZ relcache_namerrrr<es,      zBase.__getattribute__cCsdt|j|jS)z[ Returns a safe representation of this object without accessing the server z{}: {})r&rrr1)rrrrr)sz Base.__repr__cCsH|t|jkr8t|j|js8td|t|j|||dS)zQ Enforces allowing editing of only Properties defined as mutable z#'{}' is not a mutable field of '{}'N)rr4r(r AttributeErrorr&rr2)rr@valuerrr __setattr__s"zBase.__setattr__cCs,|jjt|j||d}d|kr(dSdS)zR Send this object's mutable values to the server in a PUT request )modeldataerrorFT)r/putr api_endpoint _serialize)rresprrrsaves  z Base.savecCs.|jjt|j|d}d|kr"dS|dS)z8 Sends a DELETE request for this object )rDrFFT)r/deleterrH invalidate)rrJrrrrLs z Base.deletecsBx0fddtjDD]}|dqWdddS)z Invalidates all non-identifier Properties this object has locally, causing the next access to re-fetch them from the server cs g|]}tj|js|qSr)rr4r )rk)rrrr!sz#Base.invalidate..Nr-F)rr4r(r2)rkeyr)rrrMs"zBase.invalidatecs\fddtjD}x>|D]2\}}t|tr@|j||<q"t|tr"|j||<q"W|S)zb A helper method to build a dict of all mutable Properties of this object cs(i|] }tj|jrt||qSr)rr4r r6)ra)rrr sz#Base._serialize..)rr4items isinstancer,r1rr)rresultrNr%r)rrrIs   zBase._serializecCs$|jjt|j|d}||dS)zD A helper method to GET this object from the server )rDN)r/getrrHr7)rr9rrrr?sz Base._api_getc s|sdSd|xN|D]D}|fddtjDkrtj|jrT||dk rTt||trg}xX||D]L}d|krq~tj|j}||dtd}|r| || |q~W||nvt||t r||d}n||}tj|j}||td}|rFt||t rF| ||||qtj|j r||dk r|tj| j ||qt||t krĈ|tf||qt||tkrt||d}||jqtj|jrRy,t||t} |tt| Wn|||YnXq|||qWdd d tdS) z A helper method that, given a JSON object representing this object, assigns values based on the properties dict and the attributes of its Properties. Nr0c3s"|]}tj|js|VqdS)N)rr4r )rrN)rrr sz!Base._populate..r1r/)_listr-Tr.)r2rr4r(r rSr" make_instancer6r7appendrrr/rrWrtimestrptime DATE_FORMATr fromtimestampmktimer>) rr9rOobjsd new_classobjZ related_idmappingtr)rrr7sX     & zBase._populatecCst|||dS)zq A helper method to set values of Properties without invoking the overloaded __setattr__ N)r;rC)rr@rBrrrr2sz Base._setcCsd|jdddS)zd Returns a URL that will produce a list of JSON objects of this class' type /N)joinrHsplit)clsrrrapi_listsz Base.api_listNcCs4ddlm}t||r$|||||S||||SdS)a Makes an api object based on an id and class. :param id: The id of the object to create :param client: The LinodeClient to give the new object :param cls: The class type to instantiate :param parent_id: The parent id for derived classes :param json: The JSON to use to populate the new class :returns: An instance of cls with the given id r) DerivedBaseN)Zdbaserk issubclass)r1r8ri parent_idr9rkrrrmake s  z Base.makecCstj|||||dS)a Makes an instance of the class this is called on and returns it. The intended usage is: instance = Linode.make_instance(123, client, json=response) :param cls: The class this was called on. :param id: The id of the instance to create :param client: The client to use for this instance :param parent_id: The parent id for derived classes :param json: The JSON to populate the instance with :returns: A new instance of this type, populated with json )rmr9)r,rn)rir1r8rmr9rrrrX4szBase.make_instance)NN)NN)rrrr*r4rr<r)rCrKrLrMrIr?r7r2 classmethodrj staticmethodrnrXrrrrr,Ks$ $    A  r,) metaclass) rZrrZ filteringrr\r=rrr;r,rrrrs