hetznercloud 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96dedcad6852bc32b89ff4a0df8ee183ed6a8c49a88c840b06dc6c0cd075d255
-  data.tar.gz: b5105539a02269441777a43e045b80d7400ff7674d88f28553a8105f19a8d8d2
+  metadata.gz: 7177e5022ba3e3023d0d5537ba6c1784e6b05dcd0e378cf134f937057842e134
+  data.tar.gz: 6e7610f8b00c41b91993bcae03f1685494510718b3f063cb16ccc26faaa956bc
 SHA512:
-  metadata.gz: 20b1d95239793c7790db9ced2f88a3b44a6add5d553a4bf4e17420b6be2290af4fe452ae5146bb769395fb645b7526322c0d4c488e00280135bcc2128f6532b0
-  data.tar.gz: 5a5834d0ba17683ca5679ef7413297cca66200747e2ce36f37e6175db7c68b194ff267b832351c369ef8aaf98a82865ec2f0326a2a203640572db44d282e8a92
+  metadata.gz: 01ca0bfe1c72a5a4d49a9c33e4c4b0d574d69879bac68b94de3ad435fce3b3fa90319285c30808c08b7bc87dac08b3a314ab81f3018aac7fd360167c3a69e322
+  data.tar.gz: 987eacdba19a6ba38de99242f2d54612c5432b9a0309b91193cc0f4b5f59d60aaa96daedda2d81301fc974f1a368c20660a74d06a37b74849139e647ae8d43c2

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## HCloud v1.2.0
+
+- Implemented Networks
+- Implemented Network Actions
+- Implemented Pricing
+- Implemented Certificates
+- Implemented Certificate Actions
+
 ## HCloud v1.1.0
 
 - Implemented Firewall Actions

data/README.md

@@ -74,8 +74,8 @@ 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      | Implemented           |
@@ -88,10 +88,10 @@ Not all Hetzner Cloud API endpoints have been implemented yet.
 | Load Balancer Actions | Not implemented       |
 | Load Balancer Types   | Not 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

@@ -5,7 +5,12 @@ HCloud.loader.inflector.inflect(
   "hcloud" => "HCloud",
   "ssh_key" => "SSHKey",
   "floating_ip" => "FloatingIP",
+  "floating_ip_price" => "FloatingIPPrice",
+  "floating_ips" => "FloatingIPs",
+  "floating_ip_prices" => "FloatingIPPrices",
   "http" => "HTTP",
+  "ipv4" => "IPv4",
+  "ipv6" => "IPv6",
   "ip_not_available" => "IPNotAvailable",
   "iso" => "ISO",
   "iso_type" => "ISOType",

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,6 +19,8 @@ module HCloud
         action_names << name.to_s
 
         define_method(name) do |**params|
+          raise Errors::MissingIDError unless id
+
           response = client
             .post("/#{resource_name.pluralize}/#{id}/actions/#{name}", params)
 

data/lib/hcloud/concerns/concerns.rb

@@ -24,6 +24,10 @@ module HCloud
       def deletable
         include Deletable
       end
+
+      def singleton
+        include Singleton
+      end
     end
   end
 end

data/lib/hcloud/concerns/creatable.rb

@@ -29,9 +29,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/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/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/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/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/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/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

data/lib/hcloud/errors.rb

@@ -53,5 +53,7 @@ module HCloud
     class Unauthorized < Error; end
     class UniquenessError < Error; end
     class UnsupportedError < Error; end
+
+    class MissingIDError < Error; end
   end
 end

data/lib/hcloud/http.rb

@@ -17,6 +17,8 @@ module HCloud
       response = http
         .get(url_for(path), params: transform_params(params))
 
+      raise Errors::ServerError, response if response.status.server_error?
+
       data = response
         .parse(:json)
         .deep_symbolize_keys
@@ -30,6 +32,8 @@ module HCloud
       response = http
         .put(url_for(path), json: body)
 
+      raise Errors::ServerError, response if response.status.server_error?
+
       data = response
         .parse(:json)
         .deep_symbolize_keys
@@ -43,6 +47,8 @@ module HCloud
       response = http
         .post(url_for(path), json: body)
 
+      raise Errors::ServerError, response if response.status.server_error?
+
       data = response
         .parse(:json)
         .deep_symbolize_keys
@@ -58,6 +64,8 @@ module HCloud
 
       return if response.status.success?
 
+      raise Errors::ServerError, response if response.status.server_error?
+
       data = response
         .parse(:json)
         .deep_symbolize_keys

data/lib/hcloud/resource_type.rb

@@ -40,6 +40,8 @@ module HCloud
     def assert_valid_value(_); end
 
     # rubocop:disable Naming/MethodName
+    # Limitation: resource types cannot be nested, because the types
+    # are registered as soon as possible, and the modules may not exist yet.
     def self.Type(class_name)
       Class
         .new(ResourceType) { self.resource_class_name = class_name }
@@ -54,20 +56,39 @@ ActiveModel::Type.register(:amount, HCloud::ResourceType.Type("HCloud::Amount"))
 ActiveModel::Type.register(:applied_to, HCloud::ResourceType.Type("HCloud::AppliedTo"))
 ActiveModel::Type.register(:applied_to_resource, HCloud::ResourceType.Type("HCloud::AppliedToResource"))
 ActiveModel::Type.register(:apply_to, HCloud::ResourceType.Type("HCloud::ApplyTo"))
+ActiveModel::Type.register(:certificate, HCloud::ResourceType.Type("HCloud::Certificate"))
+ActiveModel::Type.register(:certificate_status, HCloud::ResourceType.Type("HCloud::CertificateStatus"))
 ActiveModel::Type.register(:datacenter, HCloud::ResourceType.Type("HCloud::Datacenter"))
 ActiveModel::Type.register(:datacenter_server_type, HCloud::ResourceType.Type("HCloud::DatacenterServerType"))
 ActiveModel::Type.register(:dns_pointer, HCloud::ResourceType.Type("HCloud::DNSPointer"))
 ActiveModel::Type.register(:error, HCloud::ResourceType.Type("HCloud::Error"))
 ActiveModel::Type.register(:firewall, HCloud::ResourceType.Type("HCloud::Firewall"))
 ActiveModel::Type.register(:floating_ip, HCloud::ResourceType.Type("HCloud::FloatingIP"))
+ActiveModel::Type.register(:floating_ip_price, HCloud::ResourceType.Type("HCloud::FloatingIPPrice"))
+ActiveModel::Type.register(:floating_ip_prices, HCloud::ResourceType.Type("HCloud::FloatingIPPrices"))
 ActiveModel::Type.register(:image, HCloud::ResourceType.Type("HCloud::Image"))
+ActiveModel::Type.register(:image_price, HCloud::ResourceType.Type("HCloud::ImagePrice"))
+ActiveModel::Type.register(:ipv4, HCloud::ResourceType.Type("HCloud::IPv4"))
+ActiveModel::Type.register(:ipv6, HCloud::ResourceType.Type("HCloud::IPv6"))
 ActiveModel::Type.register(:iso, HCloud::ResourceType.Type("HCloud::ISO"))
+ActiveModel::Type.register(:load_balancer_type_price, HCloud::ResourceType.Type("HCloud::LoadBalancerTypePrice"))
 ActiveModel::Type.register(:location, HCloud::ResourceType.Type("HCloud::Location"))
+ActiveModel::Type.register(:network, HCloud::ResourceType.Type("HCloud::Network"))
 ActiveModel::Type.register(:placement_group, HCloud::ResourceType.Type("HCloud::PlacementGroup"))
 ActiveModel::Type.register(:price, HCloud::ResourceType.Type("HCloud::Price"))
+ActiveModel::Type.register(:pricing, HCloud::ResourceType.Type("HCloud::Pricing"))
+ActiveModel::Type.register(:private_net, HCloud::ResourceType.Type("HCloud::PrivateNet"))
 ActiveModel::Type.register(:protection, HCloud::ResourceType.Type("HCloud::Protection"))
+ActiveModel::Type.register(:public_net, HCloud::ResourceType.Type("HCloud::PublicNet"))
+ActiveModel::Type.register(:route, HCloud::ResourceType.Type("HCloud::Route"))
 ActiveModel::Type.register(:rule, HCloud::ResourceType.Type("HCloud::Rule"))
 ActiveModel::Type.register(:server, HCloud::ResourceType.Type("HCloud::Server"))
+ActiveModel::Type.register(:server_backup_price, HCloud::ResourceType.Type("HCloud::ServerBackupPrice"))
 ActiveModel::Type.register(:server_type, HCloud::ResourceType.Type("HCloud::ServerType"))
+ActiveModel::Type.register(:server_type_price, HCloud::ResourceType.Type("HCloud::ServerTypePrice"))
 ActiveModel::Type.register(:ssh_key, HCloud::ResourceType.Type("HCloud::SSHKey"))
+ActiveModel::Type.register(:subnet, HCloud::ResourceType.Type("HCloud::Subnet"))
+ActiveModel::Type.register(:traffic_price, HCloud::ResourceType.Type("HCloud::TrafficPrice"))
+ActiveModel::Type.register(:used_by, HCloud::ResourceType.Type("HCloud::UsedBy"))
 ActiveModel::Type.register(:volume, HCloud::ResourceType.Type("HCloud::Volume"))
+ActiveModel::Type.register(:volume_price, HCloud::ResourceType.Type("HCloud::VolumePrice"))

data/lib/hcloud/resources/certificate.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module HCloud
+  ##
+  # Represents a certificate
+  #
+  # == List all certificates
+  #
+  #     HCloud::Certificate.all
+  #     # => [#<HCloud::Certificate id: 1, ...>, ...]
+  #
+  # == Sort certificates
+  #
+  #     HCloud::Certificate.all.sort(name: :desc)
+  #     # => [#<HCloud::Certificate id: 1, ...>, ...]
+  #
+  #     HCloud::Certificate.all.sort(:id, name: :asc)
+  #     # => [#<HCloud::Certificate id: 1, ...>, ...]
+  #
+  # == Search certificates
+  #
+  #     HCloud::Certificate.all.where(name: "my_certificate")
+  #     # => #<HCloud::Certificate id: 1, ...>
+  #
+  #     HCloud::Certificate.all.where(type: "uploaded")
+  #     # => #<HCloud::Certificate id: 1, ...>
+  #
+  # == Find certificate by ID
+  #
+  #     HCloud::Certificate.find(1)
+  #     # => #<HCloud::Certificate id: 1, ...>
+  #
+  # == Create certificate
+  #
+  #     certificate = HCloud::Certificate.new(name: "my_certificate", type: "managed", domain_names: ["example.com"])
+  #     certificate.create
+  #     certificate.created?
+  #     # => true
+  #
+  #     certificate = HCloud::Certificate.create(name: "my_certificate", type: "managed", domain_names: ["example.com"])
+  #     # => #<HCloud::Certificate id: 1, ...>
+  #
+  # == Update certificate
+  #
+  #     certificate = HCloud::Certificate.find(1)
+  #     certificate.name = "another_certificate"
+  #     certificate.update
+  #
+  # == Delete certificate
+  #
+  #     certificate = HCloud::Certificate.find(1)
+  #     certificate.delete
+  #     certificate.deleted?
+  #     # => true
+  #
+  # = Actions
+  # == List actions
+  #
+  #     actions = HCloud::Certificate.find(1).actions
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  # == Sort actions
+  #
+  #     HCloud::Certificate.find(1).actions.sort(finished: :desc)
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  #     HCloud::Certificate.find(1).actions.sort(:command, finished: :asc)
+  #     # => [#<HCloud::Actions id: 1, ...>, ...]
+  #
+  # == Search actions
+  #
+  #     HCloud::Certificate.find(1).actions.where(command: "set_rules")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  #     HCloud::Certificate.find(1).actions.where(status: "success")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Find action by ID
+  #
+  #     HCloud::Certificate.find(1).actions.find(1)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # = Resource-specific actions
+  # == Retry issuance or renewal
+  #
+  #     certificate = HCloud::Certificate.find(1)
+  #
+  #     certificate.retry
+  #     # => #<HCloud::Action ...>
+  #
+  class Certificate < Resource
+    actionable
+    queryable
+    creatable
+    updatable
+    deletable
+
+    attribute :id, :integer
+    attribute :name
+
+    attribute :type
+
+    attribute :certificate
+    attribute :fingerprint
+
+    # TODO: use only for creation
+    attribute :private_key
+
+    attribute :not_valid_before, :datetime
+    attribute :not_valid_after, :datetime
+
+    attribute :domain_names, array: true, default: -> { [] }
+
+    attribute :status, :certificate_status
+
+    # TODO: dynamically return resource classes
+    attribute :used_by, :used_by, array: true, default: -> { [] }
+
+    attribute :labels, default: -> { {} }
+
+    action :retry
+
+    def creatable_attributes
+      [:name, :labels, :type, :private_key, :certificate, :domain_names]
+    end
+
+    def updatable_attributes
+      [:name, :labels]
+    end
+  end
+end

data/lib/hcloud/resources/firewall.rb

@@ -19,7 +19,7 @@ module HCloud
   #
   # == Search firewalls
   #
-  #     HCloud::Firewall.all.where(name: "my_irewall")
+  #     HCloud::Firewall.all.where(name: "my_firewall")
   #     # => #<HCloud::Firewall id: 1, ...>
   #
   # == Find firewall by ID
@@ -50,6 +50,34 @@ module HCloud
   #     firewall.deleted?
   #     # => true
   #
+  # = Actions
+  # == List actions
+  #
+  #     actions = HCloud::Firewall.find(1).actions
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  # == Sort actions
+  #
+  #     HCloud::Firewall.find(1).actions.sort(finished: :desc)
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  #     HCloud::Firewall.find(1).actions.sort(:command, finished: :asc)
+  #     # => [#<HCloud::Actions id: 1, ...>, ...]
+  #
+  # == Search actions
+  #
+  #     HCloud::Firewall.find(1).actions.where(command: "set_rules")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  #     HCloud::Firewall.find(1).actions.where(status: "success")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Find action by ID
+  #
+  #     HCloud::Firewall.find(1).actions.find(1)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # = Resource-specific actions
   # == Apply a firewall to resources
   #
   #     firewall = HCloud::Firewall.find(1)

data/lib/hcloud/resources/floating_ip.rb

@@ -77,7 +77,7 @@ module HCloud
   #     HCloud::FloatingIP.find(1).actions.find(1)
   #     # => #<HCloud::Action id: 1, ...>
   #
-  # = Floating IP-specific actions
+  # = Resource-specific actions
   # == Assign a floating IP to a server
   #
   #     HCloud::FloatingIP.find(1).assign(server: 1)
@@ -119,8 +119,7 @@ module HCloud
 
     attribute :protection, :protection
 
-    # TODO: return Server object
-    attribute :server, :integer
+    attribute :server, :server
 
     attribute :labels, default: -> { {} }
 

data/lib/hcloud/resources/image.rb

@@ -74,7 +74,7 @@ module HCloud
   #     HCloud::Image.find(1).actions.find(1)
   #     # => #<HCloud::Action id: 1, ...>
   #
-  # = Image-specific actions
+  # = Resource-specific actions
   # == Change protection
   #
   #     HCloud::Image.find(1).change_protection(delete: true)

data/lib/hcloud/resources/network.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+module HCloud
+  ##
+  # Represents a network
+  #
+  # == List all networks
+  #
+  #     HCloud::Network.all
+  #     # => [#<HCloud::Network id: 1, ...>, ...]
+  #
+  # == Search networks
+  #
+  #     HCloud::Network.all.where(name: "my_network")
+  #     # => #<HCloud::Network id: 1, ...>
+  #
+  # == Find network by ID
+  #
+  #     HCloud::Network.find(1)
+  #     # => #<HCloud::Network id: 1, ...>
+  #
+  # == Create network
+  #
+  #     network = HCloud::Network.new(name: "my_network", ip_range: "10.0.0.0/16")
+  #     network.create
+  #     network.created?
+  #     # => true
+  #
+  #     network = HCloud::Network.create(name: "my_network", ip_range: "10.0.0.0/16")
+  #     # => #<HCloud::Network id: 1, ...>
+  #
+  # == Update network
+  #
+  #     network = HCloud::Network.find(1)
+  #     network.name = "another_network"
+  #     network.update
+  #
+  # == Delete network
+  #
+  #     network = HCloud::Network.find(1)
+  #     network.delete
+  #     network.deleted?
+  #     # => true
+  #
+  # = Actions
+  # == List actions
+  #
+  #     actions = HCloud::FloatingIP.find(1).actions
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  # == Sort actions
+  #
+  #     HCloud::FloatingIP.find(1).actions.sort(finished: :desc)
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  #     HCloud::FloatingIP.find(1).actions.sort(:command, finished: :asc)
+  #     # => [#<HCloud::Actions id: 1, ...>, ...]
+  #
+  # == Search actions
+  #
+  #     HCloud::FloatingIP.find(1).actions.where(command: "assign_floating_ip")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  #     HCloud::FloatingIP.find(1).actions.where(status: "success")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Find action by ID
+  #
+  #     HCloud::FloatingIP.find(1).actions.find(1)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # = Resource-specific actions
+  # == Change protection
+  #
+  #     HCloud::Network.find(1).change_protection(delete: true)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Add a route
+  #
+  #     HCloud::Network.find(1).add_route(destination: "10.100.1.0/24", gateway: "10.0.1.1")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Add a subnet
+  #
+  #     HCloud::Network.find(1).add_subnet(ip_range: "10.0.1.0/24", network_zone: "eu-central", type: "cloud")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Change the IP range
+  #
+  #     HCloud::Network.find(1).change_ip_range(ip_range: "10.0.0.0/15")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Delete a route
+  #
+  #     HCloud::Network.find(1).delete_route(destination: "10.100.1.0/24", gateway: "10.0.1.1")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Delete a subnet
+  #
+  #     HCloud::Network.find(1).delete_subnet(ip_range: "10.0.1.0/24", network_zone: "eu-central", type: "cloud")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  class Network < Resource
+    actionable
+    queryable
+    creatable
+    updatable
+    deletable
+
+    attribute :id, :integer
+    attribute :name
+
+    attribute :ip_range
+
+    attribute :routes, :route, array: true, default: -> { [] }
+    attribute :subnets, :subnet, array: true, default: -> { [] }
+
+    attribute :servers, :server, array: true, default: -> { [] }
+
+    # TODO: load balancer resource
+    attribute :load_balancers, array: true, default: -> { [] }
+
+    attribute :protection, :protection
+
+    attribute :labels, default: -> { {} }
+
+    action :change_protection
+
+    action :add_route
+    action :add_subnet
+    action :change_ip_range
+    action :delete_route
+    action :delete_subnet
+
+    def creatable_attributes
+      [:name, :labels, :ip_range, :routes, :subnets]
+    end
+
+    def updatable_attributes
+      [:name, :labels]
+    end
+  end
+end

data/lib/hcloud/resources/pricing.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module HCloud
+  ##
+  # Represents pricing
+  #
+  # == Find pricing
+  #
+  #     HCloud::Pricing.find
+  #     # => #<HCloud::Pricing ...>
+  #
+  class Pricing < Resource
+    singleton
+
+    attribute :currency
+
+    attribute :floating_ip, :floating_ip_price
+    attribute :floating_ips, :floating_ip_prices, array: true, default: -> { [] }
+
+    attribute :image, :image_price
+
+    attribute :load_balancer_types, :load_balancer_type_price, array: true, default: -> { [] }
+
+    attribute :server_backup, :server_backup_price
+
+    attribute :server_types, :server_type_price, array: true, default: -> { [] }
+
+    attribute :traffic, :traffic_price
+
+    attribute :vat_rate
+
+    attribute :volume, :volume_price
+  end
+end

data/lib/hcloud/resources/server.rb

@@ -106,9 +106,8 @@ module HCloud
 
     attribute :image, :image
 
-    # TODO: network resource
-    attribute :public_net
-    attribute :private_net
+    attribute :public_net, :public_net
+    attribute :private_net, :private_net
 
     attribute :placement_group, :placement_group
 

data/lib/hcloud/resources/volume.rb

@@ -80,10 +80,10 @@ module HCloud
   #     HCloud::Volume.find(1).actions.find(1)
   #     # => #<HCloud::Action id: 1, ...>
   #
-  # = Volume-specific actions
+  # = Resource-specific actions
   # == Attach a volume to a server
   #
-  #     HCloud::Volume.find(1).attach(server: 1)
+  #     HCloud::Volume.find(1).attach(server: 1, automount: false)
   #     # => #<HCloud::Action id: 1, ...>
   #
   # == Detach a volume from a server
@@ -93,7 +93,7 @@ module HCloud
   #
   # == Resize volume
   #
-  #     HCloud::Volume.find(1).resize(size: 100)
+  #     HCloud::Volume.find(1).resize(size: 25)
   #     # => #<HCloud::Action id: 1, ...>
   #
   # == Change protection
@@ -122,8 +122,7 @@ module HCloud
     attribute :location, :location
     attribute :protection, :protection
 
-    # TODO: return Server object
-    attribute :server, :integer
+    attribute :server, :server
 
     attribute :labels, default: -> { {} }
 

data/lib/hcloud/version.rb

@@ -3,7 +3,7 @@
 module HCloud
   module Version
     MAJOR = 1
-    MINOR = 1
+    MINOR = 2
     PATCH = 0
     PRE   = nil
 

data/lib/hcloud.rb

@@ -15,7 +15,6 @@ module HCloud
       @root ||= Pathname.new(File.expand_path(File.join("..", ".."), __FILE__))
     end
 
-    # rubocop:disable Metrics/AbcSize
     def setup
       @loader = Zeitwerk::Loader.for_gem
 
@@ -35,7 +34,6 @@ module HCloud
       loader.setup
       loader.eager_load
     end
-    # rubocop:enable Metrics/AbcSize
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hetznercloud
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Florian Dejonckheere
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-30 00:00:00.000000000 Z
+date: 2022-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -94,20 +94,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: factory_bot
-  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: ffaker
   requirement: !ruby/object:Gem::Requirement
@@ -228,31 +214,51 @@ files:
 - lib/hcloud/concerns/creatable.rb
 - lib/hcloud/concerns/deletable.rb
 - lib/hcloud/concerns/queryable.rb
+- lib/hcloud/concerns/singleton.rb
 - lib/hcloud/concerns/updatable.rb
 - lib/hcloud/entities/amount.rb
 - lib/hcloud/entities/applied_to.rb
 - lib/hcloud/entities/applied_to_resource.rb
 - lib/hcloud/entities/apply_to.rb
+- lib/hcloud/entities/certificate_status.rb
 - lib/hcloud/entities/datacenter_server_type.rb
 - lib/hcloud/entities/dns_pointer.rb
 - lib/hcloud/entities/error.rb
+- lib/hcloud/entities/floating_ip_price.rb
+- lib/hcloud/entities/floating_ip_prices.rb
+- lib/hcloud/entities/image_price.rb
+- lib/hcloud/entities/ipv4.rb
+- lib/hcloud/entities/ipv6.rb
+- lib/hcloud/entities/load_balancer_type_price.rb
 - lib/hcloud/entities/metrics.rb
 - lib/hcloud/entities/price.rb
+- lib/hcloud/entities/private_net.rb
 - lib/hcloud/entities/protection.rb
+- lib/hcloud/entities/public_net.rb
+- lib/hcloud/entities/route.rb
 - lib/hcloud/entities/rule.rb
+- lib/hcloud/entities/server_backup_price.rb
+- lib/hcloud/entities/server_type_price.rb
+- lib/hcloud/entities/subnet.rb
+- lib/hcloud/entities/traffic_price.rb
+- lib/hcloud/entities/used_by.rb
+- lib/hcloud/entities/volume_price.rb
 - lib/hcloud/entity.rb
 - lib/hcloud/errors.rb
 - lib/hcloud/http.rb
 - lib/hcloud/resource.rb
 - lib/hcloud/resource_type.rb
 - lib/hcloud/resources/action.rb
+- lib/hcloud/resources/certificate.rb
 - lib/hcloud/resources/datacenter.rb
 - lib/hcloud/resources/firewall.rb
 - lib/hcloud/resources/floating_ip.rb
 - lib/hcloud/resources/image.rb
 - lib/hcloud/resources/iso.rb
 - lib/hcloud/resources/location.rb
+- lib/hcloud/resources/network.rb
 - lib/hcloud/resources/placement_group.rb
+- lib/hcloud/resources/pricing.rb
 - lib/hcloud/resources/server.rb
 - lib/hcloud/resources/server_type.rb
 - lib/hcloud/resources/ssh_key.rb