rest-builder 0.9.0

data/lib/rest-builder/promise.rb

@@ -0,0 +1,35 @@
+
+require 'promise_pool/promise'
+
+module RestBuilder
+  class Promise < PromisePool::Promise
+    class Future < PromisePool::Future
+      def initialize promise, key
+        super(promise)
+        @key = key
+      end
+
+      def method_missing msg, *args, &block
+        @promise.yield[@key].__send__(msg, *args, &block)
+      end
+
+      def respond_to_missing? msg, *args, &block
+        @promise.yield[@key].respond_to?(msg, *args, &block)
+      end
+    end
+
+    def future_status  ; Future.new(self, RESPONSE_STATUS ); end
+    def future_headers ; Future.new(self, RESPONSE_HEADERS); end
+    def future_body    ; Future.new(self, RESPONSE_BODY   ); end
+    def future_socket  ; Future.new(self, RESPONSE_SOCKET ); end
+    def future_failures; Future.new(self, FAIL            ); end
+    def future_response
+      {RESPONSE_STATUS  => future_status  ,
+       RESPONSE_HEADERS => future_headers ,
+       RESPONSE_BODY    => future_body    ,
+       RESPONSE_SOCKET  => future_socket  ,
+       FAIL             => future_failures,
+       PROMISE          => self}
+    end
+  end
+end

data/lib/rest-builder/test.rb

@@ -0,0 +1,26 @@
+
+require 'rest-builder'
+
+require 'pork/auto'
+require 'muack'
+require 'webmock'
+
+WebMock.disable_net_connect!(:allow_localhost => true)
+Pork::Executor.include(Muack::API, WebMock::API)
+
+class Pork::Executor
+  def with_img
+    f = Tempfile.new(['img', '.jpg'])
+    n = File.basename(f.path)
+    f.write('a'*10)
+    f.rewind
+    yield(f, n)
+  ensure
+    f.close!
+  end
+
+  def stub_select_for_stringio
+    stub(IO).select(where([is_a(StringIO)]), [], [],
+                    RestBuilder::EventSource::READ_WAIT){ |rd, *| rd }
+  end
+end

data/lib/rest-builder/version.rb

@@ -0,0 +1,4 @@
+
+module RestBuilder
+  VERSION = '0.9.0'
+end

data/rest-builder.gemspec

@@ -0,0 +1,73 @@
+# -*- encoding: utf-8 -*-
+# stub: rest-builder 0.9.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "rest-builder"
+  s.version = "0.9.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Lin Jen-Shin (godfat)"]
+  s.date = "2016-01-31"
+  s.description = "Modular Ruby clients interface for REST APIs.\n\nBuild your own API clients for less dependencies, less codes, less memory,\nless conflicts, and run faster. Checkout [rest-core][] for pre-built\nmiddleware and [rest-more][] for pre-built clients.\n\n[rest-core]: https://github.com/godfat/rest-core\n[rest-more]: https://github.com/godfat/rest-more"
+  s.email = ["godfat (XD) godfat.org"]
+  s.files = [
+  ".gitignore",
+  ".gitmodules",
+  ".travis.yml",
+  "CHANGES.md",
+  "Gemfile",
+  "README.md",
+  "Rakefile",
+  "lib/rest-builder.rb",
+  "lib/rest-builder/builder.rb",
+  "lib/rest-builder/client.rb",
+  "lib/rest-builder/engine.rb",
+  "lib/rest-builder/engine/dry.rb",
+  "lib/rest-builder/engine/http-client.rb",
+  "lib/rest-builder/error.rb",
+  "lib/rest-builder/event_source.rb",
+  "lib/rest-builder/middleware.rb",
+  "lib/rest-builder/payload.rb",
+  "lib/rest-builder/promise.rb",
+  "lib/rest-builder/test.rb",
+  "lib/rest-builder/version.rb",
+  "rest-builder.gemspec",
+  "task/README.md",
+  "task/gemgem.rb",
+  "test/test_builder.rb",
+  "test/test_client.rb",
+  "test/test_event_source.rb",
+  "test/test_future.rb",
+  "test/test_httpclient.rb",
+  "test/test_payload.rb"]
+  s.homepage = "https://github.com/godfat/rest-builder"
+  s.licenses = ["Apache License 2.0"]
+  s.rubygems_version = "2.5.1"
+  s.summary = "Modular Ruby clients interface for REST APIs."
+  s.test_files = [
+  "test/test_builder.rb",
+  "test/test_client.rb",
+  "test/test_event_source.rb",
+  "test/test_future.rb",
+  "test/test_httpclient.rb",
+  "test/test_payload.rb"]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<promise_pool>, [">= 0"])
+      s.add_runtime_dependency(%q<httpclient>, [">= 0"])
+      s.add_runtime_dependency(%q<mime-types>, [">= 0"])
+    else
+      s.add_dependency(%q<promise_pool>, [">= 0"])
+      s.add_dependency(%q<httpclient>, [">= 0"])
+      s.add_dependency(%q<mime-types>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<promise_pool>, [">= 0"])
+    s.add_dependency(%q<httpclient>, [">= 0"])
+    s.add_dependency(%q<mime-types>, [">= 0"])
+  end
+end

data/task/README.md

@@ -0,0 +1,54 @@
+# Gemgem
+
+## DESCRIPTION:
+
+Provided tasks:
+
+    rake clean        # Remove ignored files
+    rake gem:build    # Build gem
+    rake gem:install  # Install gem
+    rake gem:release  # Release gem
+    rake gem:spec     # Generate gemspec
+    rake test         # Run tests in memory
+
+## REQUIREMENTS:
+
+* Tested with MRI (official CRuby) 1.9.3, 2.0.0, Rubinius and JRuby.
+
+## INSTALLATION:
+
+    git submodule add git://github.com/godfat/gemgem.git task
+
+And in Rakefile:
+
+``` ruby
+begin
+  require "#{dir = File.dirname(__FILE__)}/task/gemgem"
+rescue LoadError
+  sh 'git submodule update --init'
+  exec Gem.ruby, '-S', $PROGRAM_NAME, *ARGV
+end
+
+Gemgem.init(dir) do |s|
+  s.name    = 'your-gem'
+  s.version = '0.1.0'
+end
+```
+
+## LICENSE:
+
+Apache License 2.0
+
+Copyright (c) 2011-2013, Lin Jen-Shin (godfat)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+<http://www.apache.org/licenses/LICENSE-2.0>
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/task/gemgem.rb

@@ -0,0 +1,316 @@
+
+module Gemgem
+  class << self
+    attr_accessor :dir, :spec, :spec_create
+  end
+
+  module_function
+  def gem_tag    ; "#{spec.name}-#{spec.version}"     ; end
+  def gem_path   ; "#{pkg_dir}/#{gem_tag}.gem"        ; end
+  def spec_path  ; "#{dir}/#{spec.name}.gemspec"      ; end
+  def pkg_dir    ; "#{dir}/pkg"                       ; end
+  def escaped_dir; @escaped_dir ||= Regexp.escape(dir); end
+
+  def init dir, &block
+    self.dir = dir
+    $LOAD_PATH.unshift("#{dir}/lib")
+    ENV['RUBYLIB'] = "#{dir}/lib:#{ENV['RUBYLIB']}"
+    ENV['PATH']    = "#{dir}/bin:#{ENV['PATH']}"
+    self.spec_create = block
+  end
+
+  def create
+    spec = Gem::Specification.new do |s|
+      s.authors     = ['Lin Jen-Shin (godfat)']
+      s.email       = ['godfat (XD) godfat.org']
+
+      s.description = description.join
+      s.summary     = description.first
+      s.license     = readme['LICENSE'].sub(/.+\n\n/, '').lines.first.strip
+
+      s.date        = Time.now.strftime('%Y-%m-%d')
+      s.files       = gem_files
+      s.test_files  = test_files
+      s.executables = bin_files
+    end
+    spec_create.call(spec)
+    spec.homepage ||= "https://github.com/godfat/#{spec.name}"
+    self.spec = spec
+  end
+
+  def gem_install
+    require 'rubygems/commands/install_command'
+    # read ~/.gemrc
+    Gem.use_paths(Gem.configuration[:gemhome], Gem.configuration[:gempath])
+    Gem::Command.extra_args = Gem.configuration[:gem]
+
+    # setup install options
+    cmd = Gem::Commands::InstallCommand.new
+    cmd.handle_options([])
+
+    # install
+    install = Gem::Installer.new(gem_path, cmd.options)
+    install.install
+    puts "\e[35mGem installed: \e[33m#{strip_path(install.gem_dir)}\e[0m"
+  end
+
+  def gem_spec
+    create
+    write
+  end
+
+  def gem_build
+    require 'fileutils'
+    require 'rubygems/package'
+    gem = nil
+    Dir.chdir(dir) do
+      gem = Gem::Package.build(Gem::Specification.load(spec_path))
+      FileUtils.mkdir_p(pkg_dir)
+      FileUtils.mv(gem, pkg_dir) # gem is relative path, but might be ok
+    end
+    puts "\e[35mGem built: \e[33m#{strip_path("#{pkg_dir}/#{gem}")}\e[0m"
+  end
+
+  def gem_release
+    sh_git('tag', gem_tag)
+    sh_git('push')
+    sh_git('push', '--tags')
+    sh_gem('push', gem_path)
+  end
+
+  def gem_check
+    unless git('status', '--porcelain').empty?
+      puts("\e[35mWorking copy is not clean.\e[0m")
+      exit(3)
+    end
+
+    ver = spec.version.to_s
+
+    if ENV['VERSION'].nil?
+      puts("\e[35mExpected "                                  \
+           "\e[33mVERSION\e[35m=\e[33m#{ver}\e[0m")
+      exit(1)
+
+    elsif ENV['VERSION'] != ver
+      puts("\e[35mExpected \e[33mVERSION\e[35m=\e[33m#{ver} " \
+           "\e[35mbut got\n         "                         \
+           "\e[33mVERSION\e[35m=\e[33m#{ENV['VERSION']}\e[0m")
+      exit(2)
+    end
+  end
+
+  def test
+    return if test_files.empty?
+
+    if ENV['COV'] || ENV['CI']
+      require 'simplecov'
+      if ENV['CI']
+        begin
+          require 'coveralls'
+          SimpleCov.formatter = Coveralls::SimpleCov::Formatter
+        rescue LoadError => e
+          puts "Cannot load coveralls, skip: #{e}"
+        end
+      end
+      SimpleCov.start do
+        add_filter('test/')
+        add_filter('test.rb')
+      end
+    end
+
+    test_files.each{ |file| require "#{dir}/#{file[0..-4]}" }
+  end
+
+  def clean
+    return if ignored_files.empty?
+
+    require 'fileutils'
+    trash = File.expand_path("~/.Trash/#{spec.name}")
+    puts "Move the following files into: \e[35m#{strip_path(trash)}\e[33m"
+
+    ignored_files.each do |file|
+      from = "#{dir}/#{file}"
+      to   = "#{trash}/#{File.dirname(file)}"
+      puts strip_path(from)
+
+      FileUtils.mkdir_p(to)
+      FileUtils.mv(from, to)
+    end
+
+    print "\e[0m"
+  end
+
+  def write
+    File.open(spec_path, 'w'){ |f| f << split_lines(spec.to_ruby) }
+  end
+
+  def split_lines ruby
+    ruby.gsub(/(.+?)\s*=\s*\[(.+?)\]/){ |s|
+      if $2.index(',')
+        "#{$1} = [\n  #{$2.split(',').map(&:strip).join(",\n  ")}]"
+      else
+        s
+      end
+    }
+  end
+
+  def strip_path path
+    strip_home_path(strip_cwd_path(path))
+  end
+
+  def strip_home_path path
+    path.sub(ENV['HOME'], '~')
+  end
+
+  def strip_cwd_path path
+    path.sub(Dir.pwd, '.')
+  end
+
+  def git *args
+    `git --git-dir=#{dir}/.git #{args.join(' ')}`
+  end
+
+  def sh_git *args
+    Rake.sh('git', "--git-dir=#{dir}/.git", *args)
+  end
+
+  def sh_gem *args
+    Rake.sh(Gem.ruby, '-S', 'gem', *args)
+  end
+
+  def glob path=dir
+    Dir.glob("#{path}/**/*", File::FNM_DOTMATCH)
+  end
+
+  def readme
+    @readme ||=
+      if (path = "#{Gemgem.dir}/README.md") && File.exist?(path)
+        ps = "##{File.read(path)}".
+             scan(/((#+)[^\n]+\n\n.+?(?=(\n\n\2[^#\n]+\n)|\Z))/m).map(&:first)
+        ps.inject('HEADER' => ps.first){ |r, s, i|
+          r[s[/\w+/]] = s
+          r
+        }
+      else
+        {}
+      end
+  end
+
+  def description
+    # JRuby String#lines is returning an enumerator
+    @description ||= (readme['DESCRIPTION']||'').sub(/.+\n\n/, '').lines.to_a
+  end
+
+  def all_files
+    @all_files ||= fold_files(glob).sort
+  end
+
+  def fold_files files
+    files.inject([]){ |r, path|
+      if File.file?(path) && path !~ %r{/\.git(/|$)}  &&
+         (rpath = path[%r{^#{escaped_dir}/(.*$)}, 1])
+        r << rpath
+      elsif File.symlink?(path) # walk into symlinks...
+        r.concat(fold_files(glob(File.expand_path(path,
+                                                  File.readlink(path)))))
+      else
+        r
+      end
+    }
+  end
+
+  def gem_files
+    @gem_files ||= all_files.reject{ |f|
+      f =~ ignored_pattern && !git_files.include?(f)
+    }
+  end
+
+  def test_files
+    @test_files ||= gem_files.grep(%r{^test/(.+?/)*test_.+?\.rb$})
+  end
+
+  def bin_files
+    @bin_files ||= gem_files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  end
+
+  def git_files
+    @git_files ||= if File.exist?("#{dir}/.git")
+                     git('ls-files').split("\n")
+                   else
+                     []
+                   end
+  end
+
+  def ignored_files
+    @ignored_files ||= all_files.grep(ignored_pattern)
+  end
+
+  def ignored_pattern
+    @ignored_pattern ||= if gitignore.empty?
+                           /^$/
+                         else
+                           Regexp.new(expand_patterns(gitignore).join('|'))
+                         end
+  end
+
+  def expand_patterns pathes
+    # http://git-scm.com/docs/gitignore
+    pathes.flat_map{ |path|
+      # we didn't implement negative pattern for now
+      Regexp.escape(path).sub(%r{^/}, '^').gsub(/\\\*/, '[^/]*')
+    }
+  end
+
+  def gitignore
+    @gitignore ||= if File.exist?(path = "#{dir}/.gitignore")
+                     File.read(path).lines.
+                       reject{ |l| l == /^\s*(#|\s+$)/ }.map(&:strip)
+                   else
+                     []
+                   end
+  end
+end
+
+namespace :gem do
+
+desc 'Install gem'
+task :install => [:build] do
+  Gemgem.gem_install
+end
+
+desc 'Build gem'
+task :build => [:spec] do
+  Gemgem.gem_build
+end
+
+desc 'Generate gemspec'
+task :spec do
+  Gemgem.gem_spec
+end
+
+desc 'Release gem'
+task :release => [:spec, :check, :build] do
+  Gemgem.gem_release
+end
+
+task :check do
+  Gemgem.gem_check
+end
+
+end # of gem namespace
+
+desc 'Run tests'
+task :test do
+  Gemgem.test
+end
+
+desc 'Trash ignored files'
+task :clean => ['gem:spec'] do
+  Gemgem.clean
+end
+
+task :default do
+  # Is there a reliable way to do this in the current process?
+  # It failed miserably before between Rake versions...
+  exec "#{Gem.ruby} -S #{$PROGRAM_NAME} -f #{Rake.application.rakefile} -T"
+end