tiktalik 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e206091adbcab3e9d09e4f58b6f2822359748cd4
+  data.tar.gz: 7caa889c4ea3147e5e4bc035bdbeb3b570dbdbc1
+SHA512:
+  metadata.gz: f6ba39ac1c5d87cde7d67cca557f37278fac439bb00b146893fe12fa1b590e5936a39621d2aab5a543122a669ed3f0ae540e28f646accf951eac9934e4641873
+  data.tar.gz: 3e2805c2b6556b874d951bbba3d5d930d577a106246f3c1563b162fa07e592c10d47c628ee70a91b91d484cfc7b4aa65b9a5b6d53e33464b4de2b7511c61cea2

data/.gitignore

@@ -0,0 +1,2 @@
+Gemfile.lock
+pkg/*.gem

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+script: "bundle exec rake spec"
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - jruby-18mode
+  - jruby-19mode
+  - rbx-18mode
+  - rbx-19mode
+  - ree

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+gemspec
+
+gem 'rake'
+gem 'rspec', '~> 2.11'
+gem 'oj'
+gem 'timecop'

data/README.md

@@ -0,0 +1,50 @@
+# Tiktalik Cloud Computing Platform SDK for Ruby
+
+Tiktalik SDK for Ruby enables developers using the Ruby programming
+language to access core features of the [Tiktalik Cloud Computing](http://www.tiktalik.com) Platform.
+
+The SDK features:
+
+ * retrieving detailed information on user's instances: recent operations,
+   running state, hourly cost etc.
+ * core operations on an instance: creating, starting, stopping, starting backup
+ * adding and removing network interfaces
+ * listing and manipulating backups
+ * listing and manipulating networks
+
+ More cool features coming soon!
+
+## Installation
+
+
+`$ gem install tiktalik`
+
+## Requirements
+
+ * [faraday](https://rubygems.org/gems/faraday)
+ * [multi_json](https://rubygems.org/gems/multi_json)
+
+## Documentation
+
+See [http://www.tiktalik.com/api](http://www.tiktalik.com/api) for documentation and tutorials.
+
+## License
+
+Copyright (c) 2013 Rebased s.c.
+
+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/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new do |t|
+  t.rspec_opts = ["-c", "-f progress"]
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+task :default => :spec

data/lib/tiktalik/computing/instance.rb

@@ -0,0 +1,118 @@
+# Represents a user's Instance. This object is used to perform mission-critical
+# operations like stopping or starting an instance. Note that you should never
+# construct this object yourself; use a ComputingConnection to fetch instances
+# from the server.
+module Tiktalik
+  module Computing
+    class Instance < Object
+
+      attr_reader :uuid,               # String
+                  :hostname,           # String
+                  :owner,              # String
+                  :vpsimage_uuid,      # String
+                  :state,              # Fixnum
+                  :running,            # Boolean
+                  :interfaces,         # Array(VPSNetInterface)
+                  :actions,            # Array(Operation)
+                  :vpsimage,           # VPSImage
+                  :default_password,   # String
+                  :service_name,       # String
+                  :gross_cost_per_hour # Float
+
+      # List of user virtual machines.
+      #
+      # @param [Hash] params Params for results
+      #
+      # @option params [Boolean] :actions Include list of recent operations if true.
+      # @option params [Boolean] :vpsimage Include details about source image if true.
+      # @option params [Boolean] :cost Include current cost per hour for each instance if true.
+      def self.all(params = {})
+        results = request(:get, '/computing/instance', params)
+        results.collect { |result| new(result) }
+      end
+
+      # Create a new virtual machine.
+      #
+      # @param [Hash] params Params for instance
+      #
+      # @option params [String] :image_uuid UID of disk image that should be used(required)
+      # @option params [String] :size Size of instance in Units(required)
+      # @option params [String] :hostname Hostname set at installation time(required)
+      # @option params [Array] :networks Networks to attach, each one as "{uuid}" from Network model.
+      def self.create(params = {})
+        require_params(params, :image_uuid, :size, :hostname)
+        result = request(:post, '/computing/instance', params)
+        new(result)
+      end
+
+      # Get virtual machine details.
+      #
+      # @param [String] uuid UUID of instance
+      def self.find(uuid)
+        result = request(:get, "/computing/instance/#{uuid}")
+        new(result)
+      end
+
+      # Delete instance.
+      def destroy
+        request(:delete, "/computing/instance/#{@uuid}")
+        true
+      end
+
+      # Create virtual machine network interface.
+      #
+      # @param [Hash] params Params for interface
+      #
+      # @option params [String] :network_uuid Network UUID. The interface will be assigned an address in this network(required)
+      # @option params [String] :seq Interface number, eg. '3' maps to eth3(required)
+      def build_interface(params = {})
+        require_params(params, :network_uuid, :seq)
+        result = request(:post, "/computing/instance/#{@uuid}/interface", params)
+        VPSNetInterface.new(result)
+      end
+
+      # Call "Install" operation on virtual machine.
+      def install
+        request(:post, "/computing/instance/#{@uuid}/install")
+        true
+      end
+
+      # Call "Boot" or "Start" operation on virtual machine.
+      def start
+        request(:post, "/computing/instance/#{@uuid}/start")
+        true
+      end
+
+      # Call "Shutdown" operation on virtual machine.
+      def stop
+        request(:post, "/computing/instance/#{@uuid}/stop")
+        true
+      end
+
+      # Force "Shutdown" operation on virtual machine.
+      def force_stop
+        request(:post, "/computing/instance/#{@uuid}/force_stop")
+        true
+      end
+
+      # Do "Backup" of virtual machine. VPS need to be stopped in order to create its backup.
+      def backup
+        request(:post, "/computing/instance/#{@uuid}/backup")
+        true
+      end
+
+      private
+
+      def after_initialize
+        @interfaces = [] unless @interfaces.is_a?(Array)
+        @interfaces.collect! { |interface| interface.is_a?(VPSNetInterface) ? interface : VPSNetInterface.new(interface.merge(:instance_uuid => @uuid)) }
+
+        @actions = [] unless @actions.is_a?(Array)
+        @actions.collect! { |action| action.is_a?(Operation) ? action : Operation.new(action) }
+
+        @vpsimage = VPSImage.new(@vpsimage) if @vpsimage
+      end
+
+    end
+  end
+end

data/lib/tiktalik/computing/network.rb

@@ -0,0 +1,42 @@
+# A user- or system-owned network. Each Instance has zero or more networks
+# attached, each networking interfaces is represented by a VPSNetInterface
+# object.
+module Tiktalik
+  module Computing
+    class Network < Object
+
+      attr_reader :uuid,       # String
+                  :name,       # String
+                  :net,        # String
+                  :owner,      # String
+                  :domainname, # String
+                  :public      # Boolean
+
+      # List of available networks.
+      def self.all
+        results = request(:get, '/computing/network')
+        results.collect { |result| new(result) }
+      end
+
+      # Create private network.
+      #
+      # @param [Hash] params Params for network
+      #
+      # @option params [String] :name Network name - as part of local domain(required)
+      def self.create(params = {})
+        require_params(params, :name)
+        result = request(:post, '/computing/network', params)
+        new(result)
+      end
+
+      # Get network.
+      #
+      # @param [String] uuid UUID of network
+      def self.find(uuid)
+        result = request(:get, "/computing/network/#{uuid}")
+        new(result)
+      end
+
+    end
+  end
+end

data/lib/tiktalik/computing/operation.rb

@@ -0,0 +1,22 @@
+# Description of an operation that was performed on an Instance.
+# Used purely for informative purposes.
+module Tiktalik
+  module Computing
+    class Operation < Object
+
+      attr_reader :uuid,        # String
+                  :start_time,  # Time
+                  :end_time,    # Time
+                  :description, # String
+                  :progress     # Fixnum
+
+      private
+
+      def after_initialize
+        @start_time = Time.parse(@start_time) if @start_time
+        @end_time = Time.parse(@end_time) if @end_time
+      end
+
+    end
+  end
+end

data/lib/tiktalik/computing/vpsimage.rb

@@ -0,0 +1,42 @@
+# Disk image that can be used to create a new instance, or restore one from backup.
+module Tiktalik
+  module Computing
+    class VPSImage < Object
+
+      attr_reader :uuid,        # String
+                  :name,        # String
+                  :owner,       # String
+                  :type,        # String - 'backup', 'image' or 'install'
+                  :is_public,   # Boolean
+                  :description, # String
+                  :create_time  # Time
+
+      # List of VPS images.
+      def self.all
+        results = request(:get, '/computing/image')
+        results.collect { |result| new(result) }
+      end
+
+      # Get image or backup.
+      #
+      # @param [String] uuid UUID of image
+      def self.find(uuid)
+        result = request(:get, "/computing/image/#{uuid}")
+        new(result)
+      end
+
+      # Delete users backup image.
+      def destroy
+        request(:delete, "/computing/image/#{uuid}")
+        true
+      end
+
+      private
+
+      def after_initialize
+        @create_time = Time.parse(@create_time) if @create_time
+      end
+
+    end
+  end
+end

data/lib/tiktalik/computing/vpsnetinterface.rb

@@ -0,0 +1,27 @@
+# A network interface attached to an Instance. Maps directly to a network interface
+# visible from the operating system's point.
+module Tiktalik
+  module Computing
+    class VPSNetInterface < Object
+
+      attr_reader :uuid,    # String
+                  :network, # Network
+                  :mac,     # String
+                  :ip,      # String
+                  :seq      # Fixnum - interface sequence number: 0 for eth0, 1 for eth1, etc.
+
+      # Remove virtual machine network interface.
+      def destroy
+        request(:delete, "/computing/instance/#{@instance_uuid}/interface/#{@uuid}")
+        true
+      end
+
+      private
+
+      def after_initialize
+        @network = Network.new(@network) if @network
+      end
+
+    end
+  end
+end

data/lib/tiktalik/computing.rb

@@ -0,0 +1,11 @@
+module Tiktalik
+  module Computing
+
+    autoload :Instance,        "#{ROOT}/tiktalik/computing/instance"
+    autoload :Network,         "#{ROOT}/tiktalik/computing/network"
+    autoload :Operation,       "#{ROOT}/tiktalik/computing/operation"
+    autoload :VPSImage,        "#{ROOT}/tiktalik/computing/vpsimage"
+    autoload :VPSNetInterface, "#{ROOT}/tiktalik/computing/vpsnetinterface"
+
+  end
+end

data/lib/tiktalik/error.rb

@@ -0,0 +1,56 @@
+module Tiktalik
+  class Error < RuntimeError
+
+    class BadRequest < Tiktalik::Error
+      def status; 400; end
+    end
+
+    class Unauthorized < Tiktalik::Error
+      def status; 401; end
+    end
+
+    class PaymentRequired < Tiktalik::Error
+      def status; 402; end
+    end
+
+    class Forbidden < Tiktalik::Error
+      def status; 403; end
+    end
+
+    class NotFound < Tiktalik::Error
+      def status; 404; end
+    end
+
+    class NotAllowed < Tiktalik::Error
+      def status; 405; end
+    end
+
+    class Conflict < Tiktalik::Error
+      def status; 409; end
+    end
+
+    class ServerError < Tiktalik::Error
+      def status; 500; end
+    end
+
+    class UnknownStatus < Tiktalik::Error
+      def status; 500; end
+    end
+
+    STATUSES = {
+      400 => BadRequest,
+      401 => Unauthorized,
+      402 => PaymentRequired,
+      403 => Forbidden,
+      404 => NotFound,
+      405 => NotAllowed,
+      409 => Conflict,
+      500 => ServerError
+    }
+
+    def self.find_by_status(status)
+      STATUSES[status.to_i] || UnknownStatus
+    end
+
+  end
+end

data/lib/tiktalik/object.rb

@@ -0,0 +1,73 @@
+require 'faraday'
+require 'digest/hmac'
+require 'base64'
+require 'uri'
+require 'multi_json'
+
+# Base class for all objects returned by the API.
+module Tiktalik
+  class Object
+
+    def initialize(json)
+      json.each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
+
+      after_initialize
+    end
+
+    private
+
+    def self.adapter
+      @@adapter ||= Faraday.new(:url => Tiktalik.base_url)
+    end
+
+    def self.request(method, path, params = {})
+      raise ArgumentError, "Set Tiktalik.api_key and Tiktalik.api_secret_key first" unless Tiktalik.api_key && Tiktalik.api_secret_key
+      date = Time.now.utc.strftime("%a, %d %b %Y %X GMT")
+      url = Tiktalik.base_path + path
+      url += "?" + URI.encode_www_form(params) unless params.nil? || params.empty? || method != :get
+      result = adapter.send(method) do |req|
+        req.url url
+        unless params.nil? || params.empty? || method == :get
+          req.body = URI.encode_www_form(params)
+          req.headers['content-md5'] = Digest::MD5.hexdigest(req.body)
+        end
+        req.headers['content-type'] = 'application/x-www-form-urlencoded'
+        req.headers['date'] = date
+        req.headers['Authorization'] = "TKAuth #{Tiktalik.api_key}:#{auth_key(method, url, req.headers)}"
+      end
+
+      raise_error(result.status, result.body) unless result.status == 200
+
+      MultiJson.load(result.body) rescue ""
+    end
+
+    def self.auth_key(method, url, headers)
+      string_to_sign = [method.to_s.upcase, headers['content-md5'], headers['content-type'], headers['date'], url].join("\n")
+      Base64.encode64(Digest::HMAC.digest(string_to_sign, Base64.decode64(Tiktalik.api_secret_key), Digest::SHA1)).strip
+    end
+
+    def self.raise_error(status, message = "")
+      message = "401 Not Authorized" if status == 401 # Bug in Tiktalik - return HTML instead of JSON
+      raise Error.find_by_status(status), message
+    end
+
+    def self.require_params(params, *require_list)
+      missing = require_list.sort - params.keys.sort
+      raise ArgumentError, "Missing attributes: #{missing}" unless missing.empty?
+    end
+
+    def after_initialize
+    end
+
+    def request(*args)
+      self.class.request(*args)
+    end
+
+    def require_params(*args)
+      self.class.require_params(*args)
+    end
+
+  end
+end

data/lib/tiktalik/version.rb

@@ -0,0 +1,3 @@
+module Tiktalik
+  VERSION = "1.0.1"
+end

data/lib/tiktalik.rb

@@ -0,0 +1,19 @@
+module Tiktalik
+
+  ROOT = File.expand_path(File.dirname(__FILE__))
+
+  autoload :Computing, "#{ROOT}/tiktalik/computing"
+  autoload :Error,     "#{ROOT}/tiktalik/error"
+  autoload :Object,    "#{ROOT}/tiktalik/object"
+  autoload :VERSION,   "#{ROOT}/tiktalik/version"
+
+  def self.base_url; 'https://www.tiktalik.com'; end
+  def self.base_path; '/api/v1'; end
+
+  def self.api_key; @api_key || ENV['API_KEY']; end
+  def self.api_key=(val); @api_key = val; end
+
+  def self.api_secret_key; @api_secret_key || ENV['API_SECRET_KEY']; end
+  def self.api_secret_key=(val); @api_secret_key = val; end
+
+end

data/spec/computing/instance_spec.rb

@@ -0,0 +1,255 @@
+require 'spec_helper'
+
+describe Tiktalik::Computing::Instance do
+
+  context ".all" do
+    let(:url) { "/api/v1/computing/instance" }
+    let(:method) { :get }
+    let(:request) { Tiktalik::Computing::Instance.method(:all) }
+
+    it "should return empty array if no instances found" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '[]' ] }
+      results = request.call
+      results.class.should eql(Array)
+      results.size.should eql(0)
+    end
+
+    it "should return array with instances if some instances found" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '[{},{}]' ] }
+      results = request.call
+      results.class.should eql(Array)
+      results.size.should eql(2)
+      results.each do |result|
+        result.class.should eql(Tiktalik::Computing::Instance)
+      end
+    end
+
+    it "should accept 'actions' parameter" do
+      $faraday_stubs.send(method, url + '?actions=true') { [ 200, {}, '[{},{}]' ] }
+      results = request.call(:actions => true)
+      results.class.should eql(Array)
+      results.size.should eql(2)
+      $faraday_stubs.verify_stubbed_calls
+    end
+
+    it "should accept 'vpsimage' parameter" do
+      $faraday_stubs.send(method, url + '?vpsimage=true') { [ 200, {}, '[{},{}]' ] }
+      results = request.call(:vpsimage => true)
+      results.class.should eql(Array)
+      results.size.should eql(2)
+      $faraday_stubs.verify_stubbed_calls
+    end
+
+    it "should accept 'cost' parameter" do
+      $faraday_stubs.send(method, url + '?cost=true') { [ 200, {}, '[{},{}]' ] }
+      results = request.call(:cost => true)
+      results.class.should eql(Array)
+      results.size.should eql(2)
+      $faraday_stubs.verify_stubbed_calls
+    end
+
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 500'
+  end
+
+  context ".create" do
+    let(:url) { "/api/v1/computing/instance" }
+    let(:method) { :post }
+    let(:request) { Tiktalik::Computing::Instance.method(:create) }
+    let(:default_params) {{ :image_uuid => "123", :size => "0.25", :hostname => "test" }}
+
+    it_should_behave_like 'require parameters', [:image_uuid, :size, :hostname]
+
+    it "should create instance" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '{}' ] }
+      result = request.call(default_params)
+      result.class.should eql(Tiktalik::Computing::Instance)
+    end
+
+    it "shuld wrap instance parameters" do
+      $faraday_stubs.send(method, url) { [ 200, {}, MultiJson.dump(INSTANCE_STUB) ] }
+      result = request.call(default_params)
+      result.class.should eql(Tiktalik::Computing::Instance)
+      result.uuid.should eql("71717dfb-3e86-487f-bcf0-01f6856d6bcd")
+    end
+
+    it_should_behave_like 'support error 400'
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 402'
+    it_should_behave_like 'support error 403'
+    it_should_behave_like 'support error 500'
+  end
+
+  context ".find" do
+    let(:url) { "/api/v1/computing/instance/123" }
+    let(:method) { :get }
+    let(:request) { Tiktalik::Computing::Instance.method(:find) }
+    let(:default_params) {"123"}
+
+    it "should return instance" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '{}' ] }
+      result = request.call(default_params)
+      result.class.should eql(Tiktalik::Computing::Instance)
+    end
+
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 404'
+  end
+
+  context "instance" do
+    let(:subject) { Tiktalik::Computing::Instance.new(INSTANCE_STUB)}
+
+    its(:uuid) { should eql("71717dfb-3e86-487f-bcf0-01f6856d6bcd")}
+    its(:hostname) { should eql("test") }
+    its(:owner) { should eql("imanel") }
+    its(:vpsimage_uuid) { should eql("e18aee6c-9548-457e-9c20-7103d454969a") }
+    its(:state) { should eql(12) }
+    its(:running) { should eql(true) }
+    its(:default_password) { should eql("c933c94b8b") }
+    its(:service_name) { should eql("TC_UNIT_MICRO") }
+    its(:gross_cost_per_hour ) { should eql(0.03321) }
+
+    it "should have interfaces" do
+      subject.interfaces.class.should eql(Array)
+      subject.interfaces.size.should eql(1)
+      interface = subject.interfaces.first
+      interface.class.should eql(Tiktalik::Computing::VPSNetInterface)
+      interface.uuid.should eql("b5a097ee-a095-47b4-b7c7-4b11100559a7")
+    end
+
+    it "should have actions" do
+      subject.actions.class.should eql(Array)
+      subject.actions.size.should eql(1)
+      action = subject.actions.first
+      action.class.should eql(Tiktalik::Computing::Operation)
+      action.uuid.should eql("ad9a7aa3-dc61-4dde-92de-af335a635041")
+    end
+
+    it "should have vpsimage" do
+      subject.vpsimage.class.should eql(Tiktalik::Computing::VPSImage)
+      subject.vpsimage.uuid.should eql("e18aee6c-9548-457e-9c20-7103d454969a")
+    end
+
+    context "#destroy" do
+      let(:url) { "/api/v1/computing/instance/#{subject.uuid}" }
+      let(:method) { :delete }
+      let(:request) { subject.method(:destroy) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 403'
+      it_should_behave_like 'support error 500'
+    end
+
+    context "#build_interface" do
+      let(:url) { "/api/v1/computing/instance/#{subject.uuid}/interface" }
+      let(:method) { :post }
+      let(:request) { subject.method(:build_interface) }
+      let(:default_params) {{ :network_uuid => "123", :seq => 1 }}
+
+      it_should_behave_like 'require parameters', [:network_uuid, :seq]
+
+      it "should return interface" do
+        $faraday_stubs.send(method, url) { [ 200, {}, MultiJson.dump(VPSNETINTERFACE_STUB) ] }
+        result = request.call(default_params)
+        result.class.should eql(Tiktalik::Computing::VPSNetInterface)
+        result.uuid.should eql("b5a097ee-a095-47b4-b7c7-4b11100559a7")
+      end
+
+      it_should_behave_like 'support error 400'
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 409'
+      it_should_behave_like 'support error 500'
+    end
+
+    context "#install" do
+      let(:url) { "/api/v1/computing/instance/#{subject.uuid}/install" }
+      let(:method) { :post }
+      let(:request) { subject.method(:install) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 403'
+      it_should_behave_like 'support error 409'
+      it_should_behave_like 'support error 500'
+    end
+
+    context "#start" do
+      let(:url) { "/api/v1/computing/instance/#{subject.uuid}/start" }
+      let(:method) { :post }
+      let(:request) { subject.method(:start) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 403'
+      it_should_behave_like 'support error 409'
+      it_should_behave_like 'support error 500'
+    end
+
+    context "#stop" do
+      let(:url) { "/api/v1/computing/instance/#{subject.uuid}/stop" }
+      let(:method) { :post }
+      let(:request) { subject.method(:stop) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 403'
+      it_should_behave_like 'support error 409'
+      it_should_behave_like 'support error 500'
+    end
+
+    context "#force_stop" do
+      let(:url) { "/api/v1/computing/instance/#{subject.uuid}/force_stop" }
+      let(:method) { :post }
+      let(:request) { subject.method(:force_stop) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 403'
+      it_should_behave_like 'support error 409'
+      it_should_behave_like 'support error 500'
+    end
+
+    context "#backup" do
+      let(:url) { "/api/v1/computing/instance/#{subject.uuid}/backup" }
+      let(:method) { :post }
+      let(:request) { subject.method(:backup) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 403'
+      it_should_behave_like 'support error 409'
+      it_should_behave_like 'support error 500'
+    end
+  end
+end

data/spec/computing/network_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+
+describe Tiktalik::Computing::Network do
+
+  context ".all" do
+    let(:url) { "/api/v1/computing/network" }
+    let(:method) { :get }
+    let(:request) { Tiktalik::Computing::Network.method(:all) }
+
+    it "should return empty array if no networks found" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '[]' ] }
+      results = request.call
+      results.class.should eql(Array)
+      results.size.should eql(0)
+    end
+
+    it "should return array with networks if some networks found" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '[{},{}]' ] }
+      results = request.call
+      results.class.should eql(Array)
+      results.size.should eql(2)
+      results.each do |result|
+        result.class.should eql(Tiktalik::Computing::Network)
+      end
+    end
+
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 500'
+  end
+
+  context ".create" do
+    let(:url) { "/api/v1/computing/network" }
+    let(:method) { :post }
+    let(:request) { Tiktalik::Computing::Network.method(:create) }
+    let(:default_params) {{ :name => "test" }}
+
+    it_should_behave_like 'require parameters', [:name]
+
+    it "should create network" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '{}' ] }
+      result = request.call(default_params)
+      result.class.should eql(Tiktalik::Computing::Network)
+    end
+
+    it "shuld wrap network parameters" do
+      $faraday_stubs.send(method, url) { [ 200, {}, MultiJson.dump(NETWORK_STUB) ] }
+      result = request.call(default_params)
+      result.class.should eql(Tiktalik::Computing::Network)
+      result.uuid.should eql("e92e60c2-2993-4a0c-b635-c5e2b2462c7a")
+    end
+
+    it_should_behave_like 'support error 400'
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 500'
+  end
+
+  context ".find" do
+    let(:url) { "/api/v1/computing/network/123" }
+    let(:method) { :get }
+    let(:request) { Tiktalik::Computing::Network.method(:find) }
+    let(:default_params) {"123"}
+
+    it "should return network" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '{}' ] }
+      result = request.call(default_params)
+      result.class.should eql(Tiktalik::Computing::Network)
+    end
+
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 404'
+  end
+
+  context "instance" do
+    let(:subject) { Tiktalik::Computing::Network.new(NETWORK_STUB)}
+
+    its(:uuid) { should eql("e92e60c2-2993-4a0c-b635-c5e2b2462c7a") }
+    its(:name) { should eql("pub2") }
+    its(:net) { should eql("37.233.98.0/24") }
+    its(:owner) { should eql("system") }
+    its(:domainname) { should eql("p2.tiktalik.com") }
+    its(:public) { should eql(true) }
+  end
+end

data/spec/computing/operation_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Tiktalik::Computing::Operation do
+
+  context "instance" do
+    let(:subject) { Tiktalik::Computing::Operation.new(OPERATION_STUB)}
+
+    its(:uuid) { should eql("ad9a7aa3-dc61-4dde-92de-af335a635041") }
+    its(:start_time) { should eql(Time.parse("2013-05-29 10:38:31 +0200 (UTC)")) }
+    its(:end_time) { should eql(Time.parse("2013-05-29 10:39:13 +0200 (UTC)")) }
+    its(:description) { should eql("Create_Install: test") }
+    its(:progress) { should eql(100) }
+
+  end
+end

data/spec/computing/vpsimage_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+
+describe Tiktalik::Computing::VPSImage do
+
+  context ".all" do
+    let(:url) { "/api/v1/computing/image" }
+    let(:method) { :get }
+    let(:request) { Tiktalik::Computing::VPSImage.method(:all) }
+
+    it "should return empty array if no images found" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '[]' ] }
+      results = request.call
+      results.class.should eql(Array)
+      results.size.should eql(0)
+    end
+
+    it "should return array with images if some images found" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '[{},{}]' ] }
+      results = request.call
+      results.class.should eql(Array)
+      results.size.should eql(2)
+      results.each do |result|
+        result.class.should eql(Tiktalik::Computing::VPSImage)
+      end
+    end
+
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 500'
+  end
+
+  context ".find" do
+    let(:url) { "/api/v1/computing/image/123" }
+    let(:method) { :get }
+    let(:request) { Tiktalik::Computing::VPSImage.method(:find) }
+    let(:default_params) {"123"}
+
+    it "should return image" do
+      $faraday_stubs.send(method, url) { [ 200, {}, '{}' ] }
+      result = request.call(default_params)
+      result.class.should eql(Tiktalik::Computing::VPSImage)
+    end
+
+    it_should_behave_like 'support error 401'
+    it_should_behave_like 'support error 404'
+    it_should_behave_like 'support error 500'
+  end
+
+  context "instance" do
+    let(:subject) { Tiktalik::Computing::VPSImage.new(VPSIMAGE_STUB)}
+
+    its(:uuid) { should eql("e18aee6c-9548-457e-9c20-7103d454969a") }
+    its(:name) { should eql("Centos 6.4 64-bit") }
+    its(:owner) { should eql("system") }
+    its(:type) { should eql("image") }
+    its(:is_public) { should eql(true) }
+    its(:description) { should eql("Some description") }
+    its(:create_time) { should eql(Time.parse("2013-03-25 15:29:51 +0100 (UTC)")) }
+
+    context "#destroy" do
+      let(:url) { "/api/v1/computing/image/#{subject.uuid}" }
+      let(:method) { :delete }
+      let(:request) { subject.method(:destroy) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 404'
+      it_should_behave_like 'support error 500'
+    end
+
+  end
+end

data/spec/computing/vpsnetinterface_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe Tiktalik::Computing::VPSNetInterface do
+
+  context "instance" do
+    let(:subject) { Tiktalik::Computing::VPSNetInterface.new(VPSNETINTERFACE_STUB)}
+
+    its(:uuid) { should eql("b5a097ee-a095-47b4-b7c7-4b11100559a7") }
+    its(:mac) { should eql("e6:95:e5:4c:99:86") }
+    its(:ip) { should eql("37.233.98.178") }
+    its(:seq ) { should eql(0) }
+
+    it "should have network" do
+      subject.network.class.should eql(Tiktalik::Computing::Network)
+      subject.network.uuid.should eql("e92e60c2-2993-4a0c-b635-c5e2b2462c7a")
+    end
+
+    context "#destroy" do
+      let(:url) { "/api/v1/computing/instance/#{INSTANCE_STUB["uuid"]}/interface/#{subject.uuid}" }
+      let(:method) { :delete }
+      let(:request) { subject.method(:destroy) }
+
+      it "should return true" do
+        $faraday_stubs.send(method, url) { [ 200, {}, '' ] }
+        request.call.should eql(true)
+        $faraday_stubs.verify_stubbed_calls
+      end
+
+      it_should_behave_like 'support error 401'
+      it_should_behave_like 'support error 404'
+      it_should_behave_like 'support error 405'
+      it_should_behave_like 'support error 500'
+    end
+  end
+end

data/spec/object_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+require 'timecop'
+require 'time'
+
+describe Tiktalik::Object do
+  before do
+    Timecop.freeze(Time.parse("Wed, 29 May 2013 10:21:20 GMT" ))
+  end
+
+  after do
+    Timecop.return
+  end
+
+  context ".request" do
+    it "should have valid content type header set" do
+      $faraday_stubs.get("/api/v1/test", { "content-type" => 'application/x-www-form-urlencoded' }) { [200, {}, '']}
+      Tiktalik::Object.send(:request, :get, "/test")
+      $faraday_stubs.verify_stubbed_calls
+    end
+
+    it "should have valid date header set" do
+      $faraday_stubs.get("/api/v1/test", { "date" => "Wed, 29 May 2013 10:21:20 GMT"  }) { [200, {}, '']}
+      Tiktalik::Object.send(:request, :get, "/test")
+      $faraday_stubs.verify_stubbed_calls
+    end
+
+    it "should have valid authorization header set" do
+      $faraday_stubs.get("/api/v1/test", { "Authorization" => "TKAuth API_KEY:is1EXmnDaRYNouQSHu5Wu36ZYg8="  }) { [200, {}, '']}
+      Tiktalik::Object.send(:request, :get, "/test")
+      $faraday_stubs.verify_stubbed_calls
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+require 'rspec'
+require 'tiktalik'
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.before(:suite) do
+    # Everything is stubbed so we just need to set it to constant
+    Tiktalik.api_key = "API_KEY"
+    Tiktalik.api_secret_key = "API_SECRET_KEY"
+
+    # Stub all requests
+    require 'faraday/adapter/test'
+    $faraday_stubs = Faraday::Adapter::Test::Stubs.new
+    Tiktalik::Object.adapter.adapter :test, $faraday_stubs
+  end
+
+  config.before(:each) do
+    # Remove previously used stubs
+    $faraday_stubs.instance_variable_set("@stack", {})
+    $faraday_stubs.instance_variable_set("@consumed", {})
+  end
+end

data/spec/support/error_requests.rb

@@ -0,0 +1,63 @@
+def expect_raise(error, message)
+  if defined?(default_params)
+    expect{ request.call(default_params) }.to raise_error(error, message)
+  else
+    expect{ request.call }.to raise_error(error, message)
+  end
+end
+
+shared_examples_for 'support error 400' do
+  it "should raise BadRequest error" do
+    $faraday_stubs.send(method, url) { [ 400, {}, '400 Bad Request' ] }
+    expect_raise(Tiktalik::Error::BadRequest, '400 Bad Request')
+  end
+end
+
+shared_examples_for 'support error 401' do
+  it "should raise Unauthorized error" do
+    $faraday_stubs.send(method, url) { [ 401, {}, '401 Not Authorized' ] }
+    expect_raise(Tiktalik::Error::Unauthorized, '401 Not Authorized')
+  end
+end
+
+shared_examples_for 'support error 402' do
+  it "should raise PaymentRequired error" do
+    $faraday_stubs.send(method, url) { [ 402, {}, '402 Payment Required' ] }
+    expect_raise(Tiktalik::Error::PaymentRequired, '402 Payment Required')
+  end
+end
+
+shared_examples_for 'support error 403' do
+  it "should raise Forbidden error" do
+    $faraday_stubs.send(method, url) { [ 403, {}, '403 Forbidden' ] }
+    expect_raise(Tiktalik::Error::Forbidden, '403 Forbidden')
+  end
+end
+
+shared_examples_for 'support error 404' do
+  it "should raise NotFound error" do
+    $faraday_stubs.send(method, url) { [ 404, {}, '404 Not Found' ] }
+    expect_raise(Tiktalik::Error::NotFound, '404 Not Found')
+  end
+end
+
+shared_examples_for 'support error 405' do
+  it "should raise NotAllowed error" do
+    $faraday_stubs.send(method, url) { [ 405, {}, '405 Not Allowed' ] }
+    expect_raise(Tiktalik::Error::NotAllowed, '405 Not Allowed')
+  end
+end
+
+shared_examples_for 'support error 409' do
+  it "should raise Conflict error" do
+    $faraday_stubs.send(method, url) { [ 409, {}, '409 Conflict' ] }
+    expect_raise(Tiktalik::Error::Conflict, '409 Conflict')
+  end
+end
+
+shared_examples_for 'support error 500' do
+  it "should raise ServerError error" do
+    $faraday_stubs.send(method, url) { [ 500, {}, '500 Server Error' ] }
+    expect_raise(Tiktalik::Error::ServerError, '500 Server Error')
+  end
+end

data/spec/support/stubs.rb

@@ -0,0 +1,60 @@
+NETWORK_STUB = {
+  "uuid"=>"e92e60c2-2993-4a0c-b635-c5e2b2462c7a",
+  "domainname"=>"p2.tiktalik.com",
+  "owner"=>"system",
+  "net"=>"37.233.98.0/24",
+  "public"=>true,
+  "name"=>"pub2"
+}
+
+OPERATION_STUB = {
+  "code"=>3,
+  "add_source"=>"imanel",
+  "end_time"=>"2013-05-29 10:39:13 +0200 (UTC)",
+  "uuid"=>"ad9a7aa3-dc61-4dde-92de-af335a635041",
+  "progress"=>100,
+  "end_code"=>0,
+  "start_time"=>"2013-05-29 10:38:31 +0200 (UTC)",
+  "description"=>"Create_Install: test",
+  "end_desc"=>"ok",
+  "add_time"=>"2013-05-29 10:38:30 +0200 (UTC)"
+}
+
+VPSIMAGE_STUB = {
+  "source_vps_size_name"=>nil,
+  "create_time"=>"2013-03-25 15:29:51 +0100 (UTC)",
+  "uuid"=>"e18aee6c-9548-457e-9c20-7103d454969a",
+  "source_vps_size_disk"=>nil,
+  "owner"=>"system",
+  "is_public"=>true,
+  "description"=>"Some description",
+  "type"=>"image",
+  "source_vps_size"=>nil,
+  "name"=>"Centos 6.4 64-bit"
+}
+
+VPSNETINTERFACE_STUB = {
+  "ip"=>"37.233.98.178",
+  "mac"=>"e6:95:e5:4c:99:86",
+  "uuid"=>"b5a097ee-a095-47b4-b7c7-4b11100559a7",
+  "seq"=>0,
+  "network"=>NETWORK_STUB,
+  "instance_uuid"=>"71717dfb-3e86-487f-bcf0-01f6856d6bcd"
+}
+
+INSTANCE_STUB = {
+  "actions_pending_count"=>0,
+  "service_name"=>"TC_UNIT_MICRO",
+  "interfaces"=>[VPSNETINTERFACE_STUB],
+  "actions"=>[OPERATION_STUB],
+  "running"=>true,
+  "vpsimage"=>VPSIMAGE_STUB,
+  "owner"=>"imanel",
+  "size"=>-2,
+  "uuid"=>"71717dfb-3e86-487f-bcf0-01f6856d6bcd",
+  "hostname"=>"test",
+  "state"=>12,
+  "gross_cost_per_hour"=>0.03321,
+  "default_password"=>"c933c94b8b",
+  "vpsimage_uuid"=>"e18aee6c-9548-457e-9c20-7103d454969a"
+}

data/spec/support/validations.rb

@@ -0,0 +1,8 @@
+shared_examples_for 'require parameters' do |parameters|
+  parameters.each do |parameter|
+    it "should raise ArgumentError if #{parameter} is not provided" do
+      default_params.delete(parameter)
+      expect{ request.call(default_params) }.to raise_error(ArgumentError, "Missing attributes: [:#{parameter}]")
+    end
+  end
+end

data/tiktalik.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "tiktalik/version"
+
+Gem::Specification.new do |s|
+  s.name        = "tiktalik"
+  s.version     = Tiktalik::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Bernard Potocki"]
+  s.email       = ["bernard.potocki@imanel.org"]
+  s.homepage    = "http://github.com/tiktalik-cloud/tiktalik-ruby"
+  s.summary     = %q{Tiktalik.com Ruby API library}
+  s.description = %q{Tiktalik.com Ruby API library}
+
+  s.add_dependency 'faraday', '~> 0.9.0.rc5'
+  s.add_dependency 'multi_json', '~> 1.7.9'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: tiktalik
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Bernard Potocki
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0.rc5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0.rc5
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.9
+description: Tiktalik.com Ruby API library
+email:
+- bernard.potocki@imanel.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- lib/tiktalik.rb
+- lib/tiktalik/computing.rb
+- lib/tiktalik/computing/instance.rb
+- lib/tiktalik/computing/network.rb
+- lib/tiktalik/computing/operation.rb
+- lib/tiktalik/computing/vpsimage.rb
+- lib/tiktalik/computing/vpsnetinterface.rb
+- lib/tiktalik/error.rb
+- lib/tiktalik/object.rb
+- lib/tiktalik/version.rb
+- spec/computing/instance_spec.rb
+- spec/computing/network_spec.rb
+- spec/computing/operation_spec.rb
+- spec/computing/vpsimage_spec.rb
+- spec/computing/vpsnetinterface_spec.rb
+- spec/object_spec.rb
+- spec/spec_helper.rb
+- spec/support/error_requests.rb
+- spec/support/stubs.rb
+- spec/support/validations.rb
+- tiktalik.gemspec
+homepage: http://github.com/tiktalik-cloud/tiktalik-ruby
+licenses: []
+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.0.7
+signing_key: 
+specification_version: 4
+summary: Tiktalik.com Ruby API library
+test_files:
+- spec/computing/instance_spec.rb
+- spec/computing/network_spec.rb
+- spec/computing/operation_spec.rb
+- spec/computing/vpsimage_spec.rb
+- spec/computing/vpsnetinterface_spec.rb
+- spec/object_spec.rb
+- spec/spec_helper.rb
+- spec/support/error_requests.rb
+- spec/support/stubs.rb
+- spec/support/validations.rb