alexa_skills_ruby 0.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1101b97d3f88c45eb43d643d75e3e8e8ca6b26c6
+  data.tar.gz: 0b6350b302c7ed1b643471986233069fe0a139c7
+SHA512:
+  metadata.gz: fc1a9404b923d9575c8a75aceed09e7bd0b9dda09230f08d475b199c7f7d53923160c39b9093d3d645872e8d0611eb3e805d31f40c35c11e56683a30aa9e2bdf
+  data.tar.gz: e3f2725899cd0147118eb291c6ba8f6753bb521d67232722695eaa78e9cd0eb6c58e9f4c1d12254da9d8796d7d36abe0a52a941a896cc88357f976a5f5869bbf

data/.gitignore

@@ -0,0 +1,36 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Dan Elbert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,58 @@
+# alexa-skills-ruby
+Simple library to interface with the Alexa Skills Kit
+
+The primary way to interact with this library is by extending the `AlexaSkillsRuby::Handler` class.  Create a subclass and
+register event handlers.
+
+The following handlers are available:
+
+* `on_authenticate` - called before checking the ApplicationID
+* `on_session_start` - called first if the request is flagged as a new session
+* `on_launch` - called for a LaunchRequest
+* `on_session_end` - called for a SessionEndedRequest
+* `on_intent` called for an IntentRequest.  Takes an optional string argument that specifies which intents it will be trigged on
+
+In event handlers, the following methods are available:
+
+* `request` - returns the current Request object, a `AlexaSkillsRuby::JsonObjects::BaseRequest`
+* `session` - returns the current Session object, a `AlexaSkillsRuby::JsonObjects::Session`
+* `session_attributes` - Hash containing the current session attributes.  If the response is not flagged to end the session, all values will be sent with the response
+* `response` - returns the current Response object, a `AlexaSkillsRuby::JsonObjects::Response`
+* `application_id` - returns the value specified in the constructor options
+* `logger` - returns the value specified in the constructor options
+
+The `AlexaSkillsRuby::Handler` constructor takes an options hash and processes the following keys:
+* `application_id` - If set, will raise a `AlexaSkillsRuby::InvalidApplicationId` if a request's application_id does not match
+* `logger` - Will be available through the `logger` method in the handler; not otherwise used by the base class
+
+## Example Sinatra App Using this Library
+
+```ruby
+require 'sinatra'
+require 'alexa_skills_ruby'
+
+class CustomHandler < AlexaSkillsRuby::Handler
+
+  on_intent("GetZodiacHoroscopeIntent") do
+    slots = request.intent.slots
+    response.set_output_speech_text("Horiscope Text")
+    response.set_simple_card("title", "content")
+    logger.info 'GetZodiacHoroscopeIntent processed'
+  end
+
+end
+
+post '/' do
+  content_type :json
+
+  handler = CustomHandler.new(application_id: ENV['APPLICATION_ID'], logger: logger)
+
+  begin
+    handler.handle(request.body.read)
+  rescue AlexaSkillsRuby::InvalidApplicationId => e
+    logger.error e.to_s
+    403
+  end
+
+end
+```

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :test => :spec
+task :default => :spec

data/alexa_skills_ruby.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'alexa_skills_ruby/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "alexa_skills_ruby"
+  spec.version       = AlexaSkillsRuby::VERSION
+  spec.authors       = ["Dan Elbert"]
+  spec.email         = ["dan.elbert@gmail.com"]
+  spec.homepage      = 'https://github.com/DanElbert/alexa_skills_ruby'
+  spec.summary       = %q{Simple library to interface with the Alexa Skills Kit}
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'activesupport', '~> 4.2'
+  spec.add_runtime_dependency "multi_json", "~> 1.0"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", "~> 3.4.0"
+  spec.add_development_dependency "oj", "~> 2.10.2"
+end

data/lib/alexa_skills_ruby.rb

@@ -0,0 +1,27 @@
+require 'active_support/core_ext/class/attribute'
+require 'active_support/callbacks'
+require 'multi_json'
+
+require 'alexa_skills_ruby/version'
+require 'alexa_skills_ruby/json_object'
+require 'alexa_skills_ruby/json_objects/application'
+require 'alexa_skills_ruby/json_objects/user'
+require 'alexa_skills_ruby/json_objects/session'
+require 'alexa_skills_ruby/json_objects/intent'
+require 'alexa_skills_ruby/json_objects/base_request'
+require 'alexa_skills_ruby/json_objects/intent_request'
+require 'alexa_skills_ruby/json_objects/launch_request'
+require 'alexa_skills_ruby/json_objects/session_ended_request'
+require 'alexa_skills_ruby/json_objects/image'
+require 'alexa_skills_ruby/json_objects/card'
+require 'alexa_skills_ruby/json_objects/output_speech'
+require 'alexa_skills_ruby/json_objects/reprompt'
+require 'alexa_skills_ruby/json_objects/response'
+require 'alexa_skills_ruby/json_objects/skills_request'
+require 'alexa_skills_ruby/json_objects/skills_response'
+require 'alexa_skills_ruby/errors'
+require 'alexa_skills_ruby/handler'
+
+module AlexaSkillsRuby
+
+end

data/lib/alexa_skills_ruby/errors.rb

@@ -0,0 +1,4 @@
+module AlexaSkillsRuby
+  class InvalidApplicationId < StandardError
+  end
+end

data/lib/alexa_skills_ruby/handler.rb

@@ -0,0 +1,87 @@
+module AlexaSkillsRuby
+  class Handler
+    include ActiveSupport::Callbacks
+    define_callbacks :authenticate, :session_start, :launch, :intent, :session_end
+
+    attr_reader :request, :session, :response
+    attr_accessor :application_id, :logger
+
+    def initialize(opts = {})
+      if opts[:application_id]
+        @application_id = opts[:application_id]
+      end
+
+      if opts[:logger]
+        @logger = opts[:logger]
+      end
+    end
+
+    def session_attributes
+      @session.attributes ||= {}
+    end
+
+    def handle(request_json)
+      @skill_request = JsonObjects::SkillsRequest.new(MultiJson.load(request_json))
+      @skill_response = JsonObjects::SkillsResponse.new
+
+      @session = @skill_request.session
+      @request = @skill_request.request
+      @response = @skill_response.response
+
+
+      run_callbacks :authenticate do
+        if @application_id
+          if @application_id != session.application.application_id
+            raise InvalidApplicationId, "Invalid: [#{session.application.application_id}]"
+          end
+        end
+      end
+
+      if session.new
+        run_callbacks :session_start
+      end
+
+      case request
+        when JsonObjects::LaunchRequest
+          run_callbacks :launch
+        when JsonObjects::IntentRequest
+          run_callbacks :intent
+        when JsonObjects::SessionEndedRequest
+          run_callbacks :session_end
+      end
+
+      if response.should_end_session
+        @skill_response.session_attributes = {}
+      else
+        @skill_response.session_attributes = session_attributes
+      end
+
+      MultiJson.dump(@skill_response.as_json)
+    end
+
+    def self.on_authenticate(&block)
+      set_callback :authenticate, :before, block
+    end
+
+    def self.on_session_start(&block)
+      set_callback :session_start, :before, block
+    end
+
+    def self.on_launch(&block)
+      set_callback :launch, :before, block
+    end
+
+    def self.on_session_end(&block)
+      set_callback :session_end, :before, block
+    end
+
+    def self.on_intent(intent_name = nil, &block)
+      opts = {}
+      if intent_name
+        opts[:if] = -> { request.intent_name == intent_name }
+      end
+      set_callback :intent, :before, block, opts
+    end
+
+  end
+end

data/lib/alexa_skills_ruby/json_object.rb

@@ -0,0 +1,122 @@
+module AlexaSkillsRuby
+  class JsonObject
+
+    class_attribute :_json_object_properties
+    class_attribute :_properties
+    self._json_object_properties = {}
+    self._properties = []
+
+    def self.json_object_attribute(*args)
+      klass = args.pop
+      raise "Invalid arguments" unless klass && klass.is_a?(Class) && args.length > 0
+
+      args.compact.map { |a| a.to_sym }.each do |a|
+        attr_accessor a
+        self._json_object_properties[a.to_sym] = klass
+      end
+    end
+
+    def self.attribute(*attrs)
+      attrs.compact.map { |a| a.to_sym }.each do |a|
+        attr_accessor a
+        self._properties << a
+      end
+    end
+
+    class << self
+      alias_method :json_object_attributes, :json_object_attribute
+      alias_method :attributes, :attribute
+    end
+
+    # Copy properties on inheritance.
+    def self.inherited(subclass)
+      entities = _json_object_properties.dup
+      attrs = _properties.dup
+      subclass._json_object_properties = entities.each { |k, v| entities[k] = v.dup }
+      subclass._properties = attrs
+      super
+    end
+
+    def initialize(attrs = {})
+      populate_from_json(attrs)
+    end
+
+    def as_json(options = nil)
+      serialize_attributes(_properties + _json_object_properties.keys)
+    end
+
+    def to_json(options = nil)
+      MultiJson.dump(as_json(options))
+    end
+
+    def populate_from_json(attrs)
+      return unless attrs
+
+      attrs.each do |k, v|
+        meth = "#{get_method_name(k)}=".to_sym
+        if self.respond_to? meth
+          if json_object_class = _json_object_properties[k.to_sym]
+            assign_json_object(meth, v, json_object_class)
+          else
+            self.send(meth, v)
+          end
+        end
+      end
+    end
+
+    def serialize_attributes(attrs)
+      json = {}
+      attrs.each do |k|
+        meth = k.to_sym
+        if self.respond_to?(meth)
+          if _json_object_properties[k.to_sym]
+            val = serialize_json_object(meth)
+          else
+            val = self.send(meth)
+          end
+          unless val.nil?
+            json[get_attribute_name(k)] = val
+          end
+        end
+      end
+      json
+    end
+
+    protected
+
+    def assign_json_object(assignment_method, value, klass)
+
+      if value.is_a? Array
+        data = value.map { |v| hydrate_entity(v, klass) }
+      else
+        data = hydrate_entity(value, klass)
+      end
+
+      self.send(assignment_method, data)
+    end
+
+    def hydrate_entity(json, klass)
+      klass.new(json)
+    end
+
+    def get_method_name(attr_name)
+      attr_name.to_s.gsub(/([a-z])([A-Z])([a-z]|^)/) { |m| "#{m[0]}_#{m[1].downcase}#{m[2]}" }
+    end
+
+    def get_attribute_name(meth_name)
+      meth_name.to_s.gsub(/([a-z])(_)([a-z])/) { |m| m[0] + m[2].upcase }
+    end
+
+    def serialize_json_object(method)
+      value = self.send(method)
+      case value
+        when nil
+          nil
+        when Array
+          value.map { |v| v.as_json }
+        else
+          value.as_json
+      end
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/application.rb

@@ -0,0 +1,7 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class Application < JsonObject
+      attributes :application_id
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/base_request.rb

@@ -0,0 +1,40 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class BaseRequest < JsonObject
+      attributes :type, :request_id, :timestamp
+
+      def self.new(*args, &block)
+        json = args.first
+        subclass = case
+                     when self != BaseRequest
+                       nil
+                     when json.nil?
+                        nil
+                      when json['type'] == 'LaunchRequest'
+                        LaunchRequest
+                      when json['type'] == 'IntentRequest'
+                        IntentRequest
+                      when json['type'] == 'SessionEndedRequest'
+                        SessionEndedRequest
+                      else
+                        nil
+                   end
+
+        if subclass
+          subclass.new(*args, &block)
+        else
+          super
+        end
+      end
+
+      def intent_name
+        if self.is_a? IntentRequest
+          self.intent.name
+        else
+          nil
+        end
+      end
+
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/card.rb

@@ -0,0 +1,16 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class Card < JsonObject
+      attributes :type, :title, :content, :text
+      json_object_attributes :image, Image
+
+      def self.simple(title, content)
+        card = new
+        card.type = "Simple"
+        card.title = title
+        card.content = content
+        card
+      end
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/image.rb

@@ -0,0 +1,7 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class Image < JsonObject
+      attributes :small_image_url, :large_image_url
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/intent.rb

@@ -0,0 +1,11 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class Intent < JsonObject
+      attributes :name, :slots
+
+      def slots=(val)
+        @slots = Hash[(val || {}).map { |k, v| [k, v['value']] }]
+      end
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/intent_request.rb

@@ -0,0 +1,7 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class IntentRequest < BaseRequest
+      json_object_attribute :intent, Intent
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/launch_request.rb

@@ -0,0 +1,7 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class LaunchRequest < BaseRequest
+
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/output_speech.rb

@@ -0,0 +1,21 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class OutputSpeech < JsonObject
+      attributes :type, :text, :ssml
+
+      def self.text(text)
+        os = new
+        os.text = text
+        os.type = 'PlainText'
+        os
+      end
+
+      def self.ssml(ssml)
+        os = new
+        os.ssml = ssml
+        os.type = 'SSML'
+        os
+      end
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/reprompt.rb

@@ -0,0 +1,7 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class Reprompt < JsonObject
+      json_object_attributes :output_speech, OutputSpeech
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/response.rb

@@ -0,0 +1,29 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class Response < JsonObject
+      attributes :should_end_session
+      json_object_attribute :output_speech, OutputSpeech
+      json_object_attribute :card, Card
+      json_object_attribute :reprompt, Reprompt
+
+      def initialize
+        self.should_end_session = true
+      end
+
+      def set_output_speech_text(text)
+        self.output_speech = OutputSpeech.text(text)
+      end
+
+      def set_simple_card(title, content)
+        self.card = Card.simple(title, content)
+      end
+
+      def set_reprompt_speech_text(text)
+        os = OutputSpeech.text(text)
+        rp = Reprompt.new
+        rp.output_speech = os
+        self.reprompt = rp
+      end
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/session.rb

@@ -0,0 +1,9 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class Session < JsonObject
+      attributes :new, :session_id, :attributes
+      json_object_attribute :application, Application
+      json_object_attribute :user, User
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/session_ended_request.rb

@@ -0,0 +1,7 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class SessionEndedRequest < BaseRequest
+      attribute :reason
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/skills_request.rb

@@ -0,0 +1,9 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class SkillsRequest < JsonObject
+      attribute :version
+      json_object_attribute :session, Session
+      json_object_attribute :request, BaseRequest
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/skills_response.rb

@@ -0,0 +1,14 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class SkillsResponse < JsonObject
+      attributes :version, :session_attributes
+      json_object_attribute :response, Response
+
+      def initialize
+        self.version = '1.0'
+        self.session_attributes = {}
+        self.response = JsonObjects::Response.new
+      end
+    end
+  end
+end

data/lib/alexa_skills_ruby/json_objects/user.rb

@@ -0,0 +1,7 @@
+module AlexaSkillsRuby
+  module JsonObjects
+    class User < JsonObject
+      attributes :user_id, :access_token
+    end
+  end
+end

data/lib/alexa_skills_ruby/version.rb

@@ -0,0 +1,3 @@
+module AlexaSkillsRuby
+  VERSION = '0.0.5'
+end

data/spec/fixtures/example_intent.json

@@ -0,0 +1,34 @@
+{
+  "version": "1.0",
+  "session": {
+    "new": false,
+    "sessionId": "amzn1.echo-api.session.0000000-0000-0000-0000-00000000000",
+    "application": {
+      "applicationId": "amzn1.echo-sdk-ams.app.000000-d0ed-0000-ad00-000000d00ebe"
+    },
+    "attributes": {
+      "supportedHoroscopePeriods": {
+        "daily": true,
+        "weekly": false,
+        "monthly": false
+      }
+    },
+    "user": {
+      "userId": "amzn1.account.AM3B00000000000000000000000"
+    }
+  },
+  "request": {
+    "type": "IntentRequest",
+    "requestId": "amzn1.echo-api.request.0000000-0000-0000-0000-00000000000",
+    "timestamp": "2015-05-13T12:34:56Z",
+    "intent": {
+      "name": "GetZodiacHoroscopeIntent",
+      "slots": {
+        "ZodiacSign": {
+          "name": "ZodiacSign",
+          "value": "virgo"
+        }
+      }
+    }
+  }
+}

data/spec/fixtures/example_launch.json

@@ -0,0 +1,19 @@
+{
+  "version": "1.0",
+  "session": {
+    "new": true,
+    "sessionId": "amzn1.echo-api.session.0000000-0000-0000-0000-00000000000",
+    "application": {
+      "applicationId": "amzn1.echo-sdk-ams.app.000000-d0ed-0000-ad00-000000d00ebe"
+    },
+    "attributes": {},
+    "user": {
+      "userId": "amzn1.account.AM3B00000000000000000000000"
+    }
+  },
+  "request": {
+    "type": "LaunchRequest",
+    "requestId": "amzn1.echo-api.request.0000000-0000-0000-0000-00000000000",
+    "timestamp": "2015-05-13T12:34:56Z"
+  }
+}

data/spec/fixtures/example_response.json

@@ -0,0 +1,28 @@
+{
+  "version": "1.0",
+  "sessionAttributes": {
+    "supportedHoriscopePeriods": {
+      "daily": true,
+      "weekly": false,
+      "monthly": false
+    }
+  },
+  "response": {
+    "outputSpeech": {
+      "type": "PlainText",
+      "text": "Today will provide you a new learning opportunity.  Stick with it and the possibilities will be endless. Can I help you with anything else?"
+    },
+    "card": {
+      "type": "Simple",
+      "title": "Horoscope",
+      "content": "Today will provide you a new learning opportunity.  Stick with it and the possibilities will be endless."
+    },
+    "reprompt": {
+      "outputSpeech": {
+        "type": "PlainText",
+        "text": "Can I help you with anything else?"
+      }
+    },
+    "shouldEndSession": false
+  }
+}

data/spec/fixtures/example_session_ended.json

@@ -0,0 +1,26 @@
+{
+  "version": "1.0",
+  "session": {
+    "new": false,
+    "sessionId": "amzn1.echo-api.session.0000000-0000-0000-0000-00000000000",
+    "application": {
+      "applicationId": "amzn1.echo-sdk-ams.app.000000-d0ed-0000-ad00-000000d00ebe"
+    },
+    "attributes": {
+      "supportedHoroscopePeriods": {
+        "daily": true,
+        "weekly": false,
+        "monthly": false
+      }
+    },
+    "user": {
+      "userId": "amzn1.account.AM3B00000000000000000000000"
+    }
+  },
+  "request": {
+    "type": "SessionEndedRequest",
+    "requestId": "amzn1.echo-api.request.0000000-0000-0000-0000-00000000000",
+    "timestamp": "2015-05-13T12:34:56Z",
+    "reason": "USER_INITIATED"
+  }
+}

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'oj'
+require 'rspec'
+require File.expand_path('../../lib/alexa_skills_ruby', __FILE__)
+
+MultiJson.use :oj
+
+Dir[File.expand_path('../support/**/*', __FILE__)].each { |f| require f }
+
+RSpec.configure do |config|
+
+  config.include FixtureSupport
+
+end

data/spec/support/fixture_support.rb

@@ -0,0 +1,11 @@
+module FixtureSupport
+
+  def load_json(name)
+    File.read(File.expand_path(File.dirname(__FILE__) + '/../fixtures/' + name))
+  end
+
+  def load_fixture(name)
+    Oj.load(load_json(name))
+  end
+
+end

data/spec/unit/handler_spec.rb

@@ -0,0 +1,142 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe AlexaSkillsRuby::Handler do
+
+  class TestHandler < AlexaSkillsRuby::Handler
+
+    attr_reader :auths, :intents, :launch, :ends, :starts
+
+    def initialize(*args)
+      super
+      @auths = []
+      @intents = []
+      @launch = []
+      @ends = []
+      @starts = []
+    end
+
+    on_session_start do
+      @starts << request
+    end
+
+    on_authenticate do
+      @auths << request
+    end
+
+    on_launch do
+      @launch << request
+    end
+
+    on_intent do
+      @intents << request
+    end
+
+    on_intent('special') do
+      @intents << request
+    end
+
+    on_session_end do
+      @ends << request
+    end
+  end
+
+  let(:handler) { TestHandler.new }
+
+  describe 'with a launch request' do
+    let(:request_json) { load_json 'example_launch.json' }
+
+    it 'fires the handlers' do
+      handler.handle(request_json)
+
+      expect(handler.auths.count).to eq 1
+      expect(handler.intents.count).to eq 0
+      expect(handler.ends.count).to eq 0
+      expect(handler.starts.count).to eq 1
+      expect(handler.launch.count).to eq 1
+    end
+  end
+
+  describe 'with an intent request' do
+    let(:request_json) { load_json 'example_intent.json' }
+
+    it 'fires the handlers' do
+      handler.handle(request_json)
+
+      expect(handler.auths.count).to eq 1
+      expect(handler.intents.count).to eq 1
+      expect(handler.ends.count).to eq 0
+      expect(handler.starts.count).to eq 0
+      expect(handler.launch.count).to eq 0
+    end
+  end
+
+  describe 'with a special intent request' do
+    let(:request_json) do
+      json = load_fixture 'example_intent.json'
+      json['request']['intent']['name'] = 'special'
+      Oj.dump(json)
+    end
+
+    it 'fires the handlers' do
+      handler.handle(request_json)
+
+      expect(handler.auths.count).to eq 1
+      expect(handler.intents.count).to eq 2
+      expect(handler.ends.count).to eq 0
+      expect(handler.starts.count).to eq 0
+      expect(handler.launch.count).to eq 0
+    end
+  end
+
+  describe 'with a session ended request' do
+    let(:request_json) { load_json 'example_session_ended.json' }
+
+    it 'fires the handlers' do
+      handler.handle(request_json)
+
+      expect(handler.auths.count).to eq 1
+      expect(handler.intents.count).to eq 0
+      expect(handler.ends.count).to eq 1
+      expect(handler.starts.count).to eq 0
+      expect(handler.launch.count).to eq 0
+    end
+  end
+
+  describe 'with an application_id set' do
+
+    let(:handler) { TestHandler.new({application_id: 'amzn1.echo-sdk-ams.app.000000-d0ed-0000-ad00-000000d00ebe'}) }
+
+    describe 'with a valid app id in request' do
+      let(:request_json) { load_json 'example_session_ended.json' }
+
+      it 'fires the handlers' do
+        handler.handle(request_json)
+
+        expect(handler.auths.count).to eq 1
+        expect(handler.intents.count).to eq 0
+        expect(handler.ends.count).to eq 1
+        expect(handler.starts.count).to eq 0
+        expect(handler.launch.count).to eq 0
+      end
+    end
+
+    describe 'with an invalid app id in request' do
+      let(:request_json) do
+        json = load_fixture 'example_intent.json'
+        json['session']['application']['applicationId'] = 'broke'
+        Oj.dump(json)
+      end
+
+      it 'fires the handlers' do
+        expect { handler.handle(request_json) }.to raise_error AlexaSkillsRuby::InvalidApplicationId
+
+        expect(handler.auths.count).to eq 1
+        expect(handler.intents.count).to eq 0
+        expect(handler.ends.count).to eq 0
+        expect(handler.starts.count).to eq 0
+        expect(handler.launch.count).to eq 0
+      end
+    end
+  end
+
+end

data/spec/unit/json_object_spec.rb

@@ -0,0 +1,59 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe AlexaSkillsRuby::JsonObject do
+
+  class TestJsonObject < AlexaSkillsRuby::JsonObject
+    attributes :name, :id
+    json_object_attribute :attr1, AlexaSkillsRuby::JsonObjects::User
+  end
+
+  class ChildTestJsonObject < TestJsonObject
+    attribute :another_field
+    json_object_attribute :attr2, AlexaSkillsRuby::JsonObjects::User
+  end
+
+  class OtherTestJsonObject < AlexaSkillsRuby::JsonObject
+    json_object_attribute :attr3, AlexaSkillsRuby::JsonObjects::User
+  end
+
+  describe '.json_object_attribute' do
+
+    it 'should keep separate lists for each type' do
+      expect(TestJsonObject._json_object_properties.keys).to contain_exactly :attr1
+      expect(ChildTestJsonObject._json_object_properties.keys).to contain_exactly :attr1, :attr2
+      expect(OtherTestJsonObject._json_object_properties.keys).to contain_exactly :attr3
+
+      expect(TestJsonObject._properties).to contain_exactly :name, :id
+      expect(ChildTestJsonObject._properties).to contain_exactly :name, :id, :another_field
+      expect(OtherTestJsonObject._properties.length).to eq 0
+    end
+
+  end
+
+  describe 'serialization' do
+
+    it 'serializes entities' do
+      json_object = TestJsonObject.new
+      json_object.attr1 = AlexaSkillsRuby::JsonObjects::User.new
+      json_object.attr1.user_id = 5
+      json_object.attr1.access_token = 'token'
+      json_object.name = 'name'
+      json_object.id = 1
+
+      json = json_object.as_json
+      expect(json).to eq({ 'attr1' => { 'userId' => 5, 'accessToken' => 'token'}, 'name' => 'name', 'id' => 1 })
+    end
+
+  end
+
+  describe 'deserialization' do
+    it 'populates the objects' do
+      json = { attr1: { id: 5, access_token: 'token'}, name: 'name', id: 1 }
+      json_object = TestJsonObject.new(json)
+      expect(json_object.name).to eq 'name'
+      expect(json_object.attr1).to be_a AlexaSkillsRuby::JsonObjects::User
+      expect(json_object.attr1.access_token).to eq 'token'
+    end
+  end
+
+end

data/spec/unit/json_objects/skills_request_spec.rb

@@ -0,0 +1,56 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe AlexaSkillsRuby::JsonObjects::SkillsRequest do
+
+  let(:launch_request_json) do
+    load_fixture 'example_launch.json'
+  end
+
+  let(:intent_request_json) do
+    load_fixture 'example_intent.json'
+  end
+
+  let(:session_ended_request_json) do
+    load_fixture 'example_session_ended.json'
+  end
+
+  it 'constructs a launch request' do
+    r = AlexaSkillsRuby::JsonObjects::SkillsRequest.new(launch_request_json)
+    expect(r).not_to be_nil
+    expect(r.version).to eq '1.0'
+    expect(r.session).to be_a AlexaSkillsRuby::JsonObjects::Session
+    expect(r.session.new).to eq true
+    expect(r.session.session_id).to eq 'amzn1.echo-api.session.0000000-0000-0000-0000-00000000000'
+    expect(r.session.application).to be_a AlexaSkillsRuby::JsonObjects::Application
+    expect(r.session.application.application_id).to eq 'amzn1.echo-sdk-ams.app.000000-d0ed-0000-ad00-000000d00ebe'
+    expect(r.session.attributes).to eq({})
+    expect(r.session.user).to be_a AlexaSkillsRuby::JsonObjects::User
+    expect(r.session.user.user_id).to eq 'amzn1.account.AM3B00000000000000000000000'
+    expect(r.request).to be_a AlexaSkillsRuby::JsonObjects::LaunchRequest
+    expect(r.request.type).to eq 'LaunchRequest'
+    expect(r.request.request_id).to eq 'amzn1.echo-api.request.0000000-0000-0000-0000-00000000000'
+    expect(r.request.timestamp).to eq '2015-05-13T12:34:56Z'
+  end
+
+  it 'constructs an intent request' do
+    r = AlexaSkillsRuby::JsonObjects::SkillsRequest.new(intent_request_json)
+    expect(r.request).to be_a AlexaSkillsRuby::JsonObjects::IntentRequest
+    expect(r.request.type).to eq 'IntentRequest'
+    expect(r.request.request_id).to eq 'amzn1.echo-api.request.0000000-0000-0000-0000-00000000000'
+    expect(r.request.timestamp).to eq '2015-05-13T12:34:56Z'
+    expect(r.request.intent).to be_a AlexaSkillsRuby::JsonObjects::Intent
+    expect(r.request.intent.name).to eq 'GetZodiacHoroscopeIntent'
+    expect(r.request.intent.slots).to be_a Hash
+    expect(r.request.intent.slots['ZodiacSign']).to eq('virgo')
+  end
+
+  it 'constructs a session ended request' do
+    r = AlexaSkillsRuby::JsonObjects::SkillsRequest.new(session_ended_request_json)
+    expect(r.request).to be_a AlexaSkillsRuby::JsonObjects::SessionEndedRequest
+    expect(r.request.type).to eq 'SessionEndedRequest'
+    expect(r.request.request_id).to eq 'amzn1.echo-api.request.0000000-0000-0000-0000-00000000000'
+    expect(r.request.timestamp).to eq '2015-05-13T12:34:56Z'
+    expect(r.request.reason).to eq 'USER_INITIATED'
+  end
+
+end

data/spec/unit/json_objects/skills_response_spec.rb

@@ -0,0 +1,48 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe AlexaSkillsRuby::JsonObjects::SkillsResponse do
+
+  let(:response_json) do
+    {
+      'version' => "1.0",
+      'sessionAttributes' => {
+        'supportedHoriscopePeriods' => {
+          'daily' => true,
+          'weekly' => false,
+          'monthly' => false
+        }
+      },
+      'response' => {
+        'outputSpeech' => {
+          'type' => "PlainText",
+          'text' => "Today will provide you a new learning opportunity.  Stick with it and the possibilities will be endless. Can I help you with anything else?"
+        },
+        'card' => {
+          'type' => "Simple",
+          'title' => "Horoscope",
+          'content' => "Today will provide you a new learning opportunity.  Stick with it and the possibilities will be endless."
+        },
+        'reprompt' => {
+          'outputSpeech' => {
+            'type' => "PlainText",
+            'text' => "Can I help you with anything else?"
+          }
+        },
+        'shouldEndSession' => false
+      }
+    }
+  end
+
+  it 'generates example json' do
+    sr = AlexaSkillsRuby::JsonObjects::SkillsResponse.new
+    r = sr.response
+    sr.session_attributes = {'supportedHoriscopePeriods' => {'daily' => true, 'weekly' => false, 'monthly' => false}}
+    r.set_output_speech_text("Today will provide you a new learning opportunity.  Stick with it and the possibilities will be endless. Can I help you with anything else?")
+    r.set_simple_card('Horoscope', 'Today will provide you a new learning opportunity.  Stick with it and the possibilities will be endless.')
+    r.set_reprompt_speech_text('Can I help you with anything else?')
+    r.should_end_session = false
+
+    expect(sr.as_json).to eq response_json
+  end
+
+end

metadata

@@ -0,0 +1,173 @@
+--- !ruby/object:Gem::Specification
+name: alexa_skills_ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+platform: ruby
+authors:
+- Dan Elbert
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.2
+description: 
+email:
+- dan.elbert@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- alexa_skills_ruby.gemspec
+- lib/alexa_skills_ruby.rb
+- lib/alexa_skills_ruby/errors.rb
+- lib/alexa_skills_ruby/handler.rb
+- lib/alexa_skills_ruby/json_object.rb
+- lib/alexa_skills_ruby/json_objects/application.rb
+- lib/alexa_skills_ruby/json_objects/base_request.rb
+- lib/alexa_skills_ruby/json_objects/card.rb
+- lib/alexa_skills_ruby/json_objects/image.rb
+- lib/alexa_skills_ruby/json_objects/intent.rb
+- lib/alexa_skills_ruby/json_objects/intent_request.rb
+- lib/alexa_skills_ruby/json_objects/launch_request.rb
+- lib/alexa_skills_ruby/json_objects/output_speech.rb
+- lib/alexa_skills_ruby/json_objects/reprompt.rb
+- lib/alexa_skills_ruby/json_objects/response.rb
+- lib/alexa_skills_ruby/json_objects/session.rb
+- lib/alexa_skills_ruby/json_objects/session_ended_request.rb
+- lib/alexa_skills_ruby/json_objects/skills_request.rb
+- lib/alexa_skills_ruby/json_objects/skills_response.rb
+- lib/alexa_skills_ruby/json_objects/user.rb
+- lib/alexa_skills_ruby/version.rb
+- spec/fixtures/example_intent.json
+- spec/fixtures/example_launch.json
+- spec/fixtures/example_response.json
+- spec/fixtures/example_session_ended.json
+- spec/spec_helper.rb
+- spec/support/fixture_support.rb
+- spec/unit/handler_spec.rb
+- spec/unit/json_object_spec.rb
+- spec/unit/json_objects/skills_request_spec.rb
+- spec/unit/json_objects/skills_response_spec.rb
+homepage: https://github.com/DanElbert/alexa_skills_ruby
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Simple library to interface with the Alexa Skills Kit
+test_files:
+- spec/fixtures/example_intent.json
+- spec/fixtures/example_launch.json
+- spec/fixtures/example_response.json
+- spec/fixtures/example_session_ended.json
+- spec/spec_helper.rb
+- spec/support/fixture_support.rb
+- spec/unit/handler_spec.rb
+- spec/unit/json_object_spec.rb
+- spec/unit/json_objects/skills_request_spec.rb
+- spec/unit/json_objects/skills_response_spec.rb