chronos-api 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c8b3bb07696860917d8bccddca5b914f7919887e
+  data.tar.gz: f7e52fdd59a659d95095cc3ec032129a1edc1dff
+SHA512:
+  metadata.gz: 5e7ea78dbb616f3511a943aa28dcafb9ac394906fbcfa352a01feaf0e25f32fde0bd01c5e0285d8369e8e8c1adbb7a9539883968b15c657617f0174724b531e9
+  data.tar.gz: e9ad14c088f26051c7348efc8c7492984bbb6d29bc11c7441f715870313c833a265fd7c4dabea59bab06a074bece3bd40ebe664a927bb955fa75b9a9163ae189

data/.gitignore

@@ -0,0 +1,7 @@
+.bundle
+.DS_Store
+*.swp
+*.gem
+Gemfile.lock
+vendor
+coverage/

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.5
+  - 2.2.0
+script: bundle exec rake

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Algolia
+
+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,164 @@
+chronos-api
+============
+
+[![Gem Version](https://badge.fury.io/rb/chronos-api.svg)](http://badge.fury.io/rb/chronos-api) [![travis-ci](https://travis-ci.org/algolia/chronos-api.png?branch=master)](https://travis-ci.org/algolia/chronos-api)
+
+This gem provides a CLI and a simple REST API client for [Chronos](https://github.com/mesos/chronos).
+
+Installation
+------------
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'chronos-api', :require => 'chronos'
+```
+
+And then run:
+
+```shell
+$ bundle install
+```
+
+Usage
+-----
+
+If you're running Chronos locally on port 4400, there is no setup to do in Ruby. If you're not or change the path or port,  you'll have to point the gem to your socket or local/remote port. For example:
+
+```ruby
+Chronos.url = 'http://example.com:8080'
+```
+
+It's possible to use `ENV` variables to configure the endpoint as well:
+
+```shell
+$ CHRONOS_URL=http://remote.chronos.example.com:8080 irb
+irb(main):001:0> require 'chronos'
+=> true
+irb(main):002:0> Chronos.url
+=> "http://remote.chronos.example.com:8080"
+```
+
+## Authentification
+
+You have two options to set authentification if your Chronos API requires it:
+
+```ruby
+Chronos.options = {:username => 'your-user-name', :password => 'your-secret-password'}
+```
+
+or
+
+```shell
+$ export CHRONOS_USER=your-user-name
+$ export CHRONOS_PASSWORD=your-secret-password
+$ irb
+irb(main):001:0> require 'chronos'
+=> true
+irb(main):002:0> Chronos.options
+=> {:username => "your-user-name", :password => "your-secret-password"}
+```
+
+or
+
+```shell
+$ chronos -c http://USERNAME:PASSWORD@HOST:PORT
+```
+
+## List
+
+To list the current scheduled jobs:
+
+```ruby
+require 'chronos'
+jobs = Chronos.list
+```
+
+or
+
+```shell
+$ chronos list
+```
+
+## Add a job
+
+To add a new job:
+
+```ruby
+require 'chronos'
+Chronos.add({
+  name: 'myjob',
+  schedule: 'R10/2012-10-01T05:52:00Z/PT2S',
+  epsilon: 'PT15M',
+  command: 'echo foobar',
+  owner: 'chronos@algolia.com',
+  async: false
+})
+```
+
+or
+
+```shell
+$ chronos add --job /path/to/job/details.json
+```
+
+## Delete a job
+
+To delete a job:
+
+```ruby
+require 'chronos'
+Chronos.delete('job_name')
+```
+
+or
+
+```shell
+$ chronos delete --name job_name
+```
+
+## Delete all jobs
+
+To delete all jobs:
+
+```ruby
+require 'chronos'
+Chronos.delete_all
+```
+
+or
+
+```shell
+$ chronos delete_all
+```
+
+## Manually start a job
+
+To manually start a job:
+
+```ruby
+require 'chronos'
+Chronos.start('job_name')
+```
+
+or
+
+```shell
+$ chronos start --name job_name
+```
+
+Contributing
+------------
+
+Please fork and send pull request.
+Make sure to have test cases for your changes.
+
+Credits
+-------
+
+This gem has been highly inspired by [marathon-api](https://github.com/otto-de/marathon-api).
+
+License
+-------
+
+This program is licensed under the MIT license. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'rake'
+require 'json'
+require 'chronos'
+require 'rspec/core/rake_task'
+
+task :default => [:spec]
+
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+end

data/bin/chronos

@@ -0,0 +1,134 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'chronos'))
+require 'trollop'
+require 'json'
+require 'terminal-table'
+
+## Sub commands
+
+SUB_COMMANDS = %w[list delete delete_all start add] # TODO: delete_tasks add_dependency add_docker graph task]
+
+# list
+def subcmd_list(cmd_opts)
+  rows = []
+  Chronos.list.each do |job|
+    cmd = job['command'] || ''
+    cmd = "#{cmd[0..50]}..." if cmd.size > 50
+    rows << [ job['name'], job['owner'], cmd, job['cpus'], job['mem'], job['disk'], job['disabled'], job['schedule'] ]
+  end
+  puts Terminal::Table.new :headings => ['Name', 'Owner', 'Command', 'CPU', 'MEM', 'Disk', 'Disabled', 'Schedule'], :rows => rows
+end
+
+# add
+def subcmd_add(cmd_opts)
+  job = JSON.parse(cmd_opts[:job] == '-' ? $stdin.read : File.read(cmd_opts[:job]))
+  Chronos.add(job)
+end
+
+# delete
+def subcmd_delete(cmd_opts)
+  Chronos.delete(cmd_opts[:name])
+end
+
+# delete_all
+def subcmd_delete_all(cmd_opts)
+  Chronos.delete_all
+end
+
+# start
+def subcmd_start(cmd_opts)
+  Chronos.start(cmd_opts[:name])
+end
+
+## Commands
+
+# parse global options
+def parse_global_opts
+  global_opts = Trollop.options do
+    version Chronos::VERSION
+    banner <<-EOS
+Usage: chronos [global options] [command] [options]
+
+Available commands:
+
+  list           List all jobs
+  delete         Delete a job
+  delete_all     Delete all jobs
+  start          Start a job
+  add            Add a new job
+
+  TODO:
+  #delete_tasks   Delete all tasks of a job
+  #add_dependency Add a new job add_dependency
+  #add_docker     Add a new docker job
+  #graph          See the dependencies graph
+  #task           Get a task status
+
+Global options:
+EOS
+
+    opt :url, 'Chronos host (default http://localhost:4400, or CHRONOS_URL)',
+      :short => '-c', :type => String
+    opt :username, 'User name to authenticate against Chronos (optional, default unset, or CHRONOS_USER).',
+      :short => '-u', :type => String
+    opt :password, 'Password to authenticate against Chronos (optional, default unset, or CHRONOS_PASSWORD).',
+      :short => '-p', :type => String
+    stop_on SUB_COMMANDS
+  end
+  return global_opts
+end
+
+# set global options to Marathon API
+def set_global_opts(global_opts)
+  # Set client's URL
+  Chronos.url = global_opts[:url] if global_opts[:url]
+  global_opts.delete(:url)
+  # Set client's options
+  Chronos.options = global_opts if global_opts.size > 0
+end
+
+# get the subcommand
+def parse_subcmd
+  cmd = ARGV.shift
+  return cmd
+end
+
+# parse subcommand specific options
+def parse_subcmd_opts(cmd)
+  cmd_opts = case cmd
+    when 'add'
+      Trollop.options do
+        opt :job, 'A JSON formatted file to read job details from. (use - to read from stdin)', short: 'j', type: String, required: true
+      end
+    when 'delete'
+      Trollop.options do
+        opt :name, 'The name of the job to delete', short: 'n', type: String, required: true
+      end
+    when 'start'
+      Trollop.options do
+        opt :name, 'The name of the job to start', short: 'n', type: String, required: true
+      end
+    else
+      {}
+    end
+
+  return cmd_opts
+end
+
+# Run selected subcmd
+def run_subcmd(cmd, cmd_opts)
+  if SUB_COMMANDS.include?(cmd)
+    send("subcmd_#{cmd}", cmd_opts)
+  else
+    Trollop.die "unknown subcommand #{cmd.inspect}"
+  end
+end
+
+global_opts = parse_global_opts
+set_global_opts(global_opts)
+
+cmd = parse_subcmd
+cmd_opts = parse_subcmd_opts(cmd)
+
+run_subcmd(cmd, cmd_opts)

data/chronos-api.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/chronos/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name          = "chronos-api"
+  gem.version       = Chronos::VERSION
+  gem.authors       = ["Algolia Team"]
+  gem.email         = %w{support@algolia.com}
+  gem.description   = %q{A simple REST client for the Chronos API}
+  gem.summary       = %q{A simple REST client for the Chronos API}
+  gem.homepage      = 'https://github.com/algolia/chronos-api'
+  gem.license       = 'MIT'
+
+  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 = %w{lib}
+
+  gem.add_dependency 'json'
+  gem.add_dependency 'httparty', '~> 0.11.0'
+  gem.add_dependency 'trollop', '~> 2.0.0'
+  gem.add_dependency 'terminal-table', '~> 1.4.3'
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec', '~> 3.0'
+  gem.add_development_dependency 'rspec-its'
+  gem.add_development_dependency 'vcr', '>= 2.7.0'
+  gem.add_development_dependency 'webmock'
+  gem.add_development_dependency 'pry'
+end

data/lib/chronos.rb

@@ -0,0 +1,95 @@
+require 'rubygems/package'
+require 'httparty'
+require 'json'
+require 'uri'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+# The top-level module for this gem. It's purpose is to hold global
+# configuration variables that are used as defaults in other classes.
+module Chronos
+
+  attr_accessor :logger
+
+  require 'chronos/version'
+  require 'chronos/error'
+  require 'chronos/connection'
+
+  DEFAULT_URL = 'http://localhost:4400'
+
+  # Get the chronos url from environment
+  def env_url
+    ENV['CHRONOS_URL']
+  end
+
+  # Get marathon options from environment
+  def env_options
+    opts = {}
+    opts[:username] = ENV['CHRONOS_USER'] if ENV['CHRONOS_USER']
+    opts[:password] = ENV['CHRONOS_PASSWORD'] if ENV['CHRONOS_PASSWORD']
+    opts
+  end
+
+  # Get the marathon API URL
+  def url
+    @url ||= env_url || DEFAULT_URL
+    @url
+  end
+
+  # Get options for connecting to marathon API
+  def options
+    @options ||= env_options
+  end
+
+  # Set a new url
+  def url=(new_url)
+    @url = new_url
+    reset_connection!
+  end
+
+  # Set new options
+  def options=(new_options)
+    @options = env_options.merge(new_options || {})
+    reset_connection!
+  end
+
+  # Set a new connection
+  def connection
+    @connection ||= Connection.new(url, options)
+  end
+
+  # Reset the connection
+  def reset_connection!
+    @connection = nil
+  end
+
+  # list jobs
+  def list
+    connection.get('/scheduler/jobs')
+  end
+
+  ## add job
+  def add(job)
+    connection.post('/scheduler/iso8601', nil, body: job)
+  end
+
+  # delete job
+  def delete(name)
+    connection.delete("/scheduler/job/#{URI.encode name}")
+  end
+
+  # delete all jobs
+  def delete_all
+    connection.delete('/scheduler/jobs')
+  end
+
+  # start a job
+  def start(name)
+    connection.put("/scheduler/job/#{URI.encode name}")
+  end
+
+  module_function :connection, :env_options, :env_url, :logger, :logger=,
+                  :options, :options=, :url, :url= ,:reset_connection!,
+                  :list, :add, :delete, :delete_all, :start
+
+end

data/lib/chronos/connection.rb

@@ -0,0 +1,107 @@
+# This class represents a Chronos API Connection.
+class Chronos::Connection
+
+  include Chronos::Error
+  include HTTParty
+
+  headers(
+    'Content-Type' => 'application/json',
+    'Accept' => 'application/json',
+    'User-Agent' => "Chronos-API #{Chronos::VERSION}"
+  )
+
+  default_timeout 5
+  maintain_method_across_redirects
+
+  attr_reader :url, :options
+
+  # Create a new API connection.
+  # ++url++: URL of the chronos API.
+  # ++options++: Hash with options for chronos API.
+  def initialize(url, options = {})
+    @url = url
+    @options = options
+    if @options[:username] and @options[:password]
+      @options[:basic_auth] = {
+        :username => @options[:username],
+        :password => @options[:password]
+      }
+      @options.delete(:username)
+      @options.delete(:password)
+    end
+  end
+
+  # Delegate all HTTP methods to the #request.
+  [:get, :put, :post, :delete].each do |method|
+    define_method(method) { |*args, &block| request(method, *args) }
+  end
+
+  def to_s
+    "Chronos::Connection { :url => #{url} :options => #{options} }"
+  end
+
+private
+
+  # Create URL suffix for a hash of query parameters.
+  # URL escaping is done internally.
+  # ++query++: Hash of query parameters.
+  def query_params(query)
+    query = query.select { |k,v| !v.nil? }
+    URI.escape(query.map { |k,v| "#{k}=#{v}" }.join('&'))
+  end
+
+  # Create request object.
+  # ++http_method++: GET/POST/PUT/DELETE.
+  # ++path++: Relative path to connection's URL.
+  # ++query++: Optional query parameters.
+  # ++opts++: Optional options. Ex. opts[:body] is used for PUT/POST request.
+  def compile_request_params(http_method, path, query = nil, opts = nil)
+    query ||= {}
+    opts ||= {}
+    headers = opts.delete(:headers) || {}
+    opts[:body] = opts[:body].to_json unless opts[:body].nil?
+    {
+      :method        => http_method,
+      :url           => "#{@url}#{path}",
+      :query         => query
+    }.merge(opts).reject { |_, v| v.nil? }
+  end
+
+  # Create full URL with query parameters.
+  # ++request++: hash containing :url and optional :query
+  def build_url(request)
+    url = URI.escape(request[:url])
+    if request[:query].size > 0
+      url += '?' + query_params(request[:query])
+    end
+    url
+  end
+
+  # Parse response or raise error.
+  # ++response++: response from HTTParty call.
+  def parse_response(response)
+    if response.success?
+      response.parsed_response
+    else
+      raise Chronos::Error.from_response(response)
+    end
+  end
+
+  # Send a request to the server and parse response.
+  # ++http_method++: GET/POST/PUT/DELETE.
+  # ++path++: Relative path to connection's URL.
+  # ++query++: Optional query parameters.
+  # ++opts++: Optional options. Ex. opts[:body] is used for PUT/POST request.
+  def request(*args)
+    request = compile_request_params(*args)
+    url = build_url(request)
+    parse_response(self.class.send(request[:method], url, request))
+  rescue => e
+    if e.class == SocketError or e.class.name.start_with?('Errno::')
+      raise IOError, "HTTP call failed: #{e.message}"
+    else
+      raise e
+    end
+  end
+
+end

data/lib/chronos/error.rb

@@ -0,0 +1,68 @@
+# This module holds the Errors for the gem.
+module Chronos::Error
+  # The default error. It's never actually raised, but can be used to catch all
+  # gem-specific errors that are thrown as they all subclass from this.
+  class ChronosError < StandardError; end
+
+  # Raised when invalid arguments are passed to a method.
+  class ArgumentError < ChronosError; end
+
+  # Raised when a request returns a 400 or 422.
+  class ClientError < ChronosError; end
+
+  # Raised when a request returns a 404.
+  class NotFoundError < ChronosError; end
+
+  # Raised when there is an unexpected response code / body.
+  class UnexpectedResponseError < ChronosError; end
+
+  # Raised when a request times out.
+  class TimeoutError < ChronosError; end
+
+  # Raised when login fails.
+  class AuthenticationError < ChronosError; end
+
+  # Raised when an IO action fails.
+  class IOError < ChronosError; end
+
+  # Raise error specific to http response.
+  # ++response++: HTTParty response object.
+  def from_response(response)
+    error_class(response).new(error_message(response))
+  end
+
+  private
+
+  # Get reponse code specific error class.
+  # ++response++: HTTParty response object.
+  def error_class(response)
+    case response.code
+    when 400
+      ClientError
+    when 422
+      ClientError
+    when 404
+      NotFoundError
+    else
+      UnexpectedResponseError
+    end
+  end
+
+  # Get response code from http response.
+  # ++response++: HTTParty response object.
+  def error_message(response)
+    body = response.parsed_response
+    if not body.is_a?(Hash)
+      body
+    elsif body['message']
+      body['message']
+    elsif body['errors']
+      body['errors']
+    else
+      body
+    end
+  end
+
+  module_function :error_class, :error_message, :from_response
+
+end

data/lib/chronos/version.rb

@@ -0,0 +1,3 @@
+module Chronos
+  VERSION = '0.0.1'
+end

data/spec/chronos/chronos_spec.rb

@@ -0,0 +1,119 @@
+require 'spec_helper'
+
+describe Chronos do
+
+  describe '.url=' do
+    subject { described_class }
+
+    it 'sets new url' do
+      described_class.url = 'http://foo'
+      expect(described_class.url).to eq('http://foo')
+
+      # reset connection after running this spec
+      described_class.url = nil
+    end
+
+    it 'resets connection' do
+      old_connection = described_class.connection
+      described_class.url = 'http://bar'
+
+      expect(described_class.connection).not_to be(old_connection)
+
+      # reset connection after running this spec
+      described_class.url = nil
+    end
+  end
+
+  describe '.options=' do
+    subject { described_class }
+
+    it 'sets new options' do
+      described_class.options = {:foo => 'bar'}
+      expect(described_class.options).to eq({:foo => 'bar'})
+
+      # reset connection after running this spec
+      described_class.options = nil
+    end
+
+    it 'resets connection' do
+      old_connection = described_class.connection
+      described_class.options = {:foo => 'bar'}
+
+      expect(described_class.connection).not_to be(old_connection)
+
+      # reset connection after running this spec
+      described_class.options = nil
+    end
+
+    it 'adds :basic_auth options for :username and :password' do
+      described_class.options = {:username => 'user', :password => 'password'}
+      expect(described_class.connection.options)
+        .to eq({:basic_auth => {:username => 'user', :password => 'password'}})
+
+      # reset connection after running this spec
+      described_class.options = nil
+    end
+  end
+
+  describe '.list' do
+    subject { described_class }
+
+    it 'lists jobs', :vcr do
+      jobs = described_class.list
+      expect(jobs.size).to eq(1)
+      expect(jobs[0]['name']).to eq('SAMPLE_JOB1')
+    end
+  end
+
+  describe '.add' do
+    subject { described_class }
+
+    it 'adds a job', :vcr do
+      described_class.add({
+        schedule: 'R10/2012-10-01T05:52:00Z/PT2S',
+        name: 'SAMPLE_JOB1',
+        epsilon: 'PT15M',
+        command: 'echo FOO',
+        owner: 'chronos@algolia.com',
+        async: false
+      })
+    end
+  end
+
+  describe '.delete' do
+    subject { described_class }
+
+    it 'deletes a job', :vcr do
+      described_class.delete('SAMPLE_JOB1')
+    end
+
+    it 'raises a 400 if the job to delete doesn\'t exist', :vcr do
+      expect {
+        described_class.delete('doesnt_exist')
+      }.to raise_error(Chronos::Error::ClientError)
+    end
+  end
+
+
+  describe '.delete_all' do
+    subject { described_class }
+
+    it 'deletes all jobs', :vcr do
+      described_class.delete_all
+    end
+  end
+
+  describe '.start' do
+    subject { described_class }
+
+    it 'starts a job', :vcr do
+      described_class.start('SAMPLE_JOB1')
+    end
+
+    it 'raises a 400 if the jobs to start doesn\'t exist', :vcr do
+      expect {
+        described_class.start('doesnt_exist')
+      }.to raise_error(Chronos::Error::ClientError)
+    end
+  end
+end

data/spec/chronos/connection_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe Chronos::Connection do
+
+  describe '#to_s' do
+    subject { described_class.new('http://foo:4400') }
+
+    let(:expected_string) do
+      "Chronos::Connection { :url => http://foo:4400 :options => {} }"
+    end
+
+    its(:to_s) { should == expected_string }
+  end
+
+  describe '#request' do
+    subject { described_class.new('http://foo.example.org:8080') }
+
+    it 'raises IOError on SocketError' do
+      allow(described_class).to receive(:send) { raise SocketError.new }
+      expect {
+        subject.get('/path')
+      }.to raise_error(Chronos::Error::IOError)
+    end
+
+    it 'raises IOError on Errno' do
+      allow(described_class).to receive(:send) { raise Errno::EINTR.new }
+      expect {
+        subject.get('/path')
+      }.to raise_error(Chronos::Error::IOError)
+    end
+
+    it 'raises original error when unknown' do
+      allow(described_class).to receive(:send) { raise RuntimeError.new }
+      expect {
+        subject.get('/path')
+      }.to raise_error(RuntimeError)
+    end
+  end
+
+end

data/spec/chronos/error_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe Chronos::Error do
+
+  describe '.error_class' do
+    subject { described_class }
+
+    it 'returns ClientError on 400' do
+      expect(subject.error_class(Net::HTTPResponse.new(1.1, 400, 'Client Error')))
+        .to be(Chronos::Error::ClientError)
+    end
+
+    it 'returns ClientError on 422' do
+      expect(subject.error_class(Net::HTTPResponse.new(1.1, 422, 'Client Error')))
+        .to be(Chronos::Error::ClientError)
+    end
+
+    it 'returns NotFoundError on 404' do
+      expect(subject.error_class(Net::HTTPResponse.new(1.1, 404, 'Not Found')))
+        .to be(Chronos::Error::NotFoundError)
+    end
+
+    it 'returns UnexpectedResponseError anything else' do
+      expect(subject.error_class(Net::HTTPResponse.new(1.1, 599, 'Whatever')))
+        .to be(Chronos::Error::UnexpectedResponseError)
+    end
+  end
+
+  describe '.error_message' do
+    subject { described_class }
+
+    it 'returns "message" from respose json' do
+      r = { 'message' => 'fooo' }
+      expect(r).to receive(:parsed_response) { r }
+      expect(subject.error_message(r)).to eq('fooo')
+    end
+
+    it 'returns "errors" from respose json' do
+      r = { 'errors' => 'fooo' }
+      expect(r).to receive(:parsed_response) { r }
+      expect(subject.error_message(r)).to eq('fooo')
+    end
+
+    it 'returns full hash from respose json, if keys are missing' do
+      r = { 'bars' => 'fooo' }
+      expect(r).to receive(:parsed_response) { r }
+      expect(subject.error_message(r)).to eq(r)
+    end
+
+    it 'returns full body if not a hash with "message"' do
+      r = 'fooo'
+      expect(r).to receive(:parsed_response) { r }
+      expect(subject.error_message(r)).to eq('fooo')
+    end
+  end
+
+end

data/spec/fixtures/Chronos/_add/adds_a_job.yml

@@ -0,0 +1,25 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:4400/scheduler/iso8601
+    body:
+      encoding: UTF-8
+      string: '{"schedule":"R10/2012-10-01T05:52:00Z/PT2S","name":"SAMPLE_JOB1","epsilon":"PT15M","command":"echo FOO","owner":"chronos@algolia.com","async":false}'
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json
+      User-Agent:
+      - Chronos-API 0.0.1
+  response:
+    status:
+      code: 200
+      message: OK
+    body:
+      encoding: UTF-8
+      string: ""
+    http_version: 
+  recorded_at: Fri, 03 Apr 2015 19:18:04 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/Chronos/_delete/deletes_a_job.yml

@@ -0,0 +1,25 @@
+---
+http_interactions:
+- request:
+    method: delete
+    uri: http://localhost:4400/scheduler/job/SAMPLE_JOB1
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json
+      User-Agent:
+      - Chronos-API 0.0.1
+  response:
+    status:
+      code: 204
+      message: OK
+    body:
+      encoding: UTF-8
+      string: ""
+    http_version: 
+  recorded_at: Fri, 03 Apr 2015 19:29:16 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/Chronos/_delete/raises_a_400_if_the_job_to_delete_doesn_t_exist.yml

@@ -0,0 +1,25 @@
+---
+http_interactions:
+- request:
+    method: delete
+    uri: http://localhost:4400/scheduler/job/doesnt_exist
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json
+      User-Agent:
+      - Chronos-API 0.0.1
+  response:
+    status:
+      code: 400
+      message: Bad Request
+    body:
+      encoding: UTF-8
+      string: "requirement failed: Job 'doesnt_exist' not found"
+    http_version: 
+  recorded_at: Fri, 03 Apr 2015 19:41:52 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/Chronos/_delete_all/deletes_all_jobs.yml

@@ -0,0 +1,25 @@
+---
+http_interactions:
+- request:
+    method: delete
+    uri: http://localhost:4400/scheduler/jobs
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json
+      User-Agent:
+      - Chronos-API 0.0.1
+  response:
+    status:
+      code: 204
+      message: OK
+    body:
+      encoding: UTF-8
+      string: ""
+    http_version: 
+  recorded_at: Fri, 03 Apr 2015 19:31:17 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/Chronos/_list/lists_jobs.yml

@@ -0,0 +1,28 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://localhost:4400/scheduler/jobs
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json
+      User-Agent:
+      - Chronos-API 1.1.0
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - application/json
+    body:
+      encoding: UTF-8
+      string: '[{"name":"SAMPLE_JOB1","command":"echo FOO","shell":true,"epsilon":"PT15M","executor":"","executorFlags":"","retries":2,"owner":"chronos@algolia.com","async":false,"successCount":0,"errorCount":0,"lastSuccess":"","lastError":"","cpus":0.1,"disk":256.0,"mem":128.0,"disabled":false,"softError":false,"errorsSinceLastSuccess":0,"uris":[],"environmentVariables":[],"arguments":[],"highPriority":false,"runAsUser":"root","schedule":"R10/2012-10-01T05:52:00Z/PT2S","scheduleTimeZone":""}]'
+    http_version:
+  recorded_at: Fri, 03 Apr 2015 19:18:04 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/Chronos/_start/raises_a_400_if_the_jobs_to_start_doesn_t_exist.yml

@@ -0,0 +1,25 @@
+---
+http_interactions:
+- request:
+    method: put
+    uri: http://localhost:4400/scheduler/job/doesnt_exist
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json
+      User-Agent:
+      - Chronos-API 0.0.1
+  response:
+    status:
+      code: 400
+      message: Bad Request
+    body:
+      encoding: UTF-8
+      string: ""
+    http_version: 
+  recorded_at: Fri, 03 Apr 2015 19:44:16 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/Chronos/_start/starts_a_job.yml

@@ -0,0 +1,25 @@
+---
+http_interactions:
+- request:
+    method: put
+    uri: http://localhost:4400/scheduler/job/SAMPLE_JOB1
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept:
+      - application/json
+      User-Agent:
+      - Chronos-API 0.0.1
+  response:
+    status:
+      code: 204
+      message: OK
+    body:
+      encoding: UTF-8
+      string: ""
+    http_version: 
+  recorded_at: Fri, 03 Apr 2015 19:32:45 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/add.json

@@ -0,0 +1,9 @@
+{
+  "schedule": "R10/2012-10-01T05:52:00Z/PT2S",
+  "name": "SAMPLE_JOB1",
+  "epsilon": "PT15M",
+  "command": "echo FOO",
+  "owner": "chronos@algolia.com",
+  "async": false
+}
+

data/spec/spec_helper.rb

@@ -0,0 +1,30 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rspec'
+require 'rspec/its'
+require 'vcr'
+require 'webmock'
+require 'chronos'
+
+VCR.configure do |c|
+  c.allow_http_connections_when_no_cassette = false
+  c.cassette_library_dir = "spec/fixtures"
+  #c.debug_logger = $stdout
+  c.hook_into :webmock
+  c.configure_rspec_metadata!
+end
+
+RSpec.shared_context "local paths" do
+  def project_dir
+    File.expand_path(File.join(File.dirname(__FILE__), '..'))
+  end
+end
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+RSpec.configure do |c|
+  c.mock_with :rspec
+  c.color = true
+  c.formatter = :documentation
+  c.tty = true
+end

metadata

@@ -0,0 +1,221 @@
+--- !ruby/object:Gem::Specification
+name: chronos-api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Algolia Team
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !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: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A simple REST client for the Chronos API
+email:
+- support@algolia.com
+executables:
+- chronos
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/chronos
+- chronos-api.gemspec
+- lib/chronos.rb
+- lib/chronos/connection.rb
+- lib/chronos/error.rb
+- lib/chronos/version.rb
+- spec/chronos/chronos_spec.rb
+- spec/chronos/connection_spec.rb
+- spec/chronos/error_spec.rb
+- spec/fixtures/Chronos/_add/adds_a_job.yml
+- spec/fixtures/Chronos/_delete/deletes_a_job.yml
+- spec/fixtures/Chronos/_delete/raises_a_400_if_the_job_to_delete_doesn_t_exist.yml
+- spec/fixtures/Chronos/_delete_all/deletes_all_jobs.yml
+- spec/fixtures/Chronos/_list/lists_jobs.yml
+- spec/fixtures/Chronos/_start/raises_a_400_if_the_jobs_to_start_doesn_t_exist.yml
+- spec/fixtures/Chronos/_start/starts_a_job.yml
+- spec/fixtures/add.json
+- spec/spec_helper.rb
+homepage: https://github.com/algolia/chronos-api
+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.2.2
+signing_key: 
+specification_version: 4
+summary: A simple REST client for the Chronos API
+test_files:
+- spec/chronos/chronos_spec.rb
+- spec/chronos/connection_spec.rb
+- spec/chronos/error_spec.rb
+- spec/fixtures/Chronos/_add/adds_a_job.yml
+- spec/fixtures/Chronos/_delete/deletes_a_job.yml
+- spec/fixtures/Chronos/_delete/raises_a_400_if_the_job_to_delete_doesn_t_exist.yml
+- spec/fixtures/Chronos/_delete_all/deletes_all_jobs.yml
+- spec/fixtures/Chronos/_list/lists_jobs.yml
+- spec/fixtures/Chronos/_start/raises_a_400_if_the_jobs_to_start_doesn_t_exist.yml
+- spec/fixtures/Chronos/_start/starts_a_job.yml
+- spec/fixtures/add.json
+- spec/spec_helper.rb