hetznercloud 1.0.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75623886cacdbf6d5513f45eb32c0d34ef0c8f0c1adee2bc7e69bf049b9c77ce
-  data.tar.gz: 8055fc431b7a33ef53c6f30ca9002e36f91e1c723197294bf1cc8c00d8035072
+  metadata.gz: 78ef10de0c462ae7e1c5bf47c747d25a110551f817800b70b2aef7f5a045db5c
+  data.tar.gz: d9833600b525f01a5879888809a401df07bb7120f2d42db2e43220e0897cbfb5
 SHA512:
-  metadata.gz: ccc0bcd9ea354b43cd7b235b788f516a2665066580f44cd25e9d17d6e206680e3cc33786c14c1e47a5948c606588ef517e0a371a6de8537365e8697fea04a16d
-  data.tar.gz: cce03b3d75507f236152b04b731bd85cf88e15bef217805f6758e1fbf7dc12eb66e36b24717ee01680b16226f20d457b301436ca83d03aa183b6f7945f93dda0
+  metadata.gz: 20a46b53f9caa94a730c512208817c3ec7eb871983ade5bdd8acf2c19f77089084a31648c7b10d4d25d7cf3004f440d6732729398836e437838315fb01ec1985
+  data.tar.gz: 6cd6709f99a23259d4e82a93285aa415358cdc51dff6489911df5c35a06c6d85005c65eee5a42021bd69a665f33b620196d3657675122bd1c78da0d2d374c869

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## HCloud v1.3.1
+
+- Add missing Server#user_data
+
+## HCloud v1.3.0
+
+- Implemented Load Balancers
+- Implemented Load Balancer Types
+
+## HCloud v1.2.0
+
+- Implemented Networks
+- Implemented Network Actions
+- Implemented Pricing
+- Implemented Certificates
+- Implemented Certificate Actions
+
+## HCloud v1.1.0
+
+- Implemented Firewall Actions
+
 ## HCloud v1.0.0
 
 Initial release

data/README.md

@@ -74,24 +74,24 @@ Not all Hetzner Cloud API endpoints have been implemented yet.
 | Resource              | State                 |
 |-----------------------|-----------------------|
 | Actions               | Implemented           |
-| Certificates          | Not implemented       |
-| Certificate Actions   | Not implemented       |
+| Certificates          | Implemented           |
+| Certificate Actions   | Implemented           |
 | Datacenters           | Implemented           |
 | Firewalls             | Implemented           |
-| Firewall Actions      | Not implemented       |
+| Firewall Actions      | Implemented           |
 | Floating IPs          | Implemented           |
 | Floating IP Actions   | Implemented           |
 | Images                | Implemented           |
 | Image Actions         | Implemented           |
 | ISOs                  | Implemented           |
-| Load Balancers        | Not implemented       |
+| Load Balancers        | Implemented           |
 | Load Balancer Actions | Not implemented       |
-| Load Balancer Types   | Not implemented       |
+| Load Balancer Types   | Implemented           |
 | Locations             | Implemented           |
-| Networks              | Not implemented       |
-| Network Actions       | Not implemented       |
+| Networks              | Implemented           |
+| Network Actions       | Implemented           |
 | Placement Groups      | Implemented           |
-| Pricing               | Not implemented       |
+| Pricing               | Implemented           |
 | Servers               | Partially implemented |
 | Server Actions        | Not implemented       |
 | Server Types          | Implemented           |
@@ -109,6 +109,30 @@ bundle exec rspec
 bundle exec rspec --tag integration
 ```
 
+## Debugging
+
+### Logging
+
+When using the gem in your code, you can pass a `logger:` argument to `HCloud::Client`:
+
+```ruby
+logger = Logger.new("log/http.log")
+logger.level = :debug
+
+client = HCloud::Client.new(access_token: "my_access_token", logger: logger)
+```
+
+When executing the test suite, set `LOG_LEVEL` environment variable to `debug` in order to see HTTP requests.
+
+### Endpoint
+
+`HCloud::Client` also accepts an alternate endpoint:
+
+
+```ruby
+client = HCloud::Client.new(access_token: "my_access_token", endpoint: "https://myproxy/v1")
+```
+
 ## Releasing
 
 To release a new version, update the version number in `lib/hcloud/version.rb`, update the changelog, commit the files and create a git tag starting with `v`, and push it to the repository.

data/config/inflections.rb

@@ -2,18 +2,27 @@
 
 HCloud.loader.inflector.inflect(
   "dns_pointer" => "DNSPointer",
-  "hcloud" => "HCloud",
-  "ssh_key" => "SSHKey",
   "floating_ip" => "FloatingIP",
+  "floating_ip_price" => "FloatingIPPrice",
+  "floating_ip_prices" => "FloatingIPPrices",
+  "floating_ips" => "FloatingIPs",
+  "hcloud" => "HCloud",
+  "health_check_http" => "HealthCheckHTTP",
   "http" => "HTTP",
   "ip_not_available" => "IPNotAvailable",
+  "ipv4" => "IPv4",
+  "ipv6" => "IPv6",
   "iso" => "ISO",
   "iso_type" => "ISOType",
+  "service_http" => "ServiceHTTP",
+  "ssh_key" => "SSHKey",
+  "target_ip" => "TargetIP",
 )
 
 ActiveSupport::Inflector.inflections(:en) do |inflect|
   inflect.acronym "DNS"
-  inflect.acronym "JSON"
+  inflect.acronym "HTTP"
   inflect.acronym "IP"
   inflect.acronym "ISO"
+  inflect.acronym "JSON"
 end

data/lib/core_ext/send_wrap.rb

@@ -2,12 +2,19 @@
 
 module CoreExt
   module SendWrap
-    # Send a message to self, or all objects contained in self (for enumerables)
+    # Send a message to self, or all objects contained in self (for arrays)
 
-    # FIXME: { env: "prod" }.send_wrap(:try, :to_h) returns { env: nil }
+    # NOTE: { env: "prod" }.send_wrap(:try, :to_h) returns { env: nil }
+    # NOTE: ["example.com"].send_wrap(:try, to_h) return [nil]
+    # Use a block for the above cases:
+    # { env: "prod" }.send_wrap { |o| o.try(:to_h) || o }
 
-    def send_wrap(method_name, ...)
-      is_a?(Array) ? map { |v| v.send(method_name, ...) } : send(method_name, ...)
+    def send_wrap(...)
+      if is_a?(Array)
+        map { |v| block_given? ? yield(v) : v.send(...) }
+      else
+        block_given? ? yield(self) : send(...)
+      end
     end
   end
 end

data/lib/hcloud/concerns/actionable.rb

@@ -19,9 +19,16 @@ module HCloud
         action_names << name.to_s
 
         define_method(name) do |**params|
-          Action.new client
+          raise Errors::MissingIDError unless id
+
+          response = client
             .post("/#{resource_name.pluralize}/#{id}/actions/#{name}", params)
-            .fetch(:action)
+
+          if response.key?(:actions)
+            response[:actions].map { |r| Action.new r }
+          else
+            Action.new response[:action]
+          end
         end
       end
     end

data/lib/hcloud/concerns/concerns.rb

@@ -24,6 +24,14 @@ module HCloud
       def deletable
         include Deletable
       end
+
+      def meterable
+        include Meterable
+      end
+
+      def singleton
+        include Singleton
+      end
     end
   end
 end

data/lib/hcloud/concerns/creatable.rb

@@ -10,6 +10,7 @@ module HCloud
       def create
         assign_attributes client
           .post("/#{resource_name.pluralize}", creatable_params)
+          .tap { |r| r[resource_name.to_sym].merge!(r.slice(:root_password)) }
           .fetch(resource_name.to_sym)
       end
 
@@ -29,9 +30,9 @@ module HCloud
 
         attributes
           .slice(*simple_attributes.map(&:to_s))
-          .transform_values { |v| v&.send_wrap(:try, :to_h) || v&.send_wrap(:to_s) }
+          .transform_values { |v| v&.send_wrap { |o| o.try(:to_h) || o } || v&.send_wrap(:to_s) }
           .merge(nested_attributes.reduce(&:merge)&.map { |k, v| [k.to_s, Array(v).filter_map { |w| send(k)&.send_wrap(w) }.first] }.to_h)
-          .compact
+          .compact_blank
       end
       # rubocop:enable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
     end

data/lib/hcloud/concerns/deletable.rb

@@ -6,6 +6,8 @@ module HCloud
 
     included do
       def delete
+        raise Errors::MissingIDError unless id
+
         client
           .delete("/#{resource_name.pluralize}/#{id}")
 

data/lib/hcloud/concerns/meterable.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module HCloud
+  module Meterable
+    extend ActiveSupport::Concern
+
+    included do
+      def metrics(type:, from:, to:, step: nil)
+        raise Errors::MissingIDError unless id
+
+        Metrics.new client
+          .get("/#{resource_name.pluralize}/#{id}/metrics", type: Array(type).join(","), start: from.iso8601, end: to.iso8601, step: step)
+          .fetch(:metrics)
+      end
+    end
+  end
+end

data/lib/hcloud/concerns/queryable.rb

@@ -6,6 +6,8 @@ module HCloud
 
     included do
       def reload
+        raise Errors::MissingIDError unless id
+
         assign_attributes client
           .get("/#{resource_name.pluralize}/#{id}")
           .fetch(resource_name.to_sym)
@@ -16,6 +18,8 @@ module HCloud
 
     class_methods do
       def find(id)
+        raise Errors::MissingIDError unless id
+
         new client
           .get("/#{resource_name.pluralize}/#{id}")
           .fetch(resource_name.to_sym)

data/lib/hcloud/concerns/singleton.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module HCloud
+  module Singleton
+    extend ActiveSupport::Concern
+
+    included do
+      def reload
+        assign_attributes client
+          .get("/#{resource_name}")
+          .fetch(resource_name.to_sym)
+
+        self
+      end
+    end
+
+    class_methods do
+      def find
+        new client
+          .get("/#{resource_name}")
+          .fetch(resource_name.to_sym)
+      end
+    end
+  end
+end

data/lib/hcloud/concerns/updatable.rb

@@ -6,6 +6,8 @@ module HCloud
 
     included do
       def update
+        raise Errors::MissingIDError unless id
+
         assign_attributes client
           .put("/#{resource_name.pluralize}/#{id}", updatable_params)
           .fetch(resource_name.to_sym)

data/lib/hcloud/entities/algorithm.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Algorithm < Entity
+    attribute :type
+  end
+end

data/lib/hcloud/entities/certificate_status.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module HCloud
+  class CertificateStatus < Entity
+    attribute :error, :error
+    attribute :issuance
+    attribute :renewal
+  end
+end

data/lib/hcloud/entities/floating_ip_price.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class FloatingIPPrice < Entity
+    attribute :price_monthly, :amount
+  end
+end

data/lib/hcloud/entities/floating_ip_prices.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module HCloud
+  class FloatingIPPrices < Entity
+    attribute :type
+    attribute :prices, :price
+  end
+end

data/lib/hcloud/entities/health_check.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module HCloud
+  class HealthCheck < Entity
+    attribute :http, :health_check_http
+    attribute :interval, :integer
+    attribute :port, :integer
+    attribute :protocol
+    attribute :retries, :integer
+    attribute :timeout, :integer
+  end
+end

data/lib/hcloud/entities/health_check_http.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module HCloud
+  class HealthCheckHTTP < Entity
+    attribute :domain
+    attribute :path
+    attribute :response
+    attribute :status_code, array: true, default: -> { [] }
+    attribute :tls
+
+    alias tls? tls
+  end
+end

data/lib/hcloud/entities/health_status.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module HCloud
+  class HealthStatus < Entity
+    attribute :listen_port, :integer
+    attribute :status
+  end
+end

data/lib/hcloud/entities/image_price.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class ImagePrice < Entity
+    attribute :price_per_gb_month, :amount
+  end
+end

data/lib/hcloud/entities/ipv4.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module HCloud
+  class IPv4 < Entity
+    attribute :blocked, :boolean
+    attribute :dns_ptr
+    attribute :id, :integer
+    attribute :ip
+
+    alias blocked? blocked
+  end
+end

data/lib/hcloud/entities/ipv6.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module HCloud
+  class IPv6 < Entity
+    attribute :blocked, :boolean
+    attribute :dns_ptr, :dns_pointer, array: true, default: -> { [] }
+    attribute :id, :integer
+    attribute :ip
+
+    alias blocked? blocked
+  end
+end

data/lib/hcloud/entities/label_selector.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class LabelSelector < Entity
+    attribute :selector
+  end
+end

data/lib/hcloud/entities/load_balancer_private_net.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module HCloud
+  class LoadBalancerPrivateNet < Entity
+    attribute :ip
+    attribute :network
+  end
+end

data/lib/hcloud/entities/load_balancer_public_net.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HCloud
+  class LoadBalancerPublicNet < Entity
+    attribute :enabled, :boolean
+    attribute :ipv4, :dns_pointer
+    attribute :ipv6, :dns_pointer
+
+    alias enabled? enabled
+  end
+end

data/lib/hcloud/entities/load_balancer_type_price.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module HCloud
+  class LoadBalancerTypePrice < Entity
+    attribute :id, :integer
+    attribute :name
+    attribute :prices, :price, array: true, default: -> { [] }
+  end
+end

data/lib/hcloud/entities/private_net.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HCloud
+  class PrivateNet < Entity
+    attribute :alias_ips, array: true, default: -> { [] }
+    attribute :ip
+    attribute :mac_address
+    attribute :network, :network
+  end
+end

data/lib/hcloud/entities/public_net.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HCloud
+  class PublicNet < Entity
+    attribute :firewalls, :firewall, array: true, default: -> { [] }
+    attribute :floating_ips, :floating_ip, array: true, default: -> { [] }
+    attribute :ipv4, :ipv4
+    attribute :ipv6, :ipv6
+  end
+end

data/lib/hcloud/entities/route.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Route < Entity
+    attribute :destination
+    attribute :gateway
+  end
+end

data/lib/hcloud/entities/server_backup_price.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class ServerBackupPrice < Entity
+    attribute :percentage
+  end
+end

data/lib/hcloud/entities/server_type_price.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module HCloud
+  class ServerTypePrice < Entity
+    attribute :id, :integer
+    attribute :name
+    attribute :prices, :price, array: true, default: -> { [] }
+  end
+end

data/lib/hcloud/entities/service.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Service < Entity
+    attribute :listen_port, :integer
+    attribute :destination_port, :integer
+
+    attribute :protocol
+    attribute :proxyprotocol, :boolean
+
+    attribute :health_check, :health_check
+    attribute :http, :service_http
+
+    alias proxyprotocol? proxyprotocol
+  end
+end

data/lib/hcloud/entities/service_http.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module HCloud
+  class ServiceHTTP < Entity
+    attribute :certificates, :certificate, array: true, default: -> { [] }
+
+    attribute :cookie_lifetime, :integer
+    attribute :cookie_name
+
+    attribute :redirect_http, :boolean
+    attribute :sticky_sessions, :boolean
+
+    alias redirect_http? redirect_http
+    alias sticky_sessions? sticky_sessions
+  end
+end

data/lib/hcloud/entities/subnet.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Subnet < Entity
+    attribute :type
+    attribute :network_zone
+    attribute :gateway
+    attribute :ip_range
+    attribute :vswitch_id
+  end
+end

data/lib/hcloud/entities/target.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Target < Entity
+    attribute :type
+
+    attribute :health_status, :health_status, array: true, default: -> { [] }
+
+    attribute :server, :server
+
+    attribute :use_private_ip, :boolean
+
+    alias use_private_ip? use_private_ip
+  end
+end

data/lib/hcloud/entities/target_ip.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class TargetIP < Entity
+    attribute :ip
+  end
+end

data/lib/hcloud/entities/target_target.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module HCloud
+  class TargetTarget < Entity
+    attribute :type
+
+    attribute :health_status, :health_status, array: true, default: -> { [] }
+
+    attribute :server, :server
+
+    attribute :use_private_ip, :boolean
+
+    alias use_private_ip? use_private_ip
+  end
+end

data/lib/hcloud/entities/targets.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Targets < Target
+    attribute :type
+
+    attribute :ip, :target_ip
+
+    attribute :label_selector, :label_selector
+
+    attribute :targets, :target, array: true, default: -> { [] }
+  end
+end

data/lib/hcloud/entities/traffic_price.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class TrafficPrice < Entity
+    attribute :price_per_tb, :amount
+  end
+end

data/lib/hcloud/entities/used_by.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module HCloud
+  class UsedBy < Entity
+    attribute :id, :integer
+    attribute :type
+  end
+end

data/lib/hcloud/entities/volume_price.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HCloud
+  class VolumePrice < Entity
+    attribute :price_per_gb_month, :amount
+  end
+end

data/lib/hcloud/entity.rb

@@ -18,6 +18,7 @@ module HCloud
     def to_h
       attributes
         .transform_values { |v| v.try(:to_h) || v }
+        .compact_blank
     end
   end
 end