probedock-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d941395e464c62eab491d4939d4a8a64096cbac6
+  data.tar.gz: 4e35bc79a67d9f0cf1460ea0f167f5b7061a34a7
+SHA512:
+  metadata.gz: e7b22566142e31593d73930d26ef56eefc3f1e491a0deb1f22c5a1960806d07d3e82d2510706fc92f5086dd1fa1eddccb94e89db091525211d2dfb1c05a38998
+  data.tar.gz: b05d2128a07ae016a8a7616a7651b0fa4d9b1d21d08a8a6ba4cf8c6a057d7da0d486540bd9990090910dbfd4fe7208598ef10480cdb1fc769360f3728a28b8b9

data/Gemfile

@@ -0,0 +1,22 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'oj', '~> 2.1'
+gem 'httparty', '~> 0.13'
+gem 'paint', '~> 1.0'
+gem 'rake', '~> 10.1'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem 'jeweler', '~> 2.0'
+  gem 'rake-version', '~> 0.4'
+  gem 'simplecov', '~> 0.10', require: false
+  gem 'fakefs', '~> 0.6', require: 'fakefs/safe'
+  gem 'rspec', '~> 3.1'
+  gem 'rspec-its', '~> 1.2'
+  gem 'rspec-collection_matchers', '~> 1.1'
+  gem 'coveralls', '~> 0.8', require: false
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+Copyright (c) 2015 Probe Dock
+Copyright (c) 2012-2013 Lotaris SA
+
+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,36 @@
+# Probe Dock Ruby Library
+
+**Ruby library to develop new probes for [Probe Dock](https://github.com/probedock/probedock).**
+
+[![Gem Version](https://badge.fury.io/rb/probedock-ruby.svg)](http://badge.fury.io/rb/probedock-ruby)
+[![Dependency Status](https://gemnasium.com/probedock/probedock-ruby.svg)](https://gemnasium.com/probedock/probedock-ruby)
+[![Build Status](https://secure.travis-ci.org/probedock/probedock-ruby.svg)](http://travis-ci.org/probedock/probedock-ruby)
+[![Coverage Status](https://coveralls.io/repos/probedock/probedock-ruby/badge.svg)](https://coveralls.io/r/probedock/probedock-ruby?branch=master)
+[![License](https://img.shields.io/github/license/probedock/probedock-ruby.svg)](LICENSE.txt)
+
+## Requirements
+
+* Ruby 2+
+
+## Installation
+
+Add it to your Gemfile:
+
+```rb
+gem 'probedock-ruby', '~> 0.1.0'
+```
+
+Run `bundle install`.
+
+## Contributing
+
+* [Fork](https://help.github.com/articles/fork-a-repo)
+* Create a topic branch - `git checkout -b my_feature`
+* Push to your branch - `git push origin my_feature`
+* Create a [pull request](http://help.github.com/pull-requests/) from your branch
+
+Please add a [changelog](CHANGELOG.md) entry with your name for new features and bug fixes.
+
+## License
+
+Probe Dock RSpec is licensed under the [MIT License](http://opensource.org/licenses/MIT).

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/probe_dock_ruby.rb

@@ -0,0 +1,9 @@
+# encoding: UTF-8
+module ProbeDockProbe
+  VERSION = '0.1.0'
+
+  class Error < StandardError; end
+  class PayloadError < Error; end
+end
+
+Dir[File.join File.dirname(__FILE__), File.basename(__FILE__, '.*'), '*.rb'].each{ |lib| require lib }

data/lib/probe_dock_ruby/client.rb

@@ -0,0 +1,101 @@
+module ProbeDockProbe
+
+  class Client
+
+    def initialize server, options = {}
+
+      @server = server
+      @publish, @local_mode, @workspace = options[:publish], options[:local_mode], options[:workspace]
+      @print_payload, @save_payload = options[:print_payload], options[:save_payload]
+
+      @uid = UID.new workspace: @workspace
+    end
+
+    def process test_run
+
+      return fail "No server to publish results to" if !@server
+
+      test_run.uid = @uid.load_uid
+
+      payload_options = {}
+      return false unless payload = build_payload(test_run, payload_options)
+
+      published = if !@publish
+        puts Paint["Probe Dock - Publishing disabled", :yellow]
+        false
+      elsif publish_payload payload
+        true
+      else
+        false
+      end
+
+      save_payload payload if @save_payload
+      print_payload payload if @print_payload
+
+      puts
+
+      published
+    end
+
+    private
+
+    def build_payload test_run, options = {}
+      begin
+        TestPayload.new(test_run).to_h options
+      rescue PayloadError => e
+        fail e.message
+      end
+    end
+
+    def fail msg, type = :error
+      styles = { warning: [ :yellow ], error: [ :bold, :red ] }
+      warn Paint["Probe Dock - #{msg}", *styles[type]]
+      false
+    end
+
+    def print_payload payload
+      puts Paint['Probe Dock - Printing payload...', :yellow]
+      begin
+        puts JSON.pretty_generate(payload)
+      rescue
+        puts payload.inspect
+      end
+    end
+
+    def save_payload payload
+
+      missing = { "workspace" => @workspace, "server" => @server }.inject([]){ |memo,(k,v)| !v ? memo << k : memo }
+      return fail "Cannot save payload without a #{missing.join ' and '}" if missing.any?
+
+      FileUtils.mkdir_p File.dirname(payload_file)
+      File.open(payload_file, 'w'){ |f| f.write Oj.dump(payload, mode: :strict) }
+    end
+
+    def payload_file
+      @payload_file ||= File.join(@workspace, 'rspec', 'servers', @server.name, 'payload.json')
+    end
+
+    def publish_payload payload
+
+      puts Paint["Probe Dock - Sending payload to #{@server.api_url}...", :magenta]
+
+      begin
+        if @local_mode
+          puts Paint['Probe Dock - LOCAL MODE: not actually sending payload.', :yellow]
+        else
+          @server.upload payload
+        end
+        puts Paint["Probe Dock - Done!", :green]
+        true
+      rescue Server::Error => e
+        warn Paint["Probe Dock - Upload failed!", :red, :bold]
+        warn Paint["Probe Dock - #{e.message}", :red, :bold]
+        if e.response
+          warn Paint["Probe Dock - Dumping response body...", :red, :bold]
+          warn e.response.body
+        end
+        false
+      end
+    end
+  end
+end

data/lib/probe_dock_ruby/config.rb

@@ -0,0 +1,187 @@
+require 'yaml'
+
+# Utilities to send test results to Probe Dock.
+module ProbeDockProbe
+
+  def self.config
+    @config ||= Config.new.tap(&:load!)
+  end
+
+  def self.configure options = {}
+
+    yield config if block_given?
+
+    config.check!
+    config.load_warnings.each{ |w| warn Paint["Probe Dock - #{w}", :yellow] }
+
+    config
+  end
+
+  class Config
+    # TODO: add silent/verbose option(s)
+    class Error < ProbeDockProbe::Error; end
+    attr_writer :publish, :local_mode, :print_payload, :save_payload
+    attr_reader :project, :server, :workspace, :load_warnings
+
+    def initialize
+      @servers = []
+      @server = Server.new
+      @project = Project.new
+      @publish, @local_mode, @print_payload, @save_payload = false, false, false, false
+      @load_warnings = []
+    end
+
+    def workspace= dir
+      @workspace = dir ? File.expand_path(dir) : nil
+    end
+
+    def servers
+      @servers.dup
+    end
+
+    %w(publish local_mode print_payload save_payload).each do |name|
+      define_method("#{name}?"){ instance_variable_get("@#{name}") }
+    end
+
+    def client_options
+      {
+        publish: @publish,
+        local_mode: @local_mode,
+        workspace: @workspace,
+        print_payload: @print_payload,
+        save_payload: @save_payload
+      }.select{ |k,v| !v.nil? }
+    end
+
+    def load!
+
+      @server.clear
+      @servers.clear
+
+      @load_warnings = []
+      return unless config = load_config_files
+
+      @publish = parse_env_flag :publish, !!config[:publish]
+      @server_name = parse_env_option(:server) || config[:server]
+      @local_mode = parse_env_flag(:local) || !!config[:local]
+
+      self.workspace = parse_env_option(:workspace) || config[:workspace]
+      @print_payload = parse_env_flag :print_payload, !!config[:payload][:print]
+      @save_payload = parse_env_flag :save_payload, !!config[:payload][:save]
+
+      @servers, server = build_servers config
+
+      if server
+        @server = server
+      else
+        @server.name = @server_name
+      end
+
+      {
+        api_url: parse_env_option(:server_api_url),
+        api_token: parse_env_option(:server_api_token),
+        project_api_id: parse_env_option(:server_project_api_id)
+      }.each{ |k,v| @server.send "#{k}=", v if v }
+
+      project_options = config[:project]
+      project_options.merge! api_id: @server.project_api_id if @server and @server.project_api_id
+      @project.update project_options
+
+      self
+    end
+
+    def check!
+
+      configs = [ home_config_file, working_config_file ]
+      actual_configs = configs.select{ |f| File.exists? f }
+
+      if actual_configs.empty?
+        @load_warnings << %|no config file found, looking for:\n     #{configs.join "\n     "}|
+      end
+
+      if @servers.empty?
+        @load_warnings << "No server defined"
+      elsif !@server_name && !@server.name
+        @load_warnings << "No server name given"
+      end
+    end
+
+    private
+
+    def build_servers config
+
+      default_server_options = { project_api_id: config[:project][:api_id] }
+      servers = config[:servers].inject({}) do |memo,(name, options)|
+        memo[name] = Server.new default_server_options.merge(options).merge(name: name)
+        memo
+      end
+
+      [ servers.values, servers[@server_name.to_s.strip] ]
+    end
+
+    def load_config_files
+
+      configs = [ home_config_file, working_config_file ]
+      actual_configs = configs.select{ |f| File.exists? f }
+      return false if actual_configs.empty?
+
+      actual_configs.collect!{ |f| YAML.load_file f }
+
+      actual_configs.inject({ servers: {} }) do |memo,yml|
+        memo.merge! parse_general_options(yml)
+
+        if yml['servers'].kind_of? Hash
+          yml['servers'].each_pair do |k,v|
+            if v.kind_of? Hash
+              memo[:servers][k] = (memo[:servers][k] || {}).merge(parse_server_options(v))
+            end
+          end
+        end
+
+        memo[:payload] = (memo[:payload] || {}).merge parse_payload_options(yml['payload'])
+        memo[:project] = (memo[:project] || {}).merge parse_project_options(yml['project'])
+
+        memo
+      end
+    end
+
+    def home_config_file
+      File.join File.expand_path('~'), '.probedock', 'config.yml'
+    end
+
+    def working_config_file
+      File.expand_path ENV['PROBE_DOCK_CONFIG'] || 'probedock.yml', Dir.pwd
+    end
+
+    def parse_env_flag name, default = false
+      val = parse_env_option name
+      val ? !!val.to_s.strip.match(/\A(1|y|yes|t|true)\Z/i) : default
+    end
+
+    def parse_env_option name
+      var = "PROBE_DOCK_#{name.upcase}"
+      ENV.key?(var) ? ENV[var] : nil
+    end
+
+    def parse_general_options h
+      parse_options h, %w(publish server local workspace)
+    end
+
+    def parse_server_options h
+      parse_options h, %w(name apiUrl apiToken apiVersion projectApiId)
+    end
+
+    def parse_payload_options h
+      parse_options h, %w(save print)
+    end
+
+    def parse_project_options h
+      parse_options h, %w(version apiId category tags tickets)
+    end
+
+    def parse_options h, keys
+      return {} unless h.kind_of? Hash
+      keys.inject({}){ |memo,k| memo[k.gsub(/(.)([A-Z])/, '\1_\2').downcase.to_sym] = h[k] if h.key?(k); memo }
+    end
+  end
+end

data/lib/probe_dock_ruby/project.rb

@@ -0,0 +1,30 @@
+module ProbeDockProbe
+
+  class Project
+    attr_accessor :version, :api_id, :category, :tags, :tickets
+
+    def initialize options = {}
+      update options
+    end
+
+    def update options = {}
+      %w(version api_id category).each do |k|
+        instance_variable_set "@#{k}", options[k.to_sym] ? options[k.to_sym].to_s : nil if options.key? k.to_sym
+      end
+      @tags = wrap(options[:tags]).compact if options.key? :tags
+      @tickets = wrap(options[:tickets]).compact if options.key? :tickets
+    end
+
+    def validate!
+      required = { "version" => @version, "API identifier" => @api_id }
+      missing = required.inject([]){ |memo,(k,v)| v.to_s.strip.length <= 0 ? memo << k : memo }
+      raise PayloadError.new("Missing project options: #{missing.join ', '}") if missing.any?
+    end
+
+    private
+
+    def wrap a
+      a.kind_of?(Array) ? a : [ a ]
+    end
+  end
+end

data/lib/probe_dock_ruby/server.rb

@@ -0,0 +1,59 @@
+require 'oj'
+require 'httparty'
+
+module ProbeDockProbe
+
+  class Server
+    attr_accessor :name, :api_url, :api_token, :project_api_id
+
+    class Error < ProbeDockProbe::Error
+      attr_reader :response
+
+      def initialize msg, response = nil
+        super msg
+        @response = response
+      end
+    end
+
+    def initialize options = {}
+      @name = options[:name].to_s.strip if options[:name]
+      @api_url = options[:api_url].to_s if options[:api_url]
+      @api_token = options[:api_token].to_s if options[:api_token]
+      @project_api_id = options[:project_api_id].to_s if options[:project_api_id]
+    end
+
+    def clear
+      @name = nil
+      @api_url = nil
+      @api_token = nil
+      @project_api_id = nil
+    end
+
+    def upload payload
+      validate!
+
+      body = Oj.dump payload, mode: :strict
+      res = HTTParty.post payload_uri, body: body, headers: payload_headers
+
+      if res.code != 202
+        raise Error.new("Expected HTTP 202 Accepted when submitting payload, got #{res.code}", res)
+      end
+    end
+
+    private
+
+    def validate!
+      required = { "name" => @name, "apiUrl" => @api_url, "apiToken" => @api_token }
+      missing = required.inject([]){ |memo,(k,v)| v.to_s.strip.length <= 0 ? memo << k : memo }
+      raise Error.new("Server #{@name} is missing the following options: #{missing.join ', '}") if missing.any?
+    end
+
+    def payload_headers
+      { 'Authorization' => "Bearer #{@api_token}", 'Content-Type' => 'application/vnd.probedock.payload.v1+json' }
+    end
+
+    def payload_uri
+      "#{@api_url}/publish"
+    end
+  end
+end

data/lib/probe_dock_ruby/tasks.rb

@@ -0,0 +1,62 @@
+require 'fileutils'
+require 'rake/tasklib'
+
+module ProbeDockProbe
+
+  class Tasks < ::Rake::TaskLib
+
+    def initialize
+
+      namespace :spec do
+
+        namespace 'probedock' do
+
+          desc "Generate a test run UID to group test results in Probe Dock (stored in an environment variable)"
+          task :uid do
+            trace do
+              uid = uid_manager.generate_uid_to_env
+              puts Paint["Probe Dock - Generated UID for test run: #{uid}", :cyan]
+            end
+          end
+
+          namespace :uid do
+
+            desc "Generate a test run UID to group test results in Probe Dock (stored in a file)"
+            task :file do
+              trace do
+                uid = uid_manager.generate_uid_to_file
+                puts Paint["Probe Dock - Generated UID for test run: #{uid}", :cyan]
+              end
+            end
+
+            desc "Clean the test run UID (file and environment variable)"
+            task :clean do
+              trace do
+                uid_manager.clean_uid
+                puts Paint["Probe Dock - Cleaned test run UID", :cyan]
+              end
+            end
+          end
+        end
+      end
+    end
+
+    private
+
+    def trace &block
+      if Rake.application.options.trace
+        block.call
+      else
+        begin
+          block.call
+        rescue UID::Error => e
+          warn Paint["Probe Dock - #{e.message}", :red]
+        end
+      end
+    end
+
+    def uid_manager
+      UID.new ProbeDockProbe.config.client_options
+    end
+  end
+end

data/lib/probe_dock_ruby/test_payload.rb

@@ -0,0 +1,18 @@
+require 'fileutils'
+require 'digest/sha2'
+
+module ProbeDockProbe
+
+  class TestPayload
+
+    class Error < ProbeDockProbe::Error; end
+
+    def initialize run
+      @run = run
+    end
+
+    def to_h options = {}
+      @run.to_h options
+    end
+  end
+end

data/lib/probe_dock_ruby/test_result.rb

@@ -0,0 +1,112 @@
+module ProbeDockProbe
+  class TestResult
+    attr_reader :key, :name, :category, :tags, :tickets, :data, :duration, :message
+
+    def initialize project, example, groups = [], options = {}
+
+      @category = project.category
+      @tags = project.tags
+      @tickets = project.tickets
+
+      @grouped = extract_grouped example, groups
+
+      [ :key, :name, :category, :tags, :tickets, :data ].each do |attr|
+        instance_variable_set "@#{attr}".to_sym, send("extract_#{attr}".to_sym, example, groups)
+      end
+
+      @passed = !!options[:passed]
+      @duration = options[:duration]
+      @message = options[:message]
+    end
+
+    def passed?
+      @passed
+    end
+
+    def grouped?
+      @grouped
+    end
+
+    def update options = {}
+      @passed &&= options[:passed]
+      @duration += options[:duration]
+      @message = [ @message, options[:message] ].select{ |m| m }.join("\n\n") if options[:message]
+    end
+
+    def to_h options = {}
+      {
+        'p' => @passed,
+        'd' => @duration
+      }.tap do |h|
+        h['k'] = @key if @key
+        h['m'] = @message if @message
+        h['n'] = @name
+        h['c'] = @category
+        h['g'] = @tags
+        h['t'] = @tickets
+        h['a'] = @data
+      end
+    end
+
+    def self.extract_grouped example, groups = []
+      !!groups.collect{ |g| meta(g)[:grouped] }.compact.last
+    end
+
+    def self.extract_key example, groups = []
+      (groups.collect{ |g| meta(g)[:key] } << meta(example)[:key]).compact.reject{ |k| k.strip.empty? }.last
+    end
+
+    def self.meta holder
+      meta = holder.metadata[:probe_dock] || {}
+      if meta.kind_of? String
+        { key: meta }
+      elsif meta.kind_of? Hash
+        meta
+      else
+        {}
+      end
+    end
+
+    private
+
+    def meta *args
+      self.class.meta *args
+    end
+
+    def extract_grouped *args
+      self.class.extract_grouped *args
+    end
+
+    def extract_key *args
+      self.class.extract_key *args
+    end
+
+    def extract_name example, groups = []
+      parts = groups.dup
+      parts = parts[0, parts.index{ |p| meta(p)[:grouped] } + 1] if @grouped
+      parts << example unless @grouped
+      parts.collect{ |p| p.description.strip }.join ' '
+    end
+
+    def extract_category example, groups = []
+      cat = (groups.collect{ |g| meta(g)[:category] }.unshift(@category) << meta(example)[:category]).compact.last
+      cat ? cat.to_s : nil
+    end
+
+    def extract_tags example, groups = []
+      (wrap(@tags) + groups.collect{ |g| wrap meta(g)[:tags] } + (wrap meta(example)[:tags])).flatten.compact.uniq.collect(&:to_s)
+    end
+
+    def extract_tickets example, groups = []
+      (wrap(@tickets) + groups.collect{ |g| wrap meta(g)[:tickets] } + (wrap meta(example)[:tickets])).flatten.compact.uniq.collect(&:to_s)
+    end
+
+    def extract_data example, groups = []
+      meta(example)[:data] || {}
+    end
+
+    def wrap a
+      a.kind_of?(Array) ? a : [ a ]
+    end
+  end
+end

data/lib/probe_dock_ruby/test_run.rb

@@ -0,0 +1,84 @@
+module ProbeDockProbe
+
+  class TestRun
+    attr_reader :results, :project
+    attr_accessor :duration, :uid
+
+    def initialize project
+      @results = []
+      @project = project
+    end
+
+    def add_result example, groups = [], options = {}
+      if TestResult.extract_grouped(example, groups) and (existing_result = @results.find{ |r| r.grouped? && r.key == TestResult.extract_key(example, groups) })
+        existing_result.update options
+      else
+        @results << TestResult.new(@project, example, groups, options)
+      end
+    end
+
+    def results_without_key
+      @results.select{ |r| !r.key or r.key.to_s.strip.empty? }
+    end
+
+    def results_by_key
+      @results.inject({}) do |memo,r|
+        (memo[r.key] ||= []) << r unless !r.key or r.key.to_s.strip.empty?
+        memo
+      end
+    end
+
+    def to_h options = {}
+      validate!
+
+      {
+        'projectId' => @project.api_id,
+        'version' => @project.version,
+        'duration' => @duration,
+        'results' => @results.collect{ |r| r.to_h options }
+      }.tap do |h|
+        h['reports'] = [ { 'uid' => @uid } ] if @uid
+      end
+    end
+
+    private
+
+    def validate!
+      # TODO: validate duration
+
+      raise PayloadError.new("Missing project") if !@project
+      @project.validate!
+
+      # FIXME: log info/warnings
+      #validate_no_results_without_key
+      #validate_no_duplicate_keys
+    end
+
+    def validate_no_duplicate_keys
+
+      results_with_duplicate_key = results_by_key.select{ |k,r| r.length >= 2 }
+      return if results_with_duplicate_key.none?
+
+      msg = "the following keys are used by multiple test results".tap do |s|
+        results_with_duplicate_key.each_pair do |key,results|
+          s << "\n     - #{key}"
+          results.each{ |r| s << "\n       - #{r.name}" }
+        end
+      end
+
+      raise PayloadError.new(msg)
+    end
+
+    def validate_no_results_without_key
+
+      keyless = results_without_key
+      return if keyless.empty?
+
+      msg = "the following test results are missing a key".tap do |s|
+        keyless.each{ |r| s << "\n     - #{r.name}" }
+      end
+
+      raise PayloadError.new(msg)
+    end
+  end
+end

data/lib/probe_dock_ruby/uid.rb

@@ -0,0 +1,60 @@
+require 'securerandom'
+
+module ProbeDockProbe
+
+  class UID
+    ENVIRONMENT_VARIABLE = 'PROBE_DOCK_TEST_REPORT_UID'
+
+    class Error < ProbeDockProbe::Error; end
+
+    def initialize options = {}
+      @workspace = options[:workspace]
+    end
+
+    def load_uid
+      if env_var
+        return env_var
+      elsif @workspace
+        current_uid
+      end
+    end
+
+    def generate_uid_to_file
+      raise Error.new("No workspace specified; cannot save test run UID") if !@workspace
+      generate_uid.tap{ |uid| save_uid uid }
+    end
+
+    def generate_uid_to_env
+      raise Error.new("$PROBE_DOCK_TEST_REPORT_UID is already defined") if env_var
+      ENV[ENVIRONMENT_VARIABLE] = generate_uid
+    end
+
+    def clean_uid
+      ENV.delete ENVIRONMENT_VARIABLE
+      FileUtils.remove_entry_secure uid_file if @workspace and File.exists?(uid_file)
+    end
+
+    private
+
+    def save_uid uid
+      FileUtils.mkdir_p File.dirname(uid_file)
+      File.open(uid_file, 'w'){ |f| f.write uid }
+    end
+
+    def env_var
+      ENV[ENVIRONMENT_VARIABLE]
+    end
+
+    def current_uid
+      File.file?(uid_file) ? File.read(uid_file) : nil
+    end
+
+    def uid_file
+      @uid_file ||= File.join(@workspace, 'uid')
+    end
+
+    def generate_uid
+      "#{Time.now.utc.strftime '%Y%m%d%H%M%S'}-#{SecureRandom.uuid}"
+    end
+  end
+end

data/lib/probedock-ruby.rb

@@ -0,0 +1 @@
+require 'probe_dock_ruby'

metadata

@@ -0,0 +1,230 @@
+--- !ruby/object:Gem::Specification
+name: probedock-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Simon Oulevay (Alpha Hydrae)
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: paint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake-version
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: fakefs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rspec-collection_matchers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: Ruby library to develop new probes for Probe Dock. It can parse Probe
+  Dock configuration files, collect test results and publish them to a Probe Dock
+  server.
+email: devops@probedock.io
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- Gemfile
+- LICENSE.txt
+- README.md
+- VERSION
+- lib/probe_dock_ruby.rb
+- lib/probe_dock_ruby/client.rb
+- lib/probe_dock_ruby/config.rb
+- lib/probe_dock_ruby/project.rb
+- lib/probe_dock_ruby/server.rb
+- lib/probe_dock_ruby/tasks.rb
+- lib/probe_dock_ruby/test_payload.rb
+- lib/probe_dock_ruby/test_result.rb
+- lib/probe_dock_ruby/test_run.rb
+- lib/probe_dock_ruby/uid.rb
+- lib/probedock-ruby.rb
+homepage: https://github.com/probedock/probedock-ruby
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Ruby library to develop new probes for Probe Dock.
+test_files: []