1.10.5 Writing a Module Based On Session

The session classes allows some keys to be reserved so the user of the module cannot access or change those particular keys. This allows a module writer to use the session store to store important variables which the user of the module should not have access to.

session.reserve(key)
Add a reserved key
session.release(key)
Release a reserved key so that it can be used agian

An example of an application which uses these features is the web.auth module which sets information such as when the application was started and when it was last accessed. It reserves these variables so that if a user is using the same session store for a different different purpose within the same application they cannot over-write these variables.

See About this document... for information on suggesting changes.