.. _reference_session:

Session
=======

This application uses session mechanism. The session keeps the following
values.

* ``session['ciowarehouse']``: a dictionary storing CioWarehouse states. It has
  the following keys:

  - ``'favorite_only'``: ``True`` to see favorite warehouses only
  - ``'current_cache'``: a tuple containing cache key and cache namespace of
    current file list
  - ``'editing'``: a dictionary of files being edited (``{file_id:
    expiration,...}``)

* ``session['handlers']``: a dictionary storing the current rendering for a
  each file handler used by the user. See:
  :class:`~ciowarehouse.lib.handler.Handler`.

* ``session['sharings']``: list of authorized shares.