keboola-gooddata-writer 2.0.0.pre1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 85346de59e1ea53f6e4ba5e15629accc9ca519d5
+  data.tar.gz: 11eed840a3b3f0d4dcf741fb289b988f4183e853
+SHA512:
+  metadata.gz: 58927fffa6fb30be7bc722dfd76ab0e37e544f5f81d3967170ab7ed0268c380b1750eea3b895e58b97f9df6f252eb2a5bd45d0a550afedc88ac647c204f025b4
+  data.tar.gz: f7409cd5e031b9d94f30e478e5a4e6d6d8bec50d35726f2bd9e315852a07813ea7cb1d860469f6d569c239e553cb0b4aa797dbaf3354bca9d534c97c75f1988c

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1
+  - 2.2

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in keboola-gooddata-writer.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Roman Sklenář
+
+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,74 @@
+# Keboola GoodData Writer API Ruby client
+
+[![Quality](http://img.shields.io/codeclimate/github/romansklenar/gooddata-writer-ruby-client.svg?style=flat-square)](https://codeclimate.com/github/romansklenar/gooddata-writer-ruby-client)
+[![Coverage](http://img.shields.io/codeclimate/coverage/github/romansklenar/gooddata-writer-ruby-client.svg?style=flat-square)](https://codeclimate.com/github/romansklenar/gooddata-writer-ruby-client)
+[![Build](http://img.shields.io/travis-ci/romansklenar/gooddata-writer-ruby-client.svg?style=flat-square)](https://travis-ci.org/romansklenar/gooddata-writer-ruby-client)
+[![Dependencies](http://img.shields.io/gemnasium/romansklenar/gooddata-writer-ruby-client.svg?style=flat-square)](https://gemnasium.com/romansklenar/gooddata-writer-ruby-client)
+[![Downloads](http://img.shields.io/gem/dtv/gooddata-writer-ruby-client.svg?style=flat-square)](https://rubygems.org/gems/gooddata-writer-ruby-client)
+[![Tags](http://img.shields.io/github/tag/romansklenar/gooddata-writer-ruby-client.svg?style=flat-square)](http://github.com/romansklenar/gooddata-writer-ruby-client/tags)
+[![Releases](http://img.shields.io/github/release/romansklenar/gooddata-writer-ruby-client.svg?style=flat-square)](http://github.com/romansklenar/gooddata-writer-ruby-client/releases)
+[![Issues](http://img.shields.io/github/issues/romansklenar/gooddata-writer-ruby-client.svg?style=flat-square)](http://github.com/romansklenar/gooddata-writer-ruby-client/issues)
+[![License](http://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](http://opensource.org/licenses/MIT)
+[![Version](http://img.shields.io/gem/v/gooddata-writer-ruby-client.svg?style=flat-square)](https://rubygems.org/gems/gooddata-writer-ruby-client)
+
+
+Simple Ruby wrapper library for [Keboola GoodData Writer REST API](http://docs.keboolagooddatawriter.apiary.io/).
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'keboola-gooddata-writer'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install keboola-gooddata-writer
+
+## Usage
+
+Obtain your Keboola Storage API token and use to initialize client.
+
+```ruby
+api = Keboola::GoodDataWriter::API.new(token: '123-abcdefghjklmnopqrstuvxyz')
+
+# get details of specific writer
+api.writer('MyWriter') # {"bucket"=>"sys.c-wr-gooddata-writer1", "writer"=>"gooddata", "writerId"=>"writer1", …, "status"=>"ready"}
+
+# create GoodData project
+api.create_project('MyWriter', optionals: { name: 'KBC - MyProject - MyWriter' }) # <Keboola::GoodDataWriter::Job url="https://syrup.keboola.com/queue/jobs/123456", id="123456">
+
+# create user
+api.create_user('MyWriter', 'john.snow@test.keboola.com', 't0pS3cr3t', 'John', 'Snow') # <Keboola::GoodDataWriter::Job url="https://syrup.keboola.com/queue/jobs/123456", id="123456">
+
+# assign user to existing GoodData project
+api.add_project_users('MyWriter', 'xjywplmhejceb6j3ezzlxiganmjavqio', 'john.snow@test.keboola.com', 'editor') #<Keboola::GoodDataWriter::Job url="https://syrup.keboola.com/queue/jobs/123456", id="123456">
+
+# getretreive GoodData SSO link
+api.sso('MyWriter', 'xjywplmhejceb6j3ezzlxiganmjavqio', 'john.snow@test.keboola.com') # "https://secure.gooddata.com/gdc/account/customerlogin?sessionId=-----BEGIN+PGP+MESSAGE-----s0m3_l0000n6_h4sh"
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+Tests are runned against [mock API server](https://private-anon-cf7bb7f95-keboolagooddatawriter.apiary-mock.com). If you want to run tests against production API server you must provide valid Keboola Storage API token and set it as environment variable called `KEBOOLA_STORAGE_API_TOKEN`.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+Get familiar with [Github Flow](https://guides.github.com/introduction/flow/index.html) and stick with it on this project.
+We're using [Github Issues](https://github.com/slowpath/rails-insights/issues) as an issue tracker. All related tasks are there.
+
+It's simple!
+  1. Fork it ( https://github.com/romansklenar/keboola-gooddata-writer/fork )
+  2. Create your feature branch (`git checkout -b my-new-feature`)
+  3. Commit your changes (`git commit -am 'Add some feature'`)
+  4. Push to the branch (`git push origin my-new-feature`)
+  5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |task|
+  task.libs << %w[test lib]
+  task.pattern = 'test/**/*_test.rb'
+  task.verbose = true
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "keboola/gooddata_writer"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/keboola-gooddata-writer.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'keboola/gooddata_writer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "keboola-gooddata-writer"
+  spec.version       = Keboola::GoodDataWriter::VERSION
+  spec.date          = Date.today
+  spec.authors       = ["Roman Sklenář"]
+  spec.email         = ["mail@romansklenar.cz"]
+
+  spec.summary       = "A convenient Ruby wrapper around the Keboola GoodData Writer API."
+  spec.description   = "Use the Keboola::GoodDataWriter class to integrate Keboola GoodData Writer into your own application."
+  spec.homepage      = "https://github.com/romansklenar/gooddata-writer-ruby-client"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.7"
+  spec.add_development_dependency "webmock"
+  spec.add_development_dependency "vcr", "~> 2.9"
+  spec.add_development_dependency "codeclimate-test-reporter"
+
+  spec.add_dependency "json"
+  spec.add_dependency "hurley", "~> 0.1"
+end

data/lib/keboola/core_ext.rb

@@ -0,0 +1,3 @@
+Dir["#{File.dirname(__FILE__)}/core_ext/*.rb"].sort.each do |path|
+  require "keboola/core_ext/#{File.basename(path, '.rb')}"
+end

data/lib/keboola/core_ext/hash.rb

@@ -0,0 +1,22 @@
+class Hash
+  # Merges the caller into +other_hash+. For example,
+  #
+  #   options = options.reverse_merge(size: 25, velocity: 10)
+  #
+  # is equivalent to
+  #
+  #   options = { size: 25, velocity: 10 }.merge(options)
+  #
+  # This is particularly useful for initializing an options hash
+  # with default values.
+  def reverse_merge(other_hash)
+    other_hash.merge(self)
+  end
+
+  # Destructive +reverse_merge+.
+  def reverse_merge!(other_hash)
+    # right wins if there is no left
+    merge!( other_hash ){|key,left,right| left }
+  end
+  alias_method :reverse_update, :reverse_merge!
+end

data/lib/keboola/gooddata_writer.rb

@@ -0,0 +1,12 @@
+require "keboola/gooddata_writer/version"
+require "keboola/gooddata_writer/errors"
+require "keboola/gooddata_writer/job"
+require "keboola/gooddata_writer/parser"
+require "keboola/gooddata_writer/client"
+require "keboola/gooddata_writer/api"
+require "keboola/core_ext"
+
+module Keboola
+  module GoodDataWriter
+  end
+end

data/lib/keboola/gooddata_writer/api.rb

@@ -0,0 +1,365 @@
+module Keboola
+  module GoodDataWriter
+
+    class API
+      QUEUE_ENDPOINT_URL  = 'https://syrup.keboola.com/queue/'
+      WRITER_ENDPOINT_URL = 'https://syrup.keboola.com/gooddata-writer/'
+      QUEUE_MOCK_ENDPOINT_URL  = 'https://private-anon-c1bf53b9c-syrupqueue.apiary-mock.com/queue/'
+      WRITER_MOCK_ENDPOINT_URL = 'https://private-anon-df256c5fb-keboolagooddatawriter.apiary-mock.com/gooddata-writer/'
+
+      attr_accessor :token, :client, :queue, :parser
+
+
+      def initialize(token:, endpoint: nil, client: nil, queue: nil, parser: nil)
+        @token  = token
+        @client = client || self.class.build_client(endpoint: endpoint || WRITER_ENDPOINT_URL, token: token)
+        @queue  = queue  || self.class.build_client(endpoint: QUEUE_ENDPOINT_URL, token: token)
+        @parser = parser || self.class.build_parser
+      end
+
+      def self.build_client(token:, endpoint:)
+        Client.factory(token: token, endpoint: endpoint)
+      end
+
+      def self.build_parser
+        Parser.new
+      end
+
+
+      # === Writer resource commands
+
+      # Returns list of available writers and their buckets
+      def writers
+        handle @client.get("writers") do |result|
+          result["writers"]
+        end
+      end
+
+      # Returns attributes of the writer
+      def writer(writer_id)
+        handle @client.get("writers", { writerId: writer_id }) do |result|
+          result["writers"].first rescue result["writer"]
+        end
+      end
+
+      # Creates new configuration bucket and either uses existing GoodData
+      # project or creates new one along with dedicated GoodData user.
+      def create_writer(writer_id, optionals: {}, async: true)
+        handle @client.post("writers", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Sets attributes to writer's configuration
+      def update_writer(writer_id, attributes: {})
+        handle @client.post("writers/#{writer_id}", attributes.to_json) do |result|
+          Job.new(result).ok?
+        end
+      end
+
+      # Deletes configuration bucket and enqueues GoodData project and dedicated GoodData user for removal
+      def delete_writer(writer_id, async: true)
+        handle @client.delete("writers", { writerId: writer_id }) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+
+      # === Project resource commands
+
+      # Returns list of project clones including main project marked with main: 1 field
+      def projects(writer_id)
+        handle @client.get("projects", { writerId: writer_id }) do |result|
+          result["projects"]
+        end
+      end
+
+      # Creates new configuration bucket and either uses existing GoodData
+      # project or creates new one along with dedicated GoodData user.
+      def create_project(writer_id, optionals: {}, async: true)
+        handle @client.post("projects", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Creates new GoodData project for the writer and enqueues the old for deletion
+      def reset_project(writer_id, optionals: {}, async: true)
+        handle @client.post("reset-project", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Upload project to GoodData
+      def upload_project(writer_id, optionals: {}, async: true)
+        handle @client.post("upload-project", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+
+      # === User resource commands
+
+      # Get users list
+      def users(writer_id)
+        handle @client.get("users", { writerId: writer_id }) do |result|
+          result["users"]
+        end
+      end
+
+      # Creates new GoodData user in Keboola domain.
+      def create_user(writer_id, email, password, first_name, last_name, optionals: {}, async: true)
+        required = { writerId: writer_id, email: email, password: password, firstName: first_name, lastName: last_name }
+        handle @client.post("users", required.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+
+      # === Project & User nested resource commands
+
+      # Get list of users in project
+      def project_users(writer_id, project_id)
+        handle @client.get("project-users", { writerId: writer_id, pid: project_id }) do |result|
+          result["users"]
+        end
+      end
+
+      # Adds GoodData user to specified project.
+      def add_project_users(writer_id, project_id, email, role, optionals: {}, async: true)
+        required = { writerId: writer_id, pid: project_id, email: email, role: role }
+        handle @client.post("project-users", required.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Remove user from specified project.
+      def remove_project_users(writer_id, project_id, email, async: true)
+        handle @client.delete("project-users", { writerId: writer_id, pid: project_id, email: email }) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+
+      # === GoodData project structure commands
+
+      # Get tables list
+      def tables(writer_id)
+        handle @client.get("tables", { writerId: writer_id }) do |result|
+          result["tables"]
+        end
+      end
+
+      # Get table detail
+      def table(writer_id, table_id)
+        handle @client.get("tables", { writerId: writer_id, tableId: table_id }) do |result|
+          result["tables"].first rescue result["table"]
+        end
+      end
+
+      # Update table configuration
+      def update_table(writer_id, table_id, optionals: {})
+        handle @client.post("tables", { writerId: writer_id, tableId: table_id }.reverse_merge(optionals).to_json) do |result|
+          Job.new(result).ok?
+        end
+      end
+
+      # Update table column configuration
+      def update_table_column(writer_id, table_id, column, optionals: {})
+        handle @client.post("tables", { writerId: writer_id, tableId: table_id, column: column }.reverse_merge(optionals).to_json) do |result|
+          Job.new(result).ok?
+        end
+      end
+
+      # Bulk update table column configuration
+      def bulk_update_table_column(writer_id, table_id, columns = [])
+        handle @client.post("tables", { writerId: writer_id, tableId: table_id, columns: columns }.to_json) do |result|
+          Job.new(result).ok?
+        end
+      end
+
+      # Upload selected table to GoodData
+      def upload_table(writer_id, table_id, optionals: {}, async: true)
+        handle @client.post("upload-table", { writerId: writer_id, tableId: table_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Update model of selected table in GoodData
+      def update_table_model(writer_id, optionals: {}, async: true)
+        handle @client.post("update-model", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+      alias_method :update_model, :update_table_model
+
+      # Remove dataset in GoodData project belonging to the table and reset it's export status
+      def reset_table(writer_id, table_id, optionals: {}, async: true)
+        handle @client.post("reset-table", { writerId: writer_id, tableId: table_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Selectively upload date dimension (must be already configured in Writer)
+      def upload_date_dimension(writer_id, name, optionals: {}, async: true)
+        handle @client.post("reset-table", { writerId: writer_id, name: name }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+
+      # === Commands for loading data into GoodData
+
+      # Load data to selected tables in GoodData
+      def load_data(writer_id, optionals: {}, async: true)
+        handle @client.post("load-data", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Load data to selected tables in GoodData concurrently
+      def load_data_multi(writer_id, optionals: {}, async: true)
+        handle @client.post("load-data-multi", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # === Filter resource
+
+      def filters(writer_id, optionals: {})
+        handle @client.get("filters", { writerId: writer_id }.reverse_merge(optionals)) do |result|
+          result["filters"]
+        end
+      end
+
+      def create_filter(writer_id, project_id, name, attribute, value, operator = '=', optionals: {}, async: true)
+        required = { writerId: writer_id, pid: project_id, name: name, attribute: attribute, operator: operator, value: value }
+        handle @client.post("filters", required.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      def delete_filter(writer_id, name, async: true)
+        handle @client.delete("filters", { writerId: writer_id, name: name }) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+
+      # === Commands for manipulation with GoodData's Mandatory User Filters
+
+      # Get Filters for Projects
+      def filters_projects(writer_id, optionals: {})
+        handle @client.get("filters-projects", { writerId: writer_id }.reverse_merge(optionals)) do |result|
+          result["filters"]
+        end
+      end
+
+      # Get Filters for Users
+      def filters_users(writer_id, optionals: {})
+        handle @client.get("filters-users", { writerId: writer_id }.reverse_merge(optionals)) do |result|
+          result["filters"]
+        end
+      end
+
+      # Assign Filter to User
+      def assign_filters_users(writer_id, email, filters = [], optionals: {}, async: true)
+        required = { writerId: writer_id, email: email, filters: filters }
+        handle @client.post("filters-users", required.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Synchronizes filters in GoodData project according to writer's configuration
+      def sync_filters(writer_id, optionals: {}, async: true)
+        handle @client.post("sync-filters", { writerId: writer_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+
+      # === Various GoodData commands
+
+      # Execute selected reports in GoodData
+      def execute_reports(writer_id, project_id, optionals: {}, async: true)
+        handle @client.post("execute-reports", { writerId: writer_id, pid: project_id }.reverse_merge(optionals).to_json) do |result|
+          async ? Job.new(result) : wait_for_job(result["id"])
+        end
+      end
+
+      # Call to obtain an SSO link for user
+      def sso(writer_id, project_id, email, optionals: {})
+        handle @client.get("sso", { writerId: writer_id, pid: project_id, email: email }.reverse_merge(optionals)) do |result|
+          result["ssoLink"]
+        end
+      end
+
+      # Simple proxy for direct calls to GoodData API
+      def proxy(method, writer_id, query, optionals: {}, async: true)
+        required = { writerId: writer_id, query: query }
+        case method.to_sym
+          when :get
+            handle @client.get("proxy", required.reverse_merge(optionals))
+          when :post
+            handle @client.post("proxy", required.reverse_merge(optionals).to_json) do |result|
+              async ? Job.new(result) : wait_for_job(result["id"])
+            end
+        end
+      end
+
+
+      # === Commands for jobs handling in Syrup Queue API
+
+      # Return list of jobs for given writer
+      def jobs(writer_id)
+        handle @queue.get("jobs", { q: "+params.writerId:#{writer_id}", limit: 50 }) do |result|
+          result.map { |hash| Job.new(hash) }
+        end
+      end
+
+      # Return detail of given job
+      def job(job_id)
+        handle @queue.get("jobs/#{job_id}") do |result|
+          Job.new(result)
+        end
+      end
+
+      # Ask repeatedly for job status until it is finished
+      def wait_for_job(job_id)
+        begin
+          job = job(job_id)
+          sleep 5 unless job.finished?
+        end until job.finished?
+        job
+      end
+
+
+      private
+
+      # Properly handle response of API call request
+      def handle(response)
+        result = case response.status_type
+          when :success # Is this a 2xx response?
+            @parser.parse(response.body)
+
+          when :redirection # Is this a 3xx redirect?
+            @parser.parse(response.body)
+
+          when :client_error # Is this is a 4xx response?
+            raise ClientError.new(response)
+
+          when :server_error # Is this a 5xx response?
+            raise ServerError.new(response)
+
+          else
+            raise ResponseError.new(response)
+        end
+
+        block_given? ? yield(result) : result
+
+      rescue ::Hurley::Error, ::Hurley::Timeout => e
+        raise ResponseError.new(e)
+      end
+    end
+
+  end
+end

data/lib/keboola/gooddata_writer/client.rb

@@ -0,0 +1,18 @@
+require "hurley"
+
+module Keboola
+  module GoodDataWriter
+
+    class Client < ::Hurley::Client
+      def self.factory(endpoint:, token:)
+        client = new(endpoint)
+        client.header[:x_storageapi_token] = token
+        client.header[:accept] = "application/json"
+        client.request_options.redirection_limit = 5
+        client.request_options.timeout = 5
+        client
+      end
+    end
+
+  end
+end

data/lib/keboola/gooddata_writer/errors.rb

@@ -0,0 +1,46 @@
+module Keboola
+  module GoodDataWriter
+
+    class Error < RuntimeError; end
+    class ParsingError < Error; end
+
+    class ResponseError < Error
+      attr_reader :response
+
+      def initialize(ex, response = nil)
+        @wrapped_exception, @response = nil, response
+
+        if ex.respond_to?(:backtrace)
+          super(ex.message)
+          @wrapped_exception = ex
+
+        elsif ex.respond_to?(:status_code)
+          begin
+            # try to parse response body to retreive more detailed API error message
+            result = Parser.parse(ex.body)
+            super("the server responded with status #{ex.status_code} and message '#{result['message']}'")
+          rescue ParsingError
+            super("the server responded with status #{ex.status_code}")
+          ensure
+            @response = ex
+          end
+
+        else
+          super(ex.to_s)
+        end
+      end
+
+      def backtrace
+        @wrapped_exception ? @wrapped_exception.backtrace : super
+      end
+
+      def inspect
+        %(#<#{self.class}: #{@wrapped_exception.class}>)
+      end
+    end
+
+    class ClientError < ResponseError; end
+    class ServerError < ResponseError; end
+
+  end
+end

data/lib/keboola/gooddata_writer/job.rb

@@ -0,0 +1,25 @@
+require "ostruct"
+
+module Keboola
+  module GoodDataWriter
+
+    class Job < OpenStruct
+      def ok?
+        %w[ok].include?(status)
+      end
+
+      def success?
+        %w[success].include?(status)
+      end
+
+      def finished?
+        %w[cancelled success error warning terminated].include?(status)
+      end
+
+      def pending?
+        %w[waiting processing terminating].include?(status)
+      end
+    end
+
+  end
+end

data/lib/keboola/gooddata_writer/parser.rb

@@ -0,0 +1,21 @@
+require "json"
+
+module Keboola
+  module GoodDataWriter
+
+    class Parser
+      def self.parse(string)
+        begin
+          JSON.parse(string)
+        rescue JSON::ParserError, TypeError => e
+          raise ParsingError.new(e.message)
+        end
+      end
+
+      def parse(string)
+        self.class.parse(string)
+      end
+    end
+
+  end
+end

data/lib/keboola/gooddata_writer/version.rb

@@ -0,0 +1,5 @@
+module Keboola
+  module GoodDataWriter
+    VERSION = "2.0.0.pre1"
+  end
+end

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification
+name: keboola-gooddata-writer
+version: !ruby/object:Gem::Version
+  version: 2.0.0.pre1
+platform: ruby
+authors:
+- Roman Sklenář
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.7'
+- !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: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  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: 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: hurley
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: Use the Keboola::GoodDataWriter class to integrate Keboola GoodData Writer
+  into your own application.
+email:
+- mail@romansklenar.cz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- keboola-gooddata-writer.gemspec
+- lib/keboola/core_ext.rb
+- lib/keboola/core_ext/hash.rb
+- lib/keboola/gooddata_writer.rb
+- lib/keboola/gooddata_writer/api.rb
+- lib/keboola/gooddata_writer/client.rb
+- lib/keboola/gooddata_writer/errors.rb
+- lib/keboola/gooddata_writer/job.rb
+- lib/keboola/gooddata_writer/parser.rb
+- lib/keboola/gooddata_writer/version.rb
+homepage: https://github.com/romansklenar/gooddata-writer-ruby-client
+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.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A convenient Ruby wrapper around the Keboola GoodData Writer API.
+test_files: []