hetznercloud 4.2.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 497195f54e986218ca478ec89a00fed2eeaf967e4f7cc1051b025de52290783b
-  data.tar.gz: 6d0a810bfba0851a4f0957602080868259376b26f69130b743a419db644805c8
+  metadata.gz: 9175bc0a11981b096914d3a80869743db98d5691916f277c8eedb09f9c69b1e3
+  data.tar.gz: 7f1c35152b43e268bb3c39bbd57abb57f6010ad2ab5fd460c545064a5c11b593
 SHA512:
-  metadata.gz: 52d6b19d64d69acd995e18f73a6fade7a85008512a13f66cd1f6ae6efc333556038f3e1768ce9ca4c86b9a742fe51ed22f9924a9475fc23256a3b487cc9b1949
-  data.tar.gz: 6c32560938c2ec270218386ed537a82745d71f040088cd72bbfe6a6bd37c0caa8265f038ac73ec430cca7818c37d18f6286e5482e3521a284d734806708ec1fc
+  metadata.gz: 3bd92e7f000bdbbaad9065e3e8204d5bcb1d5a49b7d4b96fb56f9162101cd082bd810e4d0acbd51fbb42d3dee4e97b3c66a59f14c995badae3bac5c3354a49e9
+  data.tar.gz: '02896e1f2f35c3e3e5bb4179de52d3e711d6be7721b1b3726c269b1651a3bf3a41a79f0a327298eabdf65337647a62d06f63ae86d4c57b1ee5f10c1c89e0f464'

data/CHANGELOG.md

@@ -10,6 +10,39 @@
 
 ### Fixed
 
+## HCloud v5.0.0 (2026-01-15)
+
+### Added
+
+- Add `name` attribute to `HCloud::StorageBoxSubaccount`
+
+### Changed
+
+- Rework RRSet resource handler
+
+### Removed
+
+- Remove support for Ruby 3.0 and 3.1
+
+## HCloud v4.4.0 (2025-11-25)
+
+### Added
+
+- Add `update_records` action to `HCloud::RRSet`
+
+## HCloud v4.3.0 (2025-11-17)
+
+### Added
+
+- Implement Zones
+- Implement Zone actions
+- Implement RRSets
+- Implement RRSet actions
+
+### Removed
+
+- Removed global `ActiveSupport::Inflector` inflections 
+
 ## HCloud v4.2.0 (2025-09-24)
 
 ### Added

data/Gemfile

@@ -14,6 +14,7 @@ group :development, :test do
   gem "debug", require: false
   gem "dotenv", require: false
   gem "ffaker", require: false
+  gem "iconv", require: false
   gem "rake", require: false
   gem "rspec", require: false
   gem "rubocop", require: false

data/README.md

@@ -92,6 +92,8 @@ The following table lists the Hetzner Cloud API endpoints that are currently imp
 | [Network Actions](lib/hcloud/resources/network.rb)                               | Implemented           |
 | [Placement Groups](lib/hcloud/resources/placement_group.rb)                      | Implemented           |
 | [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       |
 | [Server Types](lib/hcloud/resources/server_type.rb)                              | Implemented           |
@@ -105,6 +107,8 @@ The following table lists the Hetzner Cloud API endpoints that are currently imp
 | [Volumes](lib/hcloud/resources/volume.rb)                                        | Implemented           |
 | [Volume Actions](lib/hcloud/resources/volume.rb)                                 | Implemented           |
 | [Metadata](lib/hcloud/resources/metadata.rb)                                     | Implemented           |
+| [Zones](lib/hcloud/resources/zone.rb)                                            | Implemented           |
+| [Zone Actions](lib/hcloud/resources/zone.rb)                                     | Implemented           |
 
 ### Pagination
 

data/config/inflections.rb

@@ -17,19 +17,9 @@ HCloud.loader.inflector.inflect(
   "iso_type" => "ISOType",
   "primary_ip" => "PrimaryIP",
   "primary_ip_prices" => "PrimaryIPPrices",
+  "rrset" => "RRSet",
   "service_http" => "ServiceHTTP",
   "ssh_key" => "SSHKey",
   "target_ip" => "TargetIP",
   "yaml" => "YAML",
 )
-
-ActiveSupport::Inflector.inflections(:en) do |inflect|
-  inflect.acronym "DNS"
-  inflect.acronym "HTTP"
-  inflect.acronym "IP"
-  inflect.acronym "IPv4"
-  inflect.acronym "IPv6"
-  inflect.acronym "ISO"
-  inflect.acronym "JSON"
-  inflect.acronym "YAML"
-end

data/lib/hcloud/concerns/creatable.rb

@@ -8,28 +8,30 @@ module HCloud
     included do # rubocop:disable Metrics/BlockLength
       attribute :created, :datetime
 
-      def create
+      def create # rubocop:disable Metrics/AbcSize
         response = client
           .post(resource_path, creatable_params)
 
-        # Some resources return an action instead of the resource itself (e.g. Storage Box API)
+        resource_key = resource_name.to_sym
+
+        if response.key?(resource_key)
+          # Set the attributes from the response
+          assign_attributes(response[resource_key].merge(response.slice(:root_password)))
+        end
+
+        # Some resources return an action instead of the resource itself
         if response.key?(:action)
           # Set the ID from the action response
-          self.id = response
+          self.id ||= response
             .dig(:action, :resources)
             .find { |r| r[:type] == [resource_class&.resource_name, resource_name].compact.join("_") }
             .fetch(:id)
 
           # Return an Action instance
-          Action.new response[:action]
-        else
-          # Set the attributes from the response
-          assign_attributes response[resource_name.to_sym]
-            .merge!(response.slice(:root_password))
-
-          # Return the resource instance
-          self
+          return Action.new(response[:action])
         end
+
+        self
       end
 
       def created?

data/lib/hcloud/concerns/subresource.rb

@@ -5,6 +5,12 @@ module HCloud
   module Subresource
     extend ActiveSupport::Concern
 
+    delegate :resource_path, to: :class
+
+    def instance_path
+      resource_path(id: id)
+    end
+
     included do
       # For super resources
       class_attribute :subresource_names
@@ -15,7 +21,7 @@ module HCloud
       class_attribute :resource_class
     end
 
-    class_methods do
+    class_methods do # rubocop:disable Metrics/BlockLength
       def inherited(subclass)
         super
 
@@ -35,27 +41,30 @@ module HCloud
 
       # For subresources
       def subresource_of(name, type = name)
+        raise ArgumentError, "Resource already a subresource of #{resource_class}" if resource_class.present?
+
         self.resource_class = ActiveModel::Type
           .lookup(type)
           .resource_class
 
-        attribute name, :integer
+        attribute name, :integer # TODO: override that returns the resource class instance instead of the ID?
 
-        # TODO: override that returns the resource class instance instead of the ID?
-      end
+        # Nested resources (e.g. /storage_boxes/123/subaccounts)
+        define_method(:resource_path) do |id: nil|
+          super_instance = public_send(resource_class.resource_name)
+
+          return super() if super_instance.blank?
 
-      def resource_path
-        "/#{resource_name.pluralize}"
+          if super_instance.respond_to?(:instance_path)
+            [super_instance.instance_path, super(id: id)].join
+          else
+            [resource_class.resource_path(id: super_instance), super(id: id)].join
+          end
+        end
       end
-    end
 
-    def resource_path
-      if resource_class && (id = send(resource_class.resource_name)).present?
-        # Nested resources (e.g. /storage_boxes/123/subaccounts)
-        "/#{resource_class.resource_name.pluralize}/#{id}/#{resource_name.pluralize}"
-      else
-        # Top-level resources (e.g. /servers)
-        "/#{resource_name.pluralize}"
+      def resource_path(id: nil)
+        ["", resource_name.pluralize, id].compact.join("/")
       end
     end
   end

data/lib/hcloud/entities/authoritative_nameservers.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module HCloud
+  class AuthoritativeNameservers < Entity
+    attribute :assigned, array: true, default: -> { [] }
+    attribute :delegated, array: true, default: -> { [] }
+    attribute :delegation_last_check, :datetime
+    attribute :delegation_status
+  end
+end

data/lib/hcloud/entities/change_protection.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module HCloud
+  class ChangeProtection < Entity
+    attribute :change, :boolean
+
+    alias change? change
+  end
+end

data/lib/hcloud/entities/nameserver.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Nameserver < Entity
+    attribute :address
+    attribute :port, :integer
+
+    attribute :tsig_key
+    attribute :tsig_algorithm
+  end
+end

data/lib/hcloud/entities/record.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Record < Entity
+    attribute :value
+    attribute :comment
+  end
+end

data/lib/hcloud/errors.rb

@@ -29,6 +29,7 @@ module HCloud
     class FirewallAlreadyRemoved < Error; end
     class FirewallResourceNotFound < Error; end
     class Forbidden < Error; end
+    class IncorrectZoneMode < Error; end
     class IPNotAvailable < Error; end
     class IPNotOwned < Error; end
     class IncompatibleNetworkType < Error; end

data/lib/hcloud/http.rb

@@ -107,16 +107,16 @@ module HCloud
     def transform_params(params)
       params
         .transform_values do |value|
-        # Don't transform if value is single argument: { sort: :id }
-        next value unless value.respond_to?(:each)
+          # Don't transform if value is single argument: { sort: :id }
+          next value unless value.respond_to?(:each)
 
-        value.map do |element|
-          # Don't transform if element is single argument: { sort: [:id] }
-          next element unless element.respond_to?(:each)
+          value.map do |element|
+            # Don't transform if element is single argument: { sort: [:id] }
+            next element unless element.respond_to?(:each)
 
-          # Join elements with : { sort: [id: :asc] }
-          element.to_a.join(":")
-        end
+            # Join elements with : { sort: [id: :asc] }
+            element.to_a.join(":")
+          end
       end
         .compact
     end

data/lib/hcloud/inflector.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module HCloud
+  class Inflector < Zeitwerk::Inflector
+    def underscore(classname)
+      classname
+        .to_s
+        .split("::")
+        .map { |word| overrides.key(word) || word.underscore }
+        .join("/")
+    end
+  end
+end

data/lib/hcloud/resource.rb

@@ -15,6 +15,10 @@ module HCloud
       assign_attributes(attributes) if attributes
     end
 
+    def mutable?
+      true
+    end
+
     delegate :[], to: :attributes
 
     def inspect
@@ -31,8 +35,8 @@ module HCloud
       id && id == other.id
     end
 
-    def self.attribute(name, *args, deprecated: false, **kwargs)
-      super(name, *args, **kwargs)
+    def self.attribute(name, *, deprecated: false, **)
+      super(name, *, **)
 
       define_method(name) do |**params|
         warn "[DEPRECATION] Field \"#{name}\" on #{self.class.name} is deprecated." if deprecated

data/lib/hcloud/resource_type.rb

@@ -12,6 +12,10 @@ module HCloud
       @array = array
     end
 
+    def mutable?
+      true
+    end
+
     def cast(value)
       case value
       when nil, []
@@ -88,8 +92,10 @@ 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(:authoritative_nameservers, HCloud::ResourceType.Type("HCloud::AuthoritativeNameservers"))
 ActiveModel::Type.register(:certificate, HCloud::ResourceType.Type("HCloud::Certificate"))
 ActiveModel::Type.register(:certificate_status, HCloud::ResourceType.Type("HCloud::CertificateStatus"))
+ActiveModel::Type.register(:change_protection, HCloud::ResourceType.Type("HCloud::ChangeProtection"))
 ActiveModel::Type.register(:datacenter, HCloud::ResourceType.Type("HCloud::Datacenter"))
 ActiveModel::Type.register(:datacenter_server_type, HCloud::ResourceType.Type("HCloud::DatacenterServerType"))
 ActiveModel::Type.register(:deprecation, HCloud::ResourceType.Type("HCloud::Deprecation"))
@@ -115,6 +121,7 @@ ActiveModel::Type.register(:load_balancer_type, HCloud::ResourceType.Type("HClou
 ActiveModel::Type.register(:load_balancer_type_price, HCloud::ResourceType.Type("HCloud::LoadBalancerTypePrice"))
 ActiveModel::Type.register(:location, HCloud::ResourceType.Type("HCloud::Location"))
 ActiveModel::Type.register(:metadata, HCloud::ResourceType.Type("HCloud::Metadata"))
+ActiveModel::Type.register(:nameserver, HCloud::ResourceType.Type("HCloud::Nameserver"))
 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"))
@@ -126,8 +133,10 @@ ActiveModel::Type.register(:private_network, HCloud::ResourceType.Type("HCloud::
 ActiveModel::Type.register(:protection, HCloud::ResourceType.Type("HCloud::Protection"))
 ActiveModel::Type.register(:public_net, HCloud::ResourceType.Type("HCloud::PublicNet"))
 ActiveModel::Type.register(:public_net_firewall, HCloud::ResourceType.Type("HCloud::PublicNetFirewall"))
+ActiveModel::Type.register(:record, HCloud::ResourceType.Type("HCloud::Record"))
 ActiveModel::Type.register(:resource, HCloud::ResourceType::GenericType)
 ActiveModel::Type.register(:route, HCloud::ResourceType.Type("HCloud::Route"))
+ActiveModel::Type.register(:rrset, HCloud::ResourceType.Type("HCloud::RRSet"))
 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"))
@@ -156,3 +165,4 @@ ActiveModel::Type.register(:traffic_price, HCloud::ResourceType.Type("HCloud::Tr
 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"))
+ActiveModel::Type.register(:zone, HCloud::ResourceType.Type("HCloud::Zone"))

data/lib/hcloud/resources/network.rb

@@ -48,28 +48,28 @@ module HCloud
   # = Actions
   # == List actions
   #
-  #     actions = HCloud::FloatingIP.find(1).actions
+  #     actions = HCloud::Network.find(1).actions
   #     # => [#<HCloud::Action id: 1, ...>, ...]
   #
   # == Sort actions
   #
-  #     HCloud::FloatingIP.find(1).actions.sort(finished: :desc)
+  #     HCloud::Network.find(1).actions.sort(finished: :desc)
   #     # => [#<HCloud::Action id: 1, ...>, ...]
   #
-  #     HCloud::FloatingIP.find(1).actions.sort(:command, finished: :asc)
+  #     HCloud::Network.find(1).actions.sort(:command, finished: :asc)
   #     # => [#<HCloud::Actions id: 1, ...>, ...]
   #
   # == Search actions
   #
-  #     HCloud::FloatingIP.find(1).actions.where(command: "assign_floating_ip")
+  #     HCloud::Network.find(1).actions.where(command: "assign_floating_ip")
   #     # => #<HCloud::Action id: 1, ...>
   #
-  #     HCloud::FloatingIP.find(1).actions.where(status: "success")
+  #     HCloud::Network.find(1).actions.where(status: "success")
   #     # => #<HCloud::Action id: 1, ...>
   #
   # == Find action by ID
   #
-  #     HCloud::FloatingIP.find(1).actions.find(1)
+  #     HCloud::Network.find(1).actions.find(1)
   #     # => #<HCloud::Action id: 1, ...>
   #
   # = Resource-specific actions

data/lib/hcloud/resources/rrset.rb

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+module HCloud
+  ##
+  # Represents a DNS zone's RRSet
+  #
+  # == List all RRSets
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets
+  #     # => [#<HCloud::RRSet id: 1, ...>, ...]
+  #
+  # == Sort RRSets
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.sort(name: :desc)
+  #     # => [#<HCloud::RRSet id: 1, ...>, ...]
+  #
+  #     zone.rrsets.sort(:id, name: :asc)
+  #     # => [#<HCloud::RRSet id: 1, ...>, ...]
+  #
+  # == Search RRSets
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.where(name: "my_zone")
+  #     # => #<HCloud::RRSet id: 1, ...>
+  #
+  #     zone.rrsets.where(type: "AAAA")
+  #     # => #<HCloud::RRSet id: 1, ...>
+  #
+  #     zone.rrsets.where(label_selector: "environment=production")
+  #     # => #<HCloud::RRSet id: 1, ...>
+  #
+  # == Find RRSet by ID
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1)
+  #     # => #<HCloud::RRSet id: 1, ...>
+  #
+  # == Create RRSet
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     rrset = zone.rrsets.new(name: "my_rrset", type: "A", ttl: 10800, records: [{ value: "198.51.100.1", comment: "My web server at Hetzner Cloud" }])
+  #     rrset.create
+  #     rrset.created?
+  #     # => true
+  #
+  # == Update RRSet
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     rrset = zone.rrsets.find(1)
+  #     rrset.name = "another_rrset"
+  #     rrset.update
+  #
+  # == Delete RRSet
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     rrset = zone.rrsets.find(1)
+  #     rrset.delete
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  #     rrset.deleted?
+  #     # => true
+  #
+  # = Actions
+  # == List actions
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     actions = zone.rrsets.find(1).actions
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  # == Sort actions
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).actions.sort(finished: :desc)
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).actions.sort(:command, finished: :asc)
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  # == Search actions
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).actions.where(command: "change_protection")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).actions.where(status: "success")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Find action by ID
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).actions.find(1)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # = Resource-specific actions
+  # == Change protection
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).change_protection(change: true)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Change TTL
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).change_ttl(ttl: 10800)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Set records
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).set_records(records: [{ value: "198.51.100.1", comment: "My web server at Hetzner Cloud" }])
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Add records
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).add_records(ttl: 10800, records: [{ value: "198.51.100.1", comment: "My web server at Hetzner Cloud" }])
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Update records
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).update_records(records: [{ value: "198.51.100.1", comment: "My web server at Hetzner Cloud" }])
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Remove records
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.rrsets.find(1).remove_records(records: [{ value: "198.51.100.1", comment: "My web server at Hetzner Cloud" }])
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  class RRSet < Resource
+    subresource_of :zone
+
+    actionable
+    queryable
+    creatable
+    updatable
+    deletable
+    labelable
+
+    attribute :id
+    attribute :name
+
+    attribute :type
+
+    attribute :ttl, :integer
+
+    attribute :protection, :change_protection
+
+    attribute :records, :record, array: true, default: -> { [] }
+
+    attribute :zone, :zone
+
+    action :change_protection
+    action :change_ttl
+    action :set_records
+    action :add_records
+    action :update_records
+    action :remove_records
+
+    def creatable_attributes
+      [:name, :type, :ttl, :records, :labels]
+    end
+
+    def updatable_attributes
+      [:labels]
+    end
+
+    def self.resource_name
+      "rrset"
+    end
+  end
+end

data/lib/hcloud/resources/storage_box_snapshot.rb

@@ -8,23 +8,23 @@ module HCloud
   #
   #     storage_box = HCloud::StorageBox.find(1)
   #     storage_box.snapshots
-  #     # => [#<HCloud::StorageBox::Snapshot id: 1, ...>, ...]
+  #     # => [#<HCloud::StorageBoxSnapshot id: 1, ...>, ...]
   #
   # == Search snapshots
   #
   #     storage_box = HCloud::StorageBox.find(1)
   #     storage_box.snapshots.where(name: "monthly_backup")
-  #     # => #<HCloud::StorageBox::Snapshot id: 1, ...>
+  #     # => #<HCloud::StorageBoxSnapshot id: 1, ...>
   #
   #     storage_box = HCloud::StorageBox.find(1)
   #     storage_box.snapshots.where(label_selector: "environment=production")
-  #     # => #<HCloud::StorageBox::Snapshot id: 1, ...>
+  #     # => #<HCloud::StorageBoxSnapshot id: 1, ...>
   #
   # == Find snapshot by ID
   #
   #     storage_box = HCloud::StorageBox.find(1)
   #     storage_box.snapshots.find(1)
-  #     # => #<HCloud::StorageBox::Snapshot id: 1, ...>
+  #     # => #<HCloud::StorageBoxSnapshot id: 1, ...>
   #
   # == Create snapshot
   #
@@ -46,7 +46,7 @@ module HCloud
   #
   #     Note: this method returns a {HCloud::Action} instance rather than the created resource itself
   #
-  #     snapshot = HCloud::StorageBox::Snapshot.create(storage_box: 1, description: "my_snapshot")
+  #     snapshot = HCloud::StorageBoxSnapshot.create(storage_box: 1, description: "my_snapshot")
   #     # => #<HCloud::Action id: 1, ...>
   #
   #     Note: this method returns a {HCloud::Action} instance rather than the created resource itself

data/lib/hcloud/resources/storage_box_subaccount.rb

@@ -8,19 +8,19 @@ module HCloud
   #
   #     storage_box = HCloud::StorageBox.find(1)
   #     storage_box.subaccounts
-  #     # => [#<HCloud::StorageBox::Subaccount id: 1, ...>, ...]
+  #     # => [#<HCloud::StorageBoxSubaccount id: 1, ...>, ...]
   #
   # == Search subaccounts
   #
   #     storage_box = HCloud::StorageBox.find(1)
   #     storage_box.subaccounts.where(label_selector: "environment=production")
-  #     # => #<HCloud::StorageBox::Subaccount id: 1, ...>
+  #     # => #<HCloud::StorageBoxSubaccount id: 1, ...>
   #
   # == Find subaccount by ID
   #
   #     storage_box = HCloud::StorageBox.find(1)
   #     storage_box.subaccounts.find(1)
-  #     # => #<HCloud::StorageBox::Subaccount id: 1, ...>
+  #     # => #<HCloud::StorageBoxSubaccount id: 1, ...>
   #
   # == Create subaccount
   #
@@ -42,7 +42,7 @@ module HCloud
   #
   #     Note: this method returns a {HCloud::Action} instance rather than the created resource itself
   #
-  #     subaccount = HCloud::StorageBox::Subaccount.create(storage_box: 1, password: "my_password", description: "my_subaccount", home_directory: "backup/", access_settings: { samba_enabled: false, ssh_enabled: true, webdav_enabled: false, readonly: false, reachable_externally: false })
+  #     subaccount = HCloud::StorageBoxSubaccount.create(storage_box: 1, password: "my_password", description: "my_subaccount", home_directory: "backup/", access_settings: { samba_enabled: false, ssh_enabled: true, webdav_enabled: false, readonly: false, reachable_externally: false })
   #     # => #<HCloud::Action id: 1, ...>
   #
   #     Note: this method returns a {HCloud::Action} instance rather than the created resource itself
@@ -111,11 +111,11 @@ module HCloud
     action :update_access_settings
 
     def creatable_attributes
-      [:password, :home_directory, :description, :labels, :access_settings]
+      [:password, :home_directory, :name, :description, :labels, :access_settings]
     end
 
     def updatable_attributes
-      [:description, :labels]
+      [:name, :description, :labels]
     end
 
     def self.resource_name

data/lib/hcloud/resources/zone.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+module HCloud
+  ##
+  # Represents a DNS zone
+  #
+  # == List all zones
+  #
+  #     HCloud::Zone.all
+  #     # => [#<HCloud::Zone id: 1, ...>, ...]
+  #
+  # == Sort zones
+  #
+  #     HCloud::Zone.sort(name: :desc)
+  #     # => [#<HCloud::Zone id: 1, ...>, ...]
+  #
+  #     HCloud::Zone.sort(:id, name: :asc)
+  #     # => [#<HCloud::Zone id: 1, ...>, ...]
+  #
+  # == Search zones
+  #
+  #     HCloud::Zone.where(name: "my_zone")
+  #     # => #<HCloud::Zone id: 1, ...>
+  #
+  #     HCloud::Zone.where(mode: "primary")
+  #     # => #<HCloud::Zone id: 1, ...>
+  #
+  #     HCloud::Zone.where(label_selector: "environment=production")
+  #     # => #<HCloud::Zone id: 1, ...>
+  #
+  # == Find zone by ID
+  #
+  #     HCloud::Zone.find(1)
+  #     # => #<HCloud::Zone id: 1, ...>
+  #
+  # == Create zone
+  #
+  #     zone = HCloud::Zone.new(name: "my_zone", mode: "primary", ttl: 10800, rrsets: [{ name: "www", type: "A", records: [{ value: "198.51.100.1", comment: "My web server at Hetzner Cloud" }] }])
+  #     zone.create
+  #     zone.created?
+  #     # => true
+  #
+  #     zone = HCloud::Zone.create(name: "my_zone", mode: "primary", ttl: 10800)
+  #     # => #<HCloud::Zone id: 1, ...>
+  #
+  # == Update zone
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.labels = { environment: "production" }
+  #     zone.update
+  #
+  # == Delete zone
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.delete
+  #     zone.deleted?
+  #     # => true
+  #
+  # == Export zone file
+  #
+  #     zone = HCloud::Zone.find(1)
+  #     zone.export
+  #     # => "$ORIGIN\texample.com.\n$TTL\t3600\n\n@\tIN\tSOA\thydrogen.ns.hetzner.com. dns.hetzner.com. ..."
+  #
+  # = Actions
+  # == List actions
+  #
+  #     actions = HCloud::Zone.find(1).actions
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  # == Sort actions
+  #
+  #     HCloud::Zone.find(1).actions.sort(finished: :desc)
+  #     # => [#<HCloud::Action id: 1, ...>, ...]
+  #
+  #     HCloud::Zone.find(1).actions.sort(:command, finished: :asc)
+  #     # => [#<HCloud::Actions id: 1, ...>, ...]
+  #
+  # == Search actions
+  #
+  #     HCloud::Zone.find(1).actions.where(command: "import_zonefile")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  #     HCloud::Zone.find(1).actions.where(status: "success")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Find action by ID
+  #
+  #     HCloud::Zone.find(1).actions.find(1)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # = Resource-specific actions
+  # == Change a zone's primary nameservers
+  #
+  #     HCloud::Zone.find(1).change_primary_nameservers(primary_nameservers: [{ address: "198.51.100.1", port: 53 }, { address: "203.0.113.1", port: 53 }])
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Change protection
+  #
+  #     HCloud::Zone.find(1).change_protection(delete: true)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Change default TTL
+  #
+  #     HCloud::Zone.find(1).change_ttl(ttl: 10800)
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  # == Import zone file
+  #
+  #     HCloud::Zone.find(1).import_zonefile(zonefile: "$ORIGIN\texample.com.\n$TTL\t3600\n\n@\tIN\tSOA\thydrogen.ns.hetzner.com. dns.hetzner.com. ...")
+  #     # => #<HCloud::Action id: 1, ...>
+  #
+  class Zone < Resource
+    actionable
+    queryable
+    creatable
+    updatable
+    deletable
+    labelable
+
+    subresource :rrset, :rrset
+
+    attribute :id, :integer
+    attribute :name
+
+    attribute :mode
+
+    attribute :primary_nameservers, :nameserver, array: true, default: -> { [] }
+    attribute :authoritative_nameservers, :authoritative_nameservers
+
+    attribute :record_count, :integer
+    attribute :ttl, :integer
+    attribute :status
+    attribute :registrar
+
+    attribute :protection, :protection
+
+    action :change_primary_nameservers
+    action :change_protection
+    action :change_ttl
+    action :import_zonefile
+
+    def export
+      raise Errors::MissingIDError unless id
+
+      client
+        .get("#{resource_path}/#{id}/zonefile")
+        .fetch(:zonefile)
+    end
+
+    def creatable_attributes
+      [:name, :mode, :ttl, :labels, :primary_nameservers, :rrsets]
+    end
+
+    def updatable_attributes
+      [:labels]
+    end
+  end
+end

data/lib/hcloud/version.rb

@@ -3,8 +3,8 @@
 module HCloud
   # @!visibility private
   module Version
-    MAJOR = 4
-    MINOR = 2
+    MAJOR = 5
+    MINOR = 0
     PATCH = 0
     PRE   = nil
 

data/lib/hcloud.rb

@@ -4,6 +4,8 @@ require "active_model"
 require "active_support/all"
 require "zeitwerk"
 
+require_relative "hcloud/inflector"
+
 module HCloud
   class << self
     # Code loader instance
@@ -16,6 +18,9 @@ module HCloud
     def setup
       @loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
 
+      # Set up inflector
+      loader.inflector = Inflector.new
+
       # Register inflections
       require root.join("config/inflections.rb")
 

data/lib/http/features/request/compressed_body.rb

@@ -30,7 +30,7 @@ module HTTP
           self
         end
 
-        def compress(&_block)
+        def compress(&)
           raise NotImplementedError
         end
 

data/lib/http/features/response/brotli_inflater.rb

@@ -17,10 +17,10 @@ module HTTP
     module Response
       # @!visibility private
       class BrotliInflater < HTTP::Response::Inflater
-        def readpartial(*args)
+        def readpartial(*)
           chunks = []
 
-          while (chunk = @connection.readpartial(*args))
+          while (chunk = @connection.readpartial(*))
             chunks << chunk
           end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hetznercloud
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 5.0.0
 platform: ruby
 authors:
 - Florian Dejonckheere
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-24 00:00:00.000000000 Z
+date: 2026-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -52,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: openssl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -99,7 +113,9 @@ files:
 - lib/hcloud/entities/applied_to.rb
 - lib/hcloud/entities/applied_to_resource.rb
 - lib/hcloud/entities/apply_to.rb
+- lib/hcloud/entities/authoritative_nameservers.rb
 - lib/hcloud/entities/certificate_status.rb
+- lib/hcloud/entities/change_protection.rb
 - lib/hcloud/entities/datacenter_server_type.rb
 - lib/hcloud/entities/deprecation.rb
 - lib/hcloud/entities/dns_pointer.rb
@@ -117,6 +133,7 @@ files:
 - lib/hcloud/entities/load_balancer_public_net.rb
 - lib/hcloud/entities/load_balancer_type_price.rb
 - lib/hcloud/entities/metrics.rb
+- lib/hcloud/entities/nameserver.rb
 - lib/hcloud/entities/price.rb
 - lib/hcloud/entities/primary_ip_prices.rb
 - lib/hcloud/entities/private_net.rb
@@ -124,6 +141,7 @@ files:
 - lib/hcloud/entities/protection.rb
 - lib/hcloud/entities/public_net.rb
 - lib/hcloud/entities/public_net_firewall.rb
+- lib/hcloud/entities/record.rb
 - lib/hcloud/entities/route.rb
 - lib/hcloud/entities/rule.rb
 - lib/hcloud/entities/server_backup_price.rb
@@ -149,6 +167,7 @@ files:
 - lib/hcloud/entity.rb
 - lib/hcloud/errors.rb
 - lib/hcloud/http.rb
+- lib/hcloud/inflector.rb
 - lib/hcloud/resource.rb
 - lib/hcloud/resource_type.rb
 - lib/hcloud/resources/action.rb
@@ -166,6 +185,7 @@ files:
 - lib/hcloud/resources/placement_group.rb
 - lib/hcloud/resources/pricing.rb
 - lib/hcloud/resources/primary_ip.rb
+- lib/hcloud/resources/rrset.rb
 - lib/hcloud/resources/server.rb
 - lib/hcloud/resources/server_type.rb
 - lib/hcloud/resources/ssh_key.rb
@@ -174,6 +194,7 @@ files:
 - lib/hcloud/resources/storage_box_subaccount.rb
 - lib/hcloud/resources/storage_box_type.rb
 - lib/hcloud/resources/volume.rb
+- lib/hcloud/resources/zone.rb
 - lib/hcloud/sub_collection.rb
 - lib/hcloud/version.rb
 - lib/http/features/block_io.rb
@@ -199,7 +220,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="