Welcome to the Alexa Twitter Trends Skill

This is an Alexa skill which can be used to get you the latest given a city name in the United States.

This skill uses the Twitter API to get the latest trends for a place. It also relies on the PY-WOEID API to retrieve the Where on Earth IDentifier for the query city name.

This project is made possible by using the following:

• Serverless Application Model (SAM)
• SAM Local
• Twit
• YQL

Code Structure

• README.md - this file
• buildspec.yml - This YAML file is used by AWS CodeBuild to create an artifact that can be used to deploy to AWS Lambda through CloudFormation.
• index.js - This file contains the AWS Lambda code used to interact with Alexa.
• twitter-wrapper.js - This file contains the code to do GET trends/place and return the top 5 trends given woeid.
• events.json - This file contains a sample of list of events that can be use to do local development using sam-local
• package.json - This file is used by NPM to package your Alexa skill.
• template.yml - This YAML file is used by AWS CloudFormation to update AWS Lambda and manage any additional AWS resources.

How to deploy your serverless app?

Reference: http://docs.aws.amazon.com/lambda/latest/dg/serverless-deploy-wt.html#serverless-deploy

1. Create your code bucket:

$ S3_BUCKET=bucket-name # You can give ${awsAccountId}-code-bucket
$ aws s3 mb s3://$S3_BUCKET --region us-east-1

2. Build and Package your application:

$ npm i && aws cloudformation package --template template.yml --s3-bucket $S3_BUCKET --output-template template-export.yml

3. Deploy your packaged application:

aws cloudformation deploy --template-file ./template-export.yml --stack-name new-alexa-trends --capabilities CAPABILITY_IAM --parameter-overrides param1=value1 param2=value2 ...

These parameters will be the environment variables specified in template.yml