hetznercloud 1.4.0 → 1.5.1

data/lib/hcloud/resources/iso.rb

@@ -11,7 +11,7 @@ module HCloud
   #
   # == Search ISOs
   #
-  #     HCloud::ISO.all.where(name: "debian-10.10.0-amd64-netinst.iso")
+  #     HCloud::ISO.where(name: "debian-10.10.0-amd64-netinst.iso")
   #     # => #<HCloud::ISO id: 7631, ...>
   #
   # == Find ISO by ID

data/lib/hcloud/resources/load_balancer.rb

@@ -11,15 +11,18 @@ module HCloud
   #
   # == Sort load balancers
   #
-  #     HCloud::LoadBalancer.all.sort(name: :desc)
+  #     HCloud::LoadBalancer.sort(name: :desc)
   #     # => [#<HCloud::LoadBalancer id: 1, ...>, ...]
   #
-  #     HCloud::LoadBalancer.all.sort(:id, name: :asc)
+  #     HCloud::LoadBalancer.sort(:id, name: :asc)
   #     # => [#<HCloud::LoadBalancer id: 1, ...>, ...]
   #
   # == Search load balancers
   #
-  #     HCloud::LoadBalancer.all.where(name: "my_load_balancer")
+  #     HCloud::LoadBalancer.where(name: "my_load_balancer")
+  #     # => #<HCloud::LoadBalancer id: 1, ...>
+  #
+  #     HCloud::LoadBalancer.where(label_selector: { environment: "production" })
   #     # => #<HCloud::LoadBalancer id: 1, ...>
   #
   # == Find load balancer by ID
@@ -65,6 +68,7 @@ module HCloud
     updatable
     deletable
     meterable
+    labelable
 
     attribute :id, :integer
     attribute :name
@@ -94,8 +98,6 @@ module HCloud
 
     attribute :protection, :protection
 
-    attribute :labels, default: -> { {} }
-
     def creatable_attributes
       [:name, :labels, :algorithm, :network_zone, :public_interface, :services, :targets, load_balancer_type: [:id, :name], location: [:id, :name], network: [:id, :name]]
     end

data/lib/hcloud/resources/load_balancer_type.rb

@@ -11,7 +11,7 @@ module HCloud
   #
   # == Search load balancer types
   #
-  #     HCloud::LoadBalancerType.all.where(name: "cx11")
+  #     HCloud::LoadBalancerType.where(name: "cx11")
   #     # => #<HCloud::LoadBalancerType id: 1, ...>
   #
   # == Find load balancer type by ID

data/lib/hcloud/resources/location.rb

@@ -11,7 +11,7 @@ module HCloud
   #
   # == Search locations
   #
-  #     HCloud::Location.all.where(name: "fsn1")
+  #     HCloud::Location.where(name: "fsn1")
   #     # => #<HCloud::Location id: 1, ...>
   #
   # == Find location by ID

data/lib/hcloud/resources/metadata.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module HCloud
+  ##
+  # Server metadata.
+  #
+  # This resource allows a Hetzner server to retrieve metadata about itself.
+  # It cannot be used outside of Hetzner servers.
+  #
+  # == Find metadata
+  #
+  #     HCloud::Metadata.find
+  #     # => #<HCloud::Metadata ...>
+  #
+  class Metadata < Resource
+    ENDPOINT = "https://169.254.169.254/hetzner/v1/metadata"
+
+    attribute :hostname
+    attribute :instance_id, :integer
+    attribute :public_ipv4
+    attribute :availability_zone
+    attribute :region
+
+    attribute :private_networks, :private_network, array: true, default: -> { [] }
+
+    def self.find
+      new(::HTTP
+        .get(ENDPOINT)
+        .parse(:yaml)
+        .deep_transform_keys { |key| key.underscore.to_sym })
+    end
+  end
+end

data/lib/hcloud/resources/network.rb

@@ -11,7 +11,10 @@ module HCloud
   #
   # == Search networks
   #
-  #     HCloud::Network.all.where(name: "my_network")
+  #     HCloud::Network.where(name: "my_network")
+  #     # => #<HCloud::Network id: 1, ...>
+  #
+  #     HCloud::Network.where(label_selector: { environment: "production" })
   #     # => #<HCloud::Network id: 1, ...>
   #
   # == Find network by ID
@@ -106,6 +109,7 @@ module HCloud
     creatable
     updatable
     deletable
+    labelable
 
     attribute :id, :integer
     attribute :name
@@ -121,8 +125,6 @@ module HCloud
 
     attribute :protection, :protection
 
-    attribute :labels, default: -> { {} }
-
     action :change_protection
 
     action :add_route

data/lib/hcloud/resources/placement_group.rb

@@ -11,15 +11,18 @@ module HCloud
   #
   # == Sort placement groups
   #
-  #     HCloud::PlacementGroup.all.sort(name: :desc)
+  #     HCloud::PlacementGroup.sort(name: :desc)
   #     # => [#<HCloud::PlacementGroup id: 1, ...>, ...]
   #
-  #     HCloud::PlacementGroup.all.sort(:id, name: :asc)
+  #     HCloud::PlacementGroup.sort(:id, name: :asc)
   #     # => [#<HCloud::PlacementGroup id: 1, ...>, ...]
   #
   # == Search placement groups
   #
-  #     HCloud::PlacementGroup.all.where(name: "my_placement_group")
+  #     HCloud::PlacementGroup.where(name: "my_placement_group")
+  #     # => #<HCloud::PlacementGroup id: 2, ...>
+  #
+  #     HCloud::PlacementGroup.where(label_selector: { environment: "production" })
   #     # => #<HCloud::PlacementGroup id: 2, ...>
   #
   # == Find placement group by ID
@@ -55,6 +58,7 @@ module HCloud
     creatable
     updatable
     deletable
+    labelable
 
     attribute :id, :integer
     attribute :name
@@ -62,8 +66,6 @@ module HCloud
 
     attribute :servers, :server, array: true, default: -> { [] }
 
-    attribute :labels, default: -> { {} }
-
     def creatable_attributes
       [:name, :type, :labels]
     end

data/lib/hcloud/resources/pricing.rb

@@ -21,6 +21,8 @@ module HCloud
 
     attribute :load_balancer_types, :load_balancer_type_price, array: true, default: -> { [] }
 
+    attribute :primary_ips, :primary_ip_prices, array: true, default: -> { [] }
+
     attribute :server_backup, :server_backup_price
 
     attribute :server_types, :server_type_price, array: true, default: -> { [] }

data/lib/hcloud/resources/primary_ip.rb

@@ -11,18 +11,21 @@ module HCloud
   #
   # == Sort primary IPs
   #
-  #     HCloud::PrimaryIP.all.sort(id: :asc)
+  #     HCloud::PrimaryIP.sort(id: :asc)
   #     # => [#<HCloud::PrimaryIP id: 1, ...>, ...]
   #
-  #     HCloud::PrimaryIP.all.sort(:id, created: :asc)
+  #     HCloud::PrimaryIP.sort(:id, created: :asc)
   #     # => [#<HCloud::PrimaryIP id: 1, ...>, ...]
   #
   # == Search primary IPs
   #
-  #     HCloud::PrimaryIP.all.where(name: "my_primary_ip")
+  #     HCloud::PrimaryIP.where(name: "my_primary_ip")
   #     # => #<HCloud::PrimaryIP id: 1, ...>
   #
-  #     HCloud::PrimaryIP.all.where(ip: "1.2.3.4")
+  #     HCloud::PrimaryIP.where(ip: "1.2.3.4")
+  #     # => #<HCloud::PrimaryIP id: 1, ...>
+  #
+  #     HCloud::PrimaryIP.where(label_selector: { environment: "production" })
   #     # => #<HCloud::PrimaryIP id: 1, ...>
   #
   # == Find primary IP by ID
@@ -107,6 +110,7 @@ module HCloud
     creatable
     updatable
     deletable
+    labelable
 
     attribute :id, :integer
     attribute :name
@@ -125,8 +129,6 @@ module HCloud
 
     attribute :protection, :protection
 
-    attribute :labels, default: -> { {} }
-
     alias auto_delete? auto_delete
     alias blocked? blocked
 

data/lib/hcloud/resources/server.rb

@@ -11,18 +11,21 @@ module HCloud
   #
   # == Sort servers
   #
-  #     HCloud::Server.all.sort(name: :desc)
+  #     HCloud::Server.sort(name: :desc)
   #     # => [#<HCloud::Server id: 1, ...>, ...]
   #
-  #     HCloud::Server.all.sort(:id, name: :asc)
+  #     HCloud::Server.sort(:id, name: :asc)
   #     # => [#<HCloud::Server id: 1, ...>, ...]
   #
   # == Search servers
   #
-  #     HCloud::Server.all.where(name: "my_server")
+  #     HCloud::Server.where(name: "my_server")
   #     # => #<HCloud::Server id: 1, ...>
   #
-  #     HCloud::Server.all.where(status: "running")
+  #     HCloud::Server.where(status: "running")
+  #     # => #<HCloud::Server id: 1, ...>
+  #
+  #     HCloud::Server.where(label_selector: { environment: "production" })
   #     # => #<HCloud::Server id: 1, ...>
   #
   # == Find server by ID
@@ -72,6 +75,7 @@ module HCloud
     updatable
     deletable
     meterable
+    labelable
 
     attribute :id, :integer
     attribute :name
@@ -107,7 +111,7 @@ module HCloud
 
     attribute :primary_disk_size, :integer
 
-    attribute :protection, :protection
+    attribute :protection, :server_protection
 
     attribute :image, :image
 
@@ -118,8 +122,6 @@ module HCloud
 
     attribute :iso, :iso
 
-    attribute :labels, default: -> { {} }
-
     attribute :load_balancers, :load_balancer, array: true, default: -> { [] }
 
     attribute :volumes, :volume, array: true, default: -> { [] }

data/lib/hcloud/resources/server_type.rb

@@ -11,7 +11,7 @@ module HCloud
   #
   # == Search server types
   #
-  #     HCloud::ServerType.all.where(name: "cx11")
+  #     HCloud::ServerType.where(name: "cx11")
   #     # => #<HCloud::ServerType id: 1, ...>
   #
   # == Find server type by ID
@@ -26,6 +26,7 @@ module HCloud
     attribute :name
     attribute :description
 
+    attribute :architecture
     attribute :cores, :integer
     attribute :disk, :integer
     attribute :memory, :integer

data/lib/hcloud/resources/ssh_key.rb

@@ -11,18 +11,21 @@ module HCloud
   #
   # == Sort SSH keys
   #
-  #     HCloud::SSHKey.all.sort(name: :desc)
+  #     HCloud::SSHKey.sort(name: :desc)
   #     # => [#<HCloud::SSHKey id: 1, ...>, ...]
   #
-  #     HCloud::SSHKey.all.sort(:id, name: :asc)
+  #     HCloud::SSHKey.sort(:id, name: :asc)
   #     # => [#<HCloud::SSHKey id: 1, ...>, ...]
   #
   # == Search SSH keys
   #
-  #     HCloud::SSHKey.all.where(name: "cx11")
+  #     HCloud::SSHKey.where(name: "cx11")
   #     # => #<HCloud::SSHKey id: 1, ...>
   #
-  #     HCloud::SSHKey.all.where(fingerprint: "B6:6C:CD:DA:A2:24:43:39:98:80:0F:F5:51:17:7E")
+  #     HCloud::SSHKey.where(fingerprint: "B6:6C:CD:DA:A2:24:43:39:98:80:0F:F5:51:17:7E")
+  #     # => #<HCloud::SSHKey id: 1, ...>
+  #
+  #     HCloud::SSHKey.where(label_selector: { environment: "production" })
   #     # => #<HCloud::SSHKey id: 1, ...>
   #
   # == Find SSH key by ID
@@ -58,14 +61,13 @@ module HCloud
     creatable
     updatable
     deletable
+    labelable
 
     attribute :id, :integer
     attribute :name
     attribute :public_key
     attribute :fingerprint
 
-    attribute :labels, default: -> { {} }
-
     def creatable_attributes
       [:name, :public_key, :labels]
     end

data/lib/hcloud/resources/volume.rb

@@ -11,18 +11,21 @@ module HCloud
   #
   # == Sort volumes
   #
-  #     HCloud::Volume.all.sort(name: :desc)
+  #     HCloud::Volume.sort(name: :desc)
   #     # => [#<HCloud::Volume id: 1, ...>, ...]
   #
-  #     HCloud::Volume.all.sort(:id, name: :asc)
+  #     HCloud::Volume.sort(:id, name: :asc)
   #     # => [#<HCloud::Volume id: 1, ...>, ...]
   #
   # == Search volumes
   #
-  #     HCloud::Volume.all.where(name: "my_volume")
+  #     HCloud::Volume.where(name: "my_volume")
   #     # => #<HCloud::Volume id: 1, ...>
   #
-  #     HCloud::Volume.all.where(status: "available")
+  #     HCloud::Volume.where(status: "available")
+  #     # => #<HCloud::Volume id: 1, ...>
+  #
+  #     HCloud::Volume.where(label_selector: { environment: "production" })
   #     # => #<HCloud::Volume id: 1, ...>
   #
   # == Find volume by ID
@@ -107,6 +110,7 @@ module HCloud
     creatable
     updatable
     deletable
+    labelable
 
     attribute :id, :integer
     attribute :name
@@ -124,8 +128,6 @@ module HCloud
 
     attribute :server, :server
 
-    attribute :labels, default: -> { {} }
-
     alias automount? automount
 
     action :attach

data/lib/hcloud/version.rb

@@ -3,8 +3,8 @@
 module HCloud
   module Version
     MAJOR = 1
-    MINOR = 4
-    PATCH = 0
+    MINOR = 5
+    PATCH = 1
     PRE   = nil
 
     VERSION = [MAJOR, MINOR, PATCH].compact.join(".")

data/lib/http/mime_type/yaml.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module HTTP
+  module MimeType
+    class YAML < Adapter
+      def encode(obj)
+        return obj.to_yaml if obj.respond_to?(:to_yaml)
+
+        ::YAML.dump(obj)
+      end
+
+      # Decodes JSON
+      def decode(str)
+        ::YAML.safe_load(str)
+      end
+    end
+  end
+end
+
+HTTP::MimeType.register_adapter "application/x-yaml", HTTP::MimeType::YAML
+HTTP::MimeType.register_alias "application/x-yaml", :yaml

data/lib/http/rate_limiter.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module HTTP
+  class RateLimiter < Feature
+    attr_reader :limit, :remaining, :reset, :at, :rate
+
+    def initialize(...)
+      super
+
+      @limit = Float::INFINITY
+      @remaining = Float::INFINITY
+      @reset = Time.at(0)
+      @at = Time.at(0)
+      @rate = 1
+    end
+
+    def wrap_request(request)
+      sleep rate while remaining.zero? && (at + rate).future?
+
+      request
+    end
+
+    def wrap_response(response)
+      # Extract rate limits
+      @limit = response["RateLimit-Limit"].to_i
+      @remaining = response["RateLimit-Remaining"].to_i
+      @reset = Time.at(response["RateLimit-Reset"].to_i)
+
+      # Extract request date
+      @at = Time.parse(response.headers["Date"])
+
+      # Calculate remaining increment rate
+      @rate = 3600 / limit
+
+      response
+    end
+  end
+end
+
+HTTP::Options.register_feature(:rate_limiter, HTTP::RateLimiter)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hetznercloud
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.1
 platform: ruby
 authors:
 - Florian Dejonckheere
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-22 00:00:00.000000000 Z
+date: 2023-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -66,132 +66,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: byebug
-  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: dotenv
-  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
-    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: rake
-  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: rspec
-  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: rubocop
-  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: rubocop-performance
-  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: rubocop-rspec
-  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: webmock
-  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'
 description: Native Ruby integration with the Hetzner Cloud API
 email:
 - florian@floriandejonckheere.be
@@ -213,6 +87,7 @@ files:
 - lib/hcloud/concerns/concerns.rb
 - lib/hcloud/concerns/creatable.rb
 - lib/hcloud/concerns/deletable.rb
+- lib/hcloud/concerns/labelable.rb
 - lib/hcloud/concerns/meterable.rb
 - lib/hcloud/concerns/queryable.rb
 - lib/hcloud/concerns/singleton.rb
@@ -240,12 +115,15 @@ files:
 - lib/hcloud/entities/load_balancer_type_price.rb
 - lib/hcloud/entities/metrics.rb
 - lib/hcloud/entities/price.rb
+- lib/hcloud/entities/primary_ip_prices.rb
 - lib/hcloud/entities/private_net.rb
+- lib/hcloud/entities/private_network.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_protection.rb
 - lib/hcloud/entities/server_type_price.rb
 - lib/hcloud/entities/service.rb
 - lib/hcloud/entities/service_http.rb
@@ -272,6 +150,7 @@ files:
 - lib/hcloud/resources/load_balancer.rb
 - lib/hcloud/resources/load_balancer_type.rb
 - lib/hcloud/resources/location.rb
+- lib/hcloud/resources/metadata.rb
 - lib/hcloud/resources/network.rb
 - lib/hcloud/resources/placement_group.rb
 - lib/hcloud/resources/pricing.rb
@@ -281,6 +160,8 @@ files:
 - lib/hcloud/resources/ssh_key.rb
 - lib/hcloud/resources/volume.rb
 - lib/hcloud/version.rb
+- lib/http/mime_type/yaml.rb
+- lib/http/rate_limiter.rb
 homepage: https://github.com/floriandejonckheere/hcloud
 licenses:
 - MIT