hetznercloud 5.1.0 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75059c7c37ac0cb1f885b4af4f6c02567f926bb22ce3f77985456219da87546d
-  data.tar.gz: 3b02d023297bc5a4376901591f790b2d2009ba0ec0f8add1c51da405cee1d0ff
+  metadata.gz: c97f9307e8cae23c94b06c853eab8432a5d571fc90b13c527a0fa8a029038143
+  data.tar.gz: da9e9aecda35dbdca6a6b1e1047d4ff957ca63a649f1a3a52b25d31c42302f48
 SHA512:
-  metadata.gz: 33a26943527f4e9136c21699670f01771f92d3bee9fe50c64347b2c33562005f692c9f1c3784c6d34e3b64ca8c5f956793678c698b4b89b2e6dc4bac66c99632
-  data.tar.gz: 7e9768db1f0e803dca01b1d8f698cc6c49a1f6737544cc43c88e64079003a2ff31889dfcb1b7939b2ad7408d08a61761d05c842efae64955cce7265fa97b1956
+  metadata.gz: feb065fa72661720caeefff45ea650374bdb71919a7e901102cfcfe79f386b80b9fde9e1700112052041ec5f4e7cc7e25eec3c6ced0e5dd15f2bbf5eb4872e37
+  data.tar.gz: 61fe9582cdc7681c567c9da110c1028a0c713f3cd3fc1f8a59ff00a0495a1e82e82070e74e3514f738eacc7949513dd68e2c35d761883cbb464015dc63b9d3ba

data/CHANGELOG.md

@@ -10,6 +10,37 @@
 
 ### Fixed
 
+## HCloud v6.1.0 (2026-07-10)
+
+### Added
+
+- Add `enable_ipv4` and `enable_ipv6` attributes to `HCloud::PublicNet`
+- Add `public_net` to `HCloud::Server` creatable attributes
+
+### Fixed
+
+- Fix a bug where name-only SSH keys serialize incorrectly
+
+## HCloud v6.0.0 (2026-06-09)
+
+### Added
+
+- Add `deprecation` attribute to `HCloud::LoadBalancerType`
+- Add `MustBeUnassigned` error class
+- Add `DeprecatedApiEndpoint` error class
+
+### Changed
+
+- Deprecate `HCloud::LoadBalancerType#deprecated`
+- Deprecate `HCloud::Datacenter`
+- Replace `GET /<resource>/{id}/actions/{action_id}` with `GET /actions/{action_id}`
+
+### Removed
+
+- Remove `HCloud::Action.all`, `.first`, `.last`, `.count`, `.where`, `.sort`, `.each`, `.empty?`, `.any?`
+
+### Fixed
+
 ## HCloud v5.1.0 (2026-03-03)
 
 ### Added

data/README.md

@@ -3,7 +3,7 @@
 ![Continuous Integration](https://github.com/floriandejonckheere/hcloud/actions/workflows/ci.yml/badge.svg)
 ![Release](https://img.shields.io/github/v/release/floriandejonckheere/hcloud?label=Latest%20release)
 
-Unofficial Ruby integration with the [Hetzner Cloud API](https://docs.hetzner.cloud/).
+Unofficial Ruby integration with the [Hetzner Cloud API](https://docs.hetzner.cloud/). Refer to the [API specification](https://docs.hetzner.cloud/reference/cloud) for more details.
 
 ## Installation
 
@@ -94,8 +94,8 @@ The following table lists the Hetzner Cloud API endpoints that are currently imp
 | [Pricing](lib/hcloud/resources/pricing.rb)                                       | Implemented           |
 | [RRSets](lib/hcloud/resources/rrset.rb)                                          | Implemented           |
 | [RRSet Actions](lib/hcloud/resources/rrset.rb)                                   | Implemented           |
-| [Servers](lib/hcloud/resources/server.rb)                                        | Partially implemented |
-| [Server Actions](lib/hcloud/resources/server.rb)                                 | Not implemented       |
+| [Servers](lib/hcloud/resources/server.rb)                                        | Implemented           |
+| [Server Actions](lib/hcloud/resources/server.rb)                                 | Implemented           |
 | [Server Types](lib/hcloud/resources/server_type.rb)                              | Implemented           |
 | [SSH Keys](lib/hcloud/resources/ssh_key.rb)                                      | Implemented           |
 | [Storage Boxes](lib/hcloud/resources/storage_box.rb)                             | Implemented           |

data/lib/hcloud/action_collection.rb

@@ -14,7 +14,7 @@ module HCloud
     def find(id)
       Action.new resource
         .client
-        .get("#{resource.resource_path}/#{resource.id}/actions/#{id}")
+        .get("/actions/#{id}")
         .fetch(:action)
     end
 

data/lib/hcloud/concerns/creatable.rb

@@ -42,19 +42,38 @@ module HCloud
         []
       end
 
-      # Convert creatable_attributes into a key-value list
-      # rubocop:disable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
       def creatable_params
         # Split simple and nested attributes
         nested_attributes, simple_attributes = creatable_attributes.partition { |a| a.respond_to? :each }
 
+        serialize_simple_attributes(simple_attributes)
+          .merge(serialize_nested_attributes(nested_attributes))
+          .compact_blank
+      end
+
+      private
+
+      def serialize_simple_attributes(simple_attributes)
         attributes
           .slice(*simple_attributes.map(&:to_s))
           .transform_values { |v| v&.send_wrap { |o| o.try(:to_h) || o } || v&.send_wrap(:to_s) }
-          .merge(nested_attributes.reduce(&:merge).to_h { |k, v| [k.to_s, Array(v).filter_map { |w| send(k)&.send_wrap(w) }.first] })
-          .compact_blank
       end
-      # rubocop:enable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+
+      def serialize_nested_attributes(nested_attributes)
+        return {} if nested_attributes.empty?
+
+        nested_attributes.reduce(&:merge).to_h do |k, v|
+          [k.to_s, serialize_nested_attribute(send(k), v)]
+        end
+      end
+
+      def serialize_nested_attribute(value, fallbacks)
+        if value.is_a?(Array)
+          value.map { |item| Array(fallbacks).filter_map { |w| item&.send_wrap(w) }.first }
+        else
+          Array(fallbacks).filter_map { |w| value&.send_wrap(w) }.first
+        end
+      end
     end
 
     class_methods do

data/lib/hcloud/concerns/deprecated_resource.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module HCloud
+  # @!visibility private
+  module DeprecatedResource
+    extend ActiveSupport::Concern
+
+    included do
+      class_attribute :_deprecated, default: false
+      class_attribute :deprecated_since
+    end
+
+    class_methods do # rubocop:disable Metrics/BlockLength
+      def deprecated(since: nil)
+        self._deprecated = true
+        self.deprecated_since = Date.parse(since) if since
+
+        [:find, :all, :create].each do |method|
+          define_singleton_method(method) do |*args, **kwargs, &block|
+            warn "[DEPRECATION] Resource \"#{name}\" is deprecated since #{deprecated_since.iso8601}." if deprecated?
+
+            super(*args, **kwargs, &block)
+          end
+        end
+      end
+
+      def deprecated?
+        _deprecated
+      end
+
+      # Wrap instance methods as they are defined (e.g. reload added by queryable)
+      def method_added(method_name)
+        super
+
+        return unless _deprecated
+        return unless [:reload, :update, :delete].include? method_name
+
+        return if @_wrapping_deprecated_instance
+
+        @_wrapping_deprecated_instance = true
+
+        original = instance_method(method_name)
+
+        define_method(method_name) do |*args, **kwargs, &block|
+          warn "[DEPRECATION] Resource \"#{self.class.name}\" is deprecated since #{self.class.deprecated_since.iso8601}." if self.class.deprecated?
+
+          original.bind_call(self, *args, **kwargs, &block)
+        end
+
+        @_wrapping_deprecated_instance = false
+      end
+    end
+  end
+end

data/lib/hcloud/entities/public_net.rb

@@ -6,5 +6,17 @@ module HCloud
     attribute :floating_ips, :floating_ip, array: true, default: -> { [] }
     attribute :ipv4, :ipv4
     attribute :ipv6, :ipv6
+
+    attribute :enable_ipv4, :boolean
+    attribute :enable_ipv6, :boolean
+
+    def to_h
+      {
+        enable_ipv4: enable_ipv4,
+        enable_ipv6: enable_ipv6,
+        ipv4: ipv4&.id,
+        ipv6: ipv6&.id,
+      }.compact
+    end
   end
 end

data/lib/hcloud/errors.rb

@@ -25,6 +25,7 @@ module HCloud
     class ActionFailed < Error; end
     class CloudResourceIPNotAllowed < Error; end
     class Conflict < Error; end
+    class DeprecatedApiEndpoint < Error; end
     class FirewallAlreadyApplied < Error; end
     class FirewallAlreadyRemoved < Error; end
     class FirewallResourceNotFound < Error; end
@@ -40,6 +41,7 @@ module HCloud
     class LoadBalancerPublicInterfaceDisabled < Error; end
     class Locked < Error; end
     class Maintenance < Error; end
+    class MustBeUnassigned < Error; end
     class NetworksOverlap < Error; end
     class NoSpaceLeftInLocation < Error; end
     class NoSubnetAvailable < Error; end

data/lib/hcloud/resource.rb

@@ -7,6 +7,7 @@ module HCloud
 
     include Concerns
     include DeprecatedAttributes
+    include DeprecatedResource
     include DynamicAttributes
     include InspectAttributes
     include Subresource

data/lib/hcloud/resources/action.rb

@@ -4,27 +4,6 @@ module HCloud
   ##
   # Represents an action
   #
-  # == List all actions
-  #
-  #     HCloud::Action.all
-  #     # => [#<HCloud::Action id: 1, ...>, ...]
-  #
-  # == Sort actions
-  #
-  #     HCloud::Action.sort(command: :desc)
-  #     # => [#<HCloud::Action id: 1, ...>, ...]
-  #
-  #     HCloud::Action.sort(:id, command: :asc)
-  #     # => [#<HCloud::Action id: 1, ...>, ...]
-  #
-  # == Search actions
-  #
-  #     HCloud::Action.where(command: "my_action")
-  #     # => #<HCloud::Action id: 1, ...>
-  #
-  #     HCloud::Action.where(status: "success")
-  #     # => #<HCloud::Action id: 1, ...>
-  #
   # == Find action by ID
   #
   #     HCloud::Action.find(1)
@@ -46,11 +25,7 @@ module HCloud
     attribute :resources, :resource, array: true, default: -> { [] }
 
     class << self
-      def all
-        warn "[DEPRECATION] Starting on 1 October 2023, this endpoint will no longer be available. After that, it won't be possible anymore to list all actions across all resources. As an alternative, you can use the action endpoints of a specific resource to list all actions (e.g. of all servers or of all Load Balancers)."
-
-        super
-      end
+      undef_method :all, :first, :last, :count, :where, :sort, :each, :empty?, :any?
     end
   end
 end

data/lib/hcloud/resources/datacenter.rb

@@ -33,6 +33,8 @@ module HCloud
   #     # => #<HCloud::Datacenter id: 2, ...>
   #
   class Datacenter < Resource
+    deprecated since: "2026-10-01"
+
     queryable
 
     attribute :id, :integer

data/lib/hcloud/resources/load_balancer.rb

@@ -184,7 +184,7 @@ module HCloud
     # TODO: use only for creation
     attribute :public_interface, :boolean
 
-    attribute :private_net, :load_balancer_private_net
+    attribute :private_net, :load_balancer_private_net, array: true, default: -> { [] }
     attribute :public_net, :load_balancer_public_net
 
     attribute :services, :service, array: true, default: -> { [] }

data/lib/hcloud/resources/load_balancer_type.rb

@@ -33,6 +33,8 @@ module HCloud
 
     attribute :prices, :price, array: true, default: -> { [] }
 
-    attribute :deprecated, :datetime
+    attribute :deprecation, :deprecation
+
+    attribute :deprecated, :datetime, deprecated: true
   end
 end

data/lib/hcloud/resources/server.rb

@@ -44,6 +44,9 @@ module HCloud
   #     firewall = HCloud::Server.create(name: "my_server", image: "debian-11", server_type: "cx11")
   #     # => #<HCloud::Server id: 1, ...>
   #
+  #     # Create a server with a private IP only
+  #     server = HCloud::Server.create(name: "my_server", image: "debian-11", server_type: "cx11", public_net: { enable_ipv4: false, enable_ipv6: false }, networks: [network_id])
+  #
   # == Update server
   #
   #     server = HCloud::Server.find(1)
@@ -168,7 +171,7 @@ module HCloud
     action :request_console
 
     def creatable_attributes
-      [:name, :automount, :start_after_create, :user_data, :labels, datacenter: [:id, :name], image: [:id, :name], location: [:id, :name], server_type: [:id, :name], ssh_keys: [:id, :name], firewalls: :id, networks: :id, volumes: :id]
+      [:name, :automount, :start_after_create, :user_data, :labels, :public_net, datacenter: [:id, :name], image: [:id, :name], location: [:id, :name], server_type: [:id, :name], ssh_keys: [:id, :name], firewalls: :id, networks: :id, volumes: :id]
     end
 
     def updatable_attributes

data/lib/hcloud/version.rb

@@ -3,7 +3,7 @@
 module HCloud
   # @!visibility private
   module Version
-    MAJOR = 5
+    MAJOR = 6
     MINOR = 1
     PATCH = 0
     PRE   = nil

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hetznercloud
 version: !ruby/object:Gem::Version
-  version: 5.1.0
+  version: 6.1.0
 platform: ruby
 authors:
 - Florian Dejonckheere
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 2026-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -102,6 +102,7 @@ files:
 - lib/hcloud/concerns/creatable.rb
 - lib/hcloud/concerns/deletable.rb
 - lib/hcloud/concerns/deprecated_attributes.rb
+- lib/hcloud/concerns/deprecated_resource.rb
 - lib/hcloud/concerns/dynamic_attributes.rb
 - lib/hcloud/concerns/inspect_attributes.rb
 - lib/hcloud/concerns/labelable.rb