hcloud 0.1.0.pre.alpha0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9cdf9035c8dc3386625887bdb9e02a25f8fe2c0b
+  data.tar.gz: c3b771e29328e7708f3f7251eb135a14335b0294
+SHA512:
+  metadata.gz: fb30c007428c885f476da3f59bd7c9bf918b0362a775822d31cc0ebb8a623d68fcbee05daea20d112d93acf4af21791a5ba36b24ddb6bf78bde184259ef71324
+  data.tar.gz: f6a1ae0b6cbc07df8786655579c27893c5e213b709d020064e335f0a7f0a031b099c4368c318f58e3e8c5fa415460350e6b3c643d06cc77d8080567f871bc96e

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/vendor
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.swp

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gem 'pry'
+
+# Specify your gem's dependencies in hcloud.gemspec
+gemspec

data/README.md

@@ -0,0 +1,67 @@
+# Hcloud
+
+This is an unoffical ruby client for HetznerCloud Api service.
+
+**Its currently in development and lacking a lot of feature. 
+The bindings are also not considered stable.**
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'hcloud'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install hcloud
+
+## Usage
+
+### Client
+
+* Create a client instance.
+
+```ruby
+c = Hcloud::Client.new(token: "<your project token>")
+```
+
+### Server Resource
+
+* List servers
+
+```ruby
+c.servers.each do |server|
+  server.datacenter.location.id #=> 1
+end
+```
+
+* Create a server
+
+```ruby
+c.servers.create(name: "moo5", server_type: "cx11", image: "ubuntu-16.04")
+#=> #<Hcloud::Server>
+```
+
+* Update servers' name
+
+```ruby
+c.servers.count
+#=> 2
+c.servers.first.update(name: "moo")
+#=> #<Hcloud::Server>
+c.servers.each{|x| x.update(name: "moo") }
+Hcloud::Error::UniquenessError: server name is already used
+```
+
+* Delete a server
+
+```ruby
+c.servers.first.delete
+#=> #<Hcloud::Action>
+```

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "hcloud"
+
+# 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(__FILE__)

data/bin/setup

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

data/hcloud.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "hcloud/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "hcloud"
+  spec.version       = Hcloud::VERSION
+  spec.authors       = ["Tim Foerster"]
+  spec.email         = ["github@moo.gl"]
+
+  spec.summary       = %q{HetznerCloud native Ruby client}
+  spec.homepage      = "https://github.com/tonobo/hcloud"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "typhoeus"
+  spec.add_development_dependency "oj"
+  spec.add_development_dependency "activesupport"
+end

data/lib/hcloud.rb

@@ -0,0 +1,16 @@
+require "hcloud/version"
+require 'active_support/core_ext/object/to_query'
+
+module Hcloud
+  autoload :Error, 'hcloud/errors'
+  autoload :Client, 'hcloud/client'
+  autoload :AbstractResource, 'hcloud/abstract_resource'
+  autoload :ServerResource, 'hcloud/server_resource'
+  autoload :EntryLoader, 'hcloud/entry_loader'
+  autoload :Server, 'hcloud/server'
+  autoload :ServerType, 'hcloud/server_type'
+  autoload :Datacenter, 'hcloud/datacenter'
+  autoload :Location, 'hcloud/location'
+  autoload :Image, 'hcloud/image'
+  autoload :Action, 'hcloud/action'
+end

data/lib/hcloud/abstract_resource.rb

@@ -0,0 +1,14 @@
+module Hcloud
+  class AbstractResource
+    attr_reader :client
+    def initialize(client:)
+      @client = client
+    end
+
+    protected
+
+    def request(*args)
+      client.request(*args)
+    end
+  end
+end

data/lib/hcloud/action.rb

@@ -0,0 +1,16 @@
+module Hcloud
+  class Action
+    Attributes = {
+      id: nil,
+      command: nil,
+      status: nil,
+      progress: nil,
+      started: :time,
+      finished: :time,
+      resources: nil,
+      error: nil,
+    }
+    
+    include EntryLoader
+  end
+end

data/lib/hcloud/client.rb

@@ -0,0 +1,66 @@
+autoload :Typhoeus, "typhoeus"
+autoload :Oj, "oj"
+
+module Hcloud
+  class Client
+    attr_reader :token
+    def initialize(token:)
+      @token = token
+    end
+
+    def authorized?
+      request("server_types").run
+      true
+    rescue Error::Unauthorized
+      false
+    end
+
+    def servers
+      ServerResource.new(client: self)
+    end
+
+    def request(path, **options)
+      code = options.delete(:code)
+      if x = options.delete(:j)
+        options[:body] = Oj.dump(x, mode: :compat)
+        options[:method] ||= :post
+      end
+      r = Typhoeus::Request.new(
+        "https://api.hetzner.cloud/v1/#{path}",
+        {
+          headers: { 
+            "Authorization" => "Bearer #{token}",
+            "Content-Type" => "application/json",
+          },
+        }.merge(options)
+      )
+      r.on_complete do |response|
+        case response.code
+        when code
+          raise Error::UnexpectedError, response.body
+        when 401
+          raise Error::Unauthorized
+        when 0
+          raise Error::ServerError, "Connection error: #{response.return_code}"
+        when 400...600
+          j = Oj.load(response.body)
+          code = j.dig("error", "code")
+          error_class = case code
+                        when "invalid_input" then Error::InvalidInput
+                        when "forbidden" then Error::Forbidden
+                        when "locked" then Error::Locked
+                        when "not_found" then Error::NotFound
+                        when "rate_limit_exceeded" then Error::RateLimitExceeded
+                        when "resource_unavailable" then Error::ResourceUnavilable
+                        when "service_error" then Error::ServiceError
+                        when "uniqueness_error" then Error::UniquenessError
+                        else
+                          Error::ServerError
+                        end
+          raise error_class, j.dig("error", "message")
+        end
+      end
+      r
+    end
+  end
+end

data/lib/hcloud/datacenter.rb

@@ -0,0 +1,13 @@
+module Hcloud
+  class Datacenter
+    Attributes = {
+      id: nil,
+      name: nil,
+      description: nil,
+      location: Location,
+    }
+
+    include EntryLoader
+
+  end
+end

data/lib/hcloud/entry_loader.rb

@@ -0,0 +1,36 @@
+require 'active_support/concern'
+module Hcloud
+  module EntryLoader
+    extend ActiveSupport::Concern
+
+    included do |klass|
+      klass.send(:attr_reader, :parent, :client)
+      klass.const_get(:Attributes).each do |attribute, value|
+        klass.send(:attr_accessor, attribute)
+      end
+    end
+
+    def initialize(resource, parent, client)
+      @parent = parent
+      @client = client
+      self.class.const_get(:Attributes).each do |attribute, value|
+        case value
+        when nil
+          self.send("#{attribute}=", resource[attribute.to_s])
+        when :time
+          unless resource[attribute.to_s].nil?
+            self.send("#{attribute}=", Time.parse(resource[attribute.to_s]))
+          end
+        else 
+          if value.is_a?(Class) and value.include?(EntryLoader)
+            self.send("#{attribute}=", value.new(resource[attribute.to_s], self, client))
+          end
+        end
+      end
+    end
+
+    def request(*args)
+      client.request(*args)
+    end
+  end
+end

data/lib/hcloud/errors.rb

@@ -0,0 +1,17 @@
+module Hcloud
+  class Error < StandardError
+    class Unauthorized < Error; end
+    class ServerError < Error; end
+    class Forbidden < Error; end
+    class InvalidInput < Error; end
+    class Locked < Error; end
+    class NotFound < Error; end
+    class RateLimitExceeded < Error; end
+    class ResourceUnavilable < Error; end
+    class ServiceError < Error; end
+    class UniquenessError < Error; end
+    class UnknownError < Error; end
+    class UnexpectedError < Error; end
+    class ResourcePathError < Error; end
+  end
+end

data/lib/hcloud/image.rb

@@ -0,0 +1,22 @@
+module Hcloud
+  class Image
+    Attributes = {
+      id: nil,
+      type: nil,
+      status: nil,
+      name: nil,
+      description: nil,
+      image_size: nil,
+      disk_size: nil,
+      created: :time,
+      created_from: nil,
+      bound_to: nil,
+      os_flavor: nil,
+      os_version: nil,
+      rapid_deploy: nil,
+    }
+
+    include EntryLoader
+
+  end
+end

data/lib/hcloud/location.rb

@@ -0,0 +1,16 @@
+module Hcloud
+  class Location
+    Attributes = {
+      id: nil,
+      name: nil,
+      description: nil,
+      country: nil,
+      city: nil,
+      longitude: nil,
+      latitude: nil,
+    }
+
+    include EntryLoader
+
+  end
+end

data/lib/hcloud/server.rb

@@ -0,0 +1,47 @@
+module Hcloud
+  class Server
+    Attributes = {
+      id: nil,
+      name: nil,
+      status: nil,
+      created: :time,
+      public_net: nil,
+      server_type: ServerType,
+      datacenter: Datacenter,
+      image: Image,
+      iso: nil,
+      rescue_enabled: nil,
+      locked: nil,
+      backup_window: nil,
+      outgoing_traffic: nil,
+      ingoing_traffic: nil,
+      included_traffic: nil
+    }
+
+    include EntryLoader
+
+    def update(name:) 
+      Server.new(
+        Oj.load(request(base_path, j: {name: name}, method: :put).run.body)["server"],
+        parent,
+        client
+      )
+    end
+
+    def destroy
+      Action.new(
+        Oj.load(request(base_path, method: :delete).run.body)["action"],
+        parent,
+        client
+      )
+    end
+
+    private
+
+    def base_path
+      return "servers/#{id}" unless id.nil?
+      raise ResourcePathError, "Unable to build resource path. Id is nil." 
+    end
+
+  end
+end

data/lib/hcloud/server_resource.rb

@@ -0,0 +1,37 @@
+module Hcloud
+  class ServerResource < AbstractResource
+    include Enumerable
+
+    def create(name:,
+               server_type:,
+               datacenter: nil,
+               location: nil,
+               start_after_create: nil,
+               image:,
+               ssh_keys: [],
+               user_data: nil)
+      query = {}
+      method(:create).parameters.inject(query) do |r,x| 
+        (var = eval(x.last.to_s)).nil? ? r : r.merge!(x.last => var)
+      end
+      Server.new(
+        Oj.load(request("servers", j: query, code: 200).run.body)["server"],
+        self,
+        client
+      )
+    end
+
+    def all
+      Oj.load(request("servers").run.body)["servers"].map do |x|
+        Server.new(x, self, client)
+      end
+    end
+
+    def each(&block)
+      all.each do |member|
+        block.call(member)
+      end
+    end
+    
+  end
+end

data/lib/hcloud/server_type.rb

@@ -0,0 +1,17 @@
+module Hcloud
+  class ServerType
+    Attributes = {
+      id: nil,
+      name: nil,
+      description: nil,
+      cores: nil,
+      memory: nil,
+      disk: nil,
+      prices: nil,
+      storage_type: nil,
+    }
+
+    include EntryLoader
+
+  end
+end

data/lib/hcloud/version.rb

@@ -0,0 +1,3 @@
+module Hcloud
+  VERSION = "0.1.0-alpha0"
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: hcloud
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre.alpha0
+platform: ruby
+authors:
+- Tim Foerster
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-01-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !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: typhoeus
+  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: oj
+  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: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- github@moo.gl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- hcloud.gemspec
+- lib/hcloud.rb
+- lib/hcloud/abstract_resource.rb
+- lib/hcloud/action.rb
+- lib/hcloud/client.rb
+- lib/hcloud/datacenter.rb
+- lib/hcloud/entry_loader.rb
+- lib/hcloud/errors.rb
+- lib/hcloud/image.rb
+- lib/hcloud/location.rb
+- lib/hcloud/server.rb
+- lib/hcloud/server_resource.rb
+- lib/hcloud/server_type.rb
+- lib/hcloud/version.rb
+homepage: https://github.com/tonobo/hcloud
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2.2
+signing_key: 
+specification_version: 4
+summary: HetznerCloud native Ruby client
+test_files: []