Package: bottle-session
Bottle_session is a session manager for the Bottle microframework that
uses a cookie to maintain your web session and stores a hash associated
with that cookie using the redis key-value store. It is designed as a
simple Bottle plugin.InstallationInstall using either pip or easy_install:$ pip install bottle-sessionor you can download the latest version from bitbucket:$ git clone https://devries@bitbucket.org/devries/bottle-session.git
$ cd bottle-session
$ python setup.py installRequirementsIn order to use bottle-session you must have both the redis and of
course the bottle modules installed. I recommend also installing
pycrypto, although it is not required. If pycrypto is installed, then
the pycrypto random number generator is used to generate session
cookies, otherwise python’s internal random number generator is used.Using Bottle-sessionThe first requirement is that you import the bottle_session module:import bottle_session
import bottleNext, initialize the plugin:app = bottle.app()
plugin = bottle_session.SessionPlugin(cookie_lifetime=600)
app.install(plugin)Thecookie_lifetimeparameter is the lifetime of the cookie in
seconds, if the lifetime is explicitly set toNoneit will last 1
week. TheSessionPluginclass initializer takes several optional
parameters:hostis the host for the redis instance. It defaults tolocalhost.portis the port for the redis instance. It defaults to6379.dbis the redis database number. It defaults to0.cookie_nameis the name of the session cookie. It defaults tobottle.session.cookie_secureis a boolean variable to set the Secure cookie
flag. It defaults toFalse.cookie_httponlyis a boolean variable to set the HttpOnly cookie
flag. It defaults toFalse.keywordis the plugin keyword. It defaults tosession.passwordis the optional password for the redis instance. It
defaults to none.To use the plugin, just add the keyword (sessionby default) to the
routed method:@bottle.route('/')
def index(session):
    user_name = session.get('name')
    if user_name is not None:
        return "Hello, %s"%user_name
    else:
        return "I don't recognize you."

@bottle.route('/set/:user_name')
def set_name(session,user_name=None):
    if user_name is not None:
        session['name']=user_name
        return "I recognize you now."
    else:
        return "What was that?"

bottle.debug(True)
bottle.run(app=app,host='localhost',port=8888)In this example you can set thenameproperty of the session cookie
to Chris by visiting thehttp://localhost:8888/set/Chrisand then
that value is retrieved when you visithttp://localhost:8888/.Using Bottle-session and Bottle-redisIf you are using redis for sessions you are likely using redis to store
other data as well, and likely use the bottle-redis plugin. You can use
both plugins together, and you can even get them to use the same
connection pool. Initialize them by creating a connection pool which you
attach to each plugin object before installing them into the bottle
application as shown below:#!/usr/bin/env python
import bottle_session
import bottle_redis
import bottle
import redis
from datetime import datetime

app = bottle.app()
session_plugin = bottle_session.SessionPlugin()
redis_plugin = bottle_redis.RedisPlugin()

connection_pool = redis.ConnectionPool(host='localhost', port=6379)

session_plugin.connection_pool = connection_pool
redis_plugin.redisdb = connection_pool
app.install(session_plugin)
app.install(redis_plugin)

@bottle.route('/')
def index(session,rdb):
    rdb.incr('visitors')
    visitor = rdb.get('visitors')
    last_visit = session['visit']
    session['visit'] = datetime.now().isoformat()

    return 'You are visitor %s, your last visit was on %s'%(visitor,last_visit)

bottle.debug(True)
bottle.run(app=app,host='localhost',port=8888)AcknowledgmentsThanks to Marcel Hellkamp and the bottle community for the framework and
to Sean M. Collins whose bottle-redis package in bottle-extras served as
the inspiration for this bottle plugin. Thank you to James Burke for
your contributions.