Metadata-Version: 2.1
Name: flask-ask-sdk
Version: 1.0.0
Summary: The Flask ASK SDK package provides support for using ASK SDK and Flask, to deploy custom skills as webservice
Home-page: https://github.com/alexa/alexa-skills-kit-sdk-for-python
Author: Alexa Skills Kit
Author-email: ask-sdk-dynamic@amazon.com
License: Apache 2.0
Keywords: ASK SDK,Alexa Skills Kit,Alexa,Flask,Flask Extension
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >2.6, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
Requires-Dist: ask-sdk-webservice-support (>=0.1.0)
Requires-Dist: flask (>=1.0.2)

====================================================
Flask ASK SDK - Extending ASK SDK to work with Flask
====================================================

**flask-ask-sdk** is the extension package, that will let skill developers
use `ASK SDK <https://developer.amazon.com/docs/alexa-skills-kit-sdk-for-python/overview.html>`__
package in their Flask application. It provides an easy way to register and
use `skills as custom webservices <https://developer.amazon.com/docs/custom-skills/host-a-custom-skill-as-a-web-service.html>`__.

Quick Start
-----------

If you already have a skill built using the ASK SDK skill builders, then you
only need to do the following, to set this up in your flask app:

.. code-block:: python

    from flask import Flask
    from ask_sdk_core.skill_builder import SkillBuilder
    from flask_ask_sdk.skill_adapter import SkillAdapter

    sb = SkillBuilder()
    # Register all handlers, interceptors etc.
    # For eg : sb.add_request_handler(LaunchRequestHandler())

    app = Flask(__name__)
    skill_response = SkillAdapter(
        skill=sb.create(), skill_id=<YOUR_SKILL_ID>, app=app)

    skill_response.register(app=app, route="/")

    if __name__ == '__main__':
        app.run()

Are you planning to deploy your skill on AWS Lambda? Then, you don't even
need this package. The `ASK SDK` provides a `lambda_handler` that can be
directly used in your lambda console.

More code examples can be found `here <https://developer.amazon.com/docs/alexa-skills-kit-sdk-for-python/sample-skills.html>`__.

Features
--------

- Works as an extension on skills built using ASK SDK. No need to learn
  something new.
- Provides default request signature and request timestamp verification.
  These can be configured on app level by setting / unsetting app
  configuration.
- Provides a way to register multiple skills on your app, at different
  endpoints.

Installation
------------

.. important::

    `cryptography` is a dependency for this package. If you have not
    already installed
    `cryptography <https://cryptography.io/en/latest/>`_, you might need to
    install additional prerequisites as detailed in the
    `cryptography installation guide <https://cryptography.io/en/latest/installation/>`_
    for your operating system.

Assuming that you have Python and ``virtualenv`` installed, you can
install the package and it's dependencies (``ask-sdk-webservice-support``,
``flask``) from PyPi as follows:

.. code-block:: sh

    $ virtualenv venv
    $ . venv/bin/activate
    $ pip install flask-ask-sdk

This package is **not** installed along-side `ask-sdk` standard distribution,
and has to be installed separately if you need support for skill
deployment as webservice, using Flask.


SDK 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 Flask ASK SDK extension package.


0.1.1
-----

This release contains the following changes :

- Fix setting the custom user agent on the skill instance, when initializing the handler.



1.0.0
-------

This release contains the following changes :

- Move the webservice adapters to GA.


