.. _reference_session:

Session
=======

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

* ``session['filepaging']``: :class:`~ciowarehouse2.lib.file_paging.FilePaging`
  class parameters.

* ``session['current_files']``: tuple of ``(ciopath, ciotype)`` of the last
  displayed files.

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

  - ``'favorite_only'``: ``True`` to see favorite warehouses only
  - ``'editing'``: a dictionary of files being edited
    (``{ciopath: expiration,...}``)
  - ``'scope'``: ``'warehouse'``, ``'favorite'``, ``'all'``, the scope of the
    current search

* ``session['favorites']``: a list of favorite warehouse.

* ``session['managers']``: a dictionary storing the current rendering for a
  each file manager used by the user. See:
  :class:`~ciowarehouse2.lib.manager.Manager`.

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

* ``session['search']``: a dictionary of last searches.