a 5Xh-@sddlZddlZddlmZmZddlmZddlmZddlm Z ddl m Z ddl m Z ejejZGdd d eZGd d d eZGd d d ZdS)N)datetime timedelta)settings)signing)timezone)get_random_string) import_stringc@seZdZdZdS) 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__rrj/var/www/viveiro_mudafortebrasil/venv/lib/python3.9/site-packages/django/contrib/sessions/backends/base.pyr sr c@seZdZdZdS) UpdateErrorzF Occurs if Django tries to update a session that was deleted. Nr rrrrrsrc@seZdZdZdZdZeZdVddZddZ d d Z d d Z d dZ e ddZdWddZefddZddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4Z d5d6Z!d7d8Z"e e!Z#e e!e"Z$dXd:d;Z%e e%Z&dd?Z(d@dAZ)dBdCZ*dDdEZ+dFdGZ,dHdIZ-dJdKZ.dLdMZ/dYdNdOZ0dZdPdQZ1dRdSZ2e3dTdUZ4dS)[ SessionBasez- Base class for all Session classes. Z testcookieZworkedNcCs"||_d|_d|_ttj|_dS)NF) _session_keyaccessedmodifiedrrZSESSION_SERIALIZER serializerself session_keyrrr__init__+szSessionBase.__init__cCs ||jvSN_sessionrkeyrrr __contains__1szSessionBase.__contains__cCs |j|Srrrrrr __getitem__4szSessionBase.__getitem__cCs||j|<d|_dSNTrrrrvaluerrr __setitem__7s zSessionBase.__setitem__cCs|j|=d|_dSr"r#rrrr __delitem__;szSessionBase.__delitem__cCs d|jjS)Nzdjango.contrib.sessions.) __class__r rrrrkey_salt?szSessionBase.key_saltcCs|j||Sr)rget)rrdefaultrrrr+CszSessionBase.getcCs:|jp||jv|_||jur dn|f}|jj|g|RS)Nr)rr_SessionBase__not_givenpop)rrr,argsrrrr.FszSessionBase.popcCs,||jvr|j|Sd|_||j|<|SdSr"r#r$rrr setdefaultKs    zSessionBase.setdefaultcCs|j||j<dSr)TEST_COOKIE_VALUETEST_COOKIE_NAMEr)rrrset_test_cookieSszSessionBase.set_test_cookiecCs||j|jkSr)r+r2r1r)rrrtest_cookie_workedVszSessionBase.test_cookie_workedcCs ||j=dSr)r2r)rrrdelete_test_cookieYszSessionBase.delete_test_cookiecCstj||j|jddS)zGReturn the given session dictionary serialized and encoded as a string.T)saltrcompress)rdumpsr*r)rZ session_dictrrrencode\s zSessionBase.encodecCsTztj||j|jdWStjy>td}|dYntyNYn0iS)N)r6rz!django.security.SuspiciousSessionzSession data corrupted) rloadsr*rZ BadSignaturelogging getLoggerwarning Exception)rZ session_dataloggerrrrdecodees   zSessionBase.decodecCs|j|d|_dSr")rupdater)rZdict_rrrrAss zSessionBase.updatecCs ||jvSrrrrrrhas_keywszSessionBase.has_keycCs |jSr)rkeysr)rrrrCzszSessionBase.keyscCs |jSr)rvaluesr)rrrrD}szSessionBase.valuescCs |jSr)ritemsr)rrrrEszSessionBase.itemscCsi|_d|_d|_dSr")_session_cacherrr)rrrclearszSessionBase.clearcCs,z|j o|j WSty&YdS0dS)zBReturn True when there is no session_key and the session is empty.TN)rrFAttributeErrorr)rrris_emptys zSessionBase.is_emptycCstdt}||s|SqdS)z)Return session key that isn't being used. N)rVALID_KEY_CHARSexistsrrrr_get_new_session_keys  z SessionBase._get_new_session_keycCs|jdur||_|jSr)rrMr)rrr_get_or_create_session_keys  z&SessionBase._get_or_create_session_keycCs|ot|dkS)z Key must be truthy and at least 8 characters long. 8 characters is an arbitrary lower bound for some minimal key security. )lenrrrr_validate_session_keysz!SessionBase._validate_session_keycCs|jSr)_SessionBase__session_keyr)rrr_get_session_keyszSessionBase._get_session_keycCs||r||_nd|_dS)zV Validate session key on assignment. Invalid values will set to None. N)rQrRrr%rrr_set_session_keys zSessionBase._set_session_keyFcCsHd|_z|jWSty@|jdus*|r2i|_n ||_Yn0|jS)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. TN)rrFrHrload)rZno_loadrrr _get_sessions zSessionBase._get_sessioncCstjSr)rZSESSION_COOKIE_AGEr)rrrget_session_cookie_agesz"SessionBase.get_session_cookie_agecKsz |d}Wnty&t}Yn0z |d}WntyP|d}Yn0|s^|St|ttfsp|St|trt|}||}|j d|j S)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+rX isinstancerstr fromisoformatdaysseconds)rkwargsrYrZdeltarrrget_expiry_ages       zSessionBase.get_expiry_agecKsz |d}Wnty&t}Yn0z |d}WntyP|d}Yn0t|tr`|St|trtt|S|p~|}|t |dS)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. rYrZr[)rb) r\rr]r+r^rr_r`rXr)rrcrYrZrrrget_expiry_dates        zSessionBase.get_expiry_datecCs^|dur*z |d=Wnty$Yn0dSt|tr@t|}t|trR|}||d<dS)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[)r\r^rrr]r isoformatrTrrr set_expirys     zSessionBase.set_expirycCs |d}durtjS|dkS)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. r[Nr)r+rZSESSION_EXPIRE_AT_BROWSER_CLOSE)rrZrrrget_expire_at_browser_closesz'SessionBase.get_expire_at_browser_closecCs||d|_dS)zc Remove the current session data from the database and regenerate the key. N)rGdeleterr)rrrflush!szSessionBase.flushcCs,|j}|j}|||_|r(||dS)zU Create a new session key, while retaining the current session data. N)rrcreaterFrj)rdatarrrr cycle_key*s zSessionBase.cycle_keycCs tddS)zF Return True if the given session_key already exists. z9subclasses of SessionBase must provide an exists() methodNNotImplementedErrorrrrrrL7szSessionBase.existscCs tddS)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() methodNror)rrrrl?szSessionBase.createcCs tddS)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() methodNro)rZ must_createrrrsaveIszSessionBase.savecCs tddS)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() methodNrorrrrrjSszSessionBase.deletecCs tddS)z@ Load the session data and return a dictionary. z6subclasses of SessionBase must provide a load() methodNror)rrrrV\szSessionBase.loadcCs tddS)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().Nro)clsrrr clear_expiredds zSessionBase.clear_expired)N)N)F)F)N)5r r r rr2r1objectr-rr r!r&r'propertyr*r+r.r0r3r4r5r9r@rArBrCrDrErGrIrMrNrQrSrUrrrWrrXrerfrhrirkrnrLrlrqrjrV classmethodrsrrrrr!sb            r)r;stringrrZ django.confrZ django.corerZ django.utilsrZdjango.utils.cryptorZdjango.utils.module_loadingrascii_lowercasedigitsrKr>r rrrrrrs