Skip to content

Commit d3ad744

Browse files
committed
Major version 1.0.0 release
1 parent 5ef1194 commit d3ad744

File tree

39 files changed

+876
-1499
lines changed

39 files changed

+876
-1499
lines changed

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,6 @@
3636
<!--- Put an `x` in the below box if you confirm that this request can be released under the Apache 2 license -->
3737
- [ ] By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
3838

39-
[issues]: https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues
39+
[issues]: https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues
4040
[license]: http://aws.amazon.com/apache2.0/
4141
[cla]: http://en.wikipedia.org/wiki/Contributor_License_Agreement

CHANGELOG.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,13 @@ CHANGELOG
1818
* unicode_type = six.text_type and define long in Python 3 (#1)
1919
* Use feature detection instead of version detection (#10)
2020
* Send stringified raw data to Alexa APIs (#12)
21+
22+
0.1.3
23+
~~~~~~~
24+
25+
* Remove inspect.getargspec from sb decorators. Closes `#20 <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues/20>`_
26+
27+
1.0.0
28+
-----
29+
30+
* Production release of ASK SDK Packages.

README.ja.rst

Lines changed: 13 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,5 @@
1-
.. raw:: html
2-
3-
<embed>
4-
<p align="center">
5-
<img src="https://m.media-amazon.com/images/G/01/mobile-apps/dex/avs/docs/ux/branding/mark1._TTH_.png">
6-
<br/>
7-
<h1 align="center">Alexa Skills Kit SDK for Python (ベータ版)</h1>
8-
<p align="center">
9-
<a href="https://travis-ci.org/alexa-labs/alexa-skills-kit-sdk-for-python"><img src="https://img.shields.io/travis/alexa-labs/alexa-skills-kit-sdk-for-python/master.svg?style=flat"></a>
10-
<a href="https://alexa-skills-kit-python-sdk.readthedocs.io/ja/latest/?badge=latest"><img src="https://readthedocs.org/projects/alexa-skills-kit-python-sdk-japanese/badge/?version=latest"></a>
11-
<a href="https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/LICENSE"><img src="http://img.shields.io/pypi/l/ask-sdk-core.svg?style=flat"></a>
12-
</p>
13-
</p>
14-
</embed>
15-
1+
ASK SDK for Python
2+
===============================
163
`English <README.rst>`_ | `日本語 <README.ja.rst>`_
174

185
|Build Status| |Japanese Docs| |License|
@@ -36,7 +23,7 @@ Python(ベータ版)**\ を使うと、ボイラープレートコード(
3623
:target: https://pypi.python.org/pypi/ask-sdk/
3724
:alt: Version
3825
.. |License| image:: http://img.shields.io/pypi/l/ask-sdk-core.svg?style=flat
39-
:target: https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/LICENSE
26+
:target: https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/LICENSE
4027
:alt: License
4128

4229
==================================== =======
@@ -71,42 +58,44 @@ Language Docs
7158
モデル
7259
------
7360

74-
SDKはネイティブのAlexa JSONリクエストおよびレスポンスではなく、モデルクラスで動作します。これらのモデルクラスは、 `開発者向けドキュメント <https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html>`__ のRequest、Response JSONスキーマを使用して生成されます。モデルクラスのソースコードは `ここに <https://github.com/alexa-labs/alexa-apis-for-python>`__ にあります
61+
SDKはネイティブのAlexa JSONリクエストおよびレスポンスではなく、モデルクラスで動作します。これらのモデルクラスは、 `開発者向けドキュメント <https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html>` __のRequest、Response JSONスキーマを使用して生成されます。モデルクラスのソースコードは `ここに <https://github.com/alexa/alexa-apis-for-python>` __にあります
7562

76-
モデルクラスのドキュメントは `here <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/models/ask_sdk_model.html>`__ にあります
63+
モデルクラスのドキュメントは `here <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/models/ask_sdk_model.html>` __にあります
7764

7865
サンプル
7966
----
8067

81-
`Hello Worldスキルサンプル <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/samples/HelloWorld>`__
68+
`Hello Worldスキルサンプル <https://github.com/alexa/skill-sample-python-helloworld-classes>`__
8269
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8370

8471
このコードサンプルでは、サンプルがトリガーされたときのAlexaの応答を聞くことができます。Alexa
8572
Skills KitやAWS Lambdaに慣れるための最小限のサンプルです。
8673

87-
`カラーピッカースキルサンプル <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/samples/ColorPicker>`__
74+
`カラーピッカースキルサンプル <https://github.com/alexa/skill-sample-python-colorpicker>`__
8875
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8976

9077
Hello
9178
Worldから機能を一歩進めて、ユーザーからの入力をキャプチャーできるようにします。スロットの使い方についても説明します。さらに、セッションアトリビュートと、リクエスト、応答のインターセプターの使い方も説明します。
9279

93-
`ハイ&ローゲームスキルサンプル <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/samples/HighLowGame>`__
80+
`ハイ&ローゲームスキルサンプル <https://github.com/alexa/skill-sample-python-highlowgame>`__
9481
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9582

9683
基本的なハイ&ローゲームスキルのテンプレートです。ユーザーが数字を推測し、Alexaがその数字が正解より大きいか小さいかを答えます。
9784

98-
`デバイスアドレスAPIスキルサンプル <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/samples/GetDeviceAddress>`__
85+
`デバイスアドレスAPIスキルサンプル <https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/samples/GetDeviceAddress>`__
9986
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10087

10188
ユーザーのデバイス設定で設定したアドレスをリクエストし、設定されたアドレスにアクセスするサンプルスキルです。
10289

10390

91+
より多くのサンプルについては、 `samples <https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/README.rst#samples>`_ セクションを見てください。
92+
10493
------------
10594

10695
フィードバック
10796
-------
10897

109-
- バグ、機能のリクエスト、ご質問、簡単なフィードバックがあればぜひお聞かせください。新しく問題を提起する前に\ `既存の問題 <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues>`__\ を検索してください。また、問題やプルリクエストはテンプレートに従って作成してください。プルリクエストの場合は\ `投稿のガイドライン <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/CONTRIBUTING.md>`__\ に従ってください。
98+
- バグ、機能のリクエスト、ご質問、簡単なフィードバックがあればぜひお聞かせください。新しく問題を提起する前に\ `既存の問題 <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues>`__\ を検索してください。また、問題やプルリクエストはテンプレートに従って作成してください。プルリクエストの場合は\ `投稿のガイドライン <https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/CONTRIBUTING.md>`__\ に従ってください。
11099

111100
- Alexaの機能に関するリクエストや投票は、\ `こちら <https://alexa.uservoice.com/forums/906892-alexa-skills-developer-voice-and-vote>`__\ をご覧ください。
112101

@@ -117,7 +106,7 @@ Worldから機能を一歩進めて、ユーザーからの入力をキャプチ
117106
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
118107

119108
.. raw:: html
120-
109+
121110
<embed>
122111
<div>
123112
<p><a href="https://github.com/alexa/alexa-skills-kit-sdk-for-nodejs"><img src="https://github.com/konpa/devicon/blob/master/icons/nodejs/nodejs-original.svg?sanitize=true" width="25px" /> NodeJS用のAlexaスキルキットSDK</a></p>

README.rst

Lines changed: 101 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@
44
<p align="center">
55
<img src="https://m.media-amazon.com/images/G/01/mobile-apps/dex/avs/docs/ux/branding/mark1._TTH_.png">
66
<br/>
7-
<h1 align="center">Alexa Skills Kit SDK for Python (Beta)</h1>
7+
<h1 align="center">Alexa Skills Kit SDK for Python</h1>
88
<p align="center">
99
<a href="https://travis-ci.org/alexa-labs/alexa-skills-kit-sdk-for-python"><img src="https://img.shields.io/travis/alexa-labs/alexa-skills-kit-sdk-for-python/master.svg?style=flat"></a>
1010
<a href="https://alexa-skills-kit-python-sdk.readthedocs.io"><img src="https://img.shields.io/readthedocs/alexa-skills-kit-python-sdk.svg?style=flat"></a>
11-
<a href="https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"></a>
11+
<a href="https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"></a>
1212
<a href="https://pypi.python.org/pypi/ask-sdk/"><img src="http://img.shields.io/pypi/v/ask-sdk.svg?style=flat"></a>
1313
<a href="https://pypi.org/project/ask-sdk-core/"><img src="https://pepy.tech/badge/ask-sdk-core"></a>
1414
<a hreg="https://pypi.python.org/pypi/ask-sdk/"><img src="https://img.shields.io/pypi/pyversions/ask-sdk.svg?style=flat"></a>
@@ -18,7 +18,7 @@
1818

1919
`English <README.rst>`_ | `日本語 <README.ja.rst>`_
2020

21-
The **ASK SDK for Python (Beta)** makes it easier for you to build highly engaging skills,
21+
The **ASK SDK for Python** makes it easier for you to build highly engaging skills,
2222
by allowing you to spend more time on implementing features and less on writing
2323
boiler-plate code.
2424

@@ -48,13 +48,13 @@ boiler-plate code.
4848
:target: https://pepy.tech/project/ask-sdk
4949
:alt: Downloads
5050
.. |License| image:: http://img.shields.io/pypi/l/ask-sdk-core.svg?style=flat
51-
:target: https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/blob/master/LICENSE
51+
:target: https://github.com/alexa/alexa-skills-kit-sdk-for-python/blob/master/LICENSE
5252
:alt: License
53-
53+
5454
Package Versions
5555
----------------
5656
==================================== ==================
57-
Package Version
57+
Package Version
5858
------------------------------------ ------------------
5959
ask-sdk-core |Core Version| |Core Downloads|
6060
ask-sdk-dynamodb-persistence-adapter |DynamoDb Version| |DynamoDb Downloads|
@@ -65,12 +65,12 @@ ask-sdk |Standard Version| |Standard Downloads|
6565
Technical Documentation
6666
-----------------------
6767

68-
=========================================================================== ======
69-
Language Docs
70-
=========================================================================== ======
71-
`English <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/>`_ |English Docs|
72-
`日本語 <https://alexa-skills-kit-python-sdk.readthedocs.io/ja/latest/>`_ |Japanese Docs|
73-
=========================================================================== ======
68+
========================================================================== ======
69+
Language Docs
70+
========================================================================== ======
71+
`English <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/>`_ |English Docs|
72+
`日本語 <https://alexa-skills-kit-python-sdk.readthedocs.io/ja/latest/>`_ |Japanese Docs|
73+
========================================================================== ======
7474

7575
.. |English Docs| image:: https://readthedocs.org/projects/alexa-skills-kit-python-sdk/badge/?version=latest
7676
:target: https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/?badge=latest
@@ -80,58 +80,132 @@ Language Doc
8080
:target: https://alexa-skills-kit-python-sdk.readthedocs.io/ja/latest/?badge=latest
8181
:alt: Read the docs japanese
8282

83-
Models
84-
------
83+
`Models <https://github.com/alexa/alexa-apis-for-python>`__
84+
-------
8585

8686
The SDK works on model classes rather than native Alexa JSON requests and
8787
responses. These model classes are generated using the Request, Response JSON
88-
schemas from the `developer docs <https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html>`__. The source code for the model classes can be
89-
found `here <https://github.com/alexa-labs/alexa-apis-for-python>`__.
88+
schemas from the `developer docs <https://developer.amazon.com/docs/custom-skills/request-and-response-json-reference.html>`__.
9089

9190
The documentation for the model classes can be found `here <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/models/ask_sdk_model.html>`__.
9291

9392
Samples
9493
-------
9594

96-
`Hello World Skill Sample <samples/HelloWorld>`_
95+
`Hello World (using Classes) <https://github.com/alexa/skill-sample-python-helloworld-classes>`_
96+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
97+
98+
This code sample will allow you to hear a response from Alexa when you
99+
trigger it. It is a minimal sample to get you familiarized with the
100+
Alexa Skills Kit and AWS Lambda.
101+
102+
This sample shows how to create a skill
103+
using the Request Handler classes. For more information, check the
104+
`Request Processing <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/REQUEST_PROCESSING.html>`_ documentation.
105+
106+
`Hello World (using Decorators) <https://github.com/alexa/skill-sample-python-helloworld-decorators>`_
97107
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
98108

99109
This code sample will allow you to hear a response from Alexa when you
100110
trigger it. It is a minimal sample to get you familiarized with the
101111
Alexa Skills Kit and AWS Lambda.
102112

103-
`Color Picker Skill Sample <samples/ColorPicker>`_
113+
This sample shows how to create a skill
114+
using the Request Handler Decorators. For more information, check the
115+
`Request Processing <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/REQUEST_PROCESSING.html>`_ documentation.
116+
117+
`Color Picker <https://github.com/alexa/skill-sample-python-colorpicker>`_
104118
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
105119

106-
This is a step-up in functionality from Hello World. It allows you to
120+
This is a step-up in functionality from Hello World. When the user provides
121+
their favorite color, Alexa remembers it and tells the user their favorite
122+
color.
123+
124+
It allows you to
107125
capture input from your user and demonstrates the use of Slots. It also
108126
demonstrates use of session attributes and request, response interceptors.
109127

110-
`High Low Game Skill Sample <samples/HighLowGame>`_
111-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
128+
`Fact <https://github.com/alexa/skill-sample-python-fact>`_
129+
~~~~~~~~~~~~~~~~~~~~~~~~~
112130

113-
Template for a basic high-low game skill. When the user guesses a number,
114-
Alexa tells the user whether the number she has in mind is higher or lower.
131+
Template for a basic fact skill. You’ll provide a list of interesting facts
132+
about a topic, Alexa will select a fact at random and tell it to the user
133+
when the skill is invoked.
134+
135+
Demonstrates use of multiple locales and internationalization in the skill.
136+
137+
`Quiz Game <https://github.com/alexa/skill-sample-python-quiz-game>`_
138+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
139+
140+
Template for a basic quiz game skill. Alexa quizzes the user with facts from
141+
a list you provide.
142+
143+
Demonstrates use of render template directives to support displays on
144+
Alexa-enabled devices with a screen.
115145

116-
`Device Address API Skill Sample <samples/GetDeviceAddress>`_
146+
`Device Address <samples/GetDeviceAddress>`_
117147
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
118148

119149
Sample skill that shows how to request and access the configured address in
120150
the user’s device settings.
121151

152+
Demonstrates how to use the alexa APIs using the SDK. For more information,
153+
check the documentation on `Alexa Service Clients <https://alexa-skills-kit-python-sdk.readthedocs.io/en/latest/SERVICE_CLIENTS.html>`_
154+
155+
`Fact with In-Skill Purchases <https://github.com/alexa/skill-sample-python-fact-in-skill-purchases>`_
156+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
157+
158+
Sample fact skill with `in-skill purchase <https://developer.amazon.com/docs/in-skill-purchase/isp-overview.html>`_
159+
features, by offering different packs of facts behind a purchase, and a
160+
subscription to unlock all of the packs at once.
161+
162+
Demonstrates calling monetization alexa service and using ASK CLI to enable
163+
in-skill purchasing.
164+
165+
`City Guide <https://github.com/alexa/skill-sample-python-city-guide>`_
166+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
167+
168+
Template for a local recommendations skill. Alexa uses the data that you
169+
provide to offer recommendations according to the user's stated preferences.
170+
171+
Demonstrates calling external APIs from the skill.
172+
173+
`Pet Match <https://github.com/alexa/skill-sample-python-petmatch>`_
174+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
175+
176+
Sample skill that matches the user with a pet. Alexa prompts the user for
177+
the information it needs to determine a match. Once all of the required
178+
information is collected, the skill sends the data to an external web service
179+
that processes the data and returns the match.
180+
181+
Demonstrates how to prompt and parse multiple values from customers using
182+
`Dialog Management <https://developer.amazon.com/alexa-skills-kit/dialog-management>`_
183+
and `Entity Resolution <https://developer.amazon.com/docs/custom-skills/define-synonyms-and-ids-for-slot-type-values-entity-resolution.html>`_.
184+
185+
`High Low Game <https://github.com/alexa/skill-sample-python-highlowgame>`_
186+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
187+
188+
Template for a basic high-low game skill. When the user guesses a number,
189+
Alexa tells the user whether the number she has in mind is higher or lower.
190+
191+
Demonstrates use of persistence attributes and the persistence adapter
192+
in the SDK.
193+
122194

123195
Got Feedback?
124196
-------------
125197

126198
- We would like to hear about your bugs, feature requests, questions or quick feedback.
127199
Please search for
128-
`existing issues <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues>`_
200+
`existing issues <https://github.com/alexa/alexa-skills-kit-sdk-for-python/issues>`_
129201
before opening a new one. It would also be helpful if you follow the
130202
templates for issue and pull request creation.
131203
Please follow the `contributing guidelines <CONTRIBUTING.md>`_ for
132204
pull requests!!
133205
- Request and vote for
134206
`Alexa features <https://alexa.uservoice.com/forums/906892-alexa-skills-developer-voice-and-vote>`_!
207+
Remember to select the category as **ASK SDK** if your feature request is
208+
specific to SDK.
135209

136210

137211
Additional Resources
@@ -141,7 +215,7 @@ Other Language Alexa Skills Kit SDKs
141215
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
142216

143217
.. raw:: html
144-
218+
145219
<embed>
146220
<div>
147221
<p><a href="https://github.com/alexa/alexa-skills-kit-sdk-for-nodejs"><img src="https://github.com/konpa/devicon/blob/master/icons/nodejs/nodejs-original.svg?sanitize=true" width="25px" /> Alexa Skills Kit SDK for NodeJS</a></p>
@@ -160,3 +234,4 @@ Tutorials & Guides
160234

161235
- `Voice Design Guide <https://developer.amazon.com/designing-for-voice/>`_ -
162236
A great resource for learning conversational and voice user interface design.
237+

ask-sdk-core/CHANGELOG.rst

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,4 +22,9 @@ CHANGELOG
2222
0.1.3
2323
~~~~~~~
2424

25-
* Remove inspect.getargspec from sb decorators. Closes [#20](https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues/20)
25+
* Remove inspect.getargspec from sb decorators. Closes `#20 <https://github.com/alexa-labs/alexa-skills-kit-sdk-for-python/issues/20>`_
26+
27+
1.0.0
28+
-----
29+
30+
* Production release of ASK SDK Core Package.

0 commit comments

Comments
 (0)