stackd 0.0.1 → 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 712a5a41ba1e4378a6f294d4ab7f4bd42dfa60df
+  data.tar.gz: 262301250ceb765546dd1120f259540e064ed25b
+SHA512:
+  metadata.gz: 0c670d327edea7dc4d9fd30337b370094abe354e5f571f0b9f201d49bfeefef479508bfbd09c305f24646a597bef4e3b96fb0440abd21b99f97a1aee072c2ad4
+  data.tar.gz: 22e64533ead572f8c16a2c2c190492cf4772eab612b47fdc6dafd8fe6defde8f0b881fa74960b7d50b602a1b3bc5ca320c2184cf0565066f00be21ccb50ea304

data/.gitignore

@@ -1,4 +1,9 @@
-*.gem
-.bundle
-Gemfile.lock
-pkg/*
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.0.0

data/Gemfile

@@ -1,4 +1,4 @@
-source "http://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in stackd.gemspec
 gemspec

data/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org>

data/README.md

@@ -0,0 +1,184 @@
+# Stackd Ruby Client
+
+[![Codeship Status for stackd/stackd-ruby](https://codeship.com/projects/ffa792f0-d110-0132-a1ec-2af27bf90e4e/status?branch=master)](https://codeship.com/projects/77196)
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/stackd`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+### Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'stackd'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install stackd
+
+### Usage
+
+###### Creating a client
+
+```ruby
+$stackd = Stackd::Client.new id: 'YOUR_CLIENT_ID',
+                             secret: 'YOUR_CLIENT_SECRET'
+```
+
+###### Getting an app token
+
+```ruby
+app_token = $stackd.auth_requests.client scope: 'a,b,c'
+# => <Stackd::Token app_id: "YOUR_CLIENT_ID",
+#                   scope: "a,b,c",
+#                   access_token: "e1979b29529ac",
+#                   expires_in: 3600>
+```
+
+###### Getting a user token
+
+```ruby
+class MyController
+  def authorize
+    auth_request = $stackd.auth_requests.new redirect_uri: 'YOUR_CALLBACK_URL',
+                                             scope: 'a,b,c'
+
+    session[:auth_state] = auth_request.state
+
+    redirect_to auth_request.url
+    # stackd.com/authorize?client_id=...&state=...&redirect_uri=...&scope=...
+  end
+
+  def callback
+    auth_request = $stackd.auth_requests.new state: session[:state]
+
+    user_token = auth_request.callback code: params[:code],
+                                       state: params[:state]
+    # => <Stackd::Token user_id: "09545bce-3c31-4593-99bd-1dfe8b98df93",
+    #                   scope: "a,b",
+    #                   access_token: "e1979b29529ac",
+    #                   refresh_token: "ca92592b9791e",
+    #                   expires_in: 3600>
+  end
+end
+```
+
+###### Refreshing a user token
+
+```ruby
+refreshed_user_token = $stackd.auth_requests.refresh user_token
+```
+
+###### Persisting tokens (example)
+
+```
+rails generate model TokenData \
+  user_id:string \
+  scope:string \
+  access_token:string \
+  refresh_token:string \
+  expires_in:integer
+```
+
+```ruby
+Stackd::Token.on_grant do |token|
+  TokenData.create! user_id: token.user_id,
+                    scope: token.scope,
+                    access_token: token.access_token,
+                    refresh_token: token.refresh_token,
+                    expires_in: token.expires_in
+end
+```
+
+```ruby
+class TokenData
+  def self.fresh_token_by criteria
+    # ...
+    token = $stackd.tokens.new user_id: user_id,
+                               scope: scope,
+                               access_token: access_token,
+                               refresh_token: refresh_token,
+                               expires_in: expires_in,
+                               token_type: 'bearer'
+
+    if expired?
+      $stackd.auth_requests.refresh token
+    else
+      token
+    end
+  end
+
+  def expired?
+    Time.now > created_at + expires_in.seconds
+  end
+end
+```
+
+###### Making requests
+
+https://stackd.com/docs
+
+```ruby
+token.post :rappers, name: 'Marshall Mathers'
+# POST /rappers
+# {"name": "Marshall Mathers"}
+# => { ... }
+```
+
+```ruby
+token.patch :rappers, ':id', name: 'EMIN3M'
+# PATCH /rappers/:id
+# {"name": "EMIN3M"}
+# => { ... }
+```
+
+```ruby
+token.get :rapper, ':id'
+# GET /rappers/:id
+# => { ... }
+```
+
+```ruby
+token.get :rappers, q: 'Slim Shady'
+# GET /rappers?q=Slim%20Shady
+# => { rappers: [ ... ], ... }
+```
+
+```ruby
+token.get '/any/url'
+# GET /any/url
+```
+
+**Application errors (4xx)**
+
+Will throw a `Stackd::Error`:
+
+```ruby
+# <Stackd::Error error="error_code"
+#                error_description="Something went wrong."
+#                error_uri="https://stackd.com/docs/errors#error_code">
+```
+
+**Server errors (5xx)**
+
+Will throw a `Stackd::ServerError`.
+
+### Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment. Run `bundle exec stackd` to use the code located in this directory, ignoring other installed copies of this gem.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+### Contributing
+
+1. Fork it ( https://github.com/stackd/stackd-ruby/fork )
+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 a new Pull Request

data/bin/bundler

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'bundler' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('bundler', 'bundler')

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "stackd"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/htmldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('diff-lcs', 'htmldiff')

data/bin/ldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('diff-lcs', 'ldiff')

data/bin/rake

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rake', 'rake')

data/bin/rdoc

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rdoc' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rdoc', 'rdoc')

data/bin/restclient

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'restclient' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rest-client', 'restclient')

data/bin/ri

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'ri' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rdoc', 'ri')

data/bin/rspec

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/bin/safe_yaml

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'safe_yaml' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('safe_yaml', 'safe_yaml')

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bin/stackd

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'stackd' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('stackd', 'stackd')

data/lib/stackd.rb

@@ -1,4 +1,29 @@
-require "stackd/version"
-
 module Stackd
+  autoload :Version,     'stackd/version'
+  autoload :Config,      'stackd/config'
+  autoload :Client,      'stackd/client'
+  autoload :AuthRequest, 'stackd/auth_request'
+  autoload :Token,       'stackd/token'
+  autoload :Error,       'stackd/error'
+  autoload :ServerError, 'stackd/server_error'
+
+  module Util
+    autoload :Portal, 'stackd/util/portal'
+    autoload :HTTP,   'stackd/util/http'
+  end
+
+  module Concerns
+    autoload :TattrAccessor, 'stackd/concerns/tattr_accessor'
+    autoload :RequireAttr,   'stackd/concerns/require_attr'
+  end
+
+  class << self
+    def config
+      @config ||= Stackd::Config.new
+    end
+
+    def configure
+      yield config
+    end
+  end
 end

data/lib/stackd/auth_request.rb

@@ -0,0 +1,138 @@
+require 'securerandom'
+require 'active_support/core_ext/hash/keys'
+require 'unirest'
+
+module Stackd
+  class AuthRequest
+    include Concerns::TattrAccessor
+    include Concerns::RequireAttr
+
+    tattr_accessor client: Client,
+                   state: String,
+                   redirect_uri: String
+
+    class << self
+      def password client, params
+        if params[:username].nil?
+          raise ArgumentError.new "username is required"
+        end
+
+        if params[:password].nil?
+          raise ArgumentError.new "password is required"
+        end
+
+        request_token client, grant_type: 'password',
+                              username: params[:username],
+                              password: params[:password],
+                              scope: params[:scope]
+      end
+
+      def client client, params = {}
+        request_token client, grant_type: 'client_credentials',
+                              scope: params[:scope]
+      end
+
+      def refresh client, token, params = {}
+        if token.nil?
+          raise ArgumentError.new "Token is required"
+        end
+
+        if token.refresh_token.nil?
+          raise ArgumentError.new "Token must have refresh_token"
+        end
+
+        request_token client, grant_type: 'refresh_token',
+                              refresh_token: token.refresh_token,
+                              scope: params[:scope]
+      end
+
+      private
+
+      def request_token client, params = {}
+        if params[:grant_type].nil?
+          raise ArgumentError.new "grant_type not provided"
+        end
+
+        res = Unirest.post "#{Stackd.config.api_url}/token", {
+          auth: {
+            user: client.id,
+            password: client.secret
+          },
+          headers: {'Content-Type' => 'application/x-www-form-urlencoded'},
+          parameters: params.reject { |k,v| v.nil? }
+        }
+
+        if res.code == 200
+          token = client.tokens.new res.body.symbolize_keys
+
+          on_grant_callbacks = \
+            Stackd::Token.instance_variable_get :@_on_grant_callbacks
+          on_grant_callbacks.each {|c| c.(token) }
+
+          token
+        else
+          raise Error.new res.body.symbolize_keys
+        end
+      end
+    end
+
+    def initialize client, attrs = {}
+      if client.nil?
+        raise ArgumentError.new "client not provided"
+      else
+        self.client = client
+      end
+
+      attrs.each do |key, val|
+        public_send :"#{key}=", val
+      end
+
+      if state.nil?
+        self.state = SecureRandom.urlsafe_base64 9
+      end
+    end
+
+    def url params = {}
+      uri = auth_url
+
+      uri.query_values = {
+        response_type: 'code',
+        client_id: client.id,
+        state: state,
+        redirect_uri: params[:redirect_uri],
+        scope: params[:scope]
+      }.reject { |k,v| v.nil? }
+
+      uri.to_s
+    end
+
+    def callback params
+      unless params[:code] || params[:error]
+        raise ArgumentError.new 'no code or error'
+      end
+
+      if params[:state] != state
+        raise StateMismatchError.new "#{params[:state]} != #{state}"
+      end
+
+      if params[:error]
+        raise Error.new params
+      else
+        self.class.send :request_token, client, {
+          grant_type: 'authorization_code',
+          code: params[:code],
+          redirect_uri: redirect_uri
+        }
+      end
+    end
+
+    private
+
+    def auth_url
+      Addressable::URI.parse Stackd.config.auth_url
+    end
+
+    class StateMismatchError < StandardError
+    end
+  end
+end

data/lib/stackd/client.rb

@@ -0,0 +1,29 @@
+module Stackd
+  class Client
+    include Concerns::TattrAccessor
+    include Concerns::RequireAttr
+
+    tattr_accessor id: String,
+                   secret: String
+
+    def initialize attrs
+      attrs.each do |attr, val|
+        public_send :"#{attr}=", val
+      end
+
+      begin
+        require_attr! :id, :secret
+      rescue Concerns::RequireAttr::AttrNotSetError => e
+        raise ArgumentError.new e.message
+      end
+    end
+
+    def auth_requests
+      @auth_requests ||= Util::Portal.new self, AuthRequest
+    end
+
+    def tokens
+      @tokens ||= Util::Portal.new self, Token
+    end
+  end
+end

data/lib/stackd/concerns/require_attr.rb

@@ -0,0 +1,20 @@
+require 'active_support/concern'
+
+module Stackd
+  module Concerns
+    module RequireAttr
+      extend ActiveSupport::Concern
+
+      def require_attr! *attrs
+        attrs.each do |key|
+          if public_send(key).nil?
+            raise AttrNotSetError.new "#{key} not set"
+          end
+        end
+      end
+
+      class AttrNotSetError < StandardError
+      end
+    end
+  end
+end

data/lib/stackd/concerns/tattr_accessor.rb

@@ -0,0 +1,51 @@
+require 'active_support/concern'
+
+module Stackd
+  module Concerns
+    module TattrAccessor
+      extend ActiveSupport::Concern
+
+      included do
+        @_tattrs = {}
+      end
+
+      class_methods do
+        def tattr_accessor tattrs
+          tattrs.each do |tattr, type|
+            attr_reader tattr
+
+            @_tattrs[tattr] = type
+
+            define_method :"#{tattr}=" do |value|
+              unless value.nil? || self.class.tattr_type_match?(tattr, value)
+                tattr_type = self.class.tattr_type tattr
+                raise TypeMismatchError.new [
+                  "tattr: #{tattr}",
+                  "tattr_type: #{tattr_type}",
+                  "value: #{value.inspect}"
+                ].join ', '
+              end
+
+              instance_variable_set :"@#{tattr}", value
+            end
+          end
+        end
+
+        def tattr_type_match? tattr, value
+          value.is_a? tattr_type(tattr)
+        end
+
+        def tattr_type tattr
+          @_tattrs[tattr]
+        end
+      end
+
+      def tattr? key
+        self.class.instance_variable_get(:@_tattrs).has_key? key
+      end
+
+      class TypeMismatchError < StandardError
+      end
+    end
+  end
+end

data/lib/stackd/config.rb

@@ -0,0 +1,23 @@
+module Stackd
+  class Config
+    include Concerns::TattrAccessor
+
+    tattr_accessor auth_url: String,
+                   token_url: String,
+                   api_url: String
+
+    def initialize attrs = {}
+      attrs.each do |key, val|
+        public_send :"#{key}=", val
+      end
+    end
+
+    def auth_url
+      @auth_url || "https://stackd.com/authorize"
+    end
+
+    def api_url
+      @api_url || "https://api.stackd.com"
+    end
+  end
+end

data/lib/stackd/error.rb

@@ -0,0 +1,27 @@
+module Stackd
+  class Error < StandardError
+    include Concerns::TattrAccessor
+    include Concerns::RequireAttr
+
+    tattr_accessor error: String,
+                   error_description: String,
+                   error_uri: String,
+                   error_params: Hash
+
+    def initialize attrs
+      attrs.each do |key, val|
+        public_send :"#{key}=", val if tattr? key
+      end
+
+      begin
+        require_attr! :error
+      rescue Concerns::RequireAttr::AttrNotSetError => e
+        raise ArgumentError.new e.message
+      end
+    end
+
+    def message
+      error_description
+    end
+  end
+end

data/lib/stackd/server_error.rb

@@ -0,0 +1,4 @@
+module Stackd
+  class ServerError < StandardError
+  end
+end

data/lib/stackd/token.rb

@@ -0,0 +1,103 @@
+require 'active_support/core_ext/object/to_query'
+
+module Stackd
+  class Token
+    include Concerns::TattrAccessor
+    include Concerns::RequireAttr
+
+    @_on_grant_callbacks = []
+
+    tattr_accessor client: Client,
+                   access_token: String,
+                   token_type: String,
+                   expires_in: Integer,
+                   refresh_token: String,
+                   scope: String,
+                   service_id: String,
+                   user_id: String
+
+    def self.on_grant &block
+      @_on_grant_callbacks.push block
+    end
+
+    def initialize client, attrs = {}
+      self.client = client
+
+      attrs.each do |key, val|
+        public_send :"#{key}=", val if tattr? key
+      end
+
+      begin
+        require_attr! :client, :access_token, :token_type
+      rescue Concerns::RequireAttr::AttrNotSetError => e
+        raise ArgumentError.new e.message
+      end
+    end
+
+    def get *args
+      Util::HTTP.get self, get_url(*args)
+    end
+
+    def post *args
+      url_args = reject_body_arg *args
+      body_arg = get_body_arg *args
+      content_type = content_type_for body_arg
+
+      Util::HTTP.post self, get_url(*url_args), body_arg, content_type
+    end
+
+    def put *args
+      url_args = reject_body_arg *args
+      body_arg = get_body_arg *args
+      content_type = content_type_for body_arg
+
+      Util::HTTP.put self, get_url(*url_args), body_arg, content_type
+    end
+
+    def patch *args
+      url_args = reject_body_arg *args
+      body_arg = get_body_arg *args
+      content_type = content_type_for body_arg
+
+      Util::HTTP.patch self, get_url(*url_args), body_arg, content_type
+    end
+
+    def delete *args
+      url_args = reject_body_arg *args
+      body_arg = get_body_arg *args
+      content_type = content_type_for body_arg
+
+      Util::HTTP.delete self, get_url(*url_args), body_arg, content_type
+    end
+
+    private
+
+    def get_url *args
+      args.inject Stackd.config.api_url do |url, part|
+        if part.is_a? Hash
+          "#{url}?#{part.to_query}"
+        else part = part.to_s
+          if part.index(Stackd.config.api_url) == 0
+            part
+          elsif part.index('/') == 0
+            "#{url}#{part}"
+          else
+            "#{url}/#{part}"
+          end
+        end
+      end
+    end
+
+    def reject_body_arg *args
+      args.reject {|a| a.is_a? Hash }
+    end
+
+    def get_body_arg *args
+      args.last if args.last.is_a? Hash
+    end
+
+    def content_type_for body_arg
+      :json unless body_arg.nil?
+    end
+  end
+end

data/lib/stackd/util/http.rb

@@ -0,0 +1,135 @@
+require 'json'
+require 'uri'
+require 'unirest'
+require 'active_support/core_ext/hash/keys'
+
+module Stackd
+  module Util
+    module HTTP
+      def self.get credentials, url
+        request_without_body :get, credentials, url
+      end
+
+      def self.post credentials, url, body, content_type
+        request_with_body :post, credentials, url, body, content_type
+      end
+
+      def self.put credentials, url, body, content_type
+        request_with_body :put, credentials, url, body, content_type
+      end
+
+      def self.patch credentials, url, body, content_type
+        request_with_body :patch, credentials, url, body, content_type
+      end
+
+      def self.delete credentials, url
+        request_without_body :delete, credentials, url
+      end
+
+      private
+
+      def self.request_without_body method, credentials, url
+        validate_params! credentials, url
+
+        basic_auth = basic_auth_for credentials
+        headers = headers_for credentials
+
+        res = Unirest.public_send method, url, headers: headers,
+                                               auth: basic_auth
+
+        process_response res
+      end
+
+      def self.request_with_body method, credentials, url, body, content_type
+        validate_params! credentials, url, body, content_type
+
+        basic_auth = basic_auth_for credentials
+        headers = headers_for credentials, content_type
+        parameters = parameters_for body, content_type
+
+        res = Unirest.public_send method, url, headers: headers,
+                                               auth: basic_auth,
+                                               parameters: parameters
+
+        process_response res
+      end
+
+      def self.validate_params! credentials, url, body = nil, content_type = nil
+        unless creds_are_valid? credentials
+          raise ArgumentError.new \
+            "credentials must be a Stackd::Token, Hash with :user + " + \
+              ":password, credentials: #{credentials.inspect}"
+        end
+
+        unless url.is_a? String
+          raise ArgumentError.new "url must be String. url: #{url.inspect}"
+        end
+
+        unless body.nil? || body.is_a?(Hash)
+          raise ArgumentError.new \
+            "body must be a Hash or nil. body: #{body.inspect}"
+        end
+
+        unless content_type.nil? || [:json, :form].include?(content_type)
+          raise ArgumentError.new \
+            "content_type must be :json, :form, or nil. " + \
+              "content_type: #{content_type.inspect}"
+        end
+      end
+
+      def self.creds_are_valid? credentials
+        credentials.nil? || \
+        credentials.is_a?(Client) || \
+        credentials.is_a?(Token) || \
+        (credentials.is_a?(Hash) && \
+         credentials[:user].is_a?(String) && \
+         credentials[:password].is_a?(String))
+      end
+
+      def self.basic_auth_for credentials
+        if credentials.is_a? Hash
+          credentials
+        elsif credentials.is_a? Client
+          { user: credentials.id, password: credentials.secret }
+        end
+      end
+
+      def self.headers_for credentials, content_type = nil
+        headers = {}
+
+        if credentials.is_a? Token
+          headers.merge!(
+            { 'Authorization' => "Bearer #{credentials.access_token}" })
+        end
+
+        unless content_type.nil?
+          content_type_value = content_type == :json \
+            ? 'application/json' \
+            : 'application/x-www-form-urlencoded'
+
+          headers.merge!({ 'Content-Type' => content_type_value })
+        end
+
+        headers
+      end
+
+      def self.parameters_for body, content_type
+        if content_type == :json
+          JSON.generate body
+        else
+          body
+        end
+      end
+
+      def self.process_response res
+        if res.code >= 500
+          raise ServerError.new res.body.deep_symbolize_keys
+        elsif res.code >= 400
+          raise Error.new res.body.deep_symbolize_keys
+        else
+          res.body.deep_symbolize_keys
+        end
+      end
+    end
+  end
+end

data/lib/stackd/util/portal.rb

@@ -0,0 +1,14 @@
+module Stackd
+  module Util
+    class Portal
+      def initialize parent, klass
+        @parent = parent
+        @klass = klass
+      end
+
+      def method_missing method, *args, &block
+        @klass.public_send method, @parent, *args, &block
+      end
+    end
+  end
+end

data/lib/stackd/version.rb

@@ -1,3 +1,3 @@
 module Stackd
-  VERSION = "0.0.1"
+  VERSION = "0.1.1"
 end

data/stackd.gemspec

@@ -1,18 +1,31 @@
-# -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "stackd/version"
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'stackd/version'
 
-Gem::Specification.new do |s|
-  s.name        = "stackd"
-  s.version     = Stackd::VERSION
-  s.author      = "Stackd"
-  s.email       = "support@stackd.com"
-  s.homepage    = "https://stackd.com/"
-  s.summary     = %q{Stackd gem}
-  s.description = %q{Stackd gem}
+Gem::Specification.new do |spec|
+  spec.name          = "stackd"
+  spec.version       = Stackd::VERSION
+  spec.authors       = ["Stephen Ausman"]
+  spec.email         = ["stephen@stackd.com"]
 
-  s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ["lib"]
+  spec.summary       = "Stackd Ruby client"
+  spec.description   = "https://stackd.com"
+  spec.homepage      = "https://github.com/stackd/stackd-ruby"
+  spec.license       = "Unlicense"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f|
+    f.match(%r{^(test|spec|features)/})
+  }
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.2"
+  spec.add_development_dependency "webmock", "~> 1.21"
+
+  spec.add_dependency "unirest", "~> 1.1"
+  spec.add_dependency "addressable", "~> 2.3"
+  spec.add_dependency "activesupport", "~> 4.2"
 end

metadata

@@ -1,50 +1,174 @@
 --- !ruby/object:Gem::Specification
 name: stackd
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 0.1.1
 platform: ruby
 authors:
-- Stackd
+- Stephen Ausman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-09 00:00:00.000000000 Z
-dependencies: []
-description: Stackd gem
-email: support@stackd.com
+date: 2015-12-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: unirest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !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'
+description: https://stackd.com
+email:
+- stephen@stackd.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
 - Gemfile
+- LICENSE
+- README.md
 - Rakefile
+- bin/bundler
+- bin/console
+- bin/htmldiff
+- bin/ldiff
+- bin/rake
+- bin/rdoc
+- bin/restclient
+- bin/ri
+- bin/rspec
+- bin/safe_yaml
+- bin/setup
+- bin/stackd
 - lib/stackd.rb
+- lib/stackd/auth_request.rb
+- lib/stackd/client.rb
+- lib/stackd/concerns/require_attr.rb
+- lib/stackd/concerns/tattr_accessor.rb
+- lib/stackd/config.rb
+- lib/stackd/error.rb
+- lib/stackd/server_error.rb
+- lib/stackd/token.rb
+- lib/stackd/util/http.rb
+- lib/stackd/util/portal.rb
 - lib/stackd/version.rb
 - stackd.gemspec
-homepage: https://stackd.com/
-licenses: []
+homepage: https://github.com/stackd/stackd-ruby
+licenses:
+- Unlicense
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 2.4.5.1
 signing_key: 
-specification_version: 3
-summary: Stackd gem
+specification_version: 4
+summary: Stackd Ruby client
 test_files: []