RubyGems - gandi_v5 - Versions diffs - 0.1.0 → 0.2.0 - Mend

gandi_v5 0.1.0 → 0.2.0

Files changed (107) hide show

checksums.yaml +4 -4
data/.rubocop.yml +1 -1
data/.travis.yml +1 -0
data/CHANGELOG.md +44 -2
data/Guardfile +5 -6
data/README.md +5 -5
data/doc/GandiV5/Billing/Info/Prepaid.html +817 -0
data/doc/GandiV5/Billing/Info.html +641 -0
data/doc/GandiV5/Billing.html +293 -0
data/doc/GandiV5/Data/ClassMethods.html +223 -0
data/doc/GandiV5/Data/Converter/ArrayOf.html +413 -0
data/doc/GandiV5/Data/Converter/Symbol.html +322 -0
data/doc/GandiV5/Data/Converter/Time.html +330 -0
data/doc/GandiV5/Data/Converter.html +433 -0
data/doc/GandiV5/Data.html +785 -0
data/doc/GandiV5/Domain/AutoRenew.html +1237 -0
data/doc/GandiV5/Domain/Availability/Product/Period.html +220 -0
data/doc/GandiV5/Domain/Availability/Product/Price.html +1031 -0
data/doc/GandiV5/Domain/Availability/Product.html +988 -0
data/doc/GandiV5/Domain/Availability/Tax.html +440 -0
data/doc/GandiV5/Domain/Availability.html +1020 -0
data/doc/GandiV5/Domain/Contact.html +4459 -0
data/doc/GandiV5/Domain/Contract.html +520 -0
data/doc/GandiV5/Domain/Dates.html +1313 -0
data/doc/GandiV5/Domain/RenewalInformation.html +1147 -0
data/doc/GandiV5/Domain/RestoreInformation.html +339 -0
data/doc/GandiV5/Domain/SharingSpace.html +437 -0
data/doc/GandiV5/Domain/TLD.html +1565 -0
data/doc/GandiV5/Domain.html +16847 -0
data/doc/GandiV5/Email/Mailbox/Responder.html +1560 -0
data/doc/GandiV5/Email/Mailbox.html +6307 -0
data/doc/GandiV5/Email/Offer.html +514 -0
data/doc/GandiV5/Email/Slot.html +4244 -0
data/doc/GandiV5/Email.html +144 -0
data/doc/GandiV5/Error/GandiError.html +270 -0
data/doc/GandiV5/Error.html +151 -0
data/doc/GandiV5/LiveDNS/Domain.html +2984 -0
data/doc/GandiV5/LiveDNS/RecordSet.html +1593 -0
data/doc/GandiV5/LiveDNS/Zone/Snapshot.html +1556 -0
data/doc/GandiV5/LiveDNS/Zone.html +8891 -0
data/doc/GandiV5/LiveDNS.html +300 -0
data/doc/GandiV5/Organization.html +2341 -0
data/doc/GandiV5.html +1183 -0
data/doc/_index.html +474 -0
data/doc/class_list.html +51 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +58 -0
data/doc/css/style.css +496 -0
data/doc/file.README.html +175 -0
data/doc/file_list.html +56 -0
data/doc/frames.html +17 -0
data/doc/index.html +175 -0
data/doc/js/app.js +303 -0
data/doc/js/full_list.js +216 -0
data/doc/js/jquery.js +4 -0
data/doc/method_list.html +2427 -0
data/doc/top-level-namespace.html +110 -0
data/gandi_v5.gemspec +1 -1
data/lib/gandi_v5/billing.rb +2 -2
data/lib/gandi_v5/data.rb +2 -0
data/lib/gandi_v5/domain/auto_renew.rb +4 -4
data/lib/gandi_v5/domain/availability/product/period.rb +24 -0
data/lib/gandi_v5/domain/availability/product/price.rb +36 -0
data/lib/gandi_v5/domain/availability/product.rb +52 -0
data/lib/gandi_v5/domain/availability/tax.rb +20 -0
data/lib/gandi_v5/domain/availability.rb +49 -0
data/lib/gandi_v5/domain/tld.rb +57 -0
data/lib/gandi_v5/domain.rb +41 -86
data/lib/gandi_v5/email/mailbox/responder.rb +43 -2
data/lib/gandi_v5/email/mailbox.rb +32 -21
data/lib/gandi_v5/email/offer.rb +2 -2
data/lib/gandi_v5/email/slot.rb +42 -16
data/lib/gandi_v5/error/gandi_error.rb +2 -2
data/lib/gandi_v5/live_dns/domain.rb +59 -45
data/lib/gandi_v5/live_dns/zone/snapshot.rb +27 -8
data/lib/gandi_v5/live_dns/zone.rb +63 -59
data/lib/gandi_v5/live_dns.rb +20 -0
data/lib/gandi_v5/organization.rb +2 -2
data/lib/gandi_v5/version.rb +1 -1
data/lib/gandi_v5.rb +25 -5
data/spec/features/domain_spec.rb +1 -1
data/spec/fixtures/bodies/{GandiV5_Domain/availability.yaml → GandiV5_Domain_Availability/fetch.yaml} +0 -0
data/spec/fixtures/bodies/{GandiV5_Domain/tld.yaml → GandiV5_Domain_TLD/fetch.yaml} +0 -0
data/spec/fixtures/bodies/{GandiV5_Domain/tlds.yaml → GandiV5_Domain_TLD/list.yaml} +0 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Zone_Snapshot/{get.yaml → fetch.yaml} +0 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Zone_Snapshot/list.yaml +3 -0
data/spec/units/gandi_v5/billing_spec.rb +2 -2
data/spec/units/gandi_v5/domain/auto_renew_spec.rb +5 -5
data/spec/units/gandi_v5/domain/availability/product/period_spec.rb +4 -0
data/spec/units/gandi_v5/domain/availability/product/price_spec.rb +4 -0
data/spec/units/gandi_v5/domain/availability/product_spec.rb +4 -0
data/spec/units/gandi_v5/domain/availability/tax_spec.rb +4 -0
data/spec/units/gandi_v5/domain/availability_spec.rb +43 -0
data/spec/units/gandi_v5/domain/tld_spec.rb +29 -0
data/spec/units/gandi_v5/domain_spec.rb +89 -81
data/spec/units/gandi_v5/email/mailbox/responder_spec.rb +52 -0
data/spec/units/gandi_v5/email/mailbox_spec.rb +56 -27
data/spec/units/gandi_v5/email/offer_spec.rb +1 -1
data/spec/units/gandi_v5/email/slot_spec.rb +101 -13
data/spec/units/gandi_v5/live_dns/domain_spec.rb +70 -40
data/spec/units/gandi_v5/live_dns/zone/snapshot_spec.rb +32 -3
data/spec/units/gandi_v5/live_dns/zone_spec.rb +68 -50
data/spec/units/gandi_v5/live_dns_spec.rb +24 -0
data/spec/units/gandi_v5/organization_spec.rb +1 -1
data/spec/units/gandi_v5_spec.rb +37 -12
metadata +72 -9
data/TODO.md +0 -29

data/doc/top-level-namespace.html ADDED Viewed

@@ -0,0 +1,110 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  Top Level Namespace
+    &mdash; Documentation by YARD 0.9.19
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  pathId = "";
+  relpath = '';
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="class_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">Top Level Namespace</span>
+</div>
+        <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+</div>
+        <div class="clear"></div>
+      </div>
+      <div id="content"><h1>Top Level Namespace
+</h1>
+<div class="box_info">
+</div>
+<h2>Defined Under Namespace</h2>
+<p class="children">
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="GandiV5.html" title="GandiV5 (class)">GandiV5</a></span>
+</p>
+</div>
+      <div id="footer">
+  Generated on Mon Jul 22 16:44:23 2019 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.19 (ruby-2.6.3).
+</div>
+    </div>
+  </body>
+</html>

data/gandi_v5.gemspec CHANGED Viewed

@@ -32,7 +32,7 @@ Gem::Specification.new do |gem|
   gem.add_development_dependency 'rb-inotify', '~> 0.9'
   gem.add_development_dependency 'rspec', '>= 3.7', '< 4'
   gem.add_development_dependency 'rspec-its', '~> 1.3'
-  gem.add_development_dependency 'rubocop', '~> 0.67'
+  gem.add_development_dependency 'rubocop', '~> 0.73'
   gem.add_development_dependency 'rubocop-performance', '~> 1.1'
   gem.add_development_dependency 'simplecov', '~> 0.7'
   gem.add_development_dependency 'timecop', '~> 0.5'

data/lib/gandi_v5/billing.rb CHANGED Viewed

@@ -11,9 +11,9 @@ class GandiV5
     # @param url [sharing_id] the Sharing ID of the organisation to get info for
     #   defaults to the user the api key belomgs to.
     # @return [GandiV5::Billing::Info]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def self.info(sharing_id = nil)
-      data = GandiV5.get url(sharing_id)
+      _response, data = GandiV5.get url(sharing_id)
       GandiV5::Billing::Info.from_gandi data
     end

data/lib/gandi_v5/data.rb CHANGED Viewed

@@ -181,7 +181,9 @@ class GandiV5
         define_method "#{name}=" do |value|
           instance_variable_set("@#{name}", value)
         end
+        # rubocop:disable Style/AccessModifierDeclarations
         private "#{name}="
+        # rubocop:enable Style/AccessModifierDeclarations
       end
       # @api private

data/lib/gandi_v5/domain/auto_renew.rb CHANGED Viewed

@@ -21,10 +21,10 @@ class GandiV5
       # Disable auto renewal for the associated domain.
       # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def disable
         body = { enabled: false }.to_json
-        data = GandiV5.patch url, body
+        _response, data = GandiV5.patch url, body
         self.enabled = false
         data['message']
       end
@@ -35,7 +35,7 @@ class GandiV5
       # @return [String] The confirmation message from Gandi.
       # @raise [ArgumentError] if duration is invalid (not 1 to 9 (inclusive)).
       # @raise [ArgumentError] if org_id is not passed and not set for this domain.
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def enable(duration: self.duration || 1, org_id: self.org_id)
         fail ArgumentError, 'duration can not be less than 1' if duration < 1
         fail ArgumentError, 'duration can not be more than 9' if duration > 9
@@ -47,7 +47,7 @@ class GandiV5
           org_id: org_id
         }.to_json
-        data = GandiV5.patch url, body
+        _response, data = GandiV5.patch url, body
         self.enabled = true
         self.duration = duration
         self.org_id = org_id

data/lib/gandi_v5/domain/availability/product/period.rb ADDED Viewed

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+class GandiV5
+  class Domain
+    class Availability
+      class Product
+        # Information about an available product.
+        # @!attribute [r] name
+        #   @return [String]
+        # @!attribute [r]
+        #   @return [Time] starts_at
+        # @!attribute [r]
+        #   @return [Time, nil] ends_at
+        class Period
+          include GandiV5::Data
+          members :name
+          member :starts_at, converter: GandiV5::Data::Converter::Time
+          member :ends_at, converter: GandiV5::Data::Converter::Time
+        end
+      end
+    end
+  end
+end

data/lib/gandi_v5/domain/availability/product/price.rb ADDED Viewed

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+class GandiV5
+  class Domain
+    class Availability
+      class Product
+        # Information about an available product.
+        # @!attribute [r] duration_unit
+        #   @return [String] time unit for the duration (e.g. y)
+        # @!attribute [r] max_duration
+        #   @return [Integer] maximum duration for which this price unit applies
+        # @!attribute [r] min_duration
+        #   @return [Integer] minimum duration for which this price unit applies.
+        # @!attribute [r] price_after_taxes
+        #   @return [Numeric] pricing after tax is applied
+        # @!attribute [r] price_before_taxes
+        #   @return [Numeric] pricing before tax is applied
+        # @!attribute [r] discount
+        #   @return [Boolean, nil] whether a discount is active on this price unit
+        # @!attribute [r] normal_price_after_taxes
+        #   @return [Numeric, nil] pricing after tax is applied, when no discount applies
+        # @!attribute [r] normal_price_before_taxes
+        #   @return [Numeric, nil] pricing before tax is applied, when no discount applies
+        # @!attribute [r] type
+        #   @return [String, nil]
+        class Price
+          include GandiV5::Data
+          members :duration_unit, :max_duration, :min_duration,
+                  :price_after_taxes, :price_before_taxes,
+                  :discount, :normal_price_after_taxes, :normal_price_after_taxes, :type
+        end
+      end
+    end
+  end
+end

data/lib/gandi_v5/domain/availability/product.rb ADDED Viewed

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+require_relative 'product/price'
+require_relative 'product/period'
+class GandiV5
+  class Domain
+    class Availability
+      # Information about an available product.
+      # @!attribute [r] name
+      #   @return [String]
+      # @!attribute [r] prices
+      #   @return [Array<GandiV5::Domain::Availability::Product::Price>]
+      # @!attribute [r] periods
+      #   @return [Array<GandiV5::Domain::Availability::Product::Period>]
+      # @!attribute [r] taxes
+      #   @return [Array<GandiV5::Domain::Availability::Tax>]
+      # @!attribute [r] process
+      #   @return [Symbol]
+      # @!attribute [r] status
+      #   @return [Symbol]
+      class Product
+        include GandiV5::Data
+        STATUSES = {
+          available: 'Domain name is available',
+          available_reserved: 'Domain name reserved under special conditions',
+          available_preorder: 'Domain name can be pre-ordered',
+          unavailable: 'Domain name is not available',
+          unavailable_premium: 'Domain name is not available',
+          unavailable_restricted: 'Domain name is not available (forbidden)',
+          error_invalid: 'Provided value is not a valid domain name',
+          error_refused: 'Service is temporarily down',
+          error_timeout: 'Service timed out, try the method again later',
+          error_unknown: 'Internal server error',
+          reserved_corporate: 'The TLD for the given domain name is reserved for ' \
+                              'Gandi Corporate Services customers',
+          pending: 'Result is not yet ready, try the method again later',
+          error_eoi: 'The TLD for the given domain name is in an ' \
+                     'Expression of Interest (EOI) period'
+        }.freeze
+        members :name
+        member :prices, converter: GandiV5::Domain::Availability::Product::Price, array: true
+        member :periods, converter: GandiV5::Domain::Availability::Product::Period, array: true
+        member :process, converter: GandiV5::Data::Converter::Symbol
+        member :status, converter: GandiV5::Data::Converter::Symbol
+        member :taxes, converter: GandiV5::Domain::Availability::Tax, array: true
+      end
+    end
+  end
+end

data/lib/gandi_v5/domain/availability/tax.rb ADDED Viewed

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+class GandiV5
+  class Domain
+    class Availability
+      # Information about tax due on a process/product.
+      # @!attribute [r] name
+      #   @return [String] name of the tax (e.g. VAT)
+      # @!attribute [r] rate
+      #   @return [Numeric] percentage rate of the tax (e.g. 20)
+      # @!attribute [r] type
+      #   @return [String] type of the tax (e.g. service)
+      class Tax
+        include GandiV5::Data
+        members :name, :rate, :type
+      end
+    end
+  end
+end

data/lib/gandi_v5/domain/availability.rb ADDED Viewed

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+require_relative 'availability/tax'
+require_relative 'availability/product'
+class GandiV5
+  class Domain
+    # Information about the availabillity of processes on a domain.
+    # @!attribute [r] currency
+    #   @return [String]
+    # @!attribute [r] grid
+    #   @return [String]
+    # @!attribute [r] products
+    #   @return [Arrav<GandiV5::Domain::Availability::Product>]
+    # @!attribute [r] taxes
+    #   @return [Array<GandiV5::Domain::Availability::Tax>]
+    class Availability
+      include GandiV5::Data
+      members :currency, :grid
+      member :products, converter: GandiV5::Domain::Availability::Product, array: true
+      member :taxes, converter: GandiV5::Domain::Availability::Tax, array: true
+      # Check domain availability and pricing.
+      # @see https://api.gandi.net/docs/domains#get-v5-domain-check
+      # @param fqdn [String, #to_s] the fully qualified domain name to check.
+      # @param country [String, #to_s] (optional)
+      #   ISO country code for which taxes are to be applied.
+      # @param currency [String, #to_s] (optional) request price for a specific ISO currency code.
+      # @param duration_unit [String, #to_s] (optional) define the unit for max_duration.
+      # @param extension [String, #to_s] (optional) query a specific extension for product options.
+      # @param grid [String, #to_s] (optional) request price for a specific rate.
+      # @param lang [String, #to_s] (optional) language code.
+      # @param max_duration [Integer, #to_s] (optional)
+      #   set a limit on the duration range for returned prices.
+      # @param period [String, #to_s] (optional) specific registration period to query.
+      # @param processes [Array<:create, :renew, :transfer etc.>] (optional default [:create])
+      #   list of at least 1 process for which pricing is to be made.
+      # @param sharing_id [String, #to_s] (optional)
+      #   organization for which the pricing is to be made.
+      # @return [GandiV5::Domain::Availability]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.fetch(fqdn, **options)
+        _response, data = GandiV5.get("#{BASE}domain/check", params: { name: fqdn }.merge(options))
+        GandiV5::Domain::Availability.from_gandi data
+      end
+    end
+  end
+end

data/lib/gandi_v5/domain/tld.rb ADDED Viewed

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+class GandiV5
+  class Domain
+    # Information about a specific TLD (Top Level Domain).
+    # @!attribute [r] name
+    #   @return [String]
+    # @!attribute [r] full_tld
+    #   @return [String]
+    # @!attribute [r] authinfo_for_transfer
+    #   @return [Boolean] whether authinfo is required for a transfer.
+    # @!attribute [r] category
+    #   @return [String]
+    # @!attribute [r] change_owner
+    #   @return [Boolean] whther changing owner is pemritted.
+    # @!attribute [r] corporate
+    #   @return [Boolean] whether this is a corporate TLD.
+    # @!attribute [r] ext_trade
+    #   @return [Boolean]
+    # @!attribute [r] lock
+    #   @return [Boolean]
+    class TLD
+      include GandiV5::Data
+      members :name, :full_tld, :authinfo_for_transfer, :change_owner, :corporate, :ext_trade, :lock
+      member :category, converter: GandiV5::Data::Converter::Symbol
+      # List of available TLDs.
+      # @see https://api.gandi.net/docs/domains#get-v5-domain-tlds
+      # @return Array<GandiV5::Domain::TLD>
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.list
+        GandiV5.get(url)
+               .last
+               .map { |tld| GandiV5::Domain::TLD.from_gandi tld }
+      end
+      # Get TLD information.
+      # @see https://api.gandi.net/docs/domains#get-v5-domain-tlds-name
+      # @param name [String, #to_s] the top level domain to get information for.
+      # @return [GandiV5::Domain::TLD]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def self.fetch(name)
+        _response, data = GandiV5.get url(name)
+        GandiV5::Domain::TLD.from_gandi data
+      end
+      private
+      def self.url(name = nil)
+        "#{BASE}domain/tlds" +
+          (name ? "/#{CGI.escape name}" : '')
+      end
+      private_class_method :url
+    end
+  end
+end

data/lib/gandi_v5/domain.rb CHANGED Viewed

@@ -1,28 +1,14 @@
 # frozen_string_literal: true
-# TODO: Add method renewal_price(currency: 'GBP', period: 1, sharing_id: self.sharing_id)
-# TODO: Glue Record Management
-#  * get-v5-domain-domains-domain-hosts
-#  * post-v5-domain-domains-domain-hosts
-# TODO: Glue Record Information
-#  * get-v5-domain-domains-domain-hosts-name
-#  * put-v5-domain-domains-domain-hosts-name
-#  * delete-v5-domain-domains-domain-hosts-name
-# TODO: LiveDNS Management
-#  * get-v5-domain-domains-domain-livedns
-#  * post-v5-domain-domains-domain-livedns
-# TODO: Nameservers Management
-#  * get-v5-domain-domains-domain-nameservers
-#  * put-v5-domain-domains-domain-nameservers
 require_relative 'domain/auto_renew'
+require_relative 'domain/availability'
 require_relative 'domain/contact'
 require_relative 'domain/contract'
 require_relative 'domain/dates'
 require_relative 'domain/renewal_information'
 require_relative 'domain/restore_information'
 require_relative 'domain/sharing_space'
+require_relative 'domain/tld'
 class GandiV5
   # Gandi Domain Management API.
@@ -175,7 +161,7 @@ class GandiV5
     # Contacts for the domain.
     # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-contacts
     # @return [Hash{:owner, :admin, :bill, :tech => GandiV5::Domain::Contact}]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def contacts
       @contacts ||= fetch_contacts
     end
@@ -183,9 +169,9 @@ class GandiV5
     # Requery Gandi for the domain's contacts.
     # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-contacts
     # @return [Hash{:owner, :admin, :bill, :tech => GandiV5::Domain::Contact}]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def fetch_contacts
-      data = GandiV5.get url('contacts')
+      _response, data = GandiV5.get url('contacts')
       self.contacts = data.transform_keys(&:to_sym)
       CONTACTS_CONVERTER.call contacts
     end
@@ -199,7 +185,7 @@ class GandiV5
     # @param tech [GandiV5::Domain::Contact, #to_gandi, #to_h]
     #   details for the new technical contact.
     # @return [Hash{:owner, :admin, :bill, :tech => GandiV5::Domain::Contact}]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def update_contacts(admin: nil, bill: nil, tech: nil)
       body = {
         admin: admin.respond_to?(:to_gandi) ? admin.to_gandi : admin,
@@ -214,7 +200,7 @@ class GandiV5
     # Renewal information for the domain.
     # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-renew
     # @return [GandiV5::Domain::RenewalInformation]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def renewal_information
       @renewal_information ||= fetch_renewal_information
     end
@@ -222,9 +208,9 @@ class GandiV5
     # Requery Gandi for the domain's renewal information.
     # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-renew
     # @return [GandiV5::Domain::RenewalInformation]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def fetch_renewal_information
-      data = GandiV5.get url('renew')
+      _response, data = GandiV5.get url('renew')
       data = data['renew'].merge('contracts' => data['contracts'])
       @renewal_information = GandiV5::Domain::RenewalInformation.from_gandi data
     end
@@ -234,31 +220,29 @@ class GandiV5
     # @see https://api.gandi.net/docs/domains#post-v5-domain-domains-domain-renew
     # @param duration [Integer, #to_s] how long to renew for (in years).
     # @return [String] confirmation message from Gandi.
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def renew_for(duration = 1)
       body = { duration: duration }.to_json
-      data = GandiV5.post url('renew'), body
+      _response, data = GandiV5.post url('renew'), body
       data['message']
     end
-    # TODO: Test when I have a restorable domain
     # Restoration information for the domain.
     # @see https://docs.gandi.net/en/domain_names/renew/restore.html
     # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-restore
     # @return [GandiV5::Domain::RestoreInformation]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def restore_information
       @restore_information ||= fetch_restore_information
     end
-    # TODO: Test when I have a restorable domain
     # Requery Gandi for the domain's restore information.
     # @see https://docs.gandi.net/en/domain_names/renew/restore.html
     # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain-restore
     # @return [GandiV5::Domain::RestoreInformation]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def fetch_restore_information
-      data = GandiV5.get url('restore')
+      _response, data = GandiV5.get url('restore')
       @restore_information = GandiV5::Domain::RestoreInformation.from_gandi data
     rescue RestClient::NotFound
       @restore_information = GandiV5::Domain::RestoreInformation.from_gandi restorable: false
@@ -269,21 +253,33 @@ class GandiV5
     # @see https://docs.gandi.net/en/domain_names/renew/restore.html
     # @see https://api.gandi.net/docs/domains#post-v5-domain-domains-domain-restore
     # @return [String] The confirmation message from Gandi.
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def restore
-      data = GandiV5.post url('restore'), '{}'
+      _response, data = GandiV5.post url('restore'), '{}'
       data['message']
     end
     # Requery Gandi fo this domain's information.
     # @return [GandiV5::Domain]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def refresh
-      data = GandiV5.get url
+      _response, data = GandiV5.get url
       from_gandi data
       auto_renew.domain = self
     end
+    # Get the price for renewing this domain.
+    # @param currency [String] the currency to get the price in (e.g. GBP)
+    # @param period [Integer] the number of year(s) renewal to get the price for
+    # @return [GandiV5::Domain::Availability::Product::Price]
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error
+    def renewal_price(currency: 'GBP', period: 1)
+      arguments = { processes: [:renew], currency: currency, period: period }
+      GandiV5::Domain::Availability.fetch(fqdn, **arguments)
+                                   .products.first
+                                   .prices.first
+    end
     # Create (register) a new domain.
     # Warning! This is not a free operation. Please ensure your prepaid account has enough credit.
     # @see https://api.gandi.net/docs/domains#post-v5-domain-domains
@@ -319,27 +315,28 @@ class GandiV5
     #   "eap7", "eap8", "eap9", "golive", #to_gandi, #to_json] (optional)
     #   @see https://docs.gandi.net/en/domain_names/register/new_gtld.html
     # @param dry_run [Boolean] whether the details should be checked
-    #   instead of actually creating the domain.
-    # @return [Hash] if actually creating, you get what Gandi returns.
-    # @return [Hash] if doing a dry run, you get what Gandi returns.
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-    # TODO: Return created domain unless dry_run
+    #   instead of actually creating the domain
+    # @return [GandiV5::Domain] the created domain
+    # @return [Hash] if doing a dry run, you get what Gandi returns
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error
     def self.create(fqdn, dry_run: false, **params)
       fail ArgumentError, 'missing keyword: owner' unless params.key?(:owner)
       body = params.merge(fqdn: fqdn)
                    .transform_values { |val| val.respond_to?(:to_gandi) ? val.to_gandi : val }
                    .to_json
-      GandiV5.post url, body, 'Dry-Run': dry_run ? 1 : 0
+      response, data = GandiV5.post(url, body, 'Dry-Run': dry_run ? 1 : 0)
+      dry_run ? data : fetch(response.headers[:location].split('/').last)
     end
     # Get information on a domain.
     # @see https://api.gandi.net/docs/domains#get-v5-domain-domains-domain
     # @param fqdn [String, #to_s] the fully qualified domain name to fetch.
     # @return [GandiV5::Domain]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def self.fetch(fqdn)
-      data = GandiV5.get url(fqdn)
+      _response, data = GandiV5.get url(fqdn)
       domain = from_gandi data
       domain.auto_renew.domain = fqdn
       domain
@@ -357,13 +354,13 @@ class GandiV5
     # @param sort_by [String, #to_s] (optional default "fqdn") how to sort the list.
     # @param tld [String, #to_s] (optional) used to filter by just the top level domain.
     # @return [Array<GandiV5::Domain>]
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+    # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
     def self.list(page: (1..), per_page: 100, **params)
       page = [page.to_i] unless page.respond_to?(:each)
       domains = []
       page.each do |page_number|
-        data = GandiV5.get url, params: params.merge(page: page_number, per_page: per_page)
+        _resp, data = GandiV5.get url, params: params.merge(page: page_number, per_page: per_page)
         break if data.empty?
         domains += data.map { |domain| from_gandi domain }
@@ -372,48 +369,6 @@ class GandiV5
       domains
     end
-    # Check domain availability and pricing.
-    # @see https://api.gandi.net/docs/domains#get-v5-domain-check
-    # @param fqdn [String, #to_s] the fully qualified domain name to check.
-    # @param country [String, #to_s] (optional) ISO country code for which taxes are to be applied.
-    # @param currency [String, #to_s] (optional) request price for a specific ISO currency code.
-    # @param duration_unit [String, #to_s] (optional) define the unit for max_duration.
-    # @param extension [String, #to_s] (optional) query a specific extension for product options.
-    # @param grid [String, #to_s] (optional) request price for a specific rate.
-    # @param lang [String, #to_s] (optional) language code.
-    # @param max_duration [Integer, #to_s] (optional)
-    #   set a limit on the duration range for returned prices.
-    # @param period [String, #to_s] (optional) specific registration period to query.
-    # @param _ [Array<:create, :renew, :transfer etc.>] (optional default [:create])
-    #   list of at least 1 process for which pricing is to be made.
-    # @param sharing_id [String, #to_s] (optional) organization for which the pricing is to be made.
-    # @return [Hash]
-    # TODO: Return an Availabillity object ???
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-    def self.availability(fqdn, **options)
-      GandiV5.get "#{BASE}domain/check", params: { name: fqdn }.merge(options)
-    end
-    # List of available TLDs.
-    # @see https://api.gandi.net/docs/domains#get-v5-domain-tlds
-    # @return Array<String>
-    # TODO: Maybe return an array of TLD objects ???
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-    def self.tlds
-      GandiV5.get("#{BASE}domain/tlds")
-             .map { |hash| hash['name'] }
-    end
-    # Get TLD information.
-    # @see https://api.gandi.net/docs/domains#get-v5-domain-tlds-name
-    # @param name [String, #to_s] the top level domain to get information for.
-    # @return [Hash]
-    # TODO: Return a TLD object ???
-    # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-    def self.tld(name)
-      GandiV5.get("#{BASE}domain/tlds/#{CGI.escape name}").transform_keys(&:to_sym)
-    end
     private
     def url(extra = nil)