vultr 0.4.3 → 1.0.0

data/Rakefile

@@ -1,10 +1,14 @@
-require 'bundler/gem_tasks'
-require 'rake/testtask'
+require "bundler/gem_tasks"
+require "rake/testtask"
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << 'test'
-  t.libs << 'lib'
-  t.test_files = FileList['test/**/*_test.rb']
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
 end
 
-task :default => :test
+task default: :test
+
+task :console do
+  exec "irb -I lib -r vultr.rb"
+end

data/bin/console

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "vultr"
+
+# 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
+
+client = Vultr::Client.new(api_key: ENV["VULTR_API_KEY"])
+
+puts
+puts "We've created a 'client' variable as a Vultr::Client using ENV['VULTR_API_KEY'] as the API key."
+puts
+
+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/bin/test

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle exec rake test

data/lib/vultr/client.rb

@@ -0,0 +1,111 @@
+module Vultr
+  class Client
+    BASE_URL = "https://api.vultr.com/v2"
+
+    attr_reader :api_key, :adapter
+
+    def initialize(api_key:, adapter: Faraday.default_adapter, stubs: nil)
+      @api_key = api_key
+      @adapter = adapter
+
+      # Test stubs for requests
+      @stubs = stubs
+    end
+
+    def account
+      AccountResource.new(self)
+    end
+
+    def applications
+      ApplicationsResource.new(self)
+    end
+
+    def backups
+      BackupsResource.new(self)
+    end
+
+    def bare_metal
+      BareMetalResource.new(self)
+    end
+
+    def block_storage
+      BlockStorageResource.new(self)
+    end
+
+    def dns
+      DnsResource.new(self)
+    end
+
+    def firewall
+      FirewallResource.new(self)
+    end
+
+    def instances
+      InstancesResource.new(self)
+    end
+
+    def iso
+      IsoResource.new(self)
+    end
+
+    def kubernetes
+      KubernetesResource.new(self)
+    end
+
+    def load_balancers
+      LoadBalancersResource.new(self)
+    end
+
+    def object_storage
+      ObjectStorageResource.new(self)
+    end
+
+    def operating_systems
+      OperatingSystemsResource.new(self)
+    end
+
+    def plans
+      PlansResource.new(self)
+    end
+
+    def private_networks
+      PrivateNetworksResource.new(self)
+    end
+
+    def reserved_ips
+      ReservedIpsResource.new(self)
+    end
+
+    def regions
+      RegionsResource.new(self)
+    end
+
+    def snapshots
+      SnapshotsResource.new(self)
+    end
+
+    def ssh_keys
+      SshKeysResource.new(self)
+    end
+
+    def startup_scripts
+      StartupScriptsResource.new(self)
+    end
+
+    def users
+      UserResource.new(self)
+    end
+
+    def connection
+      @connection ||= Faraday.new(BASE_URL) do |conn|
+        conn.request :authorization, :Bearer, api_key
+        conn.request :json
+
+        conn.response :dates
+        conn.response :json, content_type: "application/json"
+
+        conn.adapter adapter, @stubs
+      end
+    end
+  end
+end

data/lib/vultr/collection.rb

@@ -0,0 +1,22 @@
+module Vultr
+  class Collection
+    attr_reader :data, :total, :next_cursor, :prev_cursor
+
+    def self.from_response(response, key:, type:)
+      body = response.body
+      new(
+        data: body[key].map { |attrs| type.new(attrs) },
+        total: body.dig("meta", "total"),
+        next_cursor: body.dig("meta", "links", "next"),
+        prev_cursor: body.dig("meta", "links", "prev")
+      )
+    end
+
+    def initialize(data:, total:, next_cursor:, prev_cursor:)
+      @data = data
+      @total = total
+      @next_cursor = next_cursor.empty? ? nil : next_cursor
+      @prev_cursor = prev_cursor.empty? ? nil : prev_cursor
+    end
+  end
+end

data/lib/vultr/error.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Error < StandardError
+  end
+end

data/lib/vultr/object.rb

@@ -0,0 +1,19 @@
+require "ostruct"
+
+module Vultr
+  class Object < OpenStruct
+    def initialize(attributes)
+      super to_ostruct(attributes)
+    end
+
+    def to_ostruct(obj)
+      if obj.is_a?(Hash)
+        OpenStruct.new(obj.map { |key, val| [key, to_ostruct(val)] }.to_h)
+      elsif obj.is_a?(Array)
+        obj.map { |o| to_ostruct(o) }
+      else # Assumed to be a primitive value
+        obj
+      end
+    end
+  end
+end

data/lib/vultr/objects/account.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Account < Object
+  end
+end

data/lib/vultr/objects/application.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Application < Object
+  end
+end

data/lib/vultr/objects/backup.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Backup < Object
+  end
+end

data/lib/vultr/objects/bare_metal.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class BareMetal < Object
+  end
+end

data/lib/vultr/objects/block_storage.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class BlockStorage < Object
+  end
+end

data/lib/vultr/objects/domain.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Domain < Object
+  end
+end

data/lib/vultr/objects/firewall_group.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class FirewallGroup < Object
+  end
+end

data/lib/vultr/objects/instance.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Instance < Object
+  end
+end

data/lib/vultr/objects/iso.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Iso < Object
+  end
+end

data/lib/vultr/objects/kubernetes_cluster.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class KubernetesCluster < Object
+  end
+end

data/lib/vultr/objects/load_balancer.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class LoadBalancer < Object
+  end
+end

data/lib/vultr/objects/object_storage.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class ObjectStorage < Object
+  end
+end

data/lib/vultr/objects/operating_system.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class OperatingSystem < Object
+  end
+end

data/lib/vultr/objects/plan.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Plan < Object
+  end
+end

data/lib/vultr/objects/private_network.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class PrivateNetwork < Object
+  end
+end

data/lib/vultr/objects/region.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Region < Object
+  end
+end

data/lib/vultr/objects/reserved_ip.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class ReservedIp < Object
+  end
+end

data/lib/vultr/objects/snapshot.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class Snapshot < Object
+  end
+end

data/lib/vultr/objects/ssh_key.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class SshKey < Object
+  end
+end

data/lib/vultr/objects/startup_script.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class StartupScript < Object
+  end
+end

data/lib/vultr/objects/user.rb

@@ -0,0 +1,4 @@
+module Vultr
+  class User < Object
+  end
+end

data/lib/vultr/resource.rb

@@ -0,0 +1,52 @@
+module Vultr
+  class Resource
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    private
+
+    def get_request(url, params: {}, headers: {})
+      handle_response client.connection.get(url, params, headers)
+    end
+
+    def post_request(url, body:, headers: {})
+      handle_response client.connection.post(url, body, headers)
+    end
+
+    def patch_request(url, body:, headers: {})
+      handle_response client.connection.patch(url, body, headers)
+    end
+
+    def put_request(url, body:, headers: {})
+      handle_response client.connection.put(url, body, headers)
+    end
+
+    def delete_request(url, params: {}, headers: {})
+      handle_response client.connection.delete(url, params, headers)
+    end
+
+    def handle_response(response)
+      case response.status
+      when 400
+        raise Error, "Your request was malformed. #{response.body["error"]}"
+      when 401
+        raise Error, "You did not supply valid authentication credentials. #{response.body["error"]}"
+      when 403
+        raise Error, "You are not allowed to perform that action. #{response.body["error"]}"
+      when 404
+        raise Error, "No results were found for your request. #{response.body["error"]}"
+      when 429
+        raise Error, "Your request exceeded the API rate limit. #{response.body["error"]}"
+      when 500
+        raise Error, "We were unable to perform the request due to server-side problems. #{response.body["error"]}"
+      when 503
+        raise Error, "You have been rate limited for sending more than 20 requests per second. #{response.body["error"]}"
+      end
+
+      response
+    end
+  end
+end

data/lib/vultr/resources/account.rb

@@ -0,0 +1,7 @@
+module Vultr
+  class AccountResource < Resource
+    def info
+      Account.new get_request("account").body.dig("account")
+    end
+  end
+end

data/lib/vultr/resources/applications.rb

@@ -0,0 +1,8 @@
+module Vultr
+  class ApplicationsResource < Resource
+    def list(**params)
+      response = get_request("applications", params: params)
+      Collection.from_response(response, key: "applications", type: Application)
+    end
+  end
+end

data/lib/vultr/resources/backups.rb

@@ -0,0 +1,12 @@
+module Vultr
+  class BackupsResource < Resource
+    def list(**params)
+      response = get_request("backups", params: params)
+      Collection.from_response(response, key: "backups", type: Backup)
+    end
+
+    def retrieve(backup_id:)
+      Backup.new get_request("backups/#{backup_id}").body.dig("backup")
+    end
+  end
+end