{ "info": { "author": "Gregory Taylor", "author_email": "gtaylor@gc-taylor.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "django-dynamodb-sessions\n========================\n\n:Info: This package contains a simple Django session backend that uses\n Amazon's `DynamoDB`_ for data storage.\n:Author: Greg Taylor\n:Status: Stable, but un-maintained (Open an issue if interested in maintaining!)\n\n.. _DynamoDB: http://aws.amazon.com/dynamodb/\n\nStatus\n------\n\ndjango-dynamodb-sessions has seen some use on small test environments within\nEC2. While it should be ready for prime time, it hasn't been heavily battle\ntested just yet. Other notes:\n\n* There is currently no management command to remove expired sessions. We\n can't re-use the Django cleanup command, so we'll have to write our own.\n This will be added in the next release, we're already setting expiration\n attributes to drive the cleanup.\n\nSet up your DynamoDB Table\n--------------------------\n\nBefore you can use this module, you'll need to visit your `DynamoDB tab`_\nin the AWS Management Console. Then:\n\n* Hit the *Create Table* button.\n* Enter ``sessions`` as your table name. This can be something else, you'll\n just need to adjust the ``settings.DYNAMODB_SESSIONS_TABLE_NAME`` value\n accordingly.\n* Select Primary Key Type = ``Hash``.\n* Select a ``String`` hash attribute type.\n* Enter ``session_key`` for *Hash Attribute Name*.\n* Hit the *Continue* button.\n* Decide on throughput. The free tier is 10 read capacity units, 5 write.\n* Finish the rest of the steps\n\nAfter your table is created, you're ready to install the module on your\nDjango app.\n\n.. _DynamoDB tab: https://console.aws.amazon.com/dynamodb/home\n\nInstallation\n-------------\n\nInstall django-dynamodb-sessions using ``pip`` or ``easy_install``::\n\n pip install django-dynamodb-sessions\n\nIn your ``settings.py`` file, you'll need something like this::\n\n DYNAMODB_SESSIONS_AWS_ACCESS_KEY_ID = 'YourKeyIDHere'\n DYNAMODB_SESSIONS_AWS_SECRET_ACCESS_KEY = 'YourSecretHere'\n\nIf you'd like to add a caching layer between your application and DynamoDB\nto reduce queries (like Django's cached_db backend), set your session\nbackend to::\n\n SESSION_ENGINE = 'dynamodb_sessions.backends.cached_dynamodb'\n\nOtherwise, go straight to DynamoDB::\n\n SESSION_ENGINE = 'dynamodb_sessions.backends.dynamodb'\n\nAfter that, fire her up and keep an eye on your Amazon Management Console\nto see if you need to scale your read/write units up or down.\n\nIf you encounter any bugs, have questions, or would like to share an idea,\nhit up our `issue tracker`_.\n\n.. _Boto3: https://github.com/boto/boto3\n.. _issue tracker: https://github.com/gtaylor/django-dynamodb-sessions/issues\n\nConfiguration\n-------------\n\nThe following settings may be used in your ``settings.py``:\n\n:DYNAMODB_SESSIONS_TABLE_NAME: The table name to use for session data storage.\n Defaults to ``sessions``.\n:DYNAMODB_SESSIONS_TABLE_HASH_ATTRIB_NAME: The hash attribute name on your\n session table. Defaults\n to ``session_key``\n:DYNAMODB_SESSIONS_ALWAYS_CONSISTENT: If you're not using this session backend\n behind a cache, you may want to force all\n reads from DynamoDB to be consistent.\n This may lead to slightly slower queries,\n but you'll never miss object\n creation/edits. Defaults to ``True``.\n:DYNAMODB_SESSIONS_BOTO_SESSION: Used instead of providing access_key and\n region, the `boto3.session.Session `_\n containing authentication for the AWS account\n to use for DynamoDB.\n:DYNAMODB_SESSIONS_AWS_ACCESS_KEY_ID: The access key for the AWS account\n to use for DynamoDB.\n:DYNAMODB_SESSIONS_AWS_SECRET_ACCESS_KEY: The secret for the AWS account\n to use for DynamoDB.\n:DYNAMODB_SESSIONS_AWS_REGION_NAME: The region to use for DynamoDB.\n\n\nChanges\n-------\n\n0.7\n^^^\n\n* Switch to boto3 rather than boto for AWS access.\n* Allow passing of boto3 session rather than AWS credentials.\n\n0.6\n^^^\n\n* Removing some no longer used imports.\n* PEP8 cleanup.\n\n0.5\n^^^\n\n* Replacing self.session_key with self._session_key in the backend. (AdamN)\n\n0.4\n^^^\n\n* Django 1.4 compatibility, and unnecessary code removal. (AdamN)\n\n0.3\n^^^\n\n* Re-packaging with setuptools instead of distutils.\n\n0.2\n^^^\n\n* Correcting an issue with the cached_dynamodb backend.\n\n0.1\n^^^\n\n* Initial release.\n\nLicense\n-------\n\ndjango-dynamodb-sessions is licensed under the `BSD License`_.\n\n.. _BSD License: https://github.com/gtaylor/django-dynamodb-sessions/blob/master/LICENSE", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/gtaylor/django-dynamodb-sessions", "keywords": "", "license": "BSD License", "maintainer": "", "maintainer_email": "", "name": "django-dynamodb-sessions-mwas", "package_url": "https://pypi.org/project/django-dynamodb-sessions-mwas/", "platform": "any", "project_url": "https://pypi.org/project/django-dynamodb-sessions-mwas/", "project_urls": { "Homepage": "https://github.com/gtaylor/django-dynamodb-sessions" }, "release_url": "https://pypi.org/project/django-dynamodb-sessions-mwas/0.7/", "requires_dist": null, "requires_python": "", "summary": "A Django session backend using Amazon's DynamoDB", "version": "0.7" }, "last_serial": 3305206, "releases": { "0.7": [ { "comment_text": "", "digests": { "md5": "a07f5dd55b4389a9864e2eb9e14c73bc", "sha256": "7ac85fee6ecb188772ea3223d81aaa990d77e57bf0178abd1986a5904148331e" }, "downloads": -1, "filename": "django-dynamodb-sessions-mwas-0.7.tar.gz", "has_sig": false, "md5_digest": "a07f5dd55b4389a9864e2eb9e14c73bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7048, "upload_time": "2017-11-04T09:10:33", "url": "https://files.pythonhosted.org/packages/3a/75/9d91df39cb67976131df0338a7c5a039e46d6be9c7c8c8045d2726065e84/django-dynamodb-sessions-mwas-0.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a07f5dd55b4389a9864e2eb9e14c73bc", "sha256": "7ac85fee6ecb188772ea3223d81aaa990d77e57bf0178abd1986a5904148331e" }, "downloads": -1, "filename": "django-dynamodb-sessions-mwas-0.7.tar.gz", "has_sig": false, "md5_digest": "a07f5dd55b4389a9864e2eb9e14c73bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7048, "upload_time": "2017-11-04T09:10:33", "url": "https://files.pythonhosted.org/packages/3a/75/9d91df39cb67976131df0338a7c5a039e46d6be9c7c8c8045d2726065e84/django-dynamodb-sessions-mwas-0.7.tar.gz" } ] }