class documentation

class SessionStore(SessionBase):

View In Hierarchy

Implement a file based session store.
Class Method clear​_expired Remove expired sessions from the session store.
Class Method ​_get​_storage​_path Undocumented
Method __init__ Undocumented
Method ​_expiry​_date Return the expiry time of the file storing the session's content.
Method ​_key​_to​_file Get the file associated with this session key.
Method ​_last​_modification Return the modification time of the file storing the session's content.
Method clean Undocumented
Method create 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.
Method delete Delete the session data under this key. If the key is None, use the current session key value.
Method exists Return True if the given session_key already exists.
Method load Load the session data and return a dictionary.
Method save 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).
Instance Variable ​_session​_key Undocumented
Instance Variable file​_prefix Undocumented
Instance Variable modified Undocumented
Instance Variable storage​_path Undocumented

Inherited from SessionBase:

Method __contains__ Undocumented
Method __delitem__ Undocumented
Method __getitem__ Undocumented
Method __setitem__ Undocumented
Method clear Undocumented
Method cycle​_key Create a new session key, while retaining the current session data.
Method delete​_test​_cookie Undocumented
Method flush Remove the current session data from the database and regenerate the key.
Method get Undocumented
Method get​_expire​_at​_browser​_close No summary
Method get​_expiry​_age Get the number of seconds until the session expires.
Method get​_expiry​_date Get session the expiry date (as a datetime object).
Method get​_session​_cookie​_age Undocumented
Method items Undocumented
Method keys Undocumented
Method pop Undocumented
Method set​_expiry Set a custom expiration for the session. value can be an integer, a Python datetime or timedelta object or None.
Method set​_test​_cookie Undocumented
Method setdefault Undocumented
Method test​_cookie​_worked Undocumented
Constant TEST​_COOKIE​_NAME Undocumented
Constant TEST​_COOKIE​_VALUE Undocumented
Method ​_get​_new​_session​_key Return session key that isn't being used.
Method ​_get​_or​_create​_session​_key Undocumented
Method ​_get​_session Lazily load session from storage (unless "no_load" is True, when only an empty dict is stored) and store it in the current instance.
Method ​_get​_session​_key Undocumented
Method ​_set​_session​_key Validate session key on assignment. Invalid values will set to None.
Method ​_validate​_session​_key Key must be truthy and at least 8 characters long. 8 characters is an arbitrary lower bound for some minimal key security.
Method decode Undocumented
Method encode Return the given session dictionary serialized and encoded as a string.
Method has​_key Undocumented
Method is​_empty Return True when there is no session_key and the session is empty.
Method update Undocumented
Method values Undocumented
Class Variable __not​_given Undocumented
Class Variable ​_session Undocumented
Class Variable session​_key Undocumented
Instance Variable __session​_key Undocumented
Instance Variable ​_session​_cache Undocumented
Instance Variable accessed Undocumented
Instance Variable serializer Undocumented
Property key​_salt Undocumented
@classmethod
def clear_expired(cls):

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.

@classmethod
def _get_storage_path(cls):

Undocumented

def __init__(self, session_key=None):
def _expiry_date(self, session_data):
Return the expiry time of the file storing the session's content.
def _key_to_file(self, session_key=None):
Get the file associated with this session key.
def _last_modification(self):
Return the modification time of the file storing the session's content.
def clean(self):

Undocumented

def create(self):
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.
def delete(self, session_key=None):
Delete the session data under this key. If the key is None, use the current session key value.
def exists(self, session_key):
Return True if the given session_key already exists.
def load(self):
Load the session data and return a dictionary.
def save(self, must_create=False):
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).
file_prefix =

Undocumented

modified: bool =
storage_path =

Undocumented