rest-core 0.0.1

data/lib/rest-core/util/hmac.rb

@@ -0,0 +1,22 @@
+
+require 'openssl'
+
+module RestCore; end
+module RestCore::Hmac
+  module_function
+  # Fallback to ruby-hmac gem in case system openssl
+  # lib doesn't support SHA256 (OSX 10.5)
+  def sha256 key, data
+    OpenSSL::HMAC.digest('sha256', key, data)
+  rescue RuntimeError
+    require 'hmac-sha2'
+    HMAC::SHA256.digest(key, data)
+  end
+
+  def sha1 key, data
+    OpenSSL::HMAC.digest('sha1', key, data)
+  rescue RuntimeError
+    require 'hmac-sha1'
+    HMAC::SHA1.digest(key, data)
+  end
+end

data/lib/rest-core/version.rb

@@ -0,0 +1,4 @@
+
+module RestCore
+  VERSION = '0.0.1'
+end

data/lib/rest-core/wrapper.rb

@@ -0,0 +1,55 @@
+
+require 'rest-core'
+
+module RestCore::Wrapper
+  include RestCore
+  def self.included mod
+    mod.send(:attr_reader, :init, :middles, :wrapped)
+  end
+
+  def initialize &block
+    @middles ||= []
+    instance_eval(&block) if block_given?
+    @wrapped ||= to_app(@init || Ask)
+  end
+
+  def use middle, *args, &block
+    middles << [middle, args, block]
+  end
+
+  def run app
+    @init = app
+  end
+
+  def members
+    middles.map{ |(middle, args, block)|
+      if middle.public_method_defined?(:wrapped)
+        # TODO: this is hacky... try to avoid calling new!
+        middle.members + middle.new(Ask.new, *args, &block).members
+      else
+        middle.members
+      end
+    }.flatten
+  end
+
+  def to_app init=@init
+    # === foldr m.new app middles
+    middles.reverse.inject(init.new){ |app_, (middle, args, block)|
+      begin
+        middle.new(app_, *partial_deep_copy(args), &block)
+      rescue ArgumentError => e
+        raise ArgumentError.new("#{middle}: #{e}")
+      end
+    }
+  end
+
+  module_function
+  def partial_deep_copy obj
+    case obj
+      when Array; obj.map{ |o| partial_deep_copy(o) }
+      when Hash ; obj.inject({}){ |r, (k, v)| r[k] = partial_deep_copy(v); r }
+      when Numeric, Symbol, TrueClass, FalseClass, NilClass; obj
+      else begin obj.dup; rescue TypeError; obj; end
+    end
+  end
+end

data/lib/rest-graph/config_util.rb

@@ -0,0 +1,43 @@
+
+require 'erb'
+require 'yaml'
+
+require 'rest-graph/core'
+
+module RestGraph::ConfigUtil
+  extend self
+
+  def load_config_for_all
+    RestGraph::ConfigUtil.load_config_for_rails if
+      Object.const_defined?(:Rails)
+  end
+
+  def load_config_for_rails app=Rails
+    root = app.root
+    file = ["#{root}/config/rest-graph.yaml", # YAML should use .yaml
+            "#{root}/config/rest-graph.yml"].find{|path| File.exist?(path)}
+    return unless file
+
+    RestGraph::ConfigUtil.load_config(file, Rails.env)
+  end
+
+  def load_config file, env
+    config   = YAML.load(ERB.new(File.read(file)).result(binding))
+    defaults = config[env]
+    return unless defaults
+
+    mod = Module.new
+    mod.module_eval(defaults.inject([]){ |r, (k, v)|
+      # quote strings, leave others free (e.g. false, numbers, etc)
+      r << <<-RUBY
+        def default_#{k}
+          #{v.kind_of?(String) ? "'#{v}'" : v}
+        end
+      RUBY
+    }.join, __FILE__, __LINE__)
+
+    RestGraph.send(:extend, mod)
+  end
+end
+
+RestGraph.send(:extend, RestGraph::ConfigUtil)

data/rest-core.gemspec

@@ -0,0 +1,162 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rest-core}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = [
+  %q{Cardinal Blue},
+  %q{Lin Jen-Shin (godfat)}]
+  s.date = %q{2011-08-16}
+  s.description = %q{A modular Ruby REST client collection/infrastructure.
+
+In this era of web services and mashups, we have seen a blooming of REST
+APIs. One might wonder, how do we use these APIs easily and elegantly?
+Since REST is very simple compared to SOAP, it is not hard to build a
+dedicated client ourselves.
+
+We have developed [rest-core][] with composable middlewares to build a
+REST client, based on the effort from [rest-graph][]. In the cases of
+common APIs such as Facebook, Github, and Twitter, developers can simply
+use the built-in dedicated clients provided by rest-core, or do it yourself
+for any other REST APIs.
+
+[rest-core]: http://github.com/cardinalblue/rest-core
+[rest-graph]: http://github.com/cardinalblue/rest-graph}
+  s.email = [%q{dev (XD) cardinalblue.com}]
+  s.extra_rdoc_files = [
+  %q{CONTRIBUTORS},
+  %q{LICENSE},
+  %q{TODO.md},
+  %q{CONTRIBUTORS}]
+  s.files = [
+  %q{.gitignore},
+  %q{.gitmodules},
+  %q{.travis.yml},
+  %q{CONTRIBUTORS},
+  %q{Gemfile},
+  %q{LICENSE},
+  %q{NOTE.md},
+  %q{README},
+  %q{README.md},
+  %q{Rakefile},
+  %q{TODO.md},
+  %q{example/facebook.rb},
+  %q{example/github.rb},
+  %q{lib/rest-core.rb},
+  %q{lib/rest-core/app/ask.rb},
+  %q{lib/rest-core/app/rest-client.rb},
+  %q{lib/rest-core/builder.rb},
+  %q{lib/rest-core/client.rb},
+  %q{lib/rest-core/client/github.rb},
+  %q{lib/rest-core/client/linkedin.rb},
+  %q{lib/rest-core/client/rest-graph.rb},
+  %q{lib/rest-core/client/twitter.rb},
+  %q{lib/rest-core/client_oauth1.rb},
+  %q{lib/rest-core/event.rb},
+  %q{lib/rest-core/middleware.rb},
+  %q{lib/rest-core/middleware/cache.rb},
+  %q{lib/rest-core/middleware/common_logger.rb},
+  %q{lib/rest-core/middleware/default_headers.rb},
+  %q{lib/rest-core/middleware/default_query.rb},
+  %q{lib/rest-core/middleware/default_site.rb},
+  %q{lib/rest-core/middleware/defaults.rb},
+  %q{lib/rest-core/middleware/error_detector.rb},
+  %q{lib/rest-core/middleware/error_detector_http.rb},
+  %q{lib/rest-core/middleware/error_handler.rb},
+  %q{lib/rest-core/middleware/json_decode.rb},
+  %q{lib/rest-core/middleware/oauth1_header.rb},
+  %q{lib/rest-core/middleware/oauth2_query.rb},
+  %q{lib/rest-core/middleware/timeout.rb},
+  %q{lib/rest-core/util/hmac.rb},
+  %q{lib/rest-core/version.rb},
+  %q{lib/rest-core/wrapper.rb},
+  %q{lib/rest-graph/config_util.rb},
+  %q{rest-core.gemspec},
+  %q{task/.gitignore},
+  %q{task/gemgem.rb},
+  %q{test/common.rb},
+  %q{test/config/rest-graph.yaml},
+  %q{test/pending/test_load_config.rb},
+  %q{test/pending/test_multi.rb},
+  %q{test/pending/test_test_util.rb},
+  %q{test/test_api.rb},
+  %q{test/test_cache.rb},
+  %q{test/test_default.rb},
+  %q{test/test_error.rb},
+  %q{test/test_handler.rb},
+  %q{test/test_misc.rb},
+  %q{test/test_oauth.rb},
+  %q{test/test_oauth1_header.rb},
+  %q{test/test_old.rb},
+  %q{test/test_page.rb},
+  %q{test/test_parse.rb},
+  %q{test/test_rest-graph.rb},
+  %q{test/test_serialize.rb},
+  %q{test/test_timeout.rb}]
+  s.homepage = %q{https://github.com/cardinalblue/rest-core}
+  s.rdoc_options = [
+  %q{--main},
+  %q{README}]
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.7}
+  s.summary = %q{A modular Ruby REST client collection/infrastructure.}
+  s.test_files = [
+  %q{test/pending/test_load_config.rb},
+  %q{test/pending/test_multi.rb},
+  %q{test/pending/test_test_util.rb},
+  %q{test/test_api.rb},
+  %q{test/test_cache.rb},
+  %q{test/test_default.rb},
+  %q{test/test_error.rb},
+  %q{test/test_handler.rb},
+  %q{test/test_misc.rb},
+  %q{test/test_oauth.rb},
+  %q{test/test_oauth1_header.rb},
+  %q{test/test_old.rb},
+  %q{test/test_page.rb},
+  %q{test/test_parse.rb},
+  %q{test/test_rest-graph.rb},
+  %q{test/test_serialize.rb},
+  %q{test/test_timeout.rb}]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rest-client>, [">= 0"])
+      s.add_development_dependency(%q<rack>, [">= 0"])
+      s.add_development_dependency(%q<yajl-ruby>, [">= 0"])
+      s.add_development_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<json_pure>, [">= 0"])
+      s.add_development_dependency(%q<ruby-hmac>, [">= 0"])
+      s.add_development_dependency(%q<webmock>, [">= 0"])
+      s.add_development_dependency(%q<bacon>, [">= 0"])
+      s.add_development_dependency(%q<rr>, [">= 0"])
+      s.add_development_dependency(%q<rake>, [">= 0"])
+    else
+      s.add_dependency(%q<rest-client>, [">= 0"])
+      s.add_dependency(%q<rack>, [">= 0"])
+      s.add_dependency(%q<yajl-ruby>, [">= 0"])
+      s.add_dependency(%q<json>, [">= 0"])
+      s.add_dependency(%q<json_pure>, [">= 0"])
+      s.add_dependency(%q<ruby-hmac>, [">= 0"])
+      s.add_dependency(%q<webmock>, [">= 0"])
+      s.add_dependency(%q<bacon>, [">= 0"])
+      s.add_dependency(%q<rr>, [">= 0"])
+      s.add_dependency(%q<rake>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rest-client>, [">= 0"])
+    s.add_dependency(%q<rack>, [">= 0"])
+    s.add_dependency(%q<yajl-ruby>, [">= 0"])
+    s.add_dependency(%q<json>, [">= 0"])
+    s.add_dependency(%q<json_pure>, [">= 0"])
+    s.add_dependency(%q<ruby-hmac>, [">= 0"])
+    s.add_dependency(%q<webmock>, [">= 0"])
+    s.add_dependency(%q<bacon>, [">= 0"])
+    s.add_dependency(%q<rr>, [">= 0"])
+    s.add_dependency(%q<rake>, [">= 0"])
+  end
+end

data/task/.gitignore

@@ -0,0 +1 @@
+*.rbc

data/task/gemgem.rb

@@ -0,0 +1,184 @@
+
+require 'pathname'
+
+module Gemgem
+  class << self
+    attr_accessor :dir, :spec
+  end
+
+  module_function
+  def create
+    yield(spec = Gem::Specification.new{ |s|
+      s.authors     = ['Lin Jen-Shin (godfat)']
+      s.email       = ['godfat (XD) godfat.org']
+
+      description   = File.read("#{Gemgem.dir}/README").
+                      match(/DESCRIPTION:\n\n(.+?)(?=\n\n[^\n]+:\n)/m)[1].
+                      lines.to_a
+
+      s.description = description.join
+      s.summary     = description.first
+
+      s.extra_rdoc_files = %w[CHANGES    TODO    CONTRIBUTORS LICENSE
+                              CHANGES.md TODO.md CONTRIBUTORS].select{ |f|
+                             File.exist?(f) }
+      s.rdoc_options     = %w[--main README]
+      s.rubygems_version = Gem::VERSION
+      s.date             = Time.now.strftime('%Y-%m-%d')
+      s.files            = gem_files
+      s.test_files       = gem_files.grep(%r{^test/(.+?/)*test_.+?\.rb$})
+      s.executables      = Dir['bin/*'].map{ |f| File.basename(f) }
+      s.require_paths    = %w[lib]
+    })
+    spec.homepage ||= "https://github.com/godfat/#{spec.name}"
+    spec
+  end
+
+  def gem_tag
+    "#{spec.name}-#{spec.version}"
+  end
+
+  def write
+    File.open("#{dir}/#{spec.name}.gemspec", 'w'){ |f|
+      f << split_lines(spec.to_ruby) }
+  end
+
+  def split_lines ruby
+    ruby.gsub(/(.+?)\[(.+?)\]/){ |s|
+      if $2.index(',')
+        "#{$1}[\n  #{$2.split(',').map(&:strip).join(",\n  ")}]"
+      else
+        s
+      end
+    }
+  end
+
+  def all_files
+    @all_files ||= find_files(Pathname.new(dir)).map{ |file|
+      if file.to_s =~ %r{\.git/}
+        nil
+      else
+        file.to_s
+      end
+    }.compact.sort
+  end
+
+  def gem_files
+    @gem_files ||= all_files - ignored_files
+  end
+
+  def ignored_files
+    @ignored_file ||= all_files.select{ |path| ignore_patterns.find{ |ignore|
+      path =~ ignore && !git_files.include?(path)}}
+  end
+
+  def git_files
+    @git_files ||= if File.exist?("#{dir}/.git")
+                     `git ls-files`.split("\n")
+                   else
+                     []
+                   end
+  end
+
+  # protected
+  def find_files path
+    path.children.select(&:file?).map{|file| file.to_s[(dir.size+1)..-1]} +
+    path.children.select(&:directory?).map{|dir| find_files(dir)}.flatten
+  end
+
+  def ignore_patterns
+    @ignore_files ||= expand_patterns(
+      File.read("#{dir}/.gitignore").split("\n").reject{ |pattern|
+        pattern.strip == ''
+      }).map{ |pattern| %r{^([^/]+/)*?#{Regexp.escape(pattern)}(/[^/]+)*?$} }
+  end
+
+  def expand_patterns pathes
+    pathes.map{ |path|
+      if path !~ /\*/
+        path
+      else
+        expand_patterns(
+          Dir[path] +
+          Pathname.new(File.dirname(path)).children.select(&:directory?).
+            map{ |prefix| "#{prefix}/#{File.basename(path)}" })
+      end
+    }.flatten
+  end
+end
+
+namespace :gem do
+
+desc 'Install gem'
+task :install => [:build] do
+  sh("#{Gem.ruby} -S gem install pkg/#{Gemgem.gem_tag}")
+end
+
+desc 'Build gem'
+task :build => [:spec] do
+  sh("#{Gem.ruby} -S gem build #{Gemgem.spec.name}.gemspec")
+  sh("mkdir -p pkg")
+  sh("mv #{Gemgem.gem_tag}.gem pkg/")
+end
+
+desc 'Release gem'
+task :release => [:spec, :check, :build] do
+  sh("git tag #{Gemgem.gem_tag}")
+  sh("git push")
+  sh("git push --tags")
+  sh("#{Gem.ruby} -S gem push pkg/#{Gemgem.gem_tag}.gem")
+end
+
+task :check do
+  ver = Gemgem.spec.version.to_s
+
+  if ENV['VERSION'].nil?
+    puts("\x1b[35mExpected "                                        \
+         "\x1b[33mVERSION\x1b[35m=\x1b[33m#{ver}\x1b[m")
+    exit(1)
+
+  elsif ENV['VERSION'] != ver
+    puts("\x1b[35mExpected \x1b[33mVERSION\x1b[35m=\x1b[33m#{ver} " \
+         "\x1b[35mbut got\n         "                               \
+         "\x1b[33mVERSION\x1b[35m=\x1b[33m#{ENV['VERSION']}\x1b[m")
+    exit(2)
+  end
+end
+
+end # of gem namespace
+
+desc 'Run tests in memory'
+task :test do
+  require 'bacon'
+  Bacon.extend(Bacon::TestUnitOutput)
+  Bacon.summary_on_exit
+  $LOAD_PATH.unshift('lib')
+  Dir['test/**/test_*.rb'].each{ |file| load file }
+end
+
+desc 'Run tests with shell'
+task 'test:shell', :RUBY_OPTS do |t, args|
+  files = Dir['test/**/test_*.rb'].join(' ')
+
+  cmd = [Gem.ruby, args[:RUBY_OPTS],
+         '-I', 'lib', '-S', 'bacon', '--quiet', files]
+
+  sh(cmd.compact.join(' '))
+end
+
+desc 'Generate rdoc'
+task :doc => ['gem:spec'] do
+  sh("yardoc -o rdoc --main README.md" \
+     " --files #{Gemgem.spec.extra_rdoc_files.join(',')}")
+end
+
+desc 'Removed ignored files'
+task :clean => ['gem:spec'] do
+  trash = "~/.Trash/#{Gemgem.spec.name}/"
+  sh "mkdir -p #{trash}" unless File.exist?(File.expand_path(trash))
+  Gemgem.ignored_files.each{ |file| sh "mv #{file} #{trash}" }
+end
+
+task :default do
+  puts `#{Gem.ruby} -S #{$PROGRAM_NAME} -T`
+end