gandi_v5 0.1.0 → 0.2.0

data/lib/gandi_v5/email/mailbox/responder.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-# TODO: Allow enable/disable from here too ???
-
 class GandiV5
   class Email
     class Mailbox
@@ -15,13 +13,26 @@ class GandiV5
       #   @return [nil, Time]
       # @!attribute [r] message
       #   @return [nil, String]
+      # @!attribute [r] mailbox
+      #   @return [GandiV5::Email::Mailbox] the mailbox this repsonder belongs to.
       class Responder
         include GandiV5::Data
 
+        attr_reader :mailbox
+
         members :enabled, :message
         member :starts_at, converter: GandiV5::Data::Converter::Time
         member :ends_at, converter: GandiV5::Data::Converter::Time
 
+        # Create a new GandiV5::Email::Mailbox::Responder
+        # @param mailbox [GandiV5::Email::Mailbox] the mailbox this responder belongs to.
+        # @param members [Hash<Symbol => Object>]
+        # @return [GandiV5::Email::Slot]
+        def initialize(mailbox: nil, **members)
+          super(**members)
+          @mailbox = mailbox
+        end
+
         # Check if this responder is currently active.
         # @return [Boolean] whether the responder is enabled,
         #   started in the past and ends in the future.
@@ -30,6 +41,36 @@ class GandiV5
             (starts_at.nil? || starts_at < Time.now) &&
             (ends_at.nil? || ends_at > Time.now)
         end
+
+        # Enable the auto responder in Gandi.
+        # @param message [String]
+        # @param starts_at [Time]
+        # @param ends_at [Time]
+        # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+        def enable(message:, ends_at:, starts_at: Time.now)
+          mailbox.update responder: {
+            message: message,
+            starts_at: GandiV5::Data::Converter::Time.to_gandi(starts_at),
+            ends_at: GandiV5::Data::Converter::Time.to_gandi(ends_at),
+            enabled: true
+          }
+
+          self.starts_at = starts_at
+          self.ends_at = ends_at
+          self.message = message
+          self.enabled = true
+        end
+
+        # Disable the auto responder in Gandi.
+        # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+        def disable
+          mailbox.update responder: { enabled: false }
+
+          self.starts_at = nil
+          self.ends_at = nil
+          self.message = nil
+          self.enabled = false
+        end
       end
     end
   end

data/lib/gandi_v5/email/mailbox.rb

@@ -44,33 +44,43 @@ class GandiV5
 
       alias mailbox_uuid uuid
 
+      # Create a new GandiV5::Email::Mailbox
+      # @param members [Hash<Symbol => Object>]
+      # @return [GandiV5::Email::Slot]
+      def initialize(**members)
+        super(**members)
+        responder.instance_exec(self) { |mb| @mailbox = mb } if responder?
+      end
+
       # Delete the mailbox and it's contents.
       # If you delete a mailbox for which you have purchased a slot,
       # this action frees the slot so it once again becomes available
       # for use with a new mailbox, or for deletion.
       # @see https://api.gandi.net/docs/email#delete-v5-email-mailboxes-domain-mailbox_id
       # @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 delete
-        data = GandiV5.delete url
+        _response, data = GandiV5.delete url
         data['message']
       end
 
       # Purge the contents of the mailbox.
       # @see https://api.gandi.net/docs/email#delete-v5-email-mailboxes-domain-mailbox_id-contents
       # @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 purge
-        data = GandiV5.delete "#{url}/contents"
+        _response, data = GandiV5.delete "#{url}/contents"
         data['message']
       end
 
       # Requery Gandi fo this mailbox's information.
       # @return [GandiV5::Email::Mailbox]
-      # @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
+        responder.instance_exec(self) { |mb| @mailbox = mb } if responder?
+        self
       end
 
       # Update the mailbox's settings.
@@ -81,8 +91,7 @@ class GandiV5
       # @param responder [Hash, GandiV5::Mailbox::Responder, #to_gandi, #to_h]
       #   auto responder settings.
       # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-      # rubocop:disable Metrics/AbcSize
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def update(**body)
         return 'Nothing to update.' if body.empty?
 
@@ -93,11 +102,10 @@ class GandiV5
           body[:responder] = responder.respond_to?(:to_gandi) ? responder.to_gandi : responder.to_h
         end
 
-        data = GandiV5.patch url, body.to_json
+        _response, data = GandiV5.patch url, body.to_json
         refresh
         data['message']
       end
-      # rubocop:enable Metrics/AbcSize
 
       # Create a new mailbox.
       # Note that before you can create a mailbox, you must have a slot available.
@@ -107,13 +115,16 @@ class GandiV5
       # @param password [String, #to_s] the password to use.
       # @param aliases [Array<String, #to_s>] any alternative email address to be used.
       # @param type [:standard, :premium] the type of mailbox slot to use.
-      # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-      # TODO: Fetch created mailbox
+      # @return [GandiV5::Email::Mailbox] The created mailbox.
+      # @raise [GandiV5::Error] if no slots are available.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def self.create(fqdn, login, password, aliases: [], type: :standard)
-        # TODO: Check type is valid
+        fail ArgumentError, "#{type.inspect} is not a valid type" unless TYPES.include?(type)
+        if GandiV5::Email::Slot.list.none? { |slot| slot.mailbox_type == type && slot.inactive? }
+          fail GandiV5::Error, "no available #{type} slots"
+        end
+
         check_password password
-        # TODO: Check if a slot is available
 
         body = {
           mailbox_type: type,
@@ -122,8 +133,8 @@ class GandiV5
           aliases: aliases.push
         }.to_json
 
-        data = GandiV5.post url(fqdn), body
-        data['message']
+        response, _data = GandiV5.post url(fqdn), body
+        fetch fqdn, response.headers[:location].split('/').last
       end
 
       # Get information for a mailbox.
@@ -131,9 +142,9 @@ class GandiV5
       # @param fqdn [String, #to_s] the fully qualified domain name for the mailbox.
       # @param uuid [String, #to_s] unique identifier of the mailbox.
       # @return [GandiV5::Email::Mailbox]
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def self.fetch(fqdn, uuid)
-        data = GandiV5.get url(fqdn, uuid)
+        _response, data = GandiV5.get url(fqdn, uuid)
         from_gandi data
       end
 
@@ -149,7 +160,7 @@ class GandiV5
       # @param login [String] (optional) filter the list by login (pattern)
       #   e.g. ("alice" "*lice", "alic*").
       # @return [Array<GandiV5::Email::Mailbox>]
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def self.list(fqdn, page: (1..), **params)
         page = [page.to_i] unless page.respond_to?(:each)
 
@@ -158,7 +169,7 @@ class GandiV5
 
         mailboxes = []
         page.each do |page_number|
-          data = GandiV5.get url(fqdn), params: params.merge(page: page_number)
+          _response, data = GandiV5.get url(fqdn), params: params.merge(page: page_number)
           break if data.empty?
 
           mailboxes += data.map { |mailbox| from_gandi mailbox }

data/lib/gandi_v5/email/offer.rb

@@ -17,9 +17,9 @@ class GandiV5
       # @see https://api.gandi.net/docs/email#get-v5-email-offers-domain
       # @param fqdn [String, #to_s] the fully qualified domain name to get the offer for.
       # @return [GandiV5::Email::Offer]
-      # @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 "#{BASE}email/offers/#{CGI.escape fqdn}"
+        _response, data = GandiV5.get "#{BASE}email/offers/#{CGI.escape fqdn}"
         from_gandi data
       end
     end

data/lib/gandi_v5/email/slot.rb

@@ -39,12 +39,12 @@ class GandiV5
       alias slot_id id
 
       # Create a new GandiV5::Email::Slot
-      # @param string [fqdn] the fully qualified domain this slot belongs to.
+      # @param fqdn [String] the fully qualified domain this slot belongs to.
       # @param members [Hash<Symbol => Object>]
       # @return [GandiV5::Email::Slot]
       def initialize(fqdn: nil, **members)
         super(**members)
-        @fqdn = fqdn if fqdn
+        @fqdn = fqdn
       end
 
       # Delete this slot if it is inactive and refundable.
@@ -53,20 +53,23 @@ class GandiV5
       # @see GandiV5::Email::Mailbox#delete
       # @see https://api.gandi.net/docs/email#delete-v5-email-slots-domain-slot_id
       # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-      # TODO: check for inactiveness
-      # TODO: check for refundableness
+      # @raise [GandiV5::Error] if slot is active.
+      # @raise [GandiV5::Error] if slot is not refundable.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def delete
-        data = GandiV5.delete url
+        fail GandiV5::Error, 'slot can\'t be deleted whilst active' if active?
+        fail GandiV5::Error, 'slot can\'t be deleted if it\'s not refundable' unless refundable
+
+        _response, data = GandiV5.delete url
         data['message']
       end
 
       # Requery Gandi for this slot's information.
       # @see https://api.gandi.net/docs/email#get-v5-email-slots-domain-slot_id
       # @return [GandiV5::Email::Slot]
-      # @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
       end
 
@@ -77,15 +80,14 @@ class GandiV5
       # @param fqdn [String, #to_s] the fully qualified domain name to add the slot to.
       # @param type [:standard, :premium] Tyhe type of slot to add.
       # @return [String] The confirmation message from Gandi.
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-      # TODO: Fetch created slot
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def self.create(fqdn, type = :standard)
         body = {
           mailbox_type: type
         }.to_json
 
-        data = GandiV5.post url(fqdn), body
-        data['message']
+        response, _data = GandiV5.post url(fqdn), body
+        fetch fqdn, response.headers[:location].split('/').last
       end
 
       # Get information for a slot.
@@ -93,9 +95,9 @@ class GandiV5
       # @param fqdn [String, #to_s] the fully qualified domain name the slot is on.
       # @param id [String, #to_s] the ID of the slot to fetch.
       # @return [GandiV5::Email::Slot]
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def self.fetch(fqdn, id)
-        data = GandiV5.get url(fqdn, id)
+        _response, data = GandiV5.get url(fqdn, id)
         slot = from_gandi data
         slot.instance_eval { @fqdn = fqdn }
         slot
@@ -105,9 +107,9 @@ class GandiV5
       # @see https://api.gandi.net/docs/email#
       # @param fqdn [String, #to_s] the fully qualified domain name to list slots for.
       # @return [Array<GandiV5::Email::Slot>]
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def self.list(fqdn)
-        data = GandiV5.get url(fqdn)
+        _response, data = GandiV5.get url(fqdn)
         data.map { |item| from_gandi item }
             .each { |item| item.instance_eval { @fqdn = fqdn } }
       end
@@ -118,6 +120,30 @@ class GandiV5
         status.eql?(:active)
       end
 
+      # Check if the slot is inactive (not in use)
+      # @return [Boolean]
+      def inactive?
+        status.eql?(:inactive)
+      end
+
+      # Check if the slot's mailbox_type is :free
+      # @return [Boolean]
+      def free?
+        mailbox_type.eql?(:free)
+      end
+
+      # Check if the slot's mailbox_type is :standard
+      # @return [Boolean]
+      def standard?
+        mailbox_type.eql?(:standard)
+      end
+
+      # Check if the slot's mailbox_type is :premium
+      # @return [Boolean]
+      def premium?
+        mailbox_type.eql?(:premium)
+      end
+
       private
 
       def url

data/lib/gandi_v5/error/gandi_error.rb

@@ -4,9 +4,9 @@ class GandiV5
   class Error < RuntimeError
     # Generic error class for errors returned by Gandi.
     class GandiError < GandiV5::Error
-      # Generate a new GandiV5::Error::GandiError::GandiError from the hash returned by Gandi.
+      # Generate a new GandiV5::Error::GandiError from the hash returned by Gandi.
       # @param hash [Hash] the hash returned by Gandi.
-      # @return [GandiV5::Error::GandiError::GandiError]
+      # @return [GandiV5::Error::GandiError]
       def self.from_hash(hash)
         hash['errors'] ||= []
 

data/lib/gandi_v5/live_dns/domain.rb

@@ -20,9 +20,9 @@ class GandiV5
 
       # Refetch the information for this domain from Gandi.
       # @return [GandiV5::LiveDNS::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
       end
 
@@ -36,7 +36,7 @@ class GandiV5
       #   @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::GandiError] if Gandi returns an error.
+      # @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
 
@@ -44,7 +44,7 @@ class GandiV5
         url_ += "/#{CGI.escape name}" if name
         url_ += "/#{CGI.escape type}" if type
 
-        data = GandiV5.get url_
+        _response, data = GandiV5.get url_
         data = [data] unless data.is_a?(Array)
         data.map { |item| GandiV5::LiveDNS::RecordSet.from_gandi item }
       end
@@ -59,7 +59,7 @@ class GandiV5
       #   @param name [String] the name to fetch records for.
       #   @param type [String] the record type to fetch.
       # @return [String]
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @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
 
@@ -67,7 +67,7 @@ class GandiV5
         url_ += "/#{CGI.escape name}" if name
         url_ += "/#{CGI.escape type}" if type
 
-        GandiV5.get url_, accept: 'text/plain'
+        GandiV5.get(url_, accept: 'text/plain').last
       end
 
       # Add record to this domain.
@@ -76,7 +76,7 @@ class GandiV5
       # @param ttl [Integer]
       # @param values [Array<String>]
       # @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 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?
@@ -88,7 +88,7 @@ class GandiV5
           rrset_ttl: ttl,
           rrset_values: values
         }.to_json
-        data = GandiV5.post "#{url}/records", body
+        _response, data = GandiV5.post "#{url}/records", body
         data['message']
       end
 
@@ -102,14 +102,14 @@ class GandiV5
       #   @param name [String] the name to delete records for.
       #   @param type [String] the record type to delete.
       # @return [nil]
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @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_
+        GandiV5.delete(url_).last
       end
 
       # Replace all records for this domain.
@@ -119,7 +119,7 @@ class GandiV5
       # @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::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def replace_records(records: nil, text: nil)
         unless [records, text].count(&:nil?).eql?(1)
           fail ArgumentError, 'you must pass ONE of records: or text:'
@@ -129,70 +129,84 @@ class GandiV5
           body = {
             items: records.map { |r| r.transform_keys { |k| "rrset_#{k}" } }
           }.to_json
-          data = GandiV5.put "#{url}/records", body
+          _response, data = GandiV5.put "#{url}/records", body
         elsif text
-          data = GandiV5.put "#{url}/records", text, 'content-type': 'text/plain'
+          _response, data = GandiV5.put "#{url}/records", text, 'content-type': 'text/plain'
         end
         data['message']
       end
 
-      # Replace records for a name in this domain.
-      # @param name [String]
-      # @param records
-      #   [Array<Hash<type: String, ttl: Integer, values: Array<String>>>]
-      #   the records to add.
+      # @override replace_records_for(name, records)
+      #   Replace records for a name in this domain.
+      #   @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 domain.
+      #   @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::GandiError] if Gandi returns an error.
-      def replace_records_for(name, *records)
-        body = {
-          items: records.map { |r| r.transform_keys { |k| "rrset_#{k}" } }
-        }.to_json
-        data = GandiV5.put "#{url}/records/#{name}", body
-        data['message']
-      end
+      # @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
 
-      GandiV5::LiveDNS::RECORD_TYPES.each do |type|
-        # Replace records of a given type for a name in this domain.
-        # TODO: @param name [Type] description.
-        # TODO: @param ttl [Type] description.
-        # TODO: documentation for *values
-        # @return [String] The confirmation message from Gandi.
-        # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
-        define_method "replace_#{type.downcase}_records_for" do |name, ttl, *values|
+        else
           body = {
-            rrset_ttl: ttl,
-            rrset_values: values
-          }.to_json
-          data = GandiV5.put "#{url}/records/#{name}/#{type}", body
-          data['message']
+            items: records.map { |r| r.transform_keys { |k| "rrset_#{k}" } }
+          }
+          _response, data = GandiV5.put "#{url}/records/#{name}", body.to_json
         end
+
+        data['message']
       end
 
       # Change the zone used by this domain.
       # @param uuid [String, #uuid, #to_s] the UUID of the zone this domain should now use.
       # @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 change_zone(uuid)
         uuid = uuid.uuid if uuid.respond_to?(:uuid)
-        data = GandiV5.patch url, { zone_uuid: uuid }.to_json
+        _response, data = GandiV5.patch url, { zone_uuid: uuid }.to_json
         self.zone_uuid = uuid
         data['message']
       end
 
+      # @see GandiV5::LiveDNS::Zone.fetch
+      def fetch_zone
+        GandiV5::LiveDNS::Zone.fetch zone_uuid
+      end
+
+      # The domain's zone (fetching from Gandi if required).
+      # @return [GandiV5::LiveDNS::Zone]
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+      def zone
+        @zone ||= fetch_zone
+      end
+
       # List the domains.
       # @return [Array<GandiV5::LiveDNS::Domain>]
-      # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+      # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
       def self.list
-        data = GandiV5.get url
+        _response, data = GandiV5.get url
         data.map { |item| from_gandi item }
       end
 
       # Get a domain.
       # @param fqdn [String, #to_s] the fully qualified domain name to fetch.
       # @return [GandiV5::LiveDNS::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)
         from_gandi data
       end
 

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

@@ -28,32 +28,51 @@ class GandiV5
 
         # Delete this snapshot.
         # @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 delete
-          data = GandiV5.delete url
+          _response, data = GandiV5.delete url
           data['message']
         end
 
+        # @see GandiV5::LiveDNS::Zone.fetch
+        def fetch_zone
+          GandiV5::LiveDNS::Zone.fetch zone_uuid
+        end
+
+        # The snapshot's zone (fetching from Gandi if required).
+        # @return [GandiV5::LiveDNS::Zone]
+        # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+        def zone
+          @zone ||= fetch_zone
+        end
+
+        # Get snapshot UUIDs for this zone from Gandi.
+        # @return [Hash{String => Time}] Mapping UUID to time made.
+        # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
+        def self.list(zone_uuid)
+          _response, data = GandiV5.get url(zone_uuid)
+          Hash[data.map { |snapshot| [snapshot['uuid'], Time.parse(snapshot['date_created'])] }]
+        end
+
         # Get snapshot from Gandi.
         # @param zone_uuid [String, #to_s] the UUID of the zone the snapshot was made of.
         # @param snapshot_uuid [String, #to_s] the UUID of the snapshot to fetch.
         # @return [GandiV5::LiveDNS::Zone::Snapshot]
-        # @raise [GandiV5::Error::GandiError::GandiError] if Gandi returns an error.
+        # @raise [GandiV5::Error::GandiError] if Gandi returns an error.
         def self.fetch(zone_uuid, snapshot_uuid)
-          data = GandiV5.get url(zone_uuid, snapshot_uuid)
+          _response, data = GandiV5.get url(zone_uuid, snapshot_uuid)
           from_gandi data
         end
 
-        # TODO: Move listing snapshots to here
-
         private
 
         def url
           "#{BASE}zones/#{CGI.escape zone_uuid}/snapshots/#{CGI.escape uuid}"
         end
 
-        def self.url(zone_uuid, snapshot_uuid)
-          "#{BASE}zones/#{CGI.escape zone_uuid}/snapshots/#{CGI.escape snapshot_uuid}"
+        def self.url(zone_uuid, snapshot_uuid = nil)
+          "#{BASE}zones/#{CGI.escape zone_uuid}/snapshots" +
+            (snapshot_uuid ? "/#{CGI.escape snapshot_uuid}" : '')
         end
         private_class_method :url
       end