ie-ddlZddlZddlmZmZddlmZddlmZddlm Z ddl m Z ddl m Z ejejzZGdd eZGd d eZGd d Zy)N)datetime timedelta)settings)signing)timezone)get_random_string) import_stringceZdZdZy) CreateErrorz Used internally as a consistent exception type to catch from save (see the docstring for SessionBase.save() for details). N__name__ __module__ __qualname____doc__NE:\TRUCKING_PROJECT\Lib\site-packages\django/contrib/sessions/backends/base.pyr r s   rr ceZdZdZy) UpdateErrorzF Occurs if Django tries to update a session that was deleted. Nr rrrrrs  rrcjeZdZdZdZdZeZd-dZdZ dZ dZ d Z e d Zd-d Zefd Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"e e!Z#e e!e"Z$d.dZ%e e%Z&d Z'd!Z(d"Z)d#Z*d$Z+d%Z,d&Z-d'Z.d(Z/d.d)Z0d-d*Z1d+Z2e3d,Z4y)/ SessionBasez- Base class for all Session classes. testcookieworkedNcj||_d|_d|_ttj |_y)NF) _session_keyaccessedmodifiedr rSESSION_SERIALIZER serializerself session_keys r__init__zSessionBase.__init__+s*'  '(C(CDrc||jvSN_sessionr!keys r __contains__zSessionBase.__contains__1dmm##rc |j|Sr%r&r(s r __getitem__zSessionBase.__getitem__4s}}S!!rc0||j|<d|_yNTr'rr!r)values r __setitem__zSessionBase.__setitem__7s" c rc,|j|=d|_yr/r0r(s r __delitem__zSessionBase.__delitem__;s MM#  rc4d|jjzS)Nzdjango.contrib.sessions.) __class__rr!s rkey_saltzSessionBase.key_salt?s)DNN,G,GGGrc:|jj||Sr%)r'get)r!r)defaults rr;zSessionBase.getCs}}  g..rc|jxs||jv|_||jurdn|f}|jj|g|S)Nr)rr'_SessionBase__not_givenpop)r!r)r<argss rr?zSessionBase.popFsM = )=  0 00rwj t}}  ,t,,rcl||jvr|j|Sd|_||j|<|Sr/r0r1s r setdefaultzSessionBase.setdefaultKs7 $-- ==% % DM!&DMM# Lrc6|j||j<yr%)TEST_COOKIE_VALUETEST_COOKIE_NAMEr8s rset_test_cookiezSessionBase.set_test_cookieSs&*&<&<T " "#rcR|j|j|jk(Sr%)r;rErDr8s rtest_cookie_workedzSessionBase.test_cookie_workedVs"xx--.$2H2HHHrc||j=yr%)rEr8s rdelete_test_cookiezSessionBase.delete_test_cookieYs && 'rc\tj||j|jdS)zGReturn the given session dictionary serialized and encoded as a string.T)saltrcompress)rdumpsr9r)r! session_dicts rencodezSessionBase.encode\s'}}    rc tj||j|jS#tj$r*t j d}|jdYiSt$rYiSwxYw)N)rLrz!django.security.SuspiciousSessionzSession data corrupted) rloadsr9r BadSignaturelogging getLoggerwarning Exception)r! session_dataloggers rdecodezSessionBase.decodeesw ==4==T__ ## 5&&'JKF NN3 4      s+.9A6*A65A6cH|jj|d|_yr/)r'updater)r!dict_s rr\zSessionBase.updatess U# rc||jvSr%r&r(s rhas_keyzSessionBase.has_keywr+rc6|jjSr%)r'keysr8s rrazSessionBase.keyszs}}!!##rc6|jjSr%)r'valuesr8s rrczSessionBase.values}s}}##%%rc6|jjSr%)r'itemsr8s rrezSessionBase.itemss}}""$$rc.i|_d|_d|_yr/)_session_cacherrr8s rclearzSessionBase.clears!  rcZ |j xr |j S#t$rYywxYw)zBReturn True when there is no session_key and the session is empty.T)rrgAttributeErrorr8s ris_emptyzSessionBase.is_emptys6 (((D1D1D-D D  s  **cL tdt}|j|s|S$)z)Return session key that isn't being used. )rVALID_KEY_CHARSexistsr s r_get_new_session_keyz SessionBase._get_new_session_keys(+B@K;;{+""rc\|j|j|_|jSr%)rrpr8s r_get_or_create_session_keyz&SessionBase._get_or_create_session_keys+    $ $ 9 9 ;D    rc&|xrt|dk\S)z Key must be truthy and at least 8 characters long. 8 characters is an arbitrary lower bound for some minimal key security. )lenr(s r_validate_session_keyz!SessionBase._validate_session_keys $s3x1}$rc|jSr%)_SessionBase__session_keyr8s r_get_session_keyzSessionBase._get_session_keys!!!rcD|j|r||_yd|_y)zV Validate session key on assignment. Invalid values will set to None. N)rvrxr!r2s r_set_session_keyzSessionBase._set_session_keys"  % %e ,!&D !%D rcd|_ |jS#t$r9|j|ri|_n|j |_Y|jSwxYw)z Lazily load session from storage (unless "no_load" is True, when only an empty dict is stored) and store it in the current instance. T)rrgrjr"load)r!no_loads r _get_sessionzSessionBase._get_sessions\   2&& & 2'7&(#&*iik#"""  2s 4AAc"tjSr%)rSESSION_COOKIE_AGEr8s rget_session_cookie_agez"SessionBase.get_session_cookie_ages***rc  |d} |d}|s|j St |t tfs|St |trt j|}||z }|jdz|jzS#t$rtj}YwxYw#t$r|jd}YwxYw)zGet the number of seconds until the session expires. Optionally, this function accepts `modification` and `expiry` keyword arguments specifying the modification and expiry of the session. modificationexpiry_session_expiryiQ) KeyErrorrnowr;r isinstancerstr fromisoformatdaysseconds)r!kwargsrrdeltas rget_expiry_agezSessionBase.get_expiry_ages  *!.1L  1H%F..0 0&8S/2M fc "++F3F%zzE!EMM11# *#<<>L * 1XX/0F 1s"A=B =BB B=<B=c T |d} |d}t |t r|St |t rt j|S|xs|j}|t|zS#t$rtj}YwxYw#t$r|jd}YwxYw)zGet session the expiry date (as a datetime object). Optionally, this function accepts `modification` and `expiry` keyword arguments specifying the modification and expiry of the session. rrr)r) rrrr;rrrrrr)r!rrrs rget_expiry_datezSessionBase.get_expiry_dates  *!.1L 1H%F fh 'M  $))&1 184668i777 *#<<>L *  1XX/0F 1s"A'B 'BB B'&B'c| |d=yt|trtj|z}t|t r|j }||d<y#t$rYywxYw)a* Set a custom expiration for the session. ``value`` can be an integer, a Python ``datetime`` or ``timedelta`` object or ``None``. If ``value`` is an integer, the session will expire after that many seconds of inactivity. If set to ``0`` then the session will expire on browser close. If ``value`` is a ``datetime`` or ``timedelta`` object, the session will expire at that specific future time. If ``value`` is ``None``, the session uses the global session expiry policy. Nr)rrrrrr isoformatr{s r set_expiryzSessionBase.set_expirysn = *+  eY 'LLNU*E eX &OO%E"'    sA A! A!cR|jdx}tjS|dk(S)a Return ``True`` if the session is set to expire when the browser closes, and ``False`` if there's an expiry date. Use ``get_expiry_date()`` or ``get_expiry_age()`` to find the actual expiry date/age, if there is one. rr)r;rSESSION_EXPIRE_AT_BROWSER_CLOSE)r!rs rget_expire_at_browser_closez'SessionBase.get_expire_at_browser_closes/hh01 1F :;; ;{rcR|j|jd|_y)zc Remove the current session data from the database and regenerate the key. N)rhdeleterr8s rflushzSessionBase.flush!s   rc|j}|j}|j||_|r|j |yy)zU Create a new session key, while retaining the current session data. N)r'r"creatergr)r!datar)s r cycle_keyzSessionBase.cycle_key*s=}} "  KK  rctd)zF Return True if the given session_key already exists. z9subclasses of SessionBase must provide an exists() methodNotImplementedErrorr s rrozSessionBase.exists7s" G  rctd)z Create a new session instance. Guaranteed to create a new object with a unique key and will have saved the result once (with empty data) before the method returns. z8subclasses of SessionBase must provide a create() methodrr8s rrzSessionBase.create?s " F  rctd)z Save the session data. If 'must_create' is True, create a new session object (or raise CreateError). Otherwise, only update an existing object and don't create one (raise UpdateError if needed). z6subclasses of SessionBase must provide a save() methodr)r! must_creates rsavezSessionBase.saveIs " D  rctd)zx Delete the session data under this key. If the key is None, use the current session key value. z8subclasses of SessionBase must provide a delete() methodrr s rrzSessionBase.deleteSs " F  rctd)z@ Load the session data and return a dictionary. z6subclasses of SessionBase must provide a load() methodrr8s rr~zSessionBase.load\s" D  rctd)a Remove expired sessions from the session store. If this operation isn't possible on a given backend, it should raise NotImplementedError. If it isn't necessary, because the backend has a built-in expiration mechanism, it should be a no-op. z.This backend does not support clear_expired().r)clss r clear_expiredzSessionBase.clear_expiredds""RSSrr%)F)5r rrrrErDobjectr>r#r*r-r3r5propertyr9r;r?rBrFrHrJrPrZr\r_rarcrerhrkrprrrvryr|r"rrr'rrrrrrrrorrrr~ classmethodrrrrrr!s4$ (KE $"HH/ +- =I(  $$&%#! %"&+,K,.>?L # %H+268.(8 !      TTrr)rTstringrr django.confr django.corer django.utilsrdjango.utils.cryptordjango.utils.module_loadingr ascii_lowercasedigitsrnrWr rrrrrrsY ( !15((6==8 )  ) LTLTr