This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Status

django-dynamodb-sessions has seen some use on small test environments within EC2. While it should be ready for prime time, it hasn’t been heavily battle tested just yet. Other notes:

  • There is currently no management command to remove expired sessions. We can’t re-use the Django cleanup command, so we’ll have to write our own. This will be added in the next release, we’re already setting expiration attributes to drive the cleanup.

Set up your DynamoDB Table

Before you can use this module, you’ll need to visit your DynamoDB tab in the AWS Management Console. Then:

  • Hit the Create Table button.
  • Enter sessions as your table name. This can be something else, you’ll just need to adjust the settings.DYNAMODB_SESSIONS_TABLE_NAME value accordingly.
  • Select Primary Key Type = Hash.
  • Select a String hash attribute type.
  • Enter session_key for Hash Attribute Name.
  • Hit the Continue button.
  • Decide on throughput. The free tier is 10 read capacity units, 5 write.
  • Finish the rest of the steps

After your table is created, you’re ready to install the module on your Django app.

Installation

Install django-dynamodb-sessions using pip or easy_install:

pip install django-dynamodb-sessions

In your settings.py file, you’ll need something like this:

DYNAMODB_SESSIONS_AWS_ACCESS_KEY_ID = 'YourKeyIDHere'
DYNAMODB_SESSIONS_AWS_SECRET_ACCESS_KEY = 'YourSecretHere'

If you’d like to add a caching layer between your application and DynamoDB to reduce queries (like Django’s cached_db backend), set your session backend to:

SESSION_ENGINE = 'dynamodb_sessions.backends.cached_dynamodb'

Otherwise, go straight to DynamoDB:

SESSION_ENGINE = 'dynamodb_sessions.backends.dynamodb'

After that, fire her up and keep an eye on your Amazon Management Console to see if you need to scale your read/write units up or down.

If you encounter any bugs, have questions, or would like to share an idea, hit up our issue tracker.

Configuration

The following settings may be used in your settings.py:

DYNAMODB_SESSIONS_TABLE_NAME:
 The table name to use for session data storage. Defaults to sessions.
DYNAMODB_SESSIONS_TABLE_HASH_ATTRIB_NAME:
 The hash attribute name on your session table. Defaults to session_key
DYNAMODB_SESSIONS_ALWAYS_CONSISTENT:
 If you’re not using this session backend behind a cache, you may want to force all reads from DynamoDB to be consistent. This may lead to slightly slower queries, but you’ll never miss object creation/edits. Defaults to True.
DYNAMODB_SESSIONS_AWS_ACCESS_KEY_ID:
 The access key for the AWS account to use for DynamoDB.
DYNAMODB_SESSIONS_AWS_SECRET_ACCESS_KEY:
 The secret for the AWS account to use for DynamoDB.
DYNAMODB_SESSIONS_AWS_REGION_NAME:
 The region to use for DynamoDB.

Changes

0.6

  • Removing some no longer used imports.
  • PEP8 cleanup.

0.5

  • Replacing self.session_key with self._session_key in the backend. (AdamN)

0.4

  • Django 1.4 compatibility, and unnecessary code removal. (AdamN)

0.3

  • Re-packaging with setuptools instead of distutils.

0.2

  • Correcting an issue with the cached_dynamodb backend.

0.1

  • Initial release.

License

django-dynamodb-sessions is licensed under the BSD License.

Release History

Release History

0.6

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-dynamodb-sessions-0.6.tar.gz (6.6 kB) Copy SHA256 Checksum SHA256 Source Mar 3, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting