Rust Request/Response for Amazon Alexa Skills

About

Implements Amazon Alexa Skill request/response structs following the Alexa skill specifications, including Serde JSON serialization/deserialization with some helpers to extract data from requests and format responses.

These structs can be used as the request and response using the Rust AWS Lambda runtime to implement the skill.

Usage

Simplest possible Alexa "Hello, World" skill:

```rust extern crate lambdaruntime as lambda; extern crate alexasdk;

use lambda::{lambda, Context, error::HandlerError}; use alexa_sdk::{Request,Response}; use std::error::Error;

fn myhandler(req: Request, _ctx: Context) -> Result { Ok(Response::simple("hello", "hello world")) }

fn main() -> Result<(), Box> { lambda!(my_handler);

Ok(())

} ```

A more complete skill, handling multiple locales and a slot:

```rust extern crate lambdaruntime as lambda; extern crate alexasdk;

use lambda::{lambda, Context, error::HandlerError}; use alexasdk::{Request,Response}; use alexasdk::request::{IntentType, Locale}; use std::error::Error;

fn handlehelp(req: &Request) -> Result { Ok(Response::simple("hello", "to say hello, tell me: say hello to someone")) }

fn handlehello(req: &Request) -> Result { let res = match req.locale() { Locale::AustralianEnglish => Response::simple("hello", "G'day mate"), Locale::German => Response::simple("hello", "Hallo Welt"), Locale::Japanese => Response::simple("hello", "こんにちは世界"), _ => if let Some(ref s) = req.slotvalue("name") { Response::simple("hello", (String::from("hello ") + s).as_str()) } else { Response::simple("hello", "hello world") }, }; Ok(res) }

fn handlecancel(req: &Request) -> Result { Ok(Response::end()) }

fn myhandler(req: Request, _ctx: Context) -> Result { match req.intent() { IntentType::Help => handlehelp(&req), IntentType::Cancel => handlecancel(&req), IntentType::User() => handlehello(&req), _ => handlecancel (&req) } }

fn main() -> Result<(), Box> { lambda!(my_handler);

Ok(())

} ```

Reponse Builder

Besides the simplifed Response constructors Response::simple and Response::end (to end a session), the SDK supports a Response builder:

rust let img = Image { small_image_url: Some(String::from("https://example.com/baaz.png")), large_image_url: Some(String::from("https://example.com/baazLarge.png")) }; let mut res = Response::new(false) // should not end session .card(Card::standard("foo", "bar", img)) .speech(Speech::plain("hello")); res.add_attribute("attr", "value");

Attributes

Alexa skills support attributes, which can be used to carry simple state in a session. To set an attribute in the response, use add_attribute on the response, to read a previously set attribute on a subsequent request, use attribute_value on the request.

[TODO: example]