scaleway 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4221212c581c02e76a53304098a948188155ac74
+  data.tar.gz: 824b40eb6c814166c8a48d77d1c40f40da11fdb4
+SHA512:
+  metadata.gz: ce6a9abd5b98e486ea83492236c355c9d8ab2aa63ef34cdc083c1f9dd9ab68592f930728acc22fcf742d31f81e125097ce4a5e4386eeaba5924b3646fe23cb5f
+  data.tar.gz: 9d2c47c4986825c28c16b4e5450ba768422461966b34bccd9769c4f54a707d5d064fd6439af55c45b7b2998d8aed748aeb3692f63ee178a7a6806df76718e399

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.travis.yml

@@ -0,0 +1 @@
+script: "bundle exec rspec"

data/CHANGES.md

@@ -0,0 +1,14 @@
+# ChangeLog
+
+## 0.2.0 (2015-04-23)
+
+- Rename to scaleway.
+- Add the ability to reboot.
+
+## 0.1.1 (2014-11-14)
+
+- Fix push invalid gem.
+
+## 0.1.0 (2014-11-14)
+
+- Initial setup.

data/Gemfile

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

data/README.md

@@ -0,0 +1,176 @@
+# Scaleway Rubygem
+
+Easy to use Scaleway api client.
+
+## Installation
+
+Manual instalation:
+
+	gem install scaleway
+
+add this to your gemfile:
+
+	gem 'scaleway'
+
+
+## Usage
+
+### Configure the client
+
+    require 'scaleway'
+
+	Scaleway.organization = <organization_key>
+	Scaleway.token = <token>
+
+### Servers
+
+	# list all servers
+	Scaleway::Server.all
+
+	# list with filter
+	Scaleway::Server.all state: :running
+
+	# create a new server with default values
+	Scaleway::Server.create
+
+	# create a new server with name and tags
+	Scaleway::Server.create :name => 'my_new_server', tags: ['prod']
+
+	# get a server by id
+    server = Scaleway::Server.find <server_id>
+
+	# edit a server
+    server = Scaleway::Server.find <server_id>
+	server.name = 'new_name'
+	Scaleway::Server.edit server.id, server
+
+	# actions on a server
+	Scaleway::Server.power_on server.id
+
+	Scaleway::Server.power_off server.id
+
+	Scaleway::Server.terminate server.id
+
+	# destroy a server
+	Scaleway::Server.destroy server.id
+
+### Images
+
+	# list all images
+	Scaleway::Image.all
+
+	# list marketplace images
+	Scaleway::Image.marketplace
+
+	# get image by id
+	image = Scaleway::Image.find <image_id>
+
+	# get image by name
+	image = Scaleway::Image.find_by_name('Ubuntu')
+
+	# create an image
+	image = Scaleway::Image.create root_volume: snapshot
+
+	# edit an image
+	image = Scaleway::Image.edit id, image
+
+	# destroy an image
+	image = Scaleway::Image.destroy id
+
+### Volumes
+
+	# list all volumes
+	Scaleway::Volume.all
+
+	# get volume by id
+	volume = Scaleway::Volume.find <volume_id>
+
+	# create an volume
+	volume = Scaleway::Volume.create
+	volume = Scaleway::Volume.create size: 100 * 10 ** 9, volume_type: 'l_ssd'
+
+	# edit an volume
+	volume = Scaleway::Volume.edit id, volume
+
+	# destroy an volume
+	volume = Scaleway::Volume.destroy id
+
+### Snapshots
+
+	# list all snapshots
+	Scaleway::Volume.all
+
+	# get snapshot by id
+	snapshot = Scaleway::Snapshot.find <snapshot_id>
+
+	# create an snapshot
+	snapshot = Scaleway::Snapshot.create volume_id: id
+
+	# edit an snapshot
+	snapshot = Scaleway::Snapshot.edit id, snapshot
+
+	# destroy an snapshot
+	snapshot = Scaleway::Snapshot.destroy id
+
+### Ip addresses
+
+	# list all ip addresses
+	Scaleway::Ip.all
+
+	# get Ip
+	ip = Scaleway::Ip.find <ip_id>
+	ip = Scaleway::Ip.find 127.0.0.1
+
+	# reserve an ip
+	ip = Scaleway::Ip.reserve
+	# or
+	ip = Scaleway::Ip.create
+
+	# edit an ip
+	ip = Scaleway::Ip.edit id, ip
+
+	# release an ip
+	ip = Scaleway::Ip.destroy id
+
+### Handle exceptions
+
+	# Not found
+	begin
+		puts Scaleway::Server.find <invalid_id>
+	rescue Scaleway::NotFound => e
+		# handle error here
+	end
+
+	# Other
+	begin
+		puts Scaleway::Server.create extra_field: ['nope']
+	rescue Scaleway::APIError => e
+		# handle error here
+	end
+
+## Example
+
+    require 'scaleway'
+
+	Scaleway.organization = <organization_key>
+	Scaleway.token = <token>
+
+	# get the docker image
+	image = Scaleway::Image.find_by_name('Docker')
+
+	# create 5 new servers
+	5.times do |x|
+		Scaleway::Server.create name: "docker#{x}", image: image.id, tags: ['docker']
+	end
+
+	# power on
+	Scaleway::Server.all.each do |server|
+		Scaleway::Server.power_on(server.id)
+	end
+
+	# do something ...
+
+	# terminate
+	Scaleway::Server.all.each do |server|
+		Scaleway::Server.terminate(server.id)
+	end

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/scaleway/version.rb

@@ -0,0 +1,3 @@
+module Scaleway
+  VERSION = '0.2.0'
+end

data/lib/scaleway.rb

@@ -0,0 +1,350 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'recursive-open-struct'
+require 'scaleway/version'
+
+module Scaleway
+
+  extend self
+
+  def compute_endpoint
+    "https://api.scaleway.com"
+  end
+
+  def account_endpoint
+    "https://account.scaleway.com"
+  end
+
+  def token=(token)
+    @token = token
+    setup!
+    @token
+  end
+
+  def token
+    return @token if @token
+    "token_required"
+  end
+
+  def organization=(organization)
+    @organization = organization
+    setup!
+    @organization
+  end
+
+  def organization
+    return @organization if @organization
+    "organization_required"
+  end
+
+  DEFINITIONS = {
+    "Image" => {
+      :all => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/images",
+        :default_params => {
+          :organization => Proc.new { Scaleway.organization }
+        }
+      },
+      :marketplace => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/images",
+        :default_params => {
+          :public => true
+        }
+      },
+      :find => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/images/%s",
+      },
+      :find_by_name => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/images",
+        :filters => [
+          Proc.new { |item, params| item.name.include? params.first }
+        ],
+        :transform => Proc.new { |item, params| item.first },
+      },
+      :create => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/images",
+        :default_params => {
+          :name => 'default',
+          :root_volume => 'required',
+          :organization => Proc.new { Scaleway.organization },
+        }
+      },
+      :edit => {
+        :method => :put,
+        :endpoint => "#{Scaleway.compute_endpoint}/images/%s",
+      },
+      :destroy => {
+        :method => :delete,
+        :endpoint => "#{Scaleway.compute_endpoint}/images/%s",
+      },
+    },
+    "Volume" => {
+      :all => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/volumes",
+      },
+      :find => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/volumes/%s",
+      },
+      :edit => {
+        :method => :put,
+        :endpoint => "#{Scaleway.compute_endpoint}/volumes/%s",
+      },
+      :destroy => {
+        :method => :delete,
+        :endpoint => "#{Scaleway.compute_endpoint}/volumes/%s",
+      },
+      :create => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/volumes",
+        :default_params => {
+          :name => 'default',
+          :size => 20 * 10**9,
+          :volume_type => 'l_hdd',
+          :organization => Proc.new { Scaleway.organization },
+        }
+      },
+    },
+    "Ip" => {
+      :all => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/ips",
+      },
+      :find => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/ips/%s",
+      },
+      :edit => {
+        :method => :put,
+        :endpoint => "#{Scaleway.compute_endpoint}/ips/%s",
+      },
+      :destroy => {
+        :method => :delete,
+        :endpoint => "#{Scaleway.compute_endpoint}/ips/%s",
+      },
+      :reserve => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/ips",
+        :default_params => {
+          :organization => Proc.new { Scaleway.organization },
+        }
+      },
+      :create => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/ips",
+        :default_params => {
+          :organization => Proc.new { Scaleway.organization },
+        }
+      },
+    },
+    "Snapshot" => {
+      :all => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/snapshots",
+      },
+      :find => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/snapshots/%s",
+      },
+      :edit => {
+        :method => :put,
+        :endpoint => "#{Scaleway.compute_endpoint}/snapshots/%s",
+      },
+      :destroy => {
+        :method => :delete,
+        :endpoint => "#{Scaleway.compute_endpoint}/snapshots/%s",
+      },
+      :create => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/snapshots",
+        :default_params => {
+          :name => 'default',
+          :volume_id => 'required',
+          :organization => Proc.new { Scaleway.organization },
+        }
+      },
+    },
+    "Server" => {
+      :all => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers",
+      },
+      :power_on => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers/%s/action",
+        :default_params => {
+          :action => :poweron
+        }
+      },
+      :reboot => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers/%s/action",
+        :default_params => {
+          :action => :reboot
+        }
+      },
+      :power_off => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers/%s/action",
+        :default_params => {
+          :action => :poweroff
+        }
+      },
+      :terminate => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers/%s/action",
+        :default_params => {
+          :action => :terminate
+        }
+      },
+      :find => {
+        :method => :get,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers/%s",
+      },
+      :edit => {
+        :method => :put,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers/%s",
+      },
+      :destroy => {
+        :method => :delete,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers/%s",
+      },
+      :create => {
+        :method => :post,
+        :endpoint => "#{Scaleway.compute_endpoint}/servers",
+        :default_params => {
+          :name => 'default',
+          :image => Proc.new { Scaleway::Image.find_by_name('Ubuntu').id },
+          :volumes => {},
+          :organization => Proc.new { Scaleway.organization },
+        }
+      }
+    },
+  }
+
+  DEFINITIONS.each do |resource|
+    resource_name = resource[0]
+
+    resource_class = Class.new(Object) do
+      singleton = class << self; self end
+
+      DEFINITIONS[resource_name].each do |method_name, query|
+        singleton.send :define_method, method_name do |*args|
+          Scaleway.request_and_respond(query, *args)
+        end
+      end
+    end
+
+    Scaleway.const_set(resource_name, resource_class)
+  end
+
+  def request=(request)
+    @request = request
+  end
+
+  def request
+    @request
+  end
+
+  def request_and_respond(query, *params)
+    body = {}
+    body.merge! query[:default_params] || {}
+    endpoint = query[:endpoint]
+
+    params.each do |param|
+      if param.is_a? Hash or param.is_a? RecursiveOpenStruct
+        body.merge! param
+      elsif not param.nil?
+        endpoint = endpoint % param
+      end
+    end
+
+    body = Hash[body.map { |k, v|
+      if v.respond_to? :call then [k, v.call()] else [k, v] end
+    }]
+
+    resp = Scaleway.request.send(query[:method], endpoint, body)
+    body = resp.body
+    if resp.status == 204
+      return
+    end
+
+    if resp.status == 404
+      raise Scaleway::NotFound, resp
+    elsif resp.status >= 300
+      raise Scaleway::APIError, resp
+    end
+
+    hash = RecursiveOpenStruct.new(body, :recurse_over_arrays => true)
+
+    if body.length == 1
+      hash = hash.send(body.keys.first)
+    end
+
+    if query[:filters]
+      filters = query[:filters]
+      hash = hash.find_all do |item|
+        filters.all? do |filter|
+          filter.call(item, params)
+        end
+      end
+    end
+
+    if query[:transform]
+      hash = query[:transform].call(hash, params)
+    end
+
+    hash
+  end
+
+  class APIError < Exception
+    def initialize(response)
+      self.status = response.status
+      self.body = RecursiveOpenStruct.new(response.body, :recurse_over_arrays => true)
+      self.type = self.body.type
+      self.error_message = self.body.message
+    end
+
+    def to_s
+      "<status:#{status}, type:#{type}, message:\'#{error_message}\'>"
+    end
+
+    def message
+      "#{self}"
+    end
+
+    attr_accessor :status
+    attr_accessor :type
+    attr_accessor :error_message
+    attr_accessor :body
+  end
+
+  class NotFound < Scaleway::APIError
+  end
+
+
+
+  private
+
+  def setup!
+    options = {
+      :headers => {
+        'x-auth-token' => Scaleway.token,
+        'content-type' => 'application/json',
+      }
+    }
+
+    Scaleway.request = ::Faraday::Connection.new(options) do |builder|
+      builder.use     ::FaradayMiddleware::EncodeJson
+      builder.use     ::FaradayMiddleware::ParseJson
+      builder.use     ::FaradayMiddleware::FollowRedirects
+      builder.adapter ::Faraday.default_adapter
+    end
+  end
+end

data/scaleway.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'scaleway/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "scaleway"
+  gem.version       = Scaleway::VERSION
+  gem.authors       = ["bchatelard"]
+  gem.email         = ["chatel.bast@gmail.com"]
+  gem.description   = %q{Ruby bindings for the Scaleway API.}
+  gem.summary       = %q{Ruby bindings for the Scaleway API.}
+
+  # should change
+  gem.homepage      = "http://github.com/bchatelard/scaleway-ruby"
+
+  gem.add_dependency "faraday", "~> 0.9"
+  gem.add_dependency "faraday_middleware", "~> 0.9"
+  gem.add_dependency "recursive-open-struct", "~> 0.5"
+
+  gem.add_development_dependency "rake", "~> 10.1"
+  gem.add_development_dependency "rspec", "~> 3.1"
+  gem.add_development_dependency "its", "~> 0.2"
+
+  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 = ["lib"]
+end

data/spec/scaleway_spec.rb

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'its'
+require 'scaleway'
+
+describe Scaleway do
+  subject(:Scaleway) { described_class }
+
+  before do
+    Scaleway.organization = organization
+    Scaleway.token = token
+  end
+
+  describe "defaults" do
+    let(:organization)   { nil }
+    let(:token)          { nil }
+
+    its(:compute_endpoint) { should eq "https://api.scaleway.com" }
+    its(:account_endpoint) { should eq "https://account.scaleway.com" }
+    its(:token)            { should eq "token_required" }
+    its(:organization)     { should eq "organization_required" }
+
+    it { expect(Scaleway::VERSION).to eq "0.1.2" }
+  end
+
+  describe "test token and organization" do
+    let(:organization)   { "organization_id" }
+    let(:token)          { "token_id" }
+
+    its(:organization)   { should eq "organization_id" }
+    its(:token)          { should eq "token_id" }
+  end
+end

data/spec/servers_spec.rb

@@ -0,0 +1,60 @@
+require 'rubygems'
+require 'its'
+require 'scaleway'
+
+describe Scaleway::Server do
+  subject(:server) { described_class }
+
+  before do
+    stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+      stub.get('/servers')      { |env| [200, {}, {:servers => [test_server]}] }
+      stub.get('/servers/1234') { |env| [200, {}, {:server => test_server}] }
+      stub.get('/servers/not_found') { |env| [404, {}, {:type => 'not_found', :message => 'not found'}] }
+    end
+    Scaleway.request = Faraday.new do |builder|
+      builder.adapter :test, stubs
+    end
+  end
+
+  describe "all" do
+    let(:test_server)       { RecursiveOpenStruct.new({:name => 'hello', :id => '1234'}, :recurse_over_arrays => true) }
+
+    its(:all)               { should eq [test_server] }
+  end
+
+  describe "item" do
+    let(:test_server)       { RecursiveOpenStruct.new({:name => 'hello', :id => '1234'}, :recurse_over_arrays => true) }
+
+    its(:find, '1234')      { should eq test_server }
+  end
+
+  describe "not found" do
+    let(:test_server)       { RecursiveOpenStruct.new({:name => 'hello', :id => '1234'}, :recurse_over_arrays => true) }
+
+    it { expect{Scaleway::Server.find('not_found')}.to raise_error(Scaleway::NotFound) }
+  end
+
+end
+
+
+describe Scaleway::Server do
+  subject(:server) { described_class }
+
+  before do
+    stubs = Faraday::Adapter::Test::Stubs.new do |stub|
+      stub.get('/servers?state=running') { |env| [200, {}, {:servers => []}] }
+      stub.get('/servers?invalid_filter=42') { |env| [400, {}, {:type => 'invalid_filter', :message => 'invalid filter'}] }
+    end
+    Scaleway.request = Faraday.new do |builder|
+      builder.adapter :test, stubs
+    end
+  end
+
+  describe "filter" do
+    its(:all, state: 'running') { should eq [] }
+  end
+
+  describe "invalid filter" do
+    it { expect{Scaleway::Server.all(invalid_filter: 42)}.to raise_error(Scaleway::APIError) }
+  end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: scaleway
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- bchatelard
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-23 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'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: recursive-open-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: Ruby bindings for the Scaleway API.
+email:
+- chatel.bast@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CHANGES.md
+- Gemfile
+- README.md
+- Rakefile
+- lib/scaleway.rb
+- lib/scaleway/version.rb
+- scaleway.gemspec
+- spec/scaleway_spec.rb
+- spec/servers_spec.rb
+homepage: http://github.com/bchatelard/scaleway-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.2.2
+signing_key: 
+specification_version: 4
+summary: Ruby bindings for the Scaleway API.
+test_files:
+- spec/scaleway_spec.rb
+- spec/servers_spec.rb
+has_rdoc: