httpotemkin 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 680e6b1ecaeb762c4d4ec9ad4e704d07e57d11f8
+  data.tar.gz: bd9941065a464eff2cfe82259f76bcba7bd647cc
+SHA512:
+  metadata.gz: 654de56651be4fdd59502f828c9404cd266cf47046f9a6c0a7712f6a58d1a0ba79b484787240b193254597e6602a1845ffca5134d12d237e39b490840ea4cab6
+  data.tar.gz: 88bbd23cf90c764c0505d39af88096b88cd987584067c6a83cb8775d1587913f97fdcef79b1579cfca9022d2203bd80b65a23e7223f1a46ab161565321ffcbe4

data/.gitignore

@@ -0,0 +1,4 @@
+server.crt
+server.key
+*.gem
+Gemfile.lock

data/.rspec

@@ -0,0 +1,2 @@
+--color
+-fd

data/CONTRIBUTING.md

@@ -0,0 +1 @@
+Contributions are welcome. Let them flow through GitHub.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Cornelius Schumacher <schumacher@kde.org>
+
+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,25 @@
+Httpotemkin provides tools to mock HTTP servers for system-level tests. It uses
+docker containers to provide mocks of HTTP APIs and Ruby classes which can
+be used in tests to execute applications in the environment of the mocked APIs.
+This allows to test applications which talk to HTTP APIs without having to
+change them in any way for the tests, so that very high-level system tests can
+be done in a controlled environment suitable for test driven development.
+
+The tests in `spec/system` provide examples of how tests using httpotemkin can
+be written.
+
+## Debugging
+
+When debugging tests (which actually means reverse engineering the protocol of
+the service and implementing the required bits) it is convenient to get in a
+mode of interactive debugging, where there are containers for the server and
+the client under control of a shell. This allows to manually trigger calls from
+the client and see the resulting requests in the log of the server. By adapting
+the server calls one at a time, it's easily possible to provide the minimal
+mocking to make the tests run.
+
+One way to enter the state of debugging a specific test is to add debug code to
+the RSpec test, e.g. add a `binding.pry` call just before the client test call
+is executed and passing `r.pry` to the `rspec` command. Then you end up in a
+state where all containers are started, test data is injected, and you can debug
+the calls which are supposed to take place.

data/TODO

@@ -0,0 +1,5 @@
+# To do
+
+* Implement what's needed for testing of yes_ship_it
+
+* Don't recreate certificates when they are already there

data/bin/httpotemkin

@@ -0,0 +1,69 @@
+#!/usr/bin/ruby
+
+require_relative "../lib/httpotemkin"
+
+containers = Httpotemkin::Containers.new
+containers.add_server("rubygems")
+containers.add_server("api.rubygems")
+containers.add_server("obs")
+
+cmd = ARGV[0]
+
+if cmd == "status"
+  containers.print_status
+elsif cmd == "up"
+  puts "Starting server containers"
+  containers.up
+elsif cmd == "down"
+  puts "Stopping server containers"
+  containers.down
+elsif cmd == "client"
+  puts containers.run_client
+elsif cmd == "run"
+  puts "Running tests"
+
+  expected_output = File.read("expected_output")
+
+  containers.up
+  sleep 3 unless ENV["RUN_BY_RSPEC"]
+
+  actual_output = containers.run_client
+
+  puts "--- Start Test ---"
+  puts actual_output
+  puts "---- End Test ----"
+
+  containers.down(save_logs: true)
+
+  puts
+  if actual_output == expected_output
+    puts "Success."
+  else
+    puts "Failed."
+    puts
+    puts "Expected output:"
+    puts expected_output
+    puts
+    puts "Actual output:"
+    puts actual_output
+    exit 1
+  end
+else
+  if !cmd
+    STDERR.puts "You need to provide a command"
+  elsif cmd != "help"
+    puts "Unknown command: #{cmd}"
+  end
+
+  puts "Usage: httpotemkin <command>"
+  puts
+  puts "Testing with HTTP mocks based on containers"
+  puts
+  puts "Commands:"
+  puts "  status  - Show status of containers"
+  puts "  up      - Start containers"
+  puts "  down    - Stop containters"
+  puts "  client  - Run client"
+  puts "  run     - Run tests"
+  puts "  help    - Show command line help"
+end

data/containers/api.rubygems/Dockerfile

@@ -0,0 +1,12 @@
+FROM server
+MAINTAINER Cornelius Schumacher <schumacher@kde.org>
+
+COPY secure_server.rb /httpotemkin/api.rubygems/
+COPY server.crt /httpotemkin/api.rubygems/
+COPY server.key /httpotemkin/api.rubygems/
+COPY latest_specs.4.8.gz /httpotemkin/api.rubygems/
+COPY rubygems-update-2.5.0.gemspec.rz /httpotemkin/api.rubygems/
+
+CMD /httpotemkin/api.rubygems/secure_server.rb
+
+EXPOSE 443

data/containers/api.rubygems/secure_server.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby
+
+require "sinatra"
+
+require_relative "../server/server_base.rb"
+
+CERT_DIR = File.dirname(__FILE__)
+
+configure_sinatra
+
+get '/' do
+  "I'm the secure api.rubygems server\n"
+end
+
+get '/latest_specs.4.8.gz' do
+  File.read(File.expand_path("../latest_specs.4.8.gz", __FILE__))
+end
+
+get '/quick/Marshal.4.8/rubygems-update-2.5.0.gemspec.rz' do
+  File.read(File.expand_path("../rubygems-update-2.5.0.gemspec.rz", __FILE__))
+end

data/containers/build_containers

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby
+
+require "fileutils"
+
+def run(cmd)
+  puts cmd
+  if !system(cmd)
+    STDERR.puts "Command failed. Exiting."
+    exit 1
+  end
+end
+
+def build_image(name)
+  run("docker build -t #{name} #{name}")
+end
+
+def build_api_image(image_name, server_name)
+  run("openssl req -x509 -newkey rsa:2048 -keyout #{image_name}/server.key -out #{image_name}/server.crt -days 1000 -nodes -subj '/CN=#{server_name}'")
+
+  FileUtils.copy("#{image_name}/server.crt", "client/certificates/#{image_name}.crt")
+
+  run("docker build -t #{image_name} #{image_name}")
+end
+
+
+build_image("server")
+
+build_api_image("rubygems", "rubygems.org")
+build_api_image("api.rubygems", "api.rubygems.org")
+build_api_image("obs", "api.opensuse.org")
+
+build_image("client")
+
+
+puts "Success."

data/containers/client/Dockerfile

@@ -0,0 +1,30 @@
+FROM opensuse:42.1
+MAINTAINER Cornelius Schumacher <schumacher@kde.org>
+
+run zypper --non-interactive install  ca-certificates-mozilla
+
+RUN zypper --non-interactive install curl
+RUN zypper --non-interactive install ruby
+RUN zypper --non-interactive install --no-recommends osc
+
+# Dependencies for yes_ship_it
+RUN zypper --non-interactive install ruby2.1-rubygem-inifile ruby2.1-rubygem-rest-client
+RUN zypper --non-interactive install git
+
+# Configuration for OBS client
+COPY oscrc /root/.oscrc
+
+COPY certificates/rubygems.crt /etc/pki/trust/anchors/rubygems.pem
+COPY certificates/api.rubygems.crt /etc/pki/trust/anchors/api.rubygems.pem
+COPY certificates/obs.crt /etc/pki/trust/anchors/obs.pem
+
+RUN update-ca-certificates
+
+COPY run_test.rb /run_test.rb
+
+# Configuration for gem
+RUN mkdir /root/.gem
+RUN echo ":rubygems_api_key: 123" >/root/.gem/credentials
+RUN chmod 0600 /root/.gem/credentials
+
+CMD /run_test.rb

data/containers/client/certificates/.gitignore

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

data/containers/client/oscrc

@@ -0,0 +1,7 @@
+[general]
+
+apiurl = https://api.opensuse.org
+
+[https://api.opensuse.org]
+user = myuser
+pass = mypassword

data/containers/client/run_test.rb

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+curl https://rubygems.org -s
+curl https://api.rubygems.org -s
+curl https://api.opensuse.org -s

data/containers/client/server.crt

@@ -0,0 +1,19 @@
+-----BEGIN CERTIFICATE-----
+MIIDCTCCAfGgAwIBAgIJAOgD6vQm36guMA0GCSqGSIb3DQEBBQUAMBsxGTAXBgNV
+BAMMEGFwaS5ydWJ5Z2Vtcy5vcmcwHhcNMTUwOTMwMTM0MTQ0WhcNMTgwNjI2MTM0
+MTQ0WjAbMRkwFwYDVQQDDBBhcGkucnVieWdlbXMub3JnMIIBIjANBgkqhkiG9w0B
+AQEFAAOCAQ8AMIIBCgKCAQEAyLIX5wODf0a4xLLFgJk7XjZ4alx8wOvqIpeKMc6J
+yKfRp9rJWtHa578KYnLFfKZMSomHiIz1OdA+MWkOL6pt8kjJ8ciYahJ4q0gRx8+k
+8bwXWBheh2gwm4jPubX+yBvXNn1Jc1+szQyJfVR7Yt1CNDTUnYuoL9K1qCxhaSiK
+bVTu0IylVfeu83frV+hrr9IAveWZs6pD0Rm1j/V0cEbnaqWvppnHoO1HCh94rJRz
+42iMVBIUeImwpmP2Eh6Q/1EvERoSP4GK3h8fGgO21iRcaj4/idUmYYd73ih7KHWu
+FmIdK37nnyEu45dhuAnKb/OUEGW9Z07EFgy8bWDlrEMd4wIDAQABo1AwTjAdBgNV
+HQ4EFgQUgEX0+CP53wGNF3VaOfk2QOGj/A0wHwYDVR0jBBgwFoAUgEX0+CP53wGN
+F3VaOfk2QOGj/A0wDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAkMvw
+NjeKUX/5S5dhR2fl7rsmVYhXGhFUmT8R8LXMIYsbeLkukBElEH+RIsn+GHkhww0x
+imQsYKfy+ACmLUQ22rCwCu2UOyQGc+14T/RCHHwDSEMkz1Rnggo5SfjZ7NXLPnrE
+c7iPlryxt8sMQXgjqZB7BzAFQVQmeRT8UKWhWYJeGvppmiOeY6E2xPiw6udlIeXA
+Qr1qMIPZYrQIZY7+BJvB/oW9LDOgQH+IZ8clCHRajzE62KnwGEN+BzdycaulRHEK
+xggqcxq4AGQ/VfY6JEwqERC+Px0ZW3Oi2M/KilfbeXk1QTd47fWFFI1Zqa5LLVJt
+A+Ujm0Psp39L70exAg==
+-----END CERTIFICATE-----

data/containers/obs/Dockerfile

@@ -0,0 +1,10 @@
+FROM server
+MAINTAINER Cornelius Schumacher <schumacher@kde.org>
+
+COPY secure_server.rb /httpotemkin/obs/
+COPY server.crt /httpotemkin/obs/
+COPY server.key /httpotemkin/obs/
+
+CMD /httpotemkin/obs/secure_server.rb
+
+EXPOSE 443

data/containers/obs/secure_server.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/ruby
+
+require "sinatra"
+
+require_relative "../server/server_base.rb"
+
+CERT_DIR = File.dirname(__FILE__)
+
+configure_sinatra
+
+get '/' do
+  "I'm the secure OBS server\n"
+end

data/containers/rubygems/Dockerfile

@@ -0,0 +1,10 @@
+FROM server
+MAINTAINER Cornelius Schumacher <schumacher@kde.org>
+
+COPY secure_server.rb /httpotemkin/rubygems/
+COPY server.crt /httpotemkin/rubygems/
+COPY server.key /httpotemkin/rubygems/
+
+CMD /httpotemkin/rubygems/secure_server.rb
+
+EXPOSE 443

data/containers/rubygems/secure_server.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/ruby
+
+require "sinatra"
+
+require_relative "../server/server_base.rb"
+
+CERT_DIR = File.dirname(__FILE__)
+
+configure_sinatra
+
+get '/' do
+  "I'm the secure rubygems server\n"
+end
+
+post '/api/v1/gems' do
+  "Successfully registered gem: red_herring (0.0.2)"
+end
+
+get '/api/v1/versions/red_herring.json' do
+  json = <<EOT
+[{
+  "authors": "Cornelius Schumacher",
+  "built_at": "2015-06-20T00:00:00.000Z",
+  "created_at": "2015-06-20T06:57:40.675Z",
+  "description": "This is a red herring.",
+  "downloads_count": 371,
+  "metadata": {},
+  "number": "0.0.1",
+  "summary": "Red herring",
+  "platform": "ruby",
+  "ruby_version": "\u003e= 0",
+  "prerelease": false,
+  "licenses": ["MIT"],
+  "requirements": [],
+  "sha": "8afa714a16b34800a3f4e7aefcab871cf98aca33d02758e9c9d658cbf4bd740b"
+}]
+EOT
+  json
+end

data/containers/server/Dockerfile

@@ -0,0 +1,17 @@
+FROM opensuse
+MAINTAINER Cornelius Schumacher <schumacher@kde.org>
+
+RUN zypper --non-interactive install ruby
+RUN zypper --non-interactive install ruby-devel gcc-c++ make libopenssl-devel
+RUN zypper --non-interactive install ca-certificates-mozilla
+RUN zypper --non-interactive install curl
+RUN gem install --no-document sinatra thin
+
+COPY server_base.rb /httpotemkin/server/
+COPY secure_server.rb /httpotemkin/server/
+COPY server.rb /httpotemkin/server/
+
+CMD /httpotemkin/server/server.rb -p 80
+
+EXPOSE 80
+EXPOSE 443

data/containers/server/secure_server.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/ruby
+
+require "sinatra"
+
+require_relative "server_base.rb"
+
+CERT_DIR = File.dirname(__FILE__)
+
+configure_sinatra
+
+get '/' do
+  "I'm the secure base server\n"
+end

data/containers/server/server.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby
+
+require "sinatra"
+
+set :bind, "0.0.0.0"
+
+get '/' do
+  "Jups\n"
+end
+
+get "/hello" do
+  "world\n"
+end
+
+get "/*" do
+  "all the rest\n"
+end

data/containers/server/server_base.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby
+
+require "thin"
+
+class SecureServer < ::Thin::Backends::TcpServer
+  def initialize(host, port, options)
+    super(host, port)
+    @ssl = true
+    @ssl_options = options
+  end
+end
+
+def configure_sinatra
+  configure do
+    set :environment, :production
+    set :bind, '0.0.0.0'
+    set :port, 443
+    set :server, "thin"
+    class << settings
+      def server_settings
+        {
+          :backend          => SecureServer,
+          :private_key_file => CERT_DIR + "/server.key",
+          :cert_chain_file  => CERT_DIR + "/server.crt",
+          :verify_peer      => false
+        }
+      end
+    end
+  end
+end

data/containers/show_certificate.sh

@@ -0,0 +1 @@
+openssl x509 -in server.crt -text -noout

data/expected_output

@@ -0,0 +1,3 @@
+Hopss
+Hopss
+Hopss

data/httpotemkin.gemspec

@@ -0,0 +1,23 @@
+Gem::Specification.new do |s|
+  s.name        = 'httpotemkin'
+  s.version     = '0.0.1'
+  s.license     = 'MIT'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Cornelius Schumacher']
+  s.email       = ['schumacher@kde.org']
+  s.homepage    = 'https://github.com/cornelius/httpotemkin'
+  s.summary     = 'Mock HTTP services for system tests'
+  s.description = 'Httpotemkin provides tools to mock HTTP servers for system-level tests.'
+  s.required_rubygems_version = '>= 1.3.6'
+  s.rubyforge_project         = 'httpotemkin'
+
+  s.add_development_dependency 'rspec', '~> 3.0'
+  s.add_development_dependency 'given_filesystem', '>= 0.1.2'
+  s.add_development_dependency 'cli_tester', '>= 0.0.2'
+
+  s.add_runtime_dependency 'terminal-table', '~> 1.5'
+
+  s.files        = `git ls-files`.split("\n")
+  s.require_path = 'lib'
+  s.executables = ["httpotemkin"]
+end

data/lib/client.rb

@@ -0,0 +1,38 @@
+module Httpotemkin
+  class Client
+    def initialize(containers)
+      @containers = containers
+    end
+
+    def execute(cmd, working_directory: nil)
+      @out = @containers.exec_client(cmd, working_directory: working_directory)
+    end
+
+    def exit_code
+      0
+    end
+
+    def out
+      @out
+    end
+
+    def err
+      ""
+    end
+
+    def inject_tarball(filename)
+      Cheetah.run(["cat", filename], ["docker", "cp", "-", "client:/"])
+    end
+
+    def install_gem_from_spec(specfile)
+      Dir.chdir(File.dirname(specfile)) do
+        out = Cheetah.run(["gem", "build", File.basename(specfile)],
+          stdout: :capture)
+        gemfile = out[/File: (.*)\n/, 1]
+        @containers.run_docker(["cp", gemfile, "client:/tmp"])
+        @containers.run_docker(["exec", "client", "gem", "install", "--local",
+          File.join("/tmp", gemfile)])
+      end
+    end
+  end
+end

data/lib/containers.rb

@@ -0,0 +1,113 @@
+module Httpotemkin
+  class Containers
+    attr_accessor :out
+    attr_accessor :log_dir
+
+    def initialize
+      @servers = []
+      @host_names = {
+        "rubygems" => "rubygems.org",
+        "api.rubygems" => "api.rubygems.org",
+        "obs" => "api.opensuse.org",
+        "server" => "server"
+      }
+      @out = $stdout
+      @err = $stderr
+      @log_dir = ENV["HTTPOTEMKIN_LOGS_DIR"] || "logs"
+    end
+
+    def run_docker(args, options = {})
+      cmd = ["docker"] + args
+      @out.puts cmd.join(" ")
+      out = Cheetah.run(cmd, options.merge({stdout: :capture}))
+      @out.puts out if out && !out.empty?
+    end
+
+    def host_name(name)
+      @host_names[name]
+    end
+
+    def add_server(name)
+      @servers.push(name)
+    end
+
+    def print_status
+      running = `docker ps --format="{{.Names}}"`.split("\n")
+      table = Terminal::Table.new(headings: ["Container", "Status"]) do |t|
+        status.each do |container, status|
+          t.add_row([container, status ? "up" : "down"])
+        end
+      end
+
+      @out.puts table
+    end
+
+    def status
+      @status ||= {}
+      if @status.empty?
+        running = `docker ps --format="{{.Names}}"`.split("\n")
+        @servers.each do |server|
+          @status[server] = running.include?(server)
+        end
+      end
+      @status
+    end
+
+    def up
+      @servers.each do |server|
+        if status[server]
+          @out.puts "'#{server}' already up"
+        else
+          run_docker(["run", "--name=#{server}", "-d", server])
+        end
+      end
+    end
+
+    def down(save_logs: false)
+      @servers.each do |server|
+        if (save_logs)
+          log_file = File.open(File.join(@log_dir,"#{server}.log"), "w")
+          run_docker(["logs", server], stderr: log_file)
+        end
+        if status[server]
+          run_docker(["rm", "-f", server])
+        else
+          @out.puts "'#{server}' already down"
+        end
+      end
+    end
+
+    def start_client
+      if links.empty?
+        run_docker(["run", "--name=client", "-d", "client", "sleep", "infinity"])
+      else
+        run_docker(["run"] + links + ["--name=client", "-d", "client", "sleep", "infinity"])
+      end
+    end
+
+    def stop_client
+      run_docker(["rm", "-f", "client"])
+    end
+
+    def exec_client(client_cmd, working_directory: nil)
+      cmd = ["docker", "exec", "client"]
+      if working_directory
+        cmd += ["sh", "-c", "cd #{working_directory}; #{client_cmd.join(' ')}"]
+      else
+        cmd += client_cmd
+      end
+      @out.puts cmd.join(" ")
+      Cheetah.run(cmd, stdout: :capture)
+    end
+
+    def links
+      @servers.map { |name| "--link=#{name}:#{host_name(name)}" }
+    end
+
+    def run_client
+      cmd = "docker run #{links.join(" ")} client"
+      @out.puts cmd
+      `#{cmd}`
+    end
+  end
+end

data/lib/httpotemkin.rb

@@ -0,0 +1,5 @@
+require "cheetah"
+require "terminal-table"
+require_relative "containers"
+require_relative "test"
+require_relative "client"

data/lib/test.rb

@@ -0,0 +1,23 @@
+module Httpotemkin
+  class Test
+    def initialize(out: $stdout)
+      @containers = Containers.new
+      @containers.out = out
+    end
+
+    def add_server(name)
+      @containers.add_server(name)
+    end
+
+    def run
+      @containers.up
+      @containers.start_client
+      begin
+        yield Client.new(@containers)
+      ensure
+        @containers.stop_client
+        @containers.down
+      end
+    end
+  end
+end

data/logs/.gitignore

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

data/spec/integration/bin/client/docker

@@ -0,0 +1,5 @@
+#!/usr/bin/ruby
+
+3.times do
+  puts "Hopss"
+end

data/spec/integration/bin/down/docker

@@ -0,0 +1,8 @@
+#!/usr/bin/ruby
+
+if ARGV[0] == "ps"
+  puts "rubygems"
+  puts "api.rubygems"
+else
+  puts ARGV[2]
+end

data/spec/integration/bin/run.failure/docker

@@ -0,0 +1,5 @@
+#!/usr/bin/ruby
+
+if ARGV.last == "client"
+  puts "error"
+end

data/spec/integration/bin/run.success/docker

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby
+
+if ARGV.last == "client"
+  3.times do
+    puts "Hopss"
+  end
+end

data/spec/integration/bin/status/docker

@@ -0,0 +1,4 @@
+#!/usr/bin/ruby
+
+puts "rubygems"
+puts "obs"

data/spec/integration/bin/up/docker

@@ -0,0 +1,8 @@
+#!/usr/bin/ruby
+
+if ARGV[0] == "ps"
+  puts "rubygems"
+  puts "api.rubygems"
+else
+  puts "123"
+end

data/spec/integration/cli_spec.rb

@@ -0,0 +1,157 @@
+require_relative "spec_helper"
+
+include CliTester
+include GivenFilesystemSpecHelpers
+
+describe "command line interface" do
+  describe "help" do
+    it "shows help" do
+      expected_output = <<-EOT
+Usage: httpotemkin <command>
+
+Testing with HTTP mocks based on containers
+
+Commands:
+  status  - Show status of containers
+  up      - Start containers
+  down    - Stop containters
+  client  - Run client
+  run     - Run tests
+  help    - Show command line help
+      EOT
+      expect(run_command(args: ["help"])).to exit_with_success(expected_output)
+    end
+  end
+
+  describe "status" do
+    it "shows status" do
+      with_stubbed_binary("bin/status/docker") do
+        expected_output = <<-EOT
++--------------+--------+
+| Container    | Status |
++--------------+--------+
+| rubygems     | up     |
+| api.rubygems | down   |
+| obs          | up     |
++--------------+--------+
+EOT
+        expect(run_command(args: ["status"])).to exit_with_success(expected_output)
+      end
+    end
+  end
+
+  describe "up" do
+    it "starts containers" do
+      with_stubbed_binary("bin/up/docker") do
+        expected_output = <<-EOT
+Starting server containers
+'rubygems' already up
+'api.rubygems' already up
+docker run --name=obs -d obs
+123
+        EOT
+        expect(run_command(args: ["up"])).to exit_with_success(expected_output)
+      end
+    end
+  end
+
+  describe "down" do
+    it "stops containers" do
+      with_stubbed_binary("bin/down/docker") do
+        expected_output = <<-EOT
+Stopping server containers
+docker rm -f rubygems
+rubygems
+docker rm -f api.rubygems
+api.rubygems
+'obs' already down
+        EOT
+        expect(run_command(args: ["down"])).to exit_with_success(expected_output)
+      end
+    end
+  end
+
+  describe "client" do
+    it "runs client" do
+      with_stubbed_binary("bin/client/docker") do
+        expected_output = <<-EOT
+docker run --link=rubygems:rubygems.org --link=api.rubygems:api.rubygems.org --link=obs:api.opensuse.org client
+Hopss
+Hopss
+Hopss
+        EOT
+        expect(run_command(args: ["client"])).to exit_with_success(expected_output)
+      end
+    end
+  end
+
+  describe "run" do
+    use_given_filesystem
+
+    before(:each) do
+      @logs_dir = given_directory
+      ENV["HTTPOTEMKIN_LOGS_DIR"] = @logs_dir
+    end
+
+    it "runs test and succeeds" do
+      with_stubbed_binary("bin/run.success/docker") do
+        expected_output = <<-EOT
+Running tests
+docker run --name=rubygems -d rubygems
+docker run --name=api.rubygems -d api.rubygems
+docker run --name=obs -d obs
+docker run --link=rubygems:rubygems.org --link=api.rubygems:api.rubygems.org --link=obs:api.opensuse.org client
+--- Start Test ---
+Hopss
+Hopss
+Hopss
+---- End Test ----
+docker logs rubygems
+'rubygems' already down
+docker logs api.rubygems
+'api.rubygems' already down
+docker logs obs
+'obs' already down
+
+Success.
+        EOT
+        expect(run_command(args: ["run"])).to exit_with_success(expected_output)
+        expect(File.exist?(File.join(@logs_dir, "rubygems.log"))).to be(true)
+        expect(File.exist?(File.join(@logs_dir, "api.rubygems.log"))).to be(true)
+        expect(File.exist?(File.join(@logs_dir, "obs.log"))).to be(true)
+      end
+    end
+
+    it "runs test and fails" do
+      with_stubbed_binary("bin/run.failure/docker") do
+        expected_output = <<-EOT
+Running tests
+docker run --name=rubygems -d rubygems
+docker run --name=api.rubygems -d api.rubygems
+docker run --name=obs -d obs
+docker run --link=rubygems:rubygems.org --link=api.rubygems:api.rubygems.org --link=obs:api.opensuse.org client
+--- Start Test ---
+error
+---- End Test ----
+docker logs rubygems
+'rubygems' already down
+docker logs api.rubygems
+'api.rubygems' already down
+docker logs obs
+'obs' already down
+
+Failed.
+
+Expected output:
+Hopss
+Hopss
+Hopss
+
+Actual output:
+error
+        EOT
+        expect(run_command(args: ["run"])).to exit_with_error(1, "", expected_output)
+      end
+    end
+  end
+end

data/spec/integration/spec_helper.rb

@@ -0,0 +1,21 @@
+require "cli_tester"
+require "given_filesystem/spec_helpers"
+
+ENV["RUN_BY_RSPEC"] = "1"
+
+def with_stubbed_binary(bin_path)
+  saved_path = ENV["PATH"]
+
+  full_path = File.expand_path("../", __FILE__)
+  full_path = File.join(full_path, bin_path)
+  if !File.exist?(full_path)
+    STDERR.puts "Error: stubbing binary #{full_path} does not exist"
+  else
+    path = File.dirname(full_path)
+    ENV["PATH"] = path + ":" + ENV["PATH"]
+  end
+
+  yield
+
+  ENV["PATH"] = saved_path
+end

data/spec/system/client_spec.rb

@@ -0,0 +1,70 @@
+require_relative "spec_helper"
+
+include GivenFilesystemSpecHelpers
+
+describe "client" do
+  use_given_filesystem(keep_files: true)
+
+  it "injects tarballs" do
+    out = double
+    allow(out).to receive(:puts)
+
+    test = Httpotemkin::Test.new(out: out)
+
+    test.run do |client|
+      client.inject_tarball("spec/system/data/test.tar.gz")
+
+      client.execute(["ls", "test"])
+
+      expect(client.exit_code).to eq(0)
+      expect(client.out).to eq("mydir\nmyfile\n")
+      expect(client.err.empty?).to be(true)
+
+      client.execute(["ls", "test/mydir"])
+
+      expect(client.exit_code).to eq(0)
+      expect(client.out).to eq("myotherfile1\nmyotherfile2\n")
+      expect(client.err.empty?).to be(true)
+    end
+  end
+
+  it "installs gem from spec" do
+    out = double
+    allow(out).to receive(:puts)
+
+    test = Httpotemkin::Test.new(out: out)
+
+    test.run do |client|
+      gem_tarball = File.expand_path("../data/red_herring-000.tar.gz", __FILE__)
+
+      gem_dir = given_directory
+      Dir.chdir(gem_dir) do
+        Cheetah.run(["tar", "xzf", gem_tarball])
+      end
+
+      client.install_gem_from_spec(File.join(gem_dir, "red_herring",
+        "red_herring.gemspec"))
+
+      client.execute(["gem", "list", "red_herring"])
+
+      expect(client.exit_code).to eq(0)
+      expect(client.out).to match("red_herring (0.0.1)\n")
+      expect(client.err.empty?).to be(true)
+    end
+  end
+
+  it "executes command in custom working directory" do
+    out = double
+    allow(out).to receive(:puts)
+
+    test = Httpotemkin::Test.new(out: out)
+
+    test.run do |client|
+      client.execute(["ls"], working_directory: "/srv")
+
+      expect(client.exit_code).to eq(0)
+      expect(client.out).to eq("ftp\nwww\n")
+      expect(client.err.empty?).to be(true)
+    end
+  end
+end

data/spec/system/hello_world_spec.rb

@@ -0,0 +1,20 @@
+require_relative "spec_helper"
+
+describe "hello world" do
+  it "answers" do
+    out = double
+    allow(out).to receive(:puts)
+
+    test = Httpotemkin::Test.new(out: out)
+    test.add_server("server")
+
+    test.run do |client|
+      sleep 2
+      client.execute(["curl", "server/hello"])
+
+      expect(client.exit_code).to eq(0)
+      expect(client.out).to eq("world\n")
+      expect(client.err.empty?).to be(true)
+    end
+  end
+end

data/spec/system/spec_helper.rb

@@ -0,0 +1,3 @@
+require_relative "../../lib/httpotemkin"
+
+require "given_filesystem/spec_helpers"

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: httpotemkin
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Cornelius Schumacher
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: given_filesystem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: cli_tester
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: Httpotemkin provides tools to mock HTTP servers for system-level tests.
+email:
+- schumacher@kde.org
+executables:
+- httpotemkin
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CONTRIBUTING.md
+- Gemfile
+- MIT-LICENSE
+- README.md
+- TODO
+- bin/httpotemkin
+- containers/api.rubygems/Dockerfile
+- containers/api.rubygems/latest_specs.4.8.gz
+- containers/api.rubygems/rubygems-update-2.5.0.gemspec.rz
+- containers/api.rubygems/secure_server.rb
+- containers/build_containers
+- containers/client/Dockerfile
+- containers/client/certificates/.gitignore
+- containers/client/oscrc
+- containers/client/run_test.rb
+- containers/client/server.crt
+- containers/obs/Dockerfile
+- containers/obs/secure_server.rb
+- containers/rubygems/Dockerfile
+- containers/rubygems/secure_server.rb
+- containers/server/Dockerfile
+- containers/server/secure_server.rb
+- containers/server/server.rb
+- containers/server/server_base.rb
+- containers/show_certificate.sh
+- expected_output
+- httpotemkin.gemspec
+- lib/client.rb
+- lib/containers.rb
+- lib/httpotemkin.rb
+- lib/test.rb
+- logs/.gitignore
+- spec/integration/bin/client/docker
+- spec/integration/bin/down/docker
+- spec/integration/bin/run.failure/docker
+- spec/integration/bin/run.success/docker
+- spec/integration/bin/status/docker
+- spec/integration/bin/up/docker
+- spec/integration/cli_spec.rb
+- spec/integration/spec_helper.rb
+- spec/system/client_spec.rb
+- spec/system/data/red_herring-000.tar.gz
+- spec/system/data/test.tar.gz
+- spec/system/hello_world_spec.rb
+- spec/system/spec_helper.rb
+homepage: https://github.com/cornelius/httpotemkin
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: httpotemkin
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Mock HTTP services for system tests
+test_files: []
+has_rdoc: