_8@sdZddlZddlZddlmZddlmZddlmZddlmZddl m Z dd l m Z dd l m Z dd lmZGd d d e jZGdddeeZGdddeZGdddeZeZGdddeZdS)z flask.sessions ~~~~~~~~~~~~~~ Implements cookie based sessions based on itsdangerous. :copyright: 2010 Pallets :license: BSD-3-Clause N)datetime) BadSignature)URLSafeTimedSerializer) CallbackDict)collections_abc)is_ip) total_seconds)TaggedJSONSerializerc@sOeZdZdZeddZejddZdZdZdZ dS) SessionMixinz3Expands a basic dictionary with session attributes.cCs|jddS)z3This reflects the ``'_permanent'`` key in the dict. _permanentF)get)selfr//tmp/pip-build-5gj8f0j9/flask/flask/sessions.py permanentszSessionMixin.permanentcCst||d.on_update)superr__init__)rinitialr) __class__rrr Ks zSecureCookieSession.__init__csd|_tt|j|S)NT)rrr __getitem__)rkey)r"rrr#Rs zSecureCookieSession.__getitem__cs"d|_tt|j||S)NT)rrrr )rr$default)r"rrr Vs zSecureCookieSession.getcs"d|_tt|j||S)NT)rrr setdefault)rr$r%)r"rrr&Zs zSecureCookieSession.setdefault) rrrrrrr r#r r&rr)r"rr5s rc@sCeZdZdZddZeZZZZZ Z Z [dS) NullSessionzClass used to generate nicer error messages if sessions are not available. Will still allow read-only access to the empty session but fail on setting. cOstddS)NzThe session is unavailable because no secret key was set. Set the secret_key on the application to something unique and secret.) RuntimeError)rargskwargsrrr_faileszNullSession._failN) rrrrr+ __setitem__ __delitem__clearpoppopitemupdater&rrrrr'_s  r'c@seZdZdZeZdZddZddZddZ d d Z d d Z d dZ ddZ ddZddZddZddZdS)SessionInterfaceaThe basic interface you have to implement in order to replace the default session interface which uses werkzeug's securecookie implementation. The only methods you have to implement are :meth:`open_session` and :meth:`save_session`, the others have useful defaults which you don't need to change. The session object returned by the :meth:`open_session` method has to provide a dictionary like interface plus the properties and methods from the :class:`SessionMixin`. We recommend just subclassing a dict and adding that mixin:: class Session(dict, SessionMixin): pass If :meth:`open_session` returns ``None`` Flask will call into :meth:`make_null_session` to create a session that acts as replacement if the session support cannot work because some requirement is not fulfilled. The default :class:`NullSession` class that is created will complain that the secret key was not set. To replace the session interface on an application all you have to do is to assign :attr:`flask.Flask.session_interface`:: app = Flask(__name__) app.session_interface = MySessionInterface() .. versionadded:: 0.8 FcCs |jS)aCreates a null session which acts as a replacement object if the real session support could not be loaded due to a configuration error. This mainly aids the user experience because the job of the null session is to still support lookup without complaining but modifications are answered with a helpful error message of what failed. This creates an instance of :attr:`null_session_class` by default. )null_session_class)rapprrrmake_null_sessions z"SessionInterface.make_null_sessioncCst||jS)zChecks if a given object is a null session. Null sessions are not asked to be saved. This checks if the object is an instance of :attr:`null_session_class` by default. ) isinstancer3)robjrrris_null_sessionsz SessionInterface.is_null_sessioncCs|jd}|dk r'|r#|SdS|jd}|sKd|jd s   *