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

gandi_v5 0.2.0 → 0.7.0

Files changed (157) hide show

checksums.yaml +4 -4
data/.gitignore +2 -0
data/.rubocop.yml +13 -3
data/.travis.yml +15 -1
data/CHANGELOG.md +63 -0
data/FUNDING.yml +10 -0
data/LICENSE.md +2 -6
data/README.md +16 -21
data/gandi_v5.gemspec +3 -2
data/lib/gandi_v5.rb +64 -24
data/lib/gandi_v5/billing.rb +0 -2
data/lib/gandi_v5/billing/info.rb +0 -2
data/lib/gandi_v5/data.rb +1 -4
data/lib/gandi_v5/data/converter.rb +0 -4
data/lib/gandi_v5/data/converter/integer.rb +26 -0
data/lib/gandi_v5/domain.rb +167 -28
data/lib/gandi_v5/domain/availability.rb +0 -3
data/lib/gandi_v5/domain/availability/product.rb +0 -3
data/lib/gandi_v5/domain/live_dns.rb +42 -0
data/lib/gandi_v5/domain/renewal_information.rb +0 -3
data/lib/gandi_v5/domain/sharing_space.rb +10 -2
data/lib/gandi_v5/email.rb +0 -4
data/lib/gandi_v5/email/forward.rb +102 -0
data/lib/gandi_v5/email/mailbox.rb +57 -13
data/lib/gandi_v5/email/slot.rb +11 -3
data/lib/gandi_v5/error.rb +0 -2
data/lib/gandi_v5/live_dns.rb +0 -16
data/lib/gandi_v5/live_dns/domain.rb +221 -80
data/lib/gandi_v5/live_dns/domain/dnssec_key.rb +115 -0
data/lib/gandi_v5/live_dns/domain/record.rb +81 -0
data/lib/gandi_v5/live_dns/domain/snapshot.rb +107 -0
data/lib/gandi_v5/live_dns/domain/tsig_key.rb +71 -0
data/lib/gandi_v5/organization.rb +38 -5
data/lib/gandi_v5/organization/customer.rb +90 -0
data/lib/gandi_v5/version.rb +1 -1
data/spec/.rubocop.yml +9 -2
data/spec/fixtures/bodies/GandiV5_Billing/{info.yaml → info.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Domain/{get.yaml → fetch.yml} +8 -0
data/spec/fixtures/bodies/GandiV5_Domain/{fetch_contacts.yaml → fetch_contacts.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Domain/fetch_glue_records.yml +7 -0
data/spec/fixtures/bodies/GandiV5_Domain/fetch_livedns.yml +6 -0
data/spec/fixtures/bodies/GandiV5_Domain/fetch_name_servers.yml +2 -0
data/spec/fixtures/bodies/GandiV5_Domain/{renewal_info.yaml → fetch_renewal_info.yml} +0 -3
data/spec/fixtures/bodies/GandiV5_Domain/{restore_info.yaml → fetch_restore_info.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Domain/{list.yaml → list.yml} +1 -0
data/spec/fixtures/bodies/GandiV5_Domain_Availability/{fetch.yaml → fetch.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Domain_TLD/{fetch.yaml → fetch.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Domain_TLD/{list.yaml → list.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Email_Forward/list.yml +6 -0
data/spec/fixtures/bodies/GandiV5_Email_Mailbox/{get.yaml → fetch.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Email_Mailbox/{list.yaml → list.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Email_Slot/{get.yaml → fetch.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Email_Slot/{list.yaml → list.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain/fetch.yml +3 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain/{list.yaml → list.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain/list_tsig.yml +3 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain/nameservers.yml +3 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain_DnssecKey/fetch.yml +12 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain_DnssecKey/list.yml +9 -0
data/spec/fixtures/bodies/{GandiV5_LiveDNS_Zone_Snapshot/fetch.yaml → GandiV5_LiveDNS_Domain_Snapshot/fetch.yml} +4 -3
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain_Snapshot/list.yml +5 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain_TsigKey/fetch.yml +9 -0
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain_TsigKey/list.yml +4 -0
data/spec/fixtures/bodies/GandiV5_Organization/{get.yaml → fetch.yml} +0 -0
data/spec/fixtures/bodies/GandiV5_Organization/list.yml +7 -0
data/spec/fixtures/bodies/GandiV5_Organization_Customer/list.yml +8 -0
data/spec/spec_helper.rb +2 -2
data/spec/units/gandi_v5/billing_spec.rb +2 -2
data/spec/units/gandi_v5/data/converter/integer_spec.rb +16 -0
data/spec/units/gandi_v5/domain/availability_spec.rb +1 -1
data/spec/units/gandi_v5/domain/live_dns_spec.rb +45 -0
data/spec/units/gandi_v5/domain/tld_spec.rb +2 -2
data/spec/units/gandi_v5/domain_spec.rb +294 -65
data/spec/units/gandi_v5/email/forward_spec.rb +92 -0
data/spec/units/gandi_v5/email/mailbox_spec.rb +122 -40
data/spec/units/gandi_v5/email/slot_spec.rb +13 -5
data/spec/units/gandi_v5/live_dns/domain/dnssec_key_spec.rb +128 -0
data/spec/units/gandi_v5/live_dns/{record_set_spec.rb → domain/record_spec.rb} +1 -1
data/spec/units/gandi_v5/live_dns/domain/snapshot_spec.rb +101 -0
data/spec/units/gandi_v5/live_dns/domain/tsig_key_spec.rb +78 -0
data/spec/units/gandi_v5/live_dns/domain_spec.rb +299 -120
data/spec/units/gandi_v5/live_dns_spec.rb +0 -12
data/spec/units/gandi_v5/organization/customer_spec.rb +81 -0
data/spec/units/gandi_v5/organization_spec.rb +52 -1
data/spec/units/gandi_v5_spec.rb +139 -30
metadata +68 -95
data/doc/GandiV5.html +0 -1183
data/doc/GandiV5/Billing.html +0 -293
data/doc/GandiV5/Billing/Info.html +0 -641
data/doc/GandiV5/Billing/Info/Prepaid.html +0 -817
data/doc/GandiV5/Data.html +0 -785
data/doc/GandiV5/Data/ClassMethods.html +0 -223
data/doc/GandiV5/Data/Converter.html +0 -433
data/doc/GandiV5/Data/Converter/ArrayOf.html +0 -413
data/doc/GandiV5/Data/Converter/Symbol.html +0 -322
data/doc/GandiV5/Data/Converter/Time.html +0 -330
data/doc/GandiV5/Domain.html +0 -16847
data/doc/GandiV5/Domain/AutoRenew.html +0 -1237
data/doc/GandiV5/Domain/Availability.html +0 -1020
data/doc/GandiV5/Domain/Availability/Product.html +0 -988
data/doc/GandiV5/Domain/Availability/Product/Period.html +0 -220
data/doc/GandiV5/Domain/Availability/Product/Price.html +0 -1031
data/doc/GandiV5/Domain/Availability/Tax.html +0 -440
data/doc/GandiV5/Domain/Contact.html +0 -4459
data/doc/GandiV5/Domain/Contract.html +0 -520
data/doc/GandiV5/Domain/Dates.html +0 -1313
data/doc/GandiV5/Domain/RenewalInformation.html +0 -1147
data/doc/GandiV5/Domain/RestoreInformation.html +0 -339
data/doc/GandiV5/Domain/SharingSpace.html +0 -437
data/doc/GandiV5/Domain/TLD.html +0 -1565
data/doc/GandiV5/Email.html +0 -144
data/doc/GandiV5/Email/Mailbox.html +0 -6307
data/doc/GandiV5/Email/Mailbox/Responder.html +0 -1560
data/doc/GandiV5/Email/Offer.html +0 -514
data/doc/GandiV5/Email/Slot.html +0 -4244
data/doc/GandiV5/Error.html +0 -151
data/doc/GandiV5/Error/GandiError.html +0 -270
data/doc/GandiV5/LiveDNS.html +0 -300
data/doc/GandiV5/LiveDNS/Domain.html +0 -2984
data/doc/GandiV5/LiveDNS/RecordSet.html +0 -1593
data/doc/GandiV5/LiveDNS/Zone.html +0 -8891
data/doc/GandiV5/LiveDNS/Zone/Snapshot.html +0 -1556
data/doc/GandiV5/Organization.html +0 -2341
data/doc/_index.html +0 -474
data/doc/class_list.html +0 -51
data/doc/css/common.css +0 -1
data/doc/css/full_list.css +0 -58
data/doc/css/style.css +0 -496
data/doc/file.README.html +0 -175
data/doc/file_list.html +0 -56
data/doc/frames.html +0 -17
data/doc/index.html +0 -175
data/doc/js/app.js +0 -303
data/doc/js/full_list.js +0 -216
data/doc/js/jquery.js +0 -4
data/doc/method_list.html +0 -2427
data/doc/top-level-namespace.html +0 -110
data/lib/gandi_v5/live_dns/record_set.rb +0 -79
data/lib/gandi_v5/live_dns/zone.rb +0 -305
data/lib/gandi_v5/live_dns/zone/snapshot.rb +0 -81
data/spec/features/domain_spec.rb +0 -45
data/spec/features/livedns_domain_spec.rb +0 -8
data/spec/features/livedns_zone_spec.rb +0 -45
data/spec/features/mailbox_spec.rb +0 -18
data/spec/fixtures/bodies/GandiV5_LiveDNS_Domain/get.yaml +0 -4
data/spec/fixtures/bodies/GandiV5_LiveDNS_Zone/get.yaml +0 -11
data/spec/fixtures/bodies/GandiV5_LiveDNS_Zone/list.yaml +0 -11
data/spec/fixtures/bodies/GandiV5_LiveDNS_Zone_Snapshot/list.yaml +0 -3
data/spec/fixtures/vcr/Domain_features/List_domains.yml +0 -54
data/spec/fixtures/vcr/Domain_features/Renew_domain.yml +0 -133
data/spec/fixtures/vcr/LiveDNS_Domain_features/List_domains.yml +0 -32
data/spec/fixtures/vcr/LiveDNS_Zone_features/List_zones.yml +0 -42
data/spec/fixtures/vcr/LiveDNS_Zone_features/Make_and_save_snapshot.yml +0 -72
data/spec/fixtures/vcr/LiveDNS_Zone_features/Save_zone_to_file.yml +0 -28
data/spec/fixtures/vcr/Mailbox_features/List_mailboxes.yml +0 -39
data/spec/units/gandi_v5/live_dns/zone/snapshot_spec.rb +0 -66
data/spec/units/gandi_v5/live_dns/zone_spec.rb +0 -347

data/doc/top-level-namespace.html DELETED

@@ -1,110 +0,0 @@
-<!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/lib/gandi_v5/live_dns/record_set.rb DELETED

@@ -1,79 +0,0 @@
-# frozen_string_literal: true
-class GandiV5
-  class LiveDNS
-    # A record set which comes from either a domain or zone.
-    # @!attribute [r] type
-    #   @return [String]
-    # @!attribute [r] ttl
-    #   @return [Integer]
-    # @!attribute [r] name
-    #   @return [String]
-    # @!attribute [r] values
-    #   @return [Array<String>]
-    class RecordSet
-      include GandiV5::Data
-      member :type, gandi_key: 'rrset_type'
-      member :ttl, gandi_key: 'rrset_ttl'
-      member :name, gandi_key: 'rrset_name'
-      member :values, gandi_key: 'rrset_values'
-      # Generate zone file lines for the record.
-      # @return [String]
-      def to_s
-        values.map do |value|
-          "#{name}\t#{ttl}\tIN\t#{type}\t#{value}"
-        end.join("\n")
-      end
-      GandiV5::LiveDNS::RECORD_TYPES.each do |t|
-        # Check the record type.
-        # @return [Boolean]
-        define_method "#{t.downcase}?" do
-          type.eql?(t)
-        end
-      end
-      # Check the TTL's value in seconds.
-      # @param number [Integer] the number of second(s) to check against.
-      # @return [Boolean]
-      def second?(number = 1)
-        ttl == number
-      end
-      alias seconds? second?
-      # Check the TTL's value in minutes.
-      # @param number [Integer] the number of minute(s) to check against.
-      # @return [Boolean]
-      def minute?(number = 1)
-        ttl == number * 60
-      end
-      alias minutes? minute?
-      # Check the TTL's value in hours.
-      # @param number [Integer] the number of hour(s) to check against.
-      # @return [Boolean]
-      def hour?(number = 1)
-        ttl == number * 3_600
-      end
-      alias hours? hour?
-      # Check the TTL's value in days.
-      # @param number [Integer] the number of day(s) to check against.
-      # @return [Boolean]
-      def day?(number = 1)
-        ttl == number * 86_400
-      end
-      alias days? day?
-      # Check the TTL's value in weeks.
-      # @param number [Integer] the number of week(s) to check against.
-      # @return [Boolean]
-      def week?(number = 1)
-        ttl == number * 604_800
-      end
-      alias weeks? day?
-    end
-  end
-end

data/lib/gandi_v5/live_dns/zone.rb DELETED

@@ -1,305 +0,0 @@
-# frozen_string_literal: true
-require_relative 'zone/snapshot'
-class GandiV5
-  class LiveDNS
-    # A zone within the LiveDNS system.
-    # Zones can be used by any number of domains.
-    # @!attribute [r] uuid
-    #   @return [String]
-    # @!attribute [r] name
-    #   @return [String]
-    # @!attribute [r] sharing_uuid
-    #   @return [String]
-    # @!attribute [r] soa_retry
-    #   @return [Integer] retry period, as reported in SOA record.
-    # @!attribute [r] soa_minimum
-    #   @return [Integer] minimum and negative TTL, as reported in SOA record.
-    # @!attribute [r] soa_refresh
-    #   @return [Integer] refresh period, as reported in SOA record.
-    # @!attribute [r] soa_expire
-    #   @return [Integer] expire period, as reported in SOA record.
-    # @!attribute [r] soa_serial
-    #   @return [Integer] serial number, as reported in SOA record.
-    # @!attribute [r] soa_email
-    #   @return [String] admin email address, as reported in SOA record.
-    # @!attribute [r] soa_primary_ns
-    #   @return [String] primary name server, as reported in SOA record.
-    class Zone
-      include GandiV5::Data
-      members :uuid, :name
-      member :sharing_uuid, gandi_key: 'sharing_id'
-      member :soa_retry, gandi_key: 'retry'
-      member :soa_minimum, gandi_key: 'minimum'
-      member :soa_refresh, gandi_key: 'refresh'
-      member :soa_expire, gandi_key: 'expire'
-      member :soa_serial, gandi_key: 'serial'
-      member :soa_email, gandi_key: 'email'
-      member :soa_primary_ns, gandi_key: 'primary_ns'
-      alias zone_uuid uuid
-      # Generate SOA record for the zone
-      # @return [String]
-      def to_s
-        "@\tIN\tSOA\t#{soa_primary_ns} #{soa_email} (\n" \
-        "\t#{soa_serial}\t;Serial\n" \
-        "\t#{soa_refresh}\t\t;Refresh\n" \
-        "\t#{soa_retry}\t\t;Retry\n" \
-        "\t#{soa_expire}\t\t;Expire\n" \
-        "\t#{soa_minimum}\t\t;Minimum & Negative TTL\n" \
-        ')'
-      end
-      # @overload fetch_records()
-      #   Fetch all records for this zone.
-      # @overload fetch_records(name)
-      #   Fetch records for a name.
-      #   @param name [String] the name to fetch records for.
-      # @overload fetch_records(name, type)
-      #   Fetch records of a type for a name.
-      #   @param name [String] the name to fetch records for.
-      #   @param type [String] the record type to fetch.
-      # @return [Array<GandiV5::LiveDNS::RecordSet>]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def fetch_records(name = nil, type = nil)
-        GandiV5::LiveDNS.require_valid_record_type type if type
-        url_ = "#{url}/records"
-        url_ += "/#{CGI.escape name}" if name
-        url_ += "/#{CGI.escape type}" if type
-        _response, data = GandiV5.get url_
-        data = [data] unless data.is_a?(Array)
-        data.map { |item| GandiV5::LiveDNS::RecordSet.from_gandi item }
-      end
-      # @overload fetch_zone_lines()
-      #   Fetch all records for this zone.
-      # @overload fetch_zone_lines(name)
-      #   Fetch records for a name.
-      #   @param name [String] the name to fetch records for.
-      # @overload fetch_zone_lines(name, type)
-      #   Fetch records of a type for a name.
-      #   @param name [String] the name to fetch records for.
-      #   @param type [String] the record type to fetch.
-      # @return [String]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def fetch_zone_lines(name = nil, type = nil)
-        GandiV5::LiveDNS.require_valid_record_type type if type
-        url_ = "#{url}/records"
-        url_ += "/#{CGI.escape name}" if name
-        url_ += "/#{CGI.escape type}" if type
-        GandiV5.get(url_, accept: 'text/plain').last
-      end
-      # Add record to this zone.
-      # @param name [String]
-      # @param type [String]
-      # @param ttl [Integer]
-      # @param values [Array<String>]
-      # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def add_record(name, type, ttl, *values)
-        GandiV5::LiveDNS.require_valid_record_type type
-        fail ArgumentError, 'ttl must be positive and non-zero' unless ttl.positive?
-        fail ArgumentError, 'there must be at least one value' if values.none?
-        body = {
-          rrset_name: name,
-          rrset_type: type,
-          rrset_ttl: ttl,
-          rrset_values: values
-        }.to_json
-        _response, data = GandiV5.post "#{url}/records", body
-        data['message']
-      end
-      # @overload delete_records()
-      #   Delete all records for this zone.
-      # @overload delete_records(name)
-      #   Delete records for a name.
-      #   @param name [String] the name to delete records for.
-      # @overload delete_records(name, type)
-      #   Delete records of a type for a name.
-      #   @param name [String] the name to delete records for.
-      #   @param type [String] the record type to delete.
-      # @return [nil]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def delete_records(name = nil, type = nil)
-        GandiV5::LiveDNS.require_valid_record_type type if type
-        url_ = "#{url}/records"
-        url_ += "/#{CGI.escape name}" if name
-        url_ += "/#{CGI.escape type}" if type
-        GandiV5.delete(url_).last
-      end
-      # Replace all records for this zone.
-      # @param records
-      #   [Array<Hash<:name, :type => String, :ttl => Integer, :values => Array<String>>>]
-      #   the records to add.
-      # @param text [String] zone file lines to replace the records with.
-      # @return [String] The confirmation message from Gandi.
-      # @raise [ArgumentError] if neither/both of records & test are passed.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def replace_records(records: nil, text: nil)
-        unless [records, text].one?(&:nil?)
-          fail ArgumentError, 'you must pass ONE of records: or text:'
-        end
-        if records
-          body = {
-            items: records.map { |r| r.transform_keys { |k| "rrset_#{k}" } }
-          }.to_json
-          _response, data = GandiV5.put "#{url}/records", body
-        elsif text
-          _response, data = GandiV5.put "#{url}/records", text, 'content-type': 'text/plain'
-        end
-        data['message']
-      end
-      # @override replace_records_for(name, records)
-      #   Replace records for a name in this zone.
-      #   @param name [String]
-      #   @param records
-      #     [Array<Hash<type: String, ttl: Integer, values: Array<String>>>]
-      #     the records to add.
-      # @override replace_records_for(name, values, type: nil, ttl: nil)
-      #   Replace records for a name in this zone.
-      #   @param name [String]
-      #   @param type [String] the record type.
-      #   @param ttl [Integer] the TTL to set for the record.
-      #   @param values [Array<String>] the values to set for the record.
-      #   @raise [ArgumentError] if ttl is present and type is absent.
-      # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def replace_records_for(name, records, type: nil, ttl: nil)
-        fail ArgumentError, 'missing keyword: type' if ttl && type.nil?
-        if type
-          GandiV5::LiveDNS.require_valid_record_type type
-          body = { rrset_values: records, rrset_ttl: ttl }
-          # body[:rrset_ttl] = ttl if ttl
-          _response, data = GandiV5.put "#{url}/records/#{name}/#{type}", body.to_json
-        else
-          body = {
-            items: records.map { |r| r.transform_keys { |k| "rrset_#{k}" } }
-          }
-          _response, data = GandiV5.put "#{url}/records/#{name}", body.to_json
-        end
-        data['message']
-      end
-      # List the domains that use this zone.
-      # @return [Array<String>] The FQDNs.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def list_domains
-        _response, data = GandiV5.get "#{url}/domains"
-        data.map { |item| item['fqdn'] }
-      end
-      # Attach domain to this zone.
-      # @param fqdn [String, #fqdn, #to_s] the fully qualified domain name
-      #   that should start using this zone.
-      # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def attach_domain(fqdn)
-        fqdn = fqdn.fqdn if fqdn.respond_to?(:fqdn)
-        _resp, data = GandiV5.patch "#{BASE}domains/#{CGI.escape fqdn}", { zone_uuid: uuid }.to_json
-        data['message']
-      end
-      # Get snapshot UUIDs for this zone from Gandi.
-      # @return [Hash{String => Time}] Mapping snapshot UUID to time made.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def snapshots
-        GandiV5::LiveDNS::Zone::Snapshot.list uuid
-      end
-      # Get snapshot from Gandi.
-      # @param uuid [String] the UUID of the snapshot to fetch.
-      # @return [GandiV5::LiveDNS::Zone::Snapshot]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def snapshot(uuid)
-        GandiV5::LiveDNS::Zone::Snapshot.fetch self.uuid, uuid
-      end
-      # Take a snapshot of this zone.
-      # @return [GandiV5::LiveDNS::Zone::Snapshot]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def take_snapshot
-        _response, data = GandiV5.post "#{url}/snapshots"
-        snapshot data['uuid']
-      end
-      # Update this zone.
-      # @param name [String, #to_s] new name for the zone.
-      # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def update(name:)
-        _response, data = GandiV5.patch url, { name: name }.to_json
-        self.name = name
-        data['message']
-      end
-      # Delete this zone from Gandi.
-      # @return [nil]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def delete
-        GandiV5.delete url
-      end
-      # Create a new zone.
-      # @param name [String] the name for the created zone.
-      # @param sharing_id [String] the UUID of the account to ceate the zone under.
-      # @return [GandiV5::LiveDNS::Zone] The created zone.
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def self.create(name, sharing_id: nil)
-        params = sharing_id ? { sharing_id: sharing_id } : {}
-        response, _data = GandiV5.post(
-          url,
-          { name: name }.to_json,
-          params: params
-        )
-        fetch response.headers[:location].split('/').last
-      end
-      # List the zones.
-      # @return [Array<GandiV5::LiveDNS::Zone>]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def self.list
-        _response, data = GandiV5.get url
-        data.map { |item| from_gandi item }
-      end
-      # Get a zone from Gandi.
-      # @param uuid [String, #to_s] the UUID of the zone to fetch.
-      # @return [GandiV5::LiveDNS::Zone]
-      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
-      def self.fetch(uuid)
-        _response, data = GandiV5.get url(uuid)
-        from_gandi data
-      end
-      private
-      def url
-        "#{BASE}zones/#{CGI.escape uuid}"
-      end
-      def self.url(uuid = nil)
-        BASE + (uuid ? "zones/#{CGI.escape(uuid)}" : 'zones')
-      end
-      private_class_method :url
-    end
-  end
-end