summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2014-02-10 01:10:05 -0600
committerSteve Piercy <web@stevepiercy.com>2014-02-10 01:10:05 -0600
commit5ac519452613b7bd5df22293c2ccb3b9c3597ef4 (patch)
treeef58daf97e5440ca525fff15f2349926ee673050 /docs
parent039d12ad4f736548ff05e0626f16f314ec10ba21 (diff)
downloadpyramid-5ac519452613b7bd5df22293c2ccb3b9c3597ef4.tar.gz
pyramid-5ac519452613b7bd5df22293c2ccb3b9c3597ef4.tar.bz2
pyramid-5ac519452613b7bd5df22293c2ccb3b9c3597ef4.zip
- Update list of session packages
- Update Quick Tour section on sessions - Closes PR #1150
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/sessions.rst22
-rw-r--r--docs/quick_tour.rst6
2 files changed, 21 insertions, 7 deletions
diff --git a/docs/narr/sessions.rst b/docs/narr/sessions.rst
index fb5035373..8da743a01 100644
--- a/docs/narr/sessions.rst
+++ b/docs/narr/sessions.rst
@@ -158,10 +158,24 @@ Some gotchas:
Using Alternate Session Factories
---------------------------------
-At the time of this writing, exactly one project-endorsed alternate session
-factory exists named :term:`pyramid_redis_sessions`. It can be downloaded from
-PyPI. It uses the Redis database as a backend. It is the recommended
-persistent session solution at the time of this writing.
+The following session factories exist at the time of this writing.
+
+======================= ======= =============================
+Session Factory Backend Description
+======================= ======= =============================
+pyramid_redis_sessions_ Redis_ Server-side session library
+ for Pyramid, using Redis for
+ storage.
+pyramid_beaker_ Beaker_ Session factory for Pyramid
+ backed by the Beaker
+ sessioning system.
+======================= ======= =============================
+
+.. _pyramid_redis_sessions: https://pypi.python.org/pypi/pyramid_redis_sessions
+.. _Redis: http://redis.io/
+
+.. _pyramid_beaker: https://pypi.python.org/pypi/pyramid_beaker
+.. _Beaker: http://beaker.readthedocs.org/en/latest/
.. index::
single: session factory (custom)
diff --git a/docs/quick_tour.rst b/docs/quick_tour.rst
index 0a8f58fd0..65fd002d5 100644
--- a/docs/quick_tour.rst
+++ b/docs/quick_tour.rst
@@ -743,9 +743,9 @@ When people use your web application, they frequently perform a task
that requires semi-permanent data to be saved. For example, a shopping
cart. This is called a :term:`session`.
-Pyramid has basic built-in support for sessions, with add-ons such as
-``pyramid_redis_sessions`` (or your own custom sessioning engine) that provide
-richer session support. Let's take a look at the
+Pyramid has basic built-in support for sessions. Third party packages such as
+``pyramid_redis_sessions`` provide richer session support. Or you can create
+your own custom sessioning engine. Let's take a look at the
:doc:`built-in sessioning support <../narr/sessions>`. In our
``__init__.py`` we first import the kind of sessioning we want: