datmachine 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5f9877e5465d31b48b8255af5d4d9bc72ef5fd8f
+  data.tar.gz: db1372df41dac0720874f24ed636c14af37dfab3
+SHA512:
+  metadata.gz: 3db6b97ac3164ff78742a172bc03725740b67e85e917b225194825e0716f1b813dedf8914632849956e6691e498217195a68a93a341637341e7cf006cc9219b5
+  data.tar.gz: bdca6cc1f10de491dc2112695dea9e7ff09f619df12a7a2857d9304e12b24075c771ffaf803704ef47d49dcdb33bc16f4612b1a17523cae3993a76e39d3a76e4

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in datmachine.gemspec
+gemspec
+
+gem "faraday"
+gem "faraday_middleware"
+gem "addressable"
+gem "json"

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 efremov
+
+MIT License
+
+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,29 @@
+# Datmachine
+
+Easy to use business intelligence solution specifically designed to improve the performance of Internet companies.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'datmachine'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install datmachine
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/datmachine.gemspec

@@ -0,0 +1,28 @@
+#!/usr/bin/env gem build
+# coding: utf-8
+
+require "base64"
+require File.expand_path('../lib/datmachine/version', __FILE__)
+
+Gem::Specification.new do |spec|
+  spec.name          = "datmachine"
+  spec.version       = Datmachine::VERSION
+  spec.authors       = ["efremov"]
+  spec.email         = ["efremov@datmachine.co"]
+  spec.description   = %q{Datmachine is a business intelligence solution for Internet companies.}
+  spec.summary       = %q{https://datmachine.co/guides}
+  spec.homepage      = "https://datmachine.co"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_dependency("faraday", ['>= 0.8.6', '<= 0.9.0'])
+  spec.add_dependency("faraday_middleware", '~> 0.9.0')
+  spec.add_dependency("addressable", '~> 2.3.5')
+  
+end

data/lib/datmachine.rb

@@ -0,0 +1,86 @@
+$:.unshift File.join(File.dirname(__FILE__), "datmachine", "resources")
+$:.unshift File.join(File.dirname(__FILE__), "datmachine", "response")
+
+require 'uri'
+require 'datmachine/version' unless defined? Datmachine::VERSION
+require 'datmachine/client'
+require 'datmachine/utils'
+require 'datmachine/error'
+
+module Datmachine
+
+  @client = nil
+  @config = {
+      :scheme => 'http',
+      :host => 'api.datmachine.co',
+      :port => 80,
+      :version => '1.1'
+  }
+
+  @hypermedia_registry = {}
+
+  class << self
+
+    attr_accessor :client
+    attr_accessor :config
+    attr_accessor :hypermedia_registry
+
+    def configure(api_key=nil, site_id=nil, options={})
+      @config = @config.merge(options)
+      @client = Datmachine::Client.new(api_key, site_id, @config)
+    end
+
+    def is_configured_with_api_key?
+      !@client.api_key.nil?
+    end
+
+    def split_the_href(href)
+      URI.parse(href).path.sub(/\/$/, '').split('/')
+    end
+
+    def from_hypermedia_registry(resource_name)
+      cls = Datmachine.hypermedia_registry[resource_name]
+      if cls.nil?
+        raise 'OH SHIT'
+      end
+      cls
+    end
+
+    def from_href(href)
+      split_uri = split_the_href(href)
+      split_uri.reverse!.each do |resource|
+        cls = Datmachine.hypermedia_registry[resource]
+        return cls unless cls.nil?
+      end
+    end
+
+    def is_collection(href)
+      split_uri = split_the_href(href)
+      split_uri.last.to_i == 0
+
+    end
+
+    def get(*args, &block)
+      self.client.get *args
+    end
+
+    def post(*args, &block)
+      self.client.post *args
+    end
+
+    def put(*args, &block)
+      self.client.put *args
+    end
+
+    def unstore(*args, &block)
+      self.client.unstore *args
+    end
+    alias_method :delete, :unstore
+  end
+
+  # configure on import so we don't have to configure for creating
+  # an api key
+  configure
+end
+
+require 'datmachine/resources'

data/lib/datmachine/client.rb

@@ -0,0 +1,103 @@
+require 'logger'
+require 'uri'
+require 'faraday'
+require 'faraday_middleware'
+require 'datmachine_exception_middleware'
+
+module Datmachine
+  class Client
+
+    DEFAULTS = {
+      :scheme => 'http',
+      :host => 'api.datmachine.co/',
+      :port => 80,
+      :version => '1',
+      :logging_level => 'WARN',
+      :connection_timeout => 60,
+      :read_timeout => 60,
+      :logger => nil,
+      :ssl_verify => false,
+      :faraday_adapter => Faraday.default_adapter,
+      :accept_type => 'application/json'
+    }
+
+    attr_reader :conn
+    attr_accessor :api_key, :config
+
+    def initialize(api_key, site_id, options={})
+      @api_key = api_key.nil? ? api_key : api_key.strip
+      @config = DEFAULTS.merge options
+      @config[:site_id] = site_id 
+      build_conn
+    end
+
+    def build_conn
+      if config[:logger]
+        logger = config[:logger]
+      else
+        logger = Logger.new(STDOUT)
+        logger.level = Logger.const_get(config[:logging_level].to_s)
+      end
+
+
+
+      options = {
+        :request => {
+          :open_timeout => config[:connection_timeout],
+          :timeout => config[:read_timeout]
+        },
+        :ssl => {
+          :verify => @config[:ssl_verify] # Only set this to false for testing
+        }
+      }
+      @conn = Faraday.new(url, options) do |cxn|
+        cxn.request :json
+
+        cxn.response :logger, logger
+        cxn.response :json
+        cxn.response :raise_error # raise exceptions on 40x, 50x responses
+        cxn.adapter config[:faraday_adapter]
+      end
+      conn.path_prefix = '/'
+      conn.headers['User-Agent'] = "datmachine-ruby/1"
+      conn.headers['Content-Type'] = "application/json"
+      conn.headers['Accept'] = "#{@config[:accept_type]}"
+    end
+
+    def url
+      builder = (config[:scheme] == 'http') ? URI::HTTP : URI::HTTPS
+
+      builder.build({:host => config[:host],
+                     :port => config[:port],
+                     :scheme => config[:scheme]})
+    end
+
+    def unstore(*args, &block)
+      delete(*args, &block)
+    end
+
+    def method_missing(method, *args, &block)
+      if is_http_method? method
+        conn.token_auth(api_key) unless api_key.nil?
+        args[0] = "/sites/#{config[:site_id]}/" + args[0]
+        conn.send method, *args
+      else
+        super method, *args, &block
+      end
+    end
+
+    private
+
+    def is_http_method? method
+      [:get, :post, :put, :delete].include? method
+    end
+
+    def respond_to?(method, include_private = false)
+      if is_http_method? method
+        true
+      else
+        super method, include_private
+      end
+    end
+  end
+end

data/lib/datmachine/error.rb

@@ -0,0 +1,117 @@
+module Datmachine
+
+  # Custom error class for rescuing from all API response-related Balanced errors
+  class Error < ::StandardError
+    attr_reader :response
+
+    # @param [Hash] response the decoded json response body
+    def initialize(response=nil)
+      @response = response
+      unless response.nil?
+        super error_message
+      end
+    end
+
+    # @return [Hash]
+    def body
+      @body ||= begin
+        return {} unless response[:body]
+        Utils.indifferent_read_access(response[:body])
+      end
+    end
+
+    def error_message
+      set_attrs
+      errors = body.fetch('errors', nil)
+      unless errors.nil?
+        error = body[:errors][0]
+        extra = error[:additional] ? " -- #{error[:additional]}" : ""
+        "#{self.class.name}(#{response[:status]})::#{error[:status]}:: "\
+        "#{response[:method].to_s.upcase} #{response[:url].to_s}: "\
+        "#{error[:category_code]}: #{error[:description]} #{extra}"
+      end
+    end
+
+    private
+    def set_attrs
+      errors = body.fetch('errors', nil)
+      unless errors.nil?
+        error = errors[0]
+        error.keys.each do |name|
+          self.class.instance_eval {
+            define_method(name) { error[name] } # Get.
+            define_method("#{name}?") { !!error[name] } # Present.
+          }
+        end
+      end
+    end
+  end
+
+  # General error class for non API response exceptions
+  class StandardError < Error
+    attr_reader :message
+    alias :error_message :message
+
+    # @param [String, nil] message a description of the exception
+    def initialize(message = nil)
+      @message = message
+      super(message)
+    end
+  end
+
+
+
+  class MoreInformationRequired < Error
+    def redirect_uri
+      response.headers['Location']
+    end
+
+    def error_message
+      set_attrs
+      "#{self.class.name} :: #{response[:method].to_s.upcase} #{response[:url].to_s}: "\
+      "#{response[:status]}: \n#{body[:friendly_html]}"
+    end
+  end
+
+  # Raised when Balanced returns a 400 HTTP status code
+  class BadRequest < Error; end
+
+  # Raised when Balanced returns a 401 HTTP status code
+  class Unauthorized < Error; end
+
+  # Raised when Balanced returns a 402 HTTP status code
+  class PaymentRequired < Error; end
+
+  # Raised when Balanced returns a 403 HTTP status code
+  class Forbidden < Error; end
+
+  # Raised when Balanced returns a 404 HTTP status code
+  class NotFound < Error; end
+
+  # Raised when Balanced returns a 405 HTTP status code
+  class MethodNotAllowed < Error; end
+
+  # Raised when Balanced returns a 409 HTTP status code
+  class Conflict < Error; end
+
+  # Raised when Balanced returns a 410 HTTP status code
+  class Gone < Error; end
+
+  # Raised when Balanced returns a 500 HTTP status code
+  class InternalServerError < Error; end
+
+  # Raised when Balanced returns a 501 HTTP status code
+  class NotImplemented < Error; end
+
+  # Raised when Balanced returns a 502 HTTP status code
+  class BadGateway < Error; end
+
+  # Raised when Balanced returns a 503 HTTP status code
+  class ServiceUnavailable < Error; end
+
+  # Raised when Balanced returns a 504 HTTP status code
+  class GatewayTimeout < Error; end
+
+
+
+end

data/lib/datmachine/pager.rb

@@ -0,0 +1,250 @@
+require "cgi"
+
+module Datmachine
+  class Pager
+    DEFAULT_SEP = /[&;] */n
+    DEFAULT_LIMIT = 10
+
+    include Enumerable
+
+    attr_accessor :href
+    attr_accessor :options
+
+    # A pager for paginating through resource records.
+    #
+    # @param [String] uri the uri of the resource
+    # @param [Hash] options
+    # @option options [Integer] limit
+    # @option options [Integer] offset
+    # @option options [Integer] per an alias for the :limit option
+    def initialize(href, options = {})
+      @href = href
+      @options = options
+      @page = nil
+      @resource_class = nil
+    end
+
+    def resource_class
+      return @resource_class unless @resource_class.nil?
+      load! unless @page
+      @resource_class
+    end
+
+    def first
+      load! unless @page
+      if items.first.nil?
+        nil
+      else
+        envelope = {
+          :meta => @page[:meta],
+          :links => @page[:links],
+          @resource_class.collection_name.to_sym => [items.first]
+        }
+        resource_class.construct_from_response(envelope)
+      end
+    end
+
+    def total
+      load! unless @page
+      @page[:meta][:total]
+    end
+
+    def limit
+      load! unless @page
+      @page[:meta][:limit]
+    end
+    alias limit_value limit
+
+    def offset
+      load! unless @page
+      @page[:meta][:offset]
+    end
+    alias offset_value offset
+
+    def items
+      load! unless @page
+      if @resource_class.nil?
+        []
+      else
+        @page[@resource_class.collection_name]
+      end
+    end
+
+    def current_page
+      (offset / limit) + 1
+    end
+
+    def num_pages
+      num = total / limit
+      num += 1 if total % limit > 0
+      num
+    end
+
+    # @return [Array] Iterates through the current page of records.
+    # @yield [record]
+    def each
+      return enum_for :each unless block_given?
+
+      load! unless @page
+      loop do
+        items.each do |r|
+          envelope = {
+            :meta => @page[:meta],
+            :links => @page[:links],
+            @resource_class.collection_name.to_sym => [r]
+          }
+          yield resource_class.construct_from_response(envelope)
+        end
+        raise StopIteration if @page[:meta].nil?
+        #raise StopIteration if @page[:meta][:next].nil?
+        self.next
+      end
+    end
+
+    # @return [nil]
+    # @see Resource.fetch_each
+    # @yield [record]
+    def fetch_each
+      return enum_for :fetch_each unless block_given?
+      begin
+        each { |record| yield record }
+      end while self.next
+    end
+
+    # @return [Array, nil] Refreshes the pager's collection of records with
+    # the next page.
+    def next
+      load! unless @page
+      next_uri = @page[:meta][:next]
+      load_from next_uri, nil unless next_uri.nil?
+    end
+
+    # @return [Array, nil] Refreshes the pager's collection of records with
+    # the previous page.
+    def prev
+      load! unless @page
+      prev_uri = @page[:meta][:prev]
+      load_from prev_uri, nil unless prev_uri.nil?
+    end
+
+    # @return [Array, nil] Refreshes the pager's collection of records with
+    # the first page.
+    def start
+      load! unless @page
+      first_page = @page[:meta][:first]
+      load_from first_page, nil unless first_page.nil?
+    end
+
+    # @return [Array, nil] Load (or reload) the pager's collection from the
+    # original, supplied options.
+    def load!
+      load_from @href, @options
+    end
+    alias reload load!
+
+    # @return [Pager] Duplicates the pager, updating it with the options
+    # supplied. Useful for resource scopes.
+    # @see #initialize
+    def paginate(options = {})
+      dup.instance_eval {
+        @page = nil
+        @options.update options and self
+      }
+    end
+    alias scoped paginate
+    alias where paginate
+
+    def all(options = {})
+      paginate(options).to_a
+    end
+
+    def fetch(uri)
+      if resource_class.respond_to? :find
+        raise NoMethodError,
+            "#find must be called on #{resource_class} directly"
+      end
+
+      resource_class.fetch uri
+    end
+
+    def create(options={})
+      opts = Datmachine::Utils.indifferent_read_access options
+      opts[:href] = @href
+      # if we don't have a media type for the href,
+      # let's try to inspect the url to look it up from the
+      # registry
+      if @resource_class.nil?
+        @resource_class = Datmachine.from_href(@href)
+      end
+      @resource_class.new(opts).save
+    end
+
+
+    private
+
+    def load_from(uri, params)
+      parsed_uri = URI.parse(uri)
+
+      params ||= {}
+      params = adjust_pagination_params(params)
+
+      unless parsed_uri.query.nil?
+        # The reason we don't use CGI::parse here is because
+        # the Datmachine api currently can't handle variable[]=value.
+        # Faraday ends up encoding a simple query string like:
+        # {"limit"=>["10"], "offset"=>["0"]}
+        # to limit[]=10&offset[]=0 and that's cool, but
+        # we have to make sure Datmachine supports it.
+        query_params = parse_query(parsed_uri.query)
+        params.merge! query_params
+        parsed_uri.query = nil
+      end
+
+      response = Datmachine.get parsed_uri.to_s, params
+      @page = Datmachine::Utils.indifferent_read_access response.body
+
+      #@href = @page[:meta][:href]
+      # resource_class?
+      hypermedia_key = (@page.keys.map{|k| k.to_sym } - [:meta, :links]).first
+      
+      unless hypermedia_key.nil?
+        @resource_class = ("Datmachine::" + Datmachine::Utils.classify(hypermedia_key)).constantize
+      end
+      
+      @page
+    end
+
+    def adjust_pagination_params(original)
+      adjusted = original.dup
+      per = adjusted.delete(:per)
+      adjusted[:limit] = per unless per.nil?
+      page = adjusted.delete(:page)
+      adjusted[:offset] = (adjusted[:limit] || DEFAULT_LIMIT) * ([page, 1].max - 1) unless page.nil?
+      adjusted
+    end
+
+    # Stolen from Mongrel, with some small modifications:
+    # Parses a query string by breaking it up at the '&'
+    # and ';' characters. You can also use this to parse
+    # cookies by changing the characters used in the second
+    # parameter (which defaults to '&;').
+    def parse_query(qs, d = nil)
+      params = {}
+
+      (qs || '').split(d ? /[#{d}] */n : DEFAULT_SEP).each do |p|
+        k, v = p.split('=', 2).map { |x| CGI::unescape(x) }
+        if (cur = params[k])
+          if cur.class == Array
+            params[k] << v
+          else
+            params[k] = [cur, v]
+          end
+        else
+          params[k] = v
+        end
+      end
+
+      params
+    end
+  end
+end

data/lib/datmachine/resources.rb

@@ -0,0 +1,8 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'datmachine', 'resources'))
+require 'resource'
+require 'hypermedia'
+require 'api_key'
+require 'customer'
+require 'plan'
+require 'subscription'
+

data/lib/datmachine/resources/customer.rb

@@ -0,0 +1,36 @@
+module Datmachine
+  # A customer represents a business or person within your Marketplace. A
+  # customer can have many funding instruments such as cards and bank accounts
+  # associated to them.
+  #
+  class Customer
+
+    include Datmachine::Resource
+
+    def create_subscription(options = {})
+      options[:href] =  self.subscriptions.href
+      subscription = Datmachine::Subscription.new(options)
+      subscription.save
+    end
+    
+    def update(options = {})
+      options.each do |key, value|
+        attributes[key] = value
+      end
+      save 
+    end
+    
+    def all_subscriptions 
+      subscriptions.to_a
+    end
+    
+    def last_subscription
+      all_subscriptions.last
+    end
+    
+    def self.find_by_id(id)
+       Datmachine::Customer.fetch("/customers/#{id}")
+    end
+    
+  end
+end

data/lib/datmachine/resources/plan.rb

@@ -0,0 +1,10 @@
+module Datmachine
+
+
+  class Plan
+    include Datmachine::Resource
+
+
+
+  end
+end

data/lib/datmachine/resources/resource.rb

@@ -0,0 +1,293 @@
+require File.expand_path('../../pager', __FILE__)
+require File.expand_path('../../utils', __FILE__)
+require 'addressable/template'
+require 'pp'
+
+
+module Datmachine
+
+  module Resource
+
+    attr_accessor :attributes
+    attr_accessor :hyperlinks
+
+    attr_accessor :id
+    attr_accessor :href
+    attr_accessor :links
+
+    def initialize(attributes = {})
+      @attributes = Utils.indifferent_read_access attributes
+      @hyperlinks = {}
+    end
+
+    def id
+      (attributes[:id] ||= nil)
+    end
+
+    def id=(value)
+      attributes[:id] = value
+    end
+
+    def href
+      (attributes[:href] ||= self.class.collection_name)
+    end
+
+    def links
+      (attributes[:links] ||= {})
+    end
+
+    def links=(value)
+      attributes[:links] = value
+    end
+
+    def hydrate(links, meta)
+      # links here is 'marketplaces.events'
+      links.each do |key, uri|
+        # key is 'marketplaces.events'
+        property = key.sub(/.*?\./, '')
+        # property here is events
+        # if marketplace.links is a hash
+        # for each property and uri, we want to set them on the instance
+        # as pagers.
+        #
+        # right?
+        if self.links.include? property
+          link_value = self.links[property]
+          # expands /customers/{marketplaces.owner_customer} to /customers/ACxxxxx
+          template = Addressable::Template.new(uri)
+          uri = template.expand("#{key}" => link_value).to_s
+          @hyperlinks[property] = Datmachine::Utils.callable(
+              link_value.nil? ? link_value : lambda { self.class.find(uri) }
+          )
+        else
+          unless uri.nil? || uri.is_a?(Hash)
+            # matches something like '/blah/{class.attribute}/bliakdf'
+            begin
+              match_data = /\{(#{self.class.collection_name}\.(\w+))\}/.match(uri)
+            rescue TypeError => ex
+              puts 'what the fuck'
+              raise ex
+            end
+            unless match_data.nil?
+              attribute_path = match_data[1]
+              attribute_name = match_data[2]
+              template = Addressable::Template.new(uri)
+              uri = template.expand("#{attribute_path}" => @attributes[attribute_name]).to_s
+            end
+          end
+          @hyperlinks[property] = Datmachine::Utils.callable(Datmachine::Pager.new(uri, {}))
+        end
+      end
+    end
+
+    # delegate the query to the pager module
+
+    def fetch(*arguments)
+      self.class.find *arguments
+    end
+    
+    alias find fetch
+
+    def save
+      href = @attributes.delete('href')
+      method = :post
+      if href.nil?
+        href = self.class.collection_path
+      elsif !Datmachine.is_collection(href)
+        method = :put
+      end
+
+      attributes_to_submit = self.sanitize
+      @response = Datmachine.send(method, href, attributes_to_submit)
+      @attributes['href'] = href
+
+      reload @response
+    end
+
+    def sanitize
+      to_submit = {}
+      @attributes.each do |key, value|
+        unless value.is_a? Datmachine::Resource
+          to_submit[key] = value
+        end
+      end
+      to_submit
+    end
+
+    def response
+      @response
+    end
+
+    private :response
+
+    def unstore
+      Datmachine.unstore @attributes[:href]
+    end
+    alias_method :destroy, :unstore
+
+    def reload(the_response = nil)
+      if the_response
+        return if the_response.body.to_s.length.zero?
+        fresh = self.class.construct_from_response the_response.body
+      else
+        fresh = self.find(@attributes[:href])
+      end
+      fresh and copy_from fresh
+      return fresh
+    end
+
+    def copy_from(other)
+      other.instance_variables.each do |ivar|
+        instance_variable_set ivar, other.instance_variable_get(ivar)
+      end
+    end
+
+    def method_missing(method, *args, &block)
+      if @attributes.has_key?(method.to_s)
+        return @attributes[method.to_s]
+      end
+
+      case method.to_s
+        when /(.+)=$/
+          attr = method.to_s.chop
+          @attributes[attr] = args[0]
+        else
+          # This piece of code is a bit disgusting. We will clean it up soon,
+          # but basically, we were creating closures using this code snippet
+          # but those closures were transferred to the actual classes themselves
+          # so you would have something like BankAccount.new.account and this
+          # will give the last closure added for a BankAccount even if it has
+          # nothing to do with the actual class itself.
+          #
+          # This caused some weird errors, so the best thing to do was to just
+          # move this piece of code and "dynamically" enable it for all
+          # method requests that are essentially #{method}_uri.
+          #
+          # This solves the acute problem, for now.
+          if @hyperlinks.has_key? "#{method}"
+            value = @hyperlinks["#{method}"]
+            result = value.call
+            return result
+          else
+            super
+          end
+      end
+    end
+
+    if RUBY_VERSION < '1.9'
+      def respond_to?(method_name, include_private=false)
+        does_resource_respond_to?(method_name) || super
+      end
+    else
+      def respond_to_missing?(method_name, include_private=false)
+        does_resource_respond_to?(method_name) || super
+      end
+    end
+
+    def does_resource_respond_to?(method_name)
+      @attributes.has_key?(method_name.to_s) or @hyperlinks.has_key?(method_name.to_s)
+    end
+
+    def self.included(base)
+      base.extend ClassMethods
+    end
+
+    module ClassMethods
+
+      def resource_name
+        Utils.demodulize name
+      end
+
+      def collection_name
+        Utils.pluralize Utils.underscore(resource_name)
+      end
+
+      def collection_path
+        # this is to just support version1 stuff, but in reality, if we get here
+        # we should throw an exception since we do not want to use v1 ever.
+        if Datmachine.config[:version] == '1'
+          # XXX: we should raise an exception if we get here.
+          ["/v#{Datmachine.config[:version]}", collection_name].compact.join '/'
+        else
+          collection_name
+        end
+      end
+
+      def href
+        collection_path
+      end
+
+      def member_name
+        Utils.underscore resource_name
+      end
+
+      def construct_from_response(payload)
+        payload = Datmachine::Utils.indifferent_read_access payload
+
+        links = payload.delete('links') || {}
+        meta = payload.delete('meta') || {}
+
+        if payload.length > 1
+          raise 'NOT SUPPORTED YET'
+        end
+
+        instance = nil
+        # the remaining keys here are just hypermedia resources
+        payload.each do |key, value|
+          # > If the length of an array at a resource key is greater than one,
+          # the value represents a list of documents.
+          if value.length > 1
+            # key is a collection, this should never happen
+            resource_body = value
+          else
+            resource_body = value.first
+          end
+          # > Singular resources are represented as JSON objects. However,
+          # they are still wrapped inside an array:
+          #resource_body = value.first
+          cls = ("Datmachine::" + Datmachine::Utils.classify(key)).constantize
+          instance = cls.new resource_body
+          instance.hydrate(links, meta)
+        end
+        instance
+        
+      end
+
+      def fetch(*arguments)
+        if arguments.nil? ||
+           arguments.empty? ||
+           arguments[0].nil? ||
+           arguments[0].empty?
+          
+        end
+        scope = arguments.slice!(0)
+        options = arguments.slice!(0) || {}
+        case scope
+          when :all then
+            all(options)
+          when :first then
+            paginate(options).first
+          else
+            response = Datmachine.get scope, options
+            construct_from_response response.body
+        end
+      end
+
+      alias find fetch
+      
+      def paginate(options = {})
+        Datmachine::Pager.new href, options
+      end
+
+      alias scoped paginate
+      alias where paginate
+
+      def all(options = {})
+        pager = paginate(options)
+        pager.to_a
+      end
+
+    end
+
+  end
+end

data/lib/datmachine/resources/subscription.rb

@@ -0,0 +1,14 @@
+module Datmachine
+
+
+  class Subscription
+    include Datmachine::Resource
+
+    def cancel
+      self.status = "canceled"
+      self.save
+    end
+
+
+  end
+end

data/lib/datmachine/response/datmachine_exception_middleware.rb

@@ -0,0 +1,34 @@
+require 'faraday'
+require 'datmachine/error'
+
+# @api private
+module Faraday
+
+  class Response::RaiseDatmachineError < Response::Middleware
+
+    HTTP_STATUS_CODES = {
+        300 => Datmachine::MoreInformationRequired,
+        400 => Datmachine::BadRequest,
+        401 => Datmachine::Unauthorized,
+        402 => Datmachine::PaymentRequired,
+        403 => Datmachine::Forbidden,
+        404 => Datmachine::NotFound,
+        405 => Datmachine::MethodNotAllowed,
+        409 => Datmachine::Conflict,
+        410 => Datmachine::Gone,
+        500 => Datmachine::InternalServerError,
+        501 => Datmachine::NotImplemented,
+        502 => Datmachine::BadGateway,
+        503 => Datmachine::ServiceUnavailable,
+        504 => Datmachine::GatewayTimeout,
+    }
+
+    def on_complete(response)
+      status_code = response[:status].to_i
+      error_class = CATEGORY_CODE_MAP[category_code] || HTTP_STATUS_CODES[status_code]
+      raise error_class.new(response) if error_class
+    end
+
+  end
+
+end

data/lib/datmachine/utils.rb

@@ -0,0 +1,92 @@
+module Datmachine
+
+  module Utils
+
+    def callable( callable_or_not )
+      callable_or_not.respond_to?(:call) ? callable_or_not : lambda { callable_or_not }
+    end
+
+    def camelize(underscored_word)
+      underscored_word.to_s.gsub(/(?:^|_)(.)/) { $1.upcase }
+    end
+
+    def classify(table_name)
+      camelize singularize(table_name.to_s.sub(/.*\./, ''))
+    end
+
+    def demodulize(class_name_in_module)
+      class_name_in_module.to_s.sub(/^.*::/, '')
+    end
+
+    def pluralize(word)
+      word.to_s.sub(/([^s])$/, '\1s')
+    end
+
+    def singularize(word)
+      word.to_s.sub(/s$/, '').sub(/ie$/, 'y')
+    end
+
+    def underscore(camel_cased_word)
+      word = camel_cased_word.to_s.dup
+      word.gsub!(/::/, '/')
+      word.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+      word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
+      word.tr! '-', '_'
+      word.downcase!
+      word
+    end
+
+    def extract_href_from_object(object)
+      object.respond_to?(:href) ? object.href : object
+    end
+
+    def indifferent_read_access(base = {})
+      indifferent = Hash.new do |hash, key|
+        hash[key.to_s] if key.is_a? Symbol
+      end
+      base.each_pair do |key, value|
+        if value.is_a? Hash
+          value = indifferent_read_access value
+        elsif value.respond_to? :each
+          if value.respond_to? :map!
+            value.map! do |v|
+              if v.is_a? Hash
+                v = indifferent_read_access v
+              end
+              v
+            end
+          else
+            value.map do |v|
+              if v.is_a? Hash
+                v = indifferent_read_access v
+              end
+              v
+            end
+          end
+        end
+        indifferent[key.to_s] = value
+      end
+      indifferent
+    end
+
+    def stringify_keys!(hash)
+      hash.keys.each do |key|
+        stringify_keys! hash[key] if hash[key].is_a? Hash
+        hash[key.to_s] = hash.delete key if key.is_a? Symbol
+      end
+    end
+
+    def assert_valid_keys(hash, *valid_keys)
+      unknown_keys = hash.keys - [valid_keys].flatten
+      raise(ArgumentError, "Unknown key(s): #{unknown_keys.join(', ')}") unless unknown_keys.empty?
+    end
+
+    def assert_required_keys(hash, params)
+      params[:required] ||= []
+      pending_keys = params[:required] - hash.keys
+      raise(ArgumentError, "Required key(s) not present: #{pending_keys.join(', ')}") unless pending_keys.empty?
+    end
+    extend self
+  end
+end
+

data/lib/datmachine/version.rb

@@ -0,0 +1,3 @@
+module Datmachine
+  VERSION = '1.0.0'
+end

metadata

@@ -0,0 +1,140 @@
+--- !ruby/object:Gem::Specification
+name: datmachine
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- efremov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.6
+    - - <=
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.6
+    - - <=
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.5
+description: Datmachine is a business intelligence solution for Internet companies.
+email:
+- efremov@datmachine.co
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- datmachine.gemspec
+- lib/datmachine.rb
+- lib/datmachine/client.rb
+- lib/datmachine/error.rb
+- lib/datmachine/pager.rb
+- lib/datmachine/resources.rb
+- lib/datmachine/resources/api_key.rb
+- lib/datmachine/resources/customer.rb
+- lib/datmachine/resources/hypermedia.rb
+- lib/datmachine/resources/plan.rb
+- lib/datmachine/resources/resource.rb
+- lib/datmachine/resources/subscription.rb
+- lib/datmachine/response/datmachine_exception_middleware.rb
+- lib/datmachine/utils.rb
+- lib/datmachine/version.rb
+homepage: https://datmachine.co
+licenses:
+- MIT
+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.0.3
+signing_key: 
+specification_version: 4
+summary: https://datmachine.co/guides
+test_files: []