vultr 0.4.3 → 2.0.0

data/gemfiles/faraday_1.gemfile.lock

@@ -0,0 +1,102 @@
+PATH
+  remote: ..
+  specs:
+    vultr (2.0.0)
+      faraday (>= 1.0, < 3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    ast (2.4.2)
+    base64 (0.2.0)
+    faraday (1.10.3)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    minitest (5.23.1)
+    multipart-post (2.4.1)
+    parallel (1.24.0)
+    parser (3.3.2.0)
+      ast (~> 2.4.1)
+      racc
+    racc (1.8.0)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    regexp_parser (2.9.2)
+    rexml (3.2.8)
+      strscan (>= 3.0.9)
+    rubocop (1.63.5)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.31.3)
+      parser (>= 3.3.1.0)
+    rubocop-performance (1.21.0)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    standard (1.36.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.63.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.4)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.4.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.21.0)
+    strscan (3.1.0)
+    thor (1.3.1)
+    unicode-display_width (2.5.0)
+
+PLATFORMS
+  ruby
+  x86_64-darwin-23
+
+DEPENDENCIES
+  appraisal
+  base64 (~> 0.2.0)
+  faraday (~> 1.10)
+  minitest (>= 5.0.5)
+  rake
+  standard
+  vultr!
+
+BUNDLED WITH
+   2.5.10

data/gemfiles/faraday_2.gemfile

@@ -0,0 +1,11 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rake"
+gem "minitest", ">= 5.0.5"
+gem "standard"
+gem "appraisal"
+gem "faraday", "~> 2.0"
+
+gemspec path: "../"

data/gemfiles/faraday_2.gemfile.lock

@@ -0,0 +1,82 @@
+PATH
+  remote: ..
+  specs:
+    vultr (2.0.0)
+      faraday (>= 1.0, < 3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    ast (2.4.2)
+    faraday (2.9.0)
+      faraday-net_http (>= 2.0, < 3.2)
+    faraday-net_http (3.1.0)
+      net-http
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    minitest (5.23.1)
+    net-http (0.4.1)
+      uri
+    parallel (1.24.0)
+    parser (3.3.2.0)
+      ast (~> 2.4.1)
+      racc
+    racc (1.8.0)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    regexp_parser (2.9.2)
+    rexml (3.2.8)
+      strscan (>= 3.0.9)
+    rubocop (1.63.5)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.31.3)
+      parser (>= 3.3.1.0)
+    rubocop-performance (1.21.0)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    standard (1.36.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.63.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.4)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.4.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.21.0)
+    strscan (3.1.0)
+    thor (1.3.1)
+    unicode-display_width (2.5.0)
+    uri (0.13.0)
+
+PLATFORMS
+  ruby
+  x86_64-darwin-23
+
+DEPENDENCIES
+  appraisal
+  faraday (~> 2.0)
+  minitest (>= 5.0.5)
+  rake
+  standard
+  vultr!
+
+BUNDLED WITH
+   2.5.10

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 :vultr
+        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/middleware.rb

@@ -0,0 +1,32 @@
+require "time"
+
+module Vultr
+  class Middleware < Faraday::Middleware
+    ISO_DATE_FORMAT = /\A\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|((\+|-)\d{2}:?\d{2}))\Z/xm
+
+    # This method will be called when the response is being processed.
+    # You can alter it as you like, accessing things like response_body, response_headers, and more.
+    # Refer to Faraday::Env for a list of accessible fields:
+    # https://github.com/lostisland/faraday/blob/main/lib/faraday/options/env.rb
+    #
+    # @param env [Faraday::Env] the environment of the response being processed.
+    def on_complete(env)
+      parse_dates! env[:body]
+    end
+
+    private
+
+    def parse_dates!(value)
+      case value
+      when Hash
+        value.each { |key, element| value[key] = parse_dates!(element) }
+      when Array
+        value.each_with_index { |element, index| value[index] = parse_dates!(element) }
+      when ISO_DATE_FORMAT
+        Time.parse(value)
+      else
+        value
+      end
+    end
+  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

data/lib/vultr/resources/bare_metal.rb

@@ -0,0 +1,79 @@
+module Vultr
+  class BareMetalResource < Resource
+    def list(**params)
+      response = get_request("bare-metals", params: params)
+      Collection.from_response(response, key: "bare_metals", type: BareMetal)
+    end
+
+    def create(**attributes)
+      BareMetal.new post_request("bare-metals", body: attributes).body.dig("bare_metal")
+    end
+
+    def retrieve(baremetal_id:)
+      BareMetal.new get_request("bare-metals/#{baremetal_id}").body.dig("bare_metal")
+    end
+
+    def update(baremetal_id:, **attributes)
+      BareMetal.new patch_request("bare-metals/#{baremetal_id}", body: attributes).body.dig("bare_metal")
+    end
+
+    def delete(baremetal_id:)
+      delete_request("bare-metals/#{baremetal_id}")
+    end
+
+    def start(baremetal_id:)
+      post_request("bare-metals/#{baremetal_id}/start", body: {})
+    end
+
+    def reboot(baremetal_id:)
+      post_request("bare-metals/#{baremetal_id}/reboot", body: {})
+    end
+
+    def reinstall(baremetal_id:)
+      BareMetal.new post_request("bare-metals/#{baremetal_id}/reinstall", body: {}).body.dig("bare_metal")
+    end
+
+    def halt(baremetal_id:)
+      post_request("bare-metals/#{baremetal_id}/halt", body: {})
+    end
+
+    def bandwidth(baremetal_id:)
+      Object.new get_request("bare-metals/#{baremetal_id}/bandwidth").body.dig("bandwidth")
+    end
+
+    def user_data(baremetal_id:)
+      Object.new get_request("bare-metals/#{baremetal_id}/user-data").body.dig("user_data")
+    end
+
+    def upgrades(baremetal_id:, **params)
+      Object.new get_request("bare-metals/#{baremetal_id}/upgrades", params: params).body.dig("upgrades")
+    end
+
+    def vnc(baremetal_id:)
+      Object.new get_request("bare-metals/#{baremetal_id}/vnc").body.dig("vnc")
+    end
+
+    def list_ipv4(baremetal_id:)
+      response = get_request("bare-metals/#{baremetal_id}/ipv4")
+      Collection.from_response(response, key: "ipv4s", type: Object)
+    end
+
+    def list_ipv6(baremetal_id:)
+      response = get_request("bare-metals/#{baremetal_id}/ipv6")
+      Collection.from_response(response, key: "ipv6s", type: Object)
+    end
+
+    # Bulk operations
+    def halt_instances(baremetal_ids:)
+      post_request("bare-metals/halt", body: {baremetal_ids: Array(baremetal_ids)})
+    end
+
+    def reboot_instances(baremetal_ids:)
+      post_request("bare-metals/reboot", body: {baremetal_ids: Array(baremetal_ids)})
+    end
+
+    def start_instances(baremetal_ids:)
+      post_request("bare-metals/start", body: {baremetal_ids: Array(baremetal_ids)})
+    end
+  end
+end