========================================================
ASK SDK DynamoDB Adapter of Python ASK SDK
========================================================
ask-sdk-dynamodb-persistence-adapter is the persistence adapter package for Alexa Skills Kit (ASK) by
the Software Development Kit (SDK) team for Python. It has the persistence adapter implementation
for connecting the Skill to the AWS DynamoDB. It also provides partition key generator functions,
to get the user id or device id from skill request, that can be used as partition keys.
Quick Start
-----------
Installation
~~~~~~~~~~~~~~~
Assuming that you have Python and ``virtualenv`` installed, you can
install the package and it's dependencies (``ask-sdk-model``, ``ask-sdk-core``) from PyPi
as follows:
.. code-block:: sh
$ virtualenv venv
$ . venv/bin/activate
$ pip install ask-sdk-dynamodb-persistence-adapter
You can also install the whole dynamodb persistence adapter package locally by following these steps:
.. code-block:: sh
$ git clone https://github.com/alexa/alexa-skills-kit-sdk-for-python.git
$ cd alexa-skills-kit-sdk-for-python/ask-sdk-dynamodb-persistence-adapter
$ virtualenv venv
...
$ . venv/bin/activate
$ python setup.py install
Usage and Getting Started
-------------------------
Getting started guides, SDK Features, API references, samples etc. can
be found in the `technical documentation <https://developer.amazon.com/docs/alexa-skills-kit-sdk-for-python/overview.html>`_
Got Feedback?
-------------
- We would like to hear about your bugs, feature requests, questions or quick feedback.
Please search for the `existing issues <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues>`_ before opening a new one. It would also be helpful
if you follow the templates for issue and pull request creation. Please follow the `contributing guidelines <https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/CONTRIBUTING.md>`_!!
- Request and vote for `Alexa features <https://alexa.uservoice.com/forums/906892-alexa-skills-developer-voice-and-vote>`_!
=========
CHANGELOG
=========
0.1
-------
* Initial release of ASK SDK DynamoDB Persistence Adapter package.
0.1.1
~~~~~
* Docstring changes for generated docs.
0.1.2
~~~~~
* unicode_type = six.text_type and define long in Python 3 (#1)
* Use feature detection instead of version detection (#10)
* Send stringified raw data to Alexa APIs (#12)
0.1.3
~~~~~~~
* Remove inspect.getargspec from sb decorators. Closes `#20 <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues/20>`_
1.0.0
-----
* Production release of ASK SDK DynamoDB Persistence Adapter Package.
1.1.0
~~~~~~~
This release contains the following changes:
- Introducing runtime layer (`#41 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/41>`__)
- Send data to service clients only if present (`#39 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/39>`__)
1.2.0
~~~~~~~
This release contains the following changes :
- Add support for Alexa Presentation Language (Public Beta). The Alexa Presentation Language (APL) enables you to build interactive voice experiences that include graphics, images, slideshows, and to customize them for different device types.
1.3.0
~~~~~~~
This release contains the following features :
- Support for [Name-free Interactions, using CanFulfill Intent in responses](https://developer.amazon.com/docs/custom-skills/implement-canfulfillintentrequest-for-name-free-interaction.html).
1.4.0
~~~~~~~
This release contains the following changes :
- Add helper function for matching CanFulfill Intent name `#46 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/46>`
- Deserialize only if payload is not None `48 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/48>`
1.5.0
~~~~~~~
This release contains the following changes :
- Refactor Python version dependencies for Python 3.7 support `50 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/50>`__
1.6.0
~~~~~~~
This release contains the following changes :
- Update DefaultSerializer to let generic classes to be added as session attributes `60 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/60>`__.
1.7.0
~~~~~~~
This release contains the following changes :
- Add optional `play_behavior` attribute to `speak` and `ask` methods in response builder `61 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/61>`__.
1.8.0
~~~~~~~
This release contains the following changes :
- Allow Default API Client to invoke Alexa APIs that require other than 'application/json' body type.
1.9.0
~~~~~~~
This release includes the following :
- Request utility methods which makes it easier to retrieve common properties from an incoming request.
1.10.0
~~~~~~~
This release contains the following changes :
- Viewport Utils support for Echo Show 5 (HUB_LANDSCAPE_SMALL).
- Add check for device information in 'get_device_id' utility function.
- Add 'get_user_id' utility function.
1.10.1
^^^^^^^
This release contains the following :
- Fix the regression bug on `response_interceptors`.
1.10.2
^^^^^^^
This release contains the following changes :
- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/99>`__ on delete persistence attributes, to delete attributes without checking if they are set.
- Fix `type hints <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/95>`__ on lambda_handler.
1.11.0
~~~~~~~
This release contains the following changes :
- `Template Resolvers <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/114>`__ used to generate responses using templates to handle ASK SDK requests.
- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/99>`__ Delete persistence attributes without checking setter.
- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/109>`__ Allow out-of-session requests.
- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/107>`__ Change get_slot_value function to return None when slot is not present.
- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/110>`__ Change decorator returned by request_handler to return the handler function.
1.12.0
~~~~~~~
This release contains the following changes :
- `person_id` as partition key generator, when storing persistence attributes in dynamo tables.
- `py.typed` files for `ask-sdk-core`. Fixes #121.
- Minor doc fix in `ask-sdk-core` readme.
1.13.0
~~~~~~
This release contains the following changes :
- py.typed files added to sdk packages, as per `PEP 561 <https://www.python.org/dev/peps/pep-0561/>`__. Fixes `121 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues/121>`__.
- Fixes the literal check bug in api client, that fails in Python 3.8 `127 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues/127>`__
1.14.0
~~~~~~
This release contains the following changes :
- general bug fixes and updates
1.15.0
~~~~~~
This release contains the following changes :
- A new class UserAgentManager, to help set user agents for higher level frameworks using the SDK
1.16.0
~~~~~~
This release includes the following :
- Added directive support on reprompt by creating utils on Response helper
1.16.1
^^^^^^
This release contains the following changes :
- general bug fixes and updates
1.17.1
^^^^^^
This release contains the following changes :
- general bug fixes and updates
1.18.0
~~~~~~
General bug fixes and updates
1.19.0
~~~~~~
General bug fixes and updates
Raw data
{
"_id": null,
"home_page": "https://github.com/alexa/alexa-skills-kit-sdk-for-python",
"name": "ask-sdk-dynamodb-persistence-adapter",
"maintainer": "",
"docs_url": null,
"requires_python": ">2.6, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*",
"maintainer_email": "",
"keywords": "ASK SDK,Alexa Skills Kit,Alexa,ASK SDK Core,Persistence,DynamoDB",
"author": "Alexa Skills Kit",
"author_email": "ask-sdk-dynamic@amazon.com",
"download_url": "https://files.pythonhosted.org/packages/2c/53/4b64d9ee81e9366546667ee9b8d4aad15b2d19483b0fd55c61e40524a7a3/ask-sdk-dynamodb-persistence-adapter-1.19.0.tar.gz",
"platform": null,
"description": "========================================================\nASK SDK DynamoDB Adapter of Python ASK SDK\n========================================================\n\nask-sdk-dynamodb-persistence-adapter is the persistence adapter package for Alexa Skills Kit (ASK) by\nthe Software Development Kit (SDK) team for Python. It has the persistence adapter implementation\nfor connecting the Skill to the AWS DynamoDB. It also provides partition key generator functions,\nto get the user id or device id from skill request, that can be used as partition keys.\n\n\nQuick Start\n-----------\n\nInstallation\n~~~~~~~~~~~~~~~\nAssuming that you have Python and ``virtualenv`` installed, you can\ninstall the package and it's dependencies (``ask-sdk-model``, ``ask-sdk-core``) from PyPi\nas follows:\n\n.. code-block:: sh\n\n $ virtualenv venv\n $ . venv/bin/activate\n $ pip install ask-sdk-dynamodb-persistence-adapter\n\n\nYou can also install the whole dynamodb persistence adapter package locally by following these steps:\n\n.. code-block:: sh\n\n $ git clone https://github.com/alexa/alexa-skills-kit-sdk-for-python.git\n $ cd alexa-skills-kit-sdk-for-python/ask-sdk-dynamodb-persistence-adapter\n $ virtualenv venv\n ...\n $ . venv/bin/activate\n $ python setup.py install\n\n\nUsage and Getting Started\n-------------------------\n\nGetting started guides, SDK Features, API references, samples etc. can\nbe found in the `technical documentation <https://developer.amazon.com/docs/alexa-skills-kit-sdk-for-python/overview.html>`_\n\n\nGot Feedback?\n-------------\n\n- We would like to hear about your bugs, feature requests, questions or quick feedback.\n Please search for the `existing issues <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues>`_ before opening a new one. It would also be helpful\n if you follow the templates for issue and pull request creation. Please follow the `contributing guidelines <https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/CONTRIBUTING.md>`_!!\n- Request and vote for `Alexa features <https://alexa.uservoice.com/forums/906892-alexa-skills-developer-voice-and-vote>`_!\n\n\n=========\nCHANGELOG\n=========\n\n0.1\n-------\n\n* Initial release of ASK SDK DynamoDB Persistence Adapter package.\n\n0.1.1\n~~~~~\n\n* Docstring changes for generated docs.\n\n0.1.2\n~~~~~\n\n* unicode_type = six.text_type and define long in Python 3 (#1)\n* Use feature detection instead of version detection (#10)\n* Send stringified raw data to Alexa APIs (#12)\n\n0.1.3\n~~~~~~~\n\n* Remove inspect.getargspec from sb decorators. Closes `#20 <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues/20>`_\n\n1.0.0\n-----\n\n* Production release of ASK SDK DynamoDB Persistence Adapter Package.\n\n\n1.1.0\n~~~~~~~\n\nThis release contains the following changes:\n\n- Introducing runtime layer (`#41 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/41>`__)\n- Send data to service clients only if present (`#39 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/39>`__)\n\n\n\n\n\n1.2.0\n~~~~~~~\n\nThis release contains the following changes : \n\n- Add support for Alexa Presentation Language (Public Beta). The Alexa Presentation Language (APL) enables you to build interactive voice experiences that include graphics, images, slideshows, and to customize them for different device types.\n\n\n1.3.0\n~~~~~~~\n\nThis release contains the following features : \n\n- Support for [Name-free Interactions, using CanFulfill Intent in responses](https://developer.amazon.com/docs/custom-skills/implement-canfulfillintentrequest-for-name-free-interaction.html).\n\n\n1.4.0\n~~~~~~~\n\nThis release contains the following changes : \n\n- Add helper function for matching CanFulfill Intent name `#46 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/46>`\n- Deserialize only if payload is not None `48 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/48>`\n\n\n\n1.5.0\n~~~~~~~\n\nThis release contains the following changes :\n\n- Refactor Python version dependencies for Python 3.7 support `50 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/50>`__\n\n\n1.6.0\n~~~~~~~\n\nThis release contains the following changes :\n\n- Update DefaultSerializer to let generic classes to be added as session attributes `60 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/60>`__.\n\n\n1.7.0\n~~~~~~~\n\nThis release contains the following changes :\n\n- Add optional `play_behavior` attribute to `speak` and `ask` methods in response builder `61 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/61>`__. \n\n\n1.8.0\n~~~~~~~\n\nThis release contains the following changes : \n\n- Allow Default API Client to invoke Alexa APIs that require other than 'application/json' body type.\n\n\n\n1.9.0\n~~~~~~~\n\nThis release includes the following : \n\n- Request utility methods which makes it easier to retrieve common properties from an incoming request.\n\n\n1.10.0\n~~~~~~~\n\nThis release contains the following changes : \n\n- Viewport Utils support for Echo Show 5 (HUB_LANDSCAPE_SMALL).\n- Add check for device information in 'get_device_id' utility function.\n- Add 'get_user_id' utility function.\n\n\n1.10.1\n^^^^^^^\n\nThis release contains the following : \n\n- Fix the regression bug on `response_interceptors`.\n\n\n\n1.10.2\n^^^^^^^\n\nThis release contains the following changes : \n\n- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/99>`__ on delete persistence attributes, to delete attributes without checking if they are set. \n- Fix `type hints <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/95>`__ on lambda_handler.\n\n\n1.11.0\n~~~~~~~\n\nThis release contains the following changes : \n- `Template Resolvers <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/114>`__ used to generate responses using templates to handle ASK SDK requests.\n- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/99>`__ Delete persistence attributes without checking setter.\n- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/109>`__ Allow out-of-session requests.\n- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/107>`__ Change get_slot_value function to return None when slot is not present.\n- `Bug fix <https://github.com/alexa/alexa-skills-kit-sdk-for-python/pull/110>`__ Change decorator returned by request_handler to return the handler function.\n\n\n1.12.0\n~~~~~~~\n\nThis release contains the following changes : \n\n- `person_id` as partition key generator, when storing persistence attributes in dynamo tables.\n- `py.typed` files for `ask-sdk-core`. Fixes #121.\n- Minor doc fix in `ask-sdk-core` readme.\n\n\n1.13.0\n~~~~~~\n\nThis release contains the following changes : \n\n- py.typed files added to sdk packages, as per `PEP 561 <https://www.python.org/dev/peps/pep-0561/>`__. Fixes `121 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues/121>`__.\n- Fixes the literal check bug in api client, that fails in Python 3.8 `127 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues/127>`__\n\n\n1.14.0\n~~~~~~\n\nThis release contains the following changes : \n\n- general bug fixes and updates\n\n\n1.15.0\n~~~~~~\n\nThis release contains the following changes : \n\n- A new class UserAgentManager, to help set user agents for higher level frameworks using the SDK\n\n\n1.16.0\n~~~~~~\n\nThis release includes the following : \n\n- Added directive support on reprompt by creating utils on Response helper\n\n\n1.16.1\n^^^^^^\n\nThis release contains the following changes : \n\n- general bug fixes and updates\n\n1.17.1\n^^^^^^\n\nThis release contains the following changes : \n\n- general bug fixes and updates\n\n\n1.18.0\n~~~~~~\n\nGeneral bug fixes and updates\n\n\n1.19.0\n~~~~~~\n\nGeneral bug fixes and updates\n\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "The ASK SDK DynamoDB Persistence Adapter package provides DynamoDB Adapter, that can be used with ASK SDK Core, for persistence management.",
"version": "1.19.0",
"project_urls": {
"Homepage": "https://github.com/alexa/alexa-skills-kit-sdk-for-python"
},
"split_keywords": [
"ask sdk",
"alexa skills kit",
"alexa",
"ask sdk core",
"persistence",
"dynamodb"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e9146b2aba5f782dd9c966fc71c3da893b41da34594d85021029b163cd23449f",
"md5": "6b64e548cdbcf41bda43f027e6c2a2a0",
"sha256": "8db8ad410f1b3a1392fe9bf816119307a771f78f0276607a37a2d1a6ae28b329"
},
"downloads": -1,
"filename": "ask_sdk_dynamodb_persistence_adapter-1.19.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b64e548cdbcf41bda43f027e6c2a2a0",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">2.6, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*",
"size": 9200,
"upload_time": "2023-06-08T18:19:57",
"upload_time_iso_8601": "2023-06-08T18:19:57.348534Z",
"url": "https://files.pythonhosted.org/packages/e9/14/6b2aba5f782dd9c966fc71c3da893b41da34594d85021029b163cd23449f/ask_sdk_dynamodb_persistence_adapter-1.19.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2c534b64d9ee81e9366546667ee9b8d4aad15b2d19483b0fd55c61e40524a7a3",
"md5": "1e40c2c3e991ec7cdbdee5aaeac16b18",
"sha256": "6b2654abffddd172184397a183181f73837027f7f65634dc519d2ab41be1920e"
},
"downloads": -1,
"filename": "ask-sdk-dynamodb-persistence-adapter-1.19.0.tar.gz",
"has_sig": false,
"md5_digest": "1e40c2c3e991ec7cdbdee5aaeac16b18",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">2.6, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*",
"size": 9613,
"upload_time": "2023-06-08T18:19:59",
"upload_time_iso_8601": "2023-06-08T18:19:59.165666Z",
"url": "https://files.pythonhosted.org/packages/2c/53/4b64d9ee81e9366546667ee9b8d4aad15b2d19483b0fd55c61e40524a7a3/ask-sdk-dynamodb-persistence-adapter-1.19.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-08 18:19:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alexa",
"github_project": "alexa-skills-kit-sdk-for-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "ask-sdk-dynamodb-persistence-adapter"
}
JSON
