eipiai 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 877a72bd72e8b2b172a6f1d5e534c938b12dc675
+  data.tar.gz: 3b11eae2304fa9a61a2ccb45e78eb0c2a1be17ff
+SHA512:
+  metadata.gz: ea7009b9c493cb4e757c5ee6f3a19a0db3ead47df7c5dcd555acf73e01565e97469529a596f031924331821029241d3ccbab328092b0caade6cb7d5c7b896f75
+  data.tar.gz: 5a1a3e46d6ed34468c386d1388315a9d2d2235563bbfa1c9b0e00906d97958b7cfa87ef5aecffaec29f8647723bac4e234d8046a637737d0baab520319d37975

data/.gitignore

@@ -0,0 +1,10 @@
+_builds
+_cache
+_projects
+_steps
+.bundle
+.yardoc
+*.gem
+doc/
+Gemfile*.lock
+pkg/*

data/.rubocop.yml

@@ -0,0 +1,5 @@
+Metrics/LineLength:
+  Max: 100
+
+Style/AlignParameters:
+  EnforcedStyle: with_fixed_indentation

data/.wercker.yml

@@ -0,0 +1,12 @@
+box: ruby
+
+build:
+  steps:
+  - bundle-install:
+    jobs: "8"
+  - script:
+    name: bootstrap
+    code: script/bootstrap
+  - script:
+    name: tests
+    code: script/test

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/README.md

@@ -0,0 +1,84 @@
+# `/ˌeɪ.piˈaɪ/` – The JSON API Framework
+
+Opinionated JSON-API stack to get the job done.
+
+This library brings some of the _best_\* Ruby JSON API libraries together,
+provides the glue to make things easy to work with out-of-the-box, and even
+easier to modify to your own liking.
+
+\* _in our humble opinion_
+
+## Usage
+
+More detailed installation instructions will follow. But for now, here's an
+example:
+
+```ruby
+gem 'eipiai'
+gem 'roar'
+gem 'sequel'
+gem 'sqlite3'
+```
+
+```sh
+bundle install
+```
+
+```ruby
+require 'eipiai'
+require 'roar/decorator'
+require 'roar/json/hal'
+require 'sequel'
+require 'sqlite3'
+
+DB = Sequel.sqlite
+DB.create_table(:items) do
+  primary_key :id
+  String :uid
+end
+
+class Item < Sequel::Model
+end
+
+class ItemRepresenter < Roar::Decorator
+  include Roar::JSON::HAL
+  property :uid
+
+  def path
+    "/item/#{represented.uid}"
+  end
+end
+
+class ItemsRepresenter < Roar::Decorator
+  include Roar::JSON::HAL
+  collection :items, getter: proc { Item.all }, decorator: ItemRepresenter
+
+  def path
+    '/items'
+  end
+end
+
+class ItemResource < Webmachine::Resource
+  include Eipiai::Resource
+end
+
+class ItemsResource < Webmachine::Resource
+  include Eipiai::Resource
+end
+
+App = Webmachine::Application.new do |app|
+  app.routes do
+    add ['items'], ItemsResource
+    add ['item', :item_uid], ItemResource
+  end
+end
+
+App.run
+```
+
+```sh
+bundle exec ruby app.rb &
+curl -XPOST -d'{"uid":"awesome"}' -HContent-Type:application/json localhost:8080/items
+curl localhost:8080/item/awesome
+# {"uid":"awesome"}
+```

data/Rakefile

@@ -0,0 +1,37 @@
+require 'bundler/gem_tasks'
+require 'cucumber/rake/task'
+require 'rubocop/rake_task'
+require 'yard-doctest'
+
+task default: %w(rubocop features yard:doctest)
+
+RuboCop::RakeTask.new
+
+desc 'Update CHANGELOG.md'
+task 'changelog' do
+  args = %w(
+    --user=blendle
+    --project=eipiai
+    --header-label="# CHANGELOG"
+    --bug-labels=type/bug,bug
+    --enhancement-labels=type/enhancement,enhancement
+    --future-release=unreleased
+    --no-verbose
+  )
+
+  sh %(github_changelog_generator #{args.join(' ')})
+end
+
+YARD::Doctest::RakeTask.new do |task|
+  task.doctest_opts = %w(--pride)
+end
+
+YARD::Rake::YardocTask.new do |task|
+  task.files = %w(lib/**/*.rb)
+  task.options = %w(--markup markdown --readme README.md)
+end
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = 'features --format pretty --tags ~@wip --no-source ' \
+                    '--color --strict --expand --order random'
+end

data/eipiai.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'eipiai/version'
+
+Gem::Specification.new do |spec|
+  spec.name     = 'eipiai'
+  spec.version  = Eipiai::VERSION
+  spec.authors  = ['Jean Mertz']
+  spec.email    = %w(jean@mertz.fm)
+  spec.summary  = 'Opinionated JSON-API stack to get the job done.'
+  spec.homepage = 'https://github.com/blendle/eipiai'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(support)/}) }
+  spec.bindir        = 'bin'
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = %w(lib)
+
+  spec.add_runtime_dependency 'activesupport'
+  spec.add_runtime_dependency 'addressable'
+  spec.add_runtime_dependency 'roar'
+  spec.add_runtime_dependency 'webmachine'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'cucumber'
+  spec.add_development_dependency 'cucumber-blendle-steps'
+  spec.add_development_dependency 'database_cleaner'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'rack-test'
+  spec.add_development_dependency 'rack'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'sqlite3'
+  spec.add_development_dependency 'yard-doctest'
+end

data/features/support/app.rb

@@ -0,0 +1,27 @@
+lib = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'eipiai'
+require 'webmachine/adapters/rack'
+require_relative '../../support/fixtures/webmachine/app'
+
+include Eipiai::Webmachine::TestApp
+
+App = Webmachine::Application.new do |app|
+  app.routes do
+    add ['api'], Eipiai::ApiResource
+
+    add ['items'], ItemsResource
+    add ['item', :item_uid], ItemResource
+  end
+
+  app.configure do |config|
+    config.adapter = :Rack
+  end
+
+  Eipiai::ApiRepresenter.populate_from_app(app)
+end
+
+def app
+  App.adapter
+end

data/features/support/db.rb

@@ -0,0 +1,8 @@
+require 'database_cleaner'
+require 'database_cleaner/cucumber'
+
+DatabaseCleaner.clean_with(:truncation)
+DatabaseCleaner.strategy = :transaction
+
+Before { DatabaseCleaner.start }
+After { DatabaseCleaner.clean }

data/features/support/env.rb

@@ -0,0 +1,6 @@
+require 'cucumber/blendle_steps'
+
+Before do
+  env('HTTPS', 'on')
+  env('SERVER_PORT', '443')
+end

data/features/webmachine.feature

@@ -0,0 +1,134 @@
+Feature: Webmachine CRUD operations
+
+  When a new JSON API service needs to be developed
+  I want to use Eipiai's default CRUD setup
+  So that the basic API operations are quick and easyi to implement
+
+  Scenario: List main API endpoint
+    When the client does a GET request to "/api"
+    Then the status code should be "200" (OK)
+    And the response should be HAL/JSON:
+      """json
+      {
+        "_links": {
+          "self": {
+            "href": "https://example.org/api"
+          },
+          "api": {
+            "href": "https://example.org/api"
+          },
+          "items": {
+            "href": "https://example.org/items"
+          },
+          "item": {
+            "templated": true,
+            "href": "https://example.org/item/{item_uid}"
+          }
+        }
+      }
+      """
+
+  Scenario: Create resource
+    Given the client provides the header "Content-Type: application/json"
+    When the client does a POST request to the "items" resource with the following content:
+      """json
+      {
+        "uid": "hello",
+        "price": 10
+      }
+      """
+    Then the status code should be "201" (Created)
+    And the response contains the "Location" header with value "https://example.org/item/hello"
+    And the response should be HAL/JSON:
+      """json
+      {
+        "_links": {
+          "self": {
+            "href": "https://example.org/item/hello"
+          }
+        },
+        "uid": "hello",
+        "price": 10
+      }
+      """
+
+  Scenario: Get resource
+    Given the item with uid "hello" and the price "10" exists
+    When the client does a GET request to the "item" resource with the template variable "item_uid" set to "hello"
+    Then the status code should be "200" (OK)
+    And the response should be HAL/JSON:
+      """json
+      {
+        "_links": {
+          "self": {
+            "href": "https://example.org/item/hello"
+          }
+        },
+        "uid": "hello",
+        "price": 10
+      }
+      """
+
+  Scenario: Update resource
+    Given the item with uid "hello" and the price "10" exists
+    Given the client provides the header "Content-Type: application/json"
+    When the client does a PUT request to the "item" resource with the template variable "item_uid" set to "hello" and the following content:
+      """json
+      {
+        "price": 100
+      }
+      """
+    Then the status code should be "204" (No Content)
+    And the response contains the "Location" header with value "https://example.org/item/hello"
+
+    When the client does a GET request to the "item" resource with the template variable "item_uid" set to "hello"
+    Then the status code should be "200" (OK)
+    And the response should be HAL/JSON:
+      """json
+      {
+        "_links": {
+          "self": {
+            "href": "https://example.org/item/hello"
+          }
+        },
+        "uid": "hello",
+        "price": 100
+      }
+      """
+
+  Scenario: List resources
+    Given the item with uid "hello" and the price "10" exists
+    When the client does a GET request to the "items" resource
+    Then the status code should be "200" (OK)
+    And the response should be HAL/JSON:
+      """json
+      {
+        "_links": {
+          "self": {
+            "href": "https://example.org/items"
+          },
+          "b:items": [
+            {
+              "href": "https://example.org/item/hello"
+            }
+          ]
+        },
+        "b:items": [
+          {
+            "_links": {
+              "self": {
+                "href": "https://example.org/item/hello"
+              }
+            },
+            "uid": "hello",
+            "price": 10
+          }
+        ]
+      }
+      """
+
+  Scenario: Delete resource
+    Given the item with uid "hello" exists
+    When the client does a DELETE request to the "item" resource with the template variable "item_uid" set to "hello"
+    Then the status code should be "204" (No Content)
+    And the item with uid "hello" should not exist

data/lib/eipiai/roar/representers/api.rb

@@ -0,0 +1,44 @@
+require 'addressable/uri'
+require 'roar'
+require 'roar/decorator'
+require 'roar/json/hal'
+
+module Eipiai
+  # ApiRepresenter
+  #
+  # This representer returns an object that represents the `/api` endpoint of
+  # the API. It contains all routes as defined in the Webmachine route, and also
+  # tells the client if the route is templated or not.
+  #
+  class ApiRepresenter < Roar::Decorator
+    include Roar::JSON::HAL
+
+    link(:self) do |request|
+      request.present? ? Addressable::URI.parse(request.uri).merge(path: path).to_s : path
+    end
+
+    def self.populate_from_app(app)
+      app.routes.each do |route|
+        next unless route.resource.respond_to?(:link_identifier)
+
+        templated = route.path_spec.any? { |r| r.is_a?(Symbol) }
+        options = { rel: route.resource.link_identifier }
+        options.merge!(templated: templated) if templated
+
+        add_route(route, options)
+      end
+    end
+
+    def self.add_route(route, options)
+      link(options) do |request|
+        path = '/' + route.path_spec.map { |e| e.is_a?(Symbol) ? "{#{e}}" : e }.join('/')
+
+        request.present? ? Addressable::URI.parse(request.uri).merge(path: path).to_s : path
+      end
+    end
+
+    def path
+      '/api'
+    end
+  end
+end

data/lib/eipiai/roar.rb

@@ -0,0 +1,3 @@
+require 'roar'
+
+require 'eipiai/roar/representers/api'

data/lib/eipiai/version.rb

@@ -0,0 +1,7 @@
+# Eipiai
+#
+# The current version of the Eipiai library.
+#
+module Eipiai
+  VERSION = '0.1.0'
+end

data/lib/eipiai/webmachine/ext/decision.rb

@@ -0,0 +1,66 @@
+require 'webmachine'
+
+module Webmachine
+  class Resource
+    # Callbacks
+    #
+    # @see http://git.io/v3vYg
+    #
+    module Callbacks
+      # unprocessable_entity?
+      #
+      # If the request is semantically correct, but unprocessable due to invalid
+      # data, this should return true, which will result in a '422 Unprocessable
+      # Entity' response.
+      #
+      # Defaults to false.
+      #
+      # @return [true, false] whether the request is unprocessable
+      #
+      def unprocessable_entity?
+        false
+      end
+
+      # payment_required?
+      #
+      # If payment is required this will result in a '402 Payment Required'
+      # response.
+      #
+      # Defaults to false
+      #
+      # @return [true, false] whether the request requires a payment
+      #
+      def payment_required?
+        false
+      end
+    end
+  end
+
+  module Decision
+    # Flow
+    #
+    # @see http://git.io/v3vYP
+    #
+    module Flow
+      # Malformed?
+      def b9b
+        decision_test(resource.malformed_request?, 400, :b9c)
+      end
+
+      # Unprocessable Entity?
+      def b9c
+        decision_test(resource.unprocessable_entity?, 422, :b8)
+      end
+
+      # Forbidden?
+      def b7
+        decision_test(resource.forbidden?, 403, :b7a)
+      end
+
+      # Payment Required?
+      def b7a
+        decision_test(resource.payment_required?, 402, :b6)
+      end
+    end
+  end
+end

data/lib/eipiai/webmachine/ext/request.rb

@@ -0,0 +1,37 @@
+require 'addressable/uri'
+require 'webmachine'
+
+module Webmachine
+  # Request
+  #
+  # @see http://git.io/vWZFi
+  #
+  class Request
+    # URIReplacement
+    #
+    # Swaps `Webmachine::Request#uri` from `URI` to `Addressable::URI`.
+    #
+    module URIReplacement
+      # build_uri
+      #
+      # Given an uri object, and headers, calls  `Webmachine::Request#build_uri`
+      # and parses the result using Addressable (if available), or simply
+      # returns the result as-is.
+      #
+      # @example
+      #   get('/items').build_uri(URI('http://example.org'), {}).class # => Addressable::URI
+      #
+      # @param [URI] uri object
+      # @param [hash] headers
+      #
+      # @return [Addressable::URI, URI]
+      #   Addressable object, or URI if the addressable object is not loaded
+      #
+      def build_uri(uri, headers)
+        defined?(Addressable) ? Addressable::URI.parse(super) : super
+      end
+    end
+
+    prepend URIReplacement
+  end
+end

data/lib/eipiai/webmachine/resources/api.rb

@@ -0,0 +1,31 @@
+require 'eipiai/webmachine/resources/base'
+
+require 'active_support/core_ext/string/inflections'
+require 'json'
+
+module Eipiai
+  class Api
+  end
+
+  # ApiResource
+  #
+  # The base resource which can be included in regular Webmachine::Resource
+  # objects. It provides sensible defaults for a full-features REST API
+  # endpoint.
+  #
+  class ApiResource < Webmachine::Resource
+    include Resource
+
+    def allowed_methods
+      %w(GET)
+    end
+
+    def cache_header
+      'public, max-age=600, s-maxage=86400'
+    end
+
+    def object
+      Api.new
+    end
+  end
+end

data/lib/eipiai/webmachine/resources/base.rb

@@ -0,0 +1,196 @@
+require 'eipiai/webmachine/resources/singular'
+require 'eipiai/webmachine/resources/collection'
+
+require 'active_support/core_ext/string/inflections'
+require 'json'
+
+module Eipiai
+  # Resource
+  #
+  # The base resource which can be included in regular Webmachine::Resource
+  # objects. It provides sensible defaults for a full-features REST API
+  # endpoint.
+  #
+  module Resource
+    # Includes the correct resource into the class, depending on its name.
+    #
+    # If the resource is called `ItemResource`, the `Item` part is considered
+    # singular, and thus the `SingularResource` is included into the class.
+    #
+    def self.included(base)
+      subject_class_name = base.name.demodulize.chomp('Resource')
+
+      if subject_class_name == subject_class_name.singularize
+        base.send(:include, SingularResource)
+      else
+        base.send(:include, CollectionResource)
+      end
+
+      base.extend(ClassMethods)
+    end
+
+    def content_types_provided
+      [['application/hal+json', :to_json]]
+    end
+
+    def content_types_accepted
+      [['application/json', :from_json]]
+    end
+
+    # new_object
+    #
+    # Return the instantiated object, based on the representer provided by
+    # `singular_representer_class` and the parameters provided by `params`.
+    #
+    # See `Object#new_object` for the version without using representers.
+    #
+    # @example
+    #   resource.new_object.class # => Item
+    #
+    # @return [Class, nil] instantiated representer, or nil if not found
+    #
+    def new_object
+      return if singular_representer_class.nil? || object_class.nil?
+
+      @new_object ||= singular_representer_class.new(object_class.new).from_hash(params)
+    end
+
+    # params
+    #
+    # Returns a Hash object, representing the JSOM payload sent in the request
+    # object. Returns an empty hash if request body contains invalid JSON.
+    #
+    # @example Parse valid JSON request
+    #   resource.send :params, ('{ "hello": "world" }') # => { 'hello' => 'world' }
+    #
+    # @example Parse invalid JSON request
+    #   resource.send :params, 'invalid' #=> {}
+    #
+    # @param [String] body JSON provided as a string
+    # @return [Hash] JSON string, converted to a hash
+    #
+    def params(body = request.body.to_s)
+      @params ||= JSON.parse(body)
+    rescue JSON::ParserError
+      {}
+    end
+
+    # to_hash
+    #
+    # Given an object, calls `#to_hash` on that object,
+    #
+    # If the object's `to_hash` implementation accepts any arguments, the
+    # `request` object is sent as its first argument.
+    #
+    # In practice, this method is used without any parameters, causing the
+    # method to call `represented`, which represents a Roar representer. This in
+    # turn converts the represented object to a HAL/JSON compatible hash
+    # representation.
+    #
+    # @example
+    #   item = Item.new(uid: 'hello')
+    #   resource.to_hash(item) # => { uid: 'hello' }
+    #
+    # @param [Object] o = represented to call #to_hash on
+    # @return [Hash] hash representation of the object
+    #
+    def to_hash(o = represented)
+      o.method(:to_hash).arity.zero? ? o.to_hash : o.to_hash(request)
+    end
+
+    def to_json
+      to_hash.to_json
+    end
+
+    private
+
+    # object_class_name
+    #
+    # String representation of the "object class", based on the current
+    # resource name.
+    #
+    # If the resource is called `ItemsResource`, object_class_name will be
+    # `Item`. It is expected that this name represents the class of the object
+    # the resource provides access to through the API.
+    #
+    # @example
+    #   resource.send :object_class_name # => 'Item'
+    #
+    # @return [String] name of object class
+    #
+    def object_class_name
+      self.class.name.chomp('Resource').demodulize.singularize
+    end
+
+    # object_class
+    #
+    # Same as `object_class_name`, except this method will return a constant
+    # _and_ keeps the namespace intact.
+    #
+    # Returns `nil` if constant does not exist.
+    #
+    # @example
+    #   resource.send :object_class # => Item
+    #
+    # @return [Class, nil] object class, or nil if not found
+    #
+    def object_class
+      self.class.name.chomp('Resource').singularize.constantize
+    rescue NameError
+      nil
+    end
+
+    # singular_representer_class
+    #
+    # Constant, representing the representer belonging to the defined
+    # `object`.
+    #
+    # If the resource is called `ItemResource`, the representer will be
+    # `ItemRepresenter`.
+    #
+    # Returns `nil` if constant does not exist.
+    #
+    # @example
+    #   resource.send :singular_representer_class # => ItemRepresenter
+    #
+    # @return [Class, nil] representer class, or nil if not found
+    #
+    def singular_representer_class
+      "#{object_class}Representer".constantize
+    rescue NameError
+      nil
+    end
+
+    # collection_representer_class
+    #
+    # Constant, representing the representer belonging to the defined
+    # collection of `object`s.
+    #
+    # If the resource is called `ItemResource`, the representer will be
+    # `ItemsRepresenter`.
+    #
+    # Returns `nil` if constant does not exist.
+    #
+    # @example
+    #   resource.send :collection_representer_class # => ItemsRepresenter
+    #
+    # @return [Class, nil] representer class, or nil if not found
+    #
+    def collection_representer_class
+      "#{object_class.to_s.pluralize}Representer".constantize
+    rescue NameError
+      nil
+    end
+
+    # ClassMethods
+    #
+    # These methods will be defined on the class in which this module is
+    # included.
+    #
+    module ClassMethods
+      def link_identifier
+        name.chomp('Resource').demodulize.underscore.to_sym
+      end
+    end
+  end
+end

data/lib/eipiai/webmachine/resources/collection.rb

@@ -0,0 +1,62 @@
+require 'eipiai/webmachine/resources/base'
+
+module Eipiai
+  # CollectionResource
+  #
+  # The collection resource is the basis for a resource representing a
+  # collection of objects.
+  #
+  # It provides basic GET and POST support.
+  #
+  # It is the collection version of the `SingularResource` resource.
+  #
+  module CollectionResource
+    def allowed_methods
+      %w(GET POST)
+    end
+
+    # TODO(JeanMertz): enable when validators are implemented.
+    #
+    # def unprocessable_entity?
+    #   super && json_error_body(*new_object.errors)
+    # end
+
+    def post_is_create?
+      true
+    end
+
+    def create_path
+      singular_representer_class.new(new_object).path
+    end
+
+    def from_json
+      new_object.save && handle_post_response
+    end
+
+    private
+
+    def content_type_handler
+      content_type = response.headers[::Webmachine::CONTENT_TYPE]
+      media_type   = ::Webmachine::MediaType.parse(content_type)
+
+      content_types_provided.find { |ct, _| media_type.type_matches?(ct) }.last
+    end
+
+    def handle_post_response
+      response.body = send(content_type_handler)
+      true
+    end
+
+    def object
+      @object ||= Struct.new(:dataset).new(object_class.dataset) if object_class
+    end
+
+    def representer_class
+      request.get? ? collection_representer_class : singular_representer_class
+    end
+
+    def represented
+      representer_class.new(request.get? ? object : new_object)
+    end
+  end
+end

data/lib/eipiai/webmachine/resources/singular.rb

@@ -0,0 +1,66 @@
+require 'eipiai/webmachine/resources/base'
+
+require 'active_support/core_ext/object/blank'
+require 'active_support/core_ext/string/inflections'
+require 'json'
+
+module Eipiai
+  # SingularResource
+  #
+  # The singular resource is the basis for a resource representing a single
+  # object.
+  #
+  # It provides basic GET, PUT and DELETE support.
+  #
+  # It is the singular version of the `CollectionResource` resource.
+  #
+  module SingularResource
+    def allowed_methods
+      %w(GET PUT DELETE)
+    end
+
+    # TODO(JeanMertz): enable when validators are implemented.
+    #
+    # def unprocessable_entity?
+    #   return unless super
+    #   return if request.put? && new_object.errors.include?(:resource_exists)
+    #
+    #   json_error_body(*new_object.errors)
+    # end
+
+    def resource_exists?
+      object.present?
+    end
+
+    def delete_resource
+      object.destroy
+      true
+    end
+
+    def from_json
+      delete_resource if (exists = object.present?)
+      new_object.save
+
+      response.headers['Location'] = request.uri.to_s
+      exists ? 204 : 201
+    end
+
+    private
+
+    def params
+      @merged_params ||= super.merge('uid' => object_uid)
+    end
+
+    def represented
+      singular_representer_class.new(object)
+    end
+
+    def object
+      @object ||= object_class.first(uid: object_uid) if object_class
+    end
+
+    def object_uid
+      request.path_info[:"#{object_class_name.downcase}_uid"]
+    end
+  end
+end

data/lib/eipiai/webmachine.rb

@@ -0,0 +1,9 @@
+require 'webmachine'
+
+require 'eipiai/webmachine/ext/decision'
+require 'eipiai/webmachine/ext/request'
+
+require 'eipiai/webmachine/resources/api'
+require 'eipiai/webmachine/resources/base'
+require 'eipiai/webmachine/resources/collection'
+require 'eipiai/webmachine/resources/singular'

data/lib/eipiai.rb

@@ -0,0 +1,2 @@
+require 'eipiai/roar'
+require 'eipiai/webmachine'

data/script/bootstrap

@@ -0,0 +1,5 @@
+#!/bin/sh
+
+bundle check || bundle install
+bundle exec yard config load_plugins true
+bundle exec yard config -a autoload_plugins yard-doctest

data/script/documentation

@@ -0,0 +1,4 @@
+#!/bin/sh
+
+bundle exec rake yard
+open doc/index.html

data/script/test

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+bundle exec rake

metadata

@@ -0,0 +1,280 @@
+--- !ruby/object:Gem::Specification
+name: eipiai
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jean Mertz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: roar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '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: cucumber
+  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: cucumber-blendle-steps
+  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: database_cleaner
+  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: pry
+  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: rack-test
+  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: rack
+  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: rubocop
+  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: sqlite3
+  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: yard-doctest
+  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'
+description: 
+email:
+- jean@mertz.fm
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".hubbit.yml"
+- ".rubocop.yml"
+- ".wercker.yml"
+- Gemfile
+- README.md
+- Rakefile
+- eipiai.gemspec
+- features/support/app.rb
+- features/support/db.rb
+- features/support/env.rb
+- features/webmachine.feature
+- lib/eipiai.rb
+- lib/eipiai/roar.rb
+- lib/eipiai/roar/representers/api.rb
+- lib/eipiai/version.rb
+- lib/eipiai/webmachine.rb
+- lib/eipiai/webmachine/ext/decision.rb
+- lib/eipiai/webmachine/ext/request.rb
+- lib/eipiai/webmachine/resources/api.rb
+- lib/eipiai/webmachine/resources/base.rb
+- lib/eipiai/webmachine/resources/collection.rb
+- lib/eipiai/webmachine/resources/singular.rb
+- script/bootstrap
+- script/documentation
+- script/test
+homepage: https://github.com/blendle/eipiai
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Opinionated JSON-API stack to get the job done.
+test_files: []
+has_rdoc: