tent-client 0.0.1

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/.rspec

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

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 1.9.2
+  - rbx-18mode
+  - rbx-19mode
+  - 1.8.7
+  - ree

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in tent-client.gemspec
+gemspec
+
+gem 'faraday_middleware-multi_json', :git => 'git://github.com/jvatic/faraday_middleware-multi_json.git', :branch => :master

data/Guardfile

@@ -0,0 +1,6 @@
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/tent-client/(.+)\.rb$})     { |m| "spec/unit/#{m[1]}_spec.rb" }
+  watch(%r{^lib/[^/]+\.rb$})    { "spec" }
+  watch(%r{spec/(spec_helper|support/).*\.rb})  { "spec" }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Apollic Software, LLC
+
+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,24 @@
+# Tent Ruby Client ![Build Status](https://magnum.travis-ci.com/tent/tent-client-ruby.png?branch=master&token=YmxLSPgdpsxNUMWJpzRx)
+
+TentClient implements a [Tent Protocol](http://tent.io) client library in Ruby.
+It is incomplete, currently only the endpoints required by
+[tentd](https://github.com/tent/tentd) and
+[tentd-admin](https://github.com/tent/tentd-admin) have been implemented.
+
+## Usage
+
+```ruby
+# Tent profile discovery
+TentClient.new.discover("http://tent-user.example.org")
+
+# Server communication
+client = TentClient.new('http://tent-user.example.org',
+                        :mac_key_id => 'be94a6bf',
+                        :mac_key => '974af035',
+                        :mac_algorithm => 'hmac-sha-256')
+client.following.create('http://another-tent.example.com')
+```
+
+## Contributions
+
+If you find missing endpoints/actions, please submit a pull request.

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+end
+task :default => :spec

data/lib/tent-client.rb

@@ -0,0 +1,81 @@
+require 'tent-client/version'
+require 'oj'
+require 'faraday'
+require 'faraday_middleware'
+require 'faraday_middleware/multi_json'
+
+class TentClient
+  autoload :Discovery, 'tent-client/discovery'
+  autoload :LinkHeader, 'tent-client/link_header'
+  autoload :Follower, 'tent-client/follower'
+  autoload :Following, 'tent-client/following'
+  autoload :Group, 'tent-client/group'
+  autoload :Profile, 'tent-client/profile'
+  autoload :App, 'tent-client/app'
+  autoload :AppAuthorization, 'tent-client/app_authorization'
+  autoload :Post, 'tent-client/post'
+  autoload :PostAttachment, 'tent-client/post_attachment'
+  autoload :CycleHTTP, 'tent-client/cycle_http'
+
+  require 'tent-client/middleware/accept_header'
+  require 'tent-client/middleware/mac_auth'
+  require 'tent-client/middleware/encode_json'
+
+  MEDIA_TYPE = 'application/vnd.tent.v0+json'.freeze
+  PROFILE_REL = 'https://tent.io/rels/profile'.freeze
+
+  attr_reader :faraday_adapter, :server_urls
+
+  def initialize(server_urls = [], options={})
+    @server_urls = Array(server_urls)
+    @faraday_adapter = options.delete(:faraday_adapter)
+    @options = options
+  end
+
+  def http
+    @http ||= CycleHTTP.new(self) do |f|
+      f.use Middleware::EncodeJson unless @options[:skip_serialization]
+      f.response :multi_json, :content_type => /\bjson\Z/ unless @options[:skip_serialization]
+      f.use Middleware::AcceptHeader
+      f.use Middleware::MacAuth, @options
+      f.adapter *Array(faraday_adapter)
+    end
+  end
+
+  def faraday_adapter
+    @faraday_adapter || Faraday.default_adapter
+  end
+
+  def server_url=(v)
+    @server_urls = Array(v)
+    @http = nil # reset Faraday connection
+  end
+
+  def discover(url)
+    Discovery.new(self, url).tap { |d| d.perform }
+  end
+
+  def follower
+    Follower.new(self)
+  end
+
+  def following
+    Following.new(self)
+  end
+
+  def group
+    Group.new(self)
+  end
+
+  def app
+    App.new(self)
+  end
+
+  def post
+    Post.new(self)
+  end
+
+  def profile
+    Profile.new(self)
+  end
+end

data/lib/tent-client/app.rb

@@ -0,0 +1,33 @@
+class TentClient
+  class App
+    attr_accessor :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def create(data)
+      @client.http.post("apps", data)
+    end
+
+    def get(id)
+      @client.http.get("apps/#{id}")
+    end
+
+    def list(params = {})
+      @client.http.get("apps", params)
+    end
+
+    def delete(id)
+      @client.http.delete("apps/#{id}")
+    end
+
+    def update(id, data)
+      @client.http.put("apps/#{id}", data)
+    end
+
+    def authorization
+      AppAuthorization.new(@client)
+    end
+  end
+end

data/lib/tent-client/app_authorization.rb

@@ -0,0 +1,21 @@
+class TentClient
+  class AppAuthorization
+    attr_accessor :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def create(app_id, data)
+      @client.http.post("apps/#{app_id}/authorizations", data)
+    end
+
+    def update(app_id, id, data)
+      @client.http.put("apps/#{app_id}/authorizations/#{id}", data)
+    end
+
+    def delete(app_id, id)
+      @client.http.delete("apps/#{app_id}/authorizations/#{id}")
+    end
+  end
+end

data/lib/tent-client/cycle_http.rb

@@ -0,0 +1,49 @@
+class TentClient
+
+  # Proxies to Faraday and cycles through server urls
+  #   until either non left or response status in the 200s or 400s
+  class CycleHTTP
+    attr_reader :client, :server_urls
+    def initialize(client, &faraday_block)
+      @faraday_block = faraday_block
+      @client = client
+      @server_urls = client.server_urls.dup
+    end
+
+    def new_http
+      @http = Faraday.new(:url => server_urls.shift) do |f|
+        @faraday_block.call(f)
+      end
+    end
+
+    def http
+      @http || new_http
+    end
+
+    %w{ head get put post patch delete options }.each do |verb|
+      define_method verb do |*args, &block|
+        res = http.send(verb, *args, &block)
+        return res unless server_urls.any?
+        case res.status
+        when 200...300, 400...500
+          res
+        else
+          new_http
+          send(verb, *args, &block)
+        end
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      http.respond_to?(method_name, include_private)
+    end
+
+    def method_missing(method_name, *args, &block)
+      if http.respond_to?(method_name)
+        http.send(method_name, *args, &block)
+      else
+        super
+      end
+    end
+  end
+end

data/lib/tent-client/discovery.rb

@@ -0,0 +1,56 @@
+require 'nokogiri'
+
+class TentClient
+  class Discovery
+    attr_accessor :url, :profile_urls, :primary_profile_url, :profile
+
+    def initialize(client, url)
+      @client, @url = client, url
+    end
+
+    def http
+      @http ||= Faraday.new do |f|
+        f.response :follow_redirects
+        f.adapter *Array(@client.faraday_adapter)
+      end
+    end
+
+    def perform
+      @profile_urls = perform_head_discovery || perform_get_discovery || []
+      @profile_urls.map! { |l| l =~ %r{\A/} ? URI.join(url, l).to_s : l }
+    end
+
+    def get_profile
+      profile_urls.each do |url|
+        res = @client.http.get(url)
+        if res['Content-Type'].split(';').first == MEDIA_TYPE
+          @profile = res.body
+          @primary_profile_url = url
+          break
+        end
+      end
+      [@profile, @primary_profile_url.to_s.sub(%r{/profile$}, '')]
+    end
+
+    def perform_head_discovery
+      perform_header_discovery http.head(url)
+    end
+
+    def perform_get_discovery
+      res = http.get(url)
+      perform_header_discovery(res) || perform_html_discovery(res)
+    end
+
+    def perform_header_discovery(res)
+      if header = res['Link']
+        links = LinkHeader.parse(header).links.select { |l| l[:rel] == PROFILE_REL }.map { |l| l.uri }
+        links unless links.empty?
+      end
+    end
+
+    def perform_html_discovery(res)
+      return unless res['Content-Type'] == 'text/html'
+      Nokogiri::HTML(res.body).css(%(link[rel="#{PROFILE_REL}"])).map { |l| l['href'] }
+    end
+  end
+end

data/lib/tent-client/follower.rb

@@ -0,0 +1,37 @@
+class TentClient
+  class Follower
+    def initialize(client)
+      @client = client
+    end
+
+    def create(data)
+      @client.http.post 'followers', data
+    end
+
+    def count(params={})
+      @client.http.get('followers/count', params)
+    end
+
+    def list(params = {})
+      @client.http.get "followers", params
+    end
+
+    def get(id)
+      @client.http.get "followers/#{id}"
+    end
+
+    def update(id, data)
+      @client.http.put "followers/#{id}", data
+    end
+
+    def delete(id)
+      @client.http.delete "followers/#{id}"
+    end
+
+    def challenge(path)
+      str = SecureRandom.hex(32)
+      res = @client.http.get(path.sub(%r{\A/}, ''), :challenge => str)
+      res.status == 200 && res.body.match(/\A#{str}/)
+    end
+  end
+end

data/lib/tent-client/following.rb

@@ -0,0 +1,31 @@
+class TentClient
+  class Following
+    def initialize(client)
+      @client = client
+    end
+
+    def count(params={})
+      @client.http.get('followings/count', params)
+    end
+
+    def list(params = {})
+      @client.http.get 'followings', params
+    end
+
+    def update(id, data)
+      @client.http.put "followings/#{id}", data
+    end
+
+    def create(entity_uri)
+      @client.http.post 'followings', :entity => entity_uri.sub(%r{/$}, '')
+    end
+
+    def get(id)
+      @client.http.get "followings/#{id}"
+    end
+
+    def delete(id)
+      @client.http.delete "followings/#{id}"
+    end
+  end
+end

data/lib/tent-client/group.rb

@@ -0,0 +1,19 @@
+class TentClient
+  class Group
+    def initialize(client)
+      @client = client
+    end
+
+    def count(params={})
+      @client.http.get('groups/count', params)
+    end
+
+    def list(params)
+      @client.http.get('/groups', params)
+    end
+
+    def create(data)
+      @client.http.post('/groups', data)
+    end
+  end
+end

data/lib/tent-client/link_header.rb

@@ -0,0 +1,72 @@
+require 'uri'
+require 'strscan'
+
+class TentClient
+  class LinkHeader
+    attr_accessor :links
+
+    def self.parse(header)
+      new header.split(',').map { |l| Link.parse(l) }
+    end
+
+    def initialize(links)
+      @links = Array(links)
+    end
+
+    def to_s
+      links.map(&:to_s).join(', ')
+    end
+
+    class Link
+      attr_accessor :uri, :attributes
+
+      def self.parse(link_text)
+        s = StringScanner.new(link_text)
+        s.scan(/[^<]+/)
+        link = s.scan(/<[^\s]+>/)
+        link = link[1..-2]
+
+        s.scan(/[^a-z]+/)
+        attrs = {}
+        while attr = s.scan(/[a-z0-9*\-]+=/)
+          next if attr =~ /\*/
+          val = s.scan(/".+?"|[^\s";]+/).sub(/\A"/, '').sub(/"\Z/, '')
+          attrs[attr[0..-2]] = val
+          s.scan(/[^a-z]+/)
+        end
+        new(link, attrs)
+      end
+
+      def initialize(uri, attributes = {})
+        @uri = uri
+        @attributes = indifferent_hash(attributes)
+      end
+
+      def ==(other)
+        false unless is_a?(self.class)
+        uri == other.uri && attributes == other.attributes
+      end
+
+      def [](k)
+        attributes[k]
+      end
+
+      def []=(k, v)
+        attributes[k.to_s] = v.to_s
+      end
+
+      def to_s
+        attr_string = "; " + attributes.sort.map { |k,v| "#{k}=#{v.inspect}" }.join('; ') if attributes
+        "<#{uri}>#{attr_string}"
+      end
+
+      private
+
+      def indifferent_hash(old_hash)
+        new_hash = Hash.new {|hash,key| hash[key.to_s] if Symbol === key }
+        old_hash.each { |k,v| new_hash[k.to_s] = v.to_s }
+        new_hash
+      end
+    end
+  end
+end

data/lib/tent-client/middleware/accept_header.rb

@@ -0,0 +1,14 @@
+class TentClient
+  module Middleware
+    class AcceptHeader
+      def initialize(app)
+        @app = app
+      end
+
+      def call(env)
+        env[:request_headers]['Accept'] ||= MEDIA_TYPE
+        @app.call(env)
+      end
+    end
+  end
+end

data/lib/tent-client/middleware/encode_json.rb

@@ -0,0 +1,48 @@
+require 'faraday_middleware'
+
+class TentClient
+  module Middleware
+    # FaradayMiddleware::EncodeJson with our media type
+    # https://github.com/pengwynn/faraday_middleware/blob/master/lib/faraday_middleware/request/encode_json.rb
+    class EncodeJson < Faraday::Middleware
+      CONTENT_TYPE = 'Content-Type'.freeze
+
+      dependency do
+        require 'oj' unless defined?(::Oj)
+      end
+
+      def call(env)
+        match_content_type(env) do |data|
+          env[:body] = encode data
+        end
+        @app.call env
+      end
+
+      def encode(data)
+        ::Oj.dump data
+      end
+
+      def match_content_type(env)
+        if process_request?(env)
+          env[:request_headers][CONTENT_TYPE] ||= MEDIA_TYPE
+          yield env[:body] unless env[:body].respond_to?(:to_str)
+        end
+      end
+
+      def process_request?(env)
+        type = request_type(env)
+        has_body?(env) and (type.empty? or type == MEDIA_TYPE)
+      end
+
+      def has_body?(env)
+        body = env[:body] and !(body.respond_to?(:to_str) and body.empty?)
+      end
+
+      def request_type(env)
+        type = env[:request_headers][CONTENT_TYPE].to_s
+        type = type.split(';', 2).first if type.index(';')
+        type
+      end
+    end
+  end
+end

data/lib/tent-client/middleware/mac_auth.rb

@@ -0,0 +1,50 @@
+require 'openssl'
+require 'base64'
+require 'securerandom'
+
+class TentClient
+  module Middleware
+    class MacAuth
+      def initialize(app, options={})
+        @app, @mac_key_id, @mac_key, @mac_algorithm = app, options[:mac_key_id], options[:mac_key], options[:mac_algorithm]
+      end
+
+      def call(env)
+        sign_request(env) if auth_enabled?
+        @app.call(env)
+      end
+
+      private
+
+      def auth_enabled?
+        @mac_key_id && @mac_key && @mac_algorithm
+      end
+
+      def sign_request(env)
+        time = Time.now.to_i
+        nonce = SecureRandom.hex(3)
+        request_string = build_request_string(time, nonce, env)
+        signature = Base64.encode64(OpenSSL::HMAC.digest(openssl_digest.new, @mac_key, request_string)).sub("\n", '')
+        env[:request_headers]['Authorization'] = build_auth_header(time, nonce, signature)
+      end
+
+      def build_request_string(time, nonce, env)
+        if env[:body].respond_to?(:read)
+           body = env[:body].read
+           env[:body].rewind
+        else
+          body = env[:body]
+        end
+        [time.to_s, nonce, env[:method].to_s.upcase, env[:url].request_uri, env[:url].host, env[:url].port || env[:url].inferred_port, body, nil].join("\n")
+      end
+
+      def build_auth_header(time, nonce, signature)
+        %Q(MAC id="#{@mac_key_id}", ts="#{time}", nonce="#{nonce}", mac="#{signature}")
+      end
+
+      def openssl_digest
+        @openssl_digest ||= OpenSSL::Digest.const_get(@mac_algorithm.to_s.gsub(/hmac|-/, '').upcase)
+      end
+    end
+  end
+end

data/lib/tent-client/post.rb

@@ -0,0 +1,66 @@
+class TentClient
+  class Post
+    MULTIPART_TYPE = 'multipart/form-data'.freeze
+    MULTIPART_BOUNDARY = "-----------TentAttachment".freeze
+
+    def initialize(client)
+      @client = client
+    end
+
+    def count(params={})
+      @client.http.get('posts/count', params)
+    end
+
+    def list(params = {})
+      @client.http.get('posts', params)
+    end
+
+    def create(post, options={})
+      if options[:attachments]
+        multipart_post(post, options, options.delete(:attachments))
+      else
+        @client.http.post(options[:url] || 'posts', post)
+      end
+    end
+
+    def get(id)
+      @client.http.get("posts/#{id}")
+    end
+
+    def delete(id)
+      @client.http.delete("posts/#{id}")
+    end
+
+    def attachment
+      PostAttachment.new(@client)
+    end
+
+    private
+
+    def multipart_post(post, options, attachments)
+      post_body = { :category => 'post', :filename => 'post.json', :type => MEDIA_TYPE, :data => post.to_json }
+      body = multipart_body(attachments.unshift(post_body))
+      @client.http.post(options[:url] || 'posts', body, 'Content-Type' => "#{MULTIPART_TYPE};boundary=#{MULTIPART_BOUNDARY}")
+    end
+
+    def multipart_body(attachments)
+      parts = attachments.inject({}) { |h,a|
+        (h[a[:category]] ||= []) << a; h
+      }.inject([]) { |a,(category,attachments)|
+        if attachments.size > 1
+          a += attachments.each_with_index.map { |attachment,i|
+            Faraday::Parts::FilePart.new(MULTIPART_BOUNDARY, "#{category}[#{i}]", attachment_io(attachment))
+          }
+        else
+          a << Faraday::Parts::FilePart.new(MULTIPART_BOUNDARY, category, attachment_io(attachments.first))
+        end
+        a
+      } << Faraday::Parts::EpiloguePart.new(MULTIPART_BOUNDARY)
+      Faraday::CompositeReadIO.new(parts)
+    end
+
+    def attachment_io(attachment)
+      Faraday::UploadIO.new(attachment[:file] || StringIO.new(attachment[:data]), attachment[:type], attachment[:filename])
+    end
+  end
+end

data/lib/tent-client/post_attachment.rb

@@ -0,0 +1,11 @@
+class TentClient
+  class PostAttachment
+    def initialize(client)
+      @client = client
+    end
+
+    def get(post_id, filename, type)
+      @client.http.get("posts/#{post_id}/attachments/#{filename}", {}, { 'Accept' => type })
+    end
+  end
+end

data/lib/tent-client/profile.rb

@@ -0,0 +1,17 @@
+class TentClient
+  class Profile
+    attr_accessor :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def update(type, data)
+      @client.http.put "profile/#{URI.encode_www_form_component(type)}", data
+    end
+
+    def get
+      @client.http.get 'profile'
+    end
+  end
+end

data/lib/tent-client/version.rb

@@ -0,0 +1,3 @@
+class TentClient
+  VERSION = '0.0.1'
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'bundler/setup'
+require 'mocha_standalone'
+require 'tent-client'
+require 'oj'
+
+Dir["#{File.dirname(__FILE__)}/support/*.rb"].each { |f| require f }
+
+RSpec.configure do |config|
+  config.mock_with :mocha
+end

data/spec/unit/cycle_http_spec.rb

@@ -0,0 +1,84 @@
+require 'spec_helper'
+
+describe TentClient::CycleHTTP do
+
+  let(:http_stubs) { Faraday::Adapter::Test::Stubs.new }
+  let(:client_options) { Hash.new }
+  let(:server_urls) { %w{ http://alex.example.org/tent http://alexsmith.example.com/tent http://smith.example.com/tent } }
+  let(:client) { TentClient.new(server_urls, client_options) }
+
+  def expect_server(env, url)
+    expect(env[:url].to_s).to match(url)
+  end
+
+  it 'should proxy http verbs to Faraday' do
+    http_stubs.get('/tent/foo/bar') { |env|
+      expect_server(env, server_urls.first)
+      [200, {}, '']
+    }
+
+    cycle_http = described_class.new(client) do |f|
+      f.adapter :test, http_stubs
+    end
+
+    %w{ head get put patch post delete options }.each { |verb|
+      expect(cycle_http).to respond_to(verb)
+    }
+
+    cycle_http.get('foo/bar')
+
+    http_stubs.verify_stubbed_calls
+  end
+
+  it 'should retry http with next server url' do
+    http_stubs.get('/tent/foo/bar') { |env|
+      expect_server(env, server_urls.first)
+      [500, {}, '']
+    }
+
+    http_stubs.get('/tent/foo/bar') { |env|
+      expect_server(env, server_urls[1])
+      [300, {}, '']
+    }
+
+    http_stubs.get('/tent/foo/bar') { |env|
+      expect_server(env, server_urls.last)
+      [200, {}, '']
+    }
+
+    cycle_http = described_class.new(client) do |f|
+      f.adapter :test, http_stubs
+    end
+
+    cycle_http.get('foo/bar')
+
+    http_stubs.verify_stubbed_calls
+  end
+
+  it 'should return response when on last server url' do
+    http_stubs.get('/tent/foo/bar') { |env|
+      expect_server(env, server_urls.first)
+      [500, {}, '']
+    }
+
+    http_stubs.get('/tent/foo/bar') { |env|
+      expect_server(env, server_urls[1])
+      [500, {}, '']
+    }
+
+    http_stubs.get('/tent/foo/bar') { |env|
+      expect_server(env, server_urls.last)
+      [300, {}, '']
+    }
+
+    http_stubs.get('/tent/foo/bar') { |env|
+      raise StandardError, 'expected stub not be called bus was'
+    }
+
+    cycle_http = described_class.new(client) do |f|
+      f.adapter :test, http_stubs
+    end
+
+    cycle_http.get('foo/bar')
+  end
+end

data/spec/unit/discovery_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe TentClient::Discovery do
+  LINK_HEADER = %(<https://example.com/tent/profile>; rel="%s") % TentClient::PROFILE_REL
+  LINK_TAG_HTML = %(<html><head><link href="https://example.com/tent/profile" rel="%s" /></head</html>) % TentClient::PROFILE_REL
+  TENT_PROFILE = %({"https://tent.io/types/info/core/v0.1.0":{"licenses":["http://creativecommons.org/licenses/by/3.0/"],"entity":"https://example.com","servers":["https://example.com/tent"]}})
+
+  let(:http_stubs) { Faraday::Adapter::Test::Stubs.new }
+  let(:client) { TentClient.new(nil, :faraday_adapter => [:test, http_stubs]) }
+
+  it 'should discover profile urls via a link header' do
+    http_stubs.head('/') { [200, { 'Link' => LINK_HEADER }, ''] }
+
+    discovery = described_class.new(client, 'http://example.com/')
+    discovery.perform.should eq(['https://example.com/tent/profile'])
+  end
+
+  it 'should discover profile urls via a link html tag' do
+    http_stubs.head('/') { [200, { 'Content-Type' => 'text/html' }, ''] }
+    http_stubs.get('/') { [200, { 'Content-Type' => 'text/html' }, LINK_TAG_HTML] }
+
+    discovery = described_class.new(client, 'http://example.com/')
+    discovery.perform.should eq(['https://example.com/tent/profile'])
+  end
+
+  it 'should work with relative urls' do
+    http_stubs.head('/') { [200, { 'Link' => LINK_HEADER.sub(%r{https://example.com}, '') }, ''] }
+
+    discovery = described_class.new(client, 'http://example.com/')
+    discovery.perform.should eq(['http://example.com/tent/profile'])
+  end
+
+  it 'should fetch a profile' do
+    http_stubs.head('/') { [200, { 'Link' => LINK_HEADER }, ''] }
+    http_stubs.get('/tent/profile') { [200, { 'Content-Type' => TentClient::MEDIA_TYPE }, TENT_PROFILE] }
+    discovery = described_class.new(client, 'http://example.com/')
+    discovery.perform
+    discovery.get_profile.should eq([Oj.load(TENT_PROFILE), "https://example.com/tent"])
+  end
+
+  it 'should delegate TentClient.discover' do
+    instance = mock(:perform => 1)
+    described_class.expects(:new).with(client, 'url').returns(instance)
+    client.discover('url').should eq(instance)
+  end
+end

data/spec/unit/link_header_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe TentClient::LinkHeader do
+  def new_link(link, attrs={})
+    TentClient::LinkHeader::Link.new(link, attrs)
+  end
+  it 'should parse a simple link' do
+    link_header = %Q(<http://example.com/TheBook/chapter2>; rel="previous";\n    title="previous chapter")
+    expected_link = new_link('http://example.com/TheBook/chapter2', :rel => 'previous', :title => 'previous chapter')
+    described_class.parse(link_header).links.first.should eq(expected_link)
+  end
+
+  it 'should ignore utf-8 attributes' do
+    link_header = %Q(</TheBook/chapter2>;\n rel="previous"; title*=UTF-8'de'letztes%20Kapitel,\n </TheBook/chapter4>;\n rel="next"; title*=UTF-8'de'n%c3%a4chstes%20Kapitel)
+    expected_links = [new_link('/TheBook/chapter2', :rel => 'previous'), new_link('/TheBook/chapter4', :rel => 'next')]
+    described_class.parse(link_header).links.should eq(expected_links)
+  end
+
+  it 'should convert a link header to a string' do
+    expected_header = %Q(<https://example.com/tent/profile>; rel="profile"; type="application/vnd.tent.profile+json")
+    link = new_link('https://example.com/tent/profile', :rel => 'profile', :type => 'application/vnd.tent.profile+json')
+    described_class.new(link).to_s.should eq(expected_header)
+  end
+end

data/spec/unit/middleware/mac_auth_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+
+describe TentClient::Middleware::MacAuth do
+  def auth_header(env)
+    env[:request_headers]['Authorization']
+  end
+
+  def perform(path = '', method = :get, body = nil)
+    make_app.call({
+      :url => URI('http://example.com' + path),
+      :method => method,
+      :request_headers => {},
+      :body => body
+    })
+  end
+
+  def make_app
+    described_class.new(lambda{ |env| env }, options)
+  end
+
+  context 'not configured' do
+    let(:options) { {} }
+
+    it "doesn't add a header" do
+      auth_header(perform).should be_nil
+    end
+  end
+
+  context 'configured' do
+    let(:options) { { :mac_key_id => 'h480djs93hd8', :mac_key => '489dks293j39', :mac_algorithm => 'hmac-sha-1' } }
+    let(:expected_header) { 'MAC id="h480djs93hd8", ts="1336363200", nonce="dj83hs9s", mac="%s"' }
+    before do
+      Time.expects(:now).returns(stub(:to_i => 1336363200))
+      SecureRandom.expects(:hex).with(3).returns('dj83hs9s')
+    end
+
+    it 'signs a GET request with no body' do
+      auth_header(perform('/resource/1?b=1&a=2')).should eq(expected_header % '6T3zZzy2Emppni6bzL7kdRxUWL4=')
+    end
+
+    it 'signs POST request with body' do
+      auth_header(perform('/resource/1?b=1&a=2', :post, "asdf\nasdf")).should ==
+        expected_header % 'hqpo01mLJLSYDbxmfRgNMEw38Wg='
+    end
+
+    it 'signs POST request with a readable body' do
+      io = StringIO.new("asdf\nasdf")
+      auth_header(perform('/resource/1?b=1&a=2', :post, io)).should == 
+        expected_header % 'hqpo01mLJLSYDbxmfRgNMEw38Wg='
+      io.eof?.should be_false
+    end
+  end
+
+  context 'faraday middleware' do
+    let(:options) { { :mac_key_id => 'h480djs93hd8', :mac_key => '489dks293j39', :mac_algorithm => 'hmac-sha-1' } }
+    let(:http_stub) {
+      Faraday::Adapter::Test::Stubs.new do |s|
+        s.post('/') { [200, {}, ''] }
+      end
+    }
+    let(:client) { TentClient.new('http://example.com', options.merge(:faraday_adapter => [:test, http_stub])) }
+
+    it "should be part of the client middleware stack" do
+      client.http.post('/', :foo => 'bar').env[:request_headers]['Authorization'].should =~ /\AMAC/
+    end
+  end
+end

data/tent-client.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tent-client/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "tent-client"
+  gem.version       = TentClient::VERSION
+  gem.authors       = ["Jonathan Rudenberg", "Jesse Stuart"]
+  gem.email         = ["jonathan@titanous.com", "jessestuart@gmail.com"]
+  gem.description   = %q{Tent Protocol client}
+  gem.summary       = %q{Tent Protocol client}
+  gem.homepage      = "http://tent.io"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_runtime_dependency 'faraday', '0.8.4'
+  gem.add_runtime_dependency 'faraday_middleware', '0.8.8'
+  gem.add_runtime_dependency 'nokogiri'
+  gem.add_runtime_dependency 'oj'
+  gem.add_runtime_dependency 'faraday_middleware-multi_json'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'bundler'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'guard-rspec'
+  gem.add_development_dependency 'mocha'
+end

metadata

@@ -0,0 +1,248 @@
+--- !ruby/object:Gem::Specification
+name: tent-client
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Jonathan Rudenberg
+- Jesse Stuart
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.4
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.8
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware-multi_json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Tent Protocol client
+email:
+- jonathan@titanous.com
+- jessestuart@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/tent-client.rb
+- lib/tent-client/app.rb
+- lib/tent-client/app_authorization.rb
+- lib/tent-client/cycle_http.rb
+- lib/tent-client/discovery.rb
+- lib/tent-client/follower.rb
+- lib/tent-client/following.rb
+- lib/tent-client/group.rb
+- lib/tent-client/link_header.rb
+- lib/tent-client/middleware/accept_header.rb
+- lib/tent-client/middleware/encode_json.rb
+- lib/tent-client/middleware/mac_auth.rb
+- lib/tent-client/post.rb
+- lib/tent-client/post_attachment.rb
+- lib/tent-client/profile.rb
+- lib/tent-client/version.rb
+- spec/spec_helper.rb
+- spec/unit/cycle_http_spec.rb
+- spec/unit/discovery_spec.rb
+- spec/unit/link_header_spec.rb
+- spec/unit/middleware/mac_auth_spec.rb
+- tent-client.gemspec
+homepage: http://tent.io
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2628975409218371797
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2628975409218371797
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Tent Protocol client
+test_files:
+- spec/spec_helper.rb
+- spec/unit/cycle_http_spec.rb
+- spec/unit/discovery_spec.rb
+- spec/unit/link_header_spec.rb
+- spec/unit/middleware/mac_auth_spec.rb