nanoc 4.11.0 → 4.11.1

data/lib/nanoc/base/entities/outdatedness_status.rb

@@ -1,25 +1,27 @@
 # frozen_string_literal: true
 
-module Nanoc::Int
-  # @api private
-  class OutdatednessStatus
-    attr_reader :reasons
-    attr_reader :props
+module Nanoc
+  module Int
+    # @api private
+    class OutdatednessStatus
+      attr_reader :reasons
+      attr_reader :props
 
-    def initialize(reasons: [], props: Props.new)
-      @reasons = reasons
-      @props = props
-    end
+      def initialize(reasons: [], props: Props.new)
+        @reasons = reasons
+        @props = props
+      end
 
-    def useful_to_apply?(rule)
-      (rule.affected_props - @props.active).any?
-    end
+      def useful_to_apply?(rule)
+        (rule.affected_props - @props.active).any?
+      end
 
-    def update(reason)
-      self.class.new(
-        reasons: @reasons + [reason],
-        props: @props.merge(reason.props),
-      )
+      def update(reason)
+        self.class.new(
+          reasons: @reasons + [reason],
+          props: @props.merge(reason.props),
+        )
+      end
     end
   end
 end

data/lib/nanoc/base/entities/props.rb

@@ -1,148 +1,150 @@
 # frozen_string_literal: true
 
-module Nanoc::Int
-  # @api private
-  class Props
-    include Nanoc::Int::ContractsSupport
-
-    attr_reader :attributes
-    attr_reader :raw_content
-
-    # TODO: Split raw_content for documents and collections
-    C_RAW_CONTENT = C::Or[C::IterOf[C::Or[String, Regexp]], C::Bool]
-    C_ATTRS = C::Or[C::IterOf[Symbol], C::Bool]
-    contract C::KeywordArgs[raw_content: C::Optional[C_RAW_CONTENT], attributes: C::Optional[C_ATTRS], compiled_content: C::Optional[C::Bool], path: C::Optional[C::Bool]] => C::Any
-    def initialize(raw_content: false, attributes: false, compiled_content: false, path: false)
-      @compiled_content = compiled_content
-      @path = path
-
-      @attributes =
-        case attributes
-        when Set
-          attributes
+module Nanoc
+  module Int
+    # @api private
+    class Props
+      include Nanoc::Core::ContractsSupport
+
+      attr_reader :attributes
+      attr_reader :raw_content
+
+      # TODO: Split raw_content for documents and collections
+      C_RAW_CONTENT = C::Or[C::IterOf[C::Or[String, Regexp]], C::Bool]
+      C_ATTRS = C::Or[C::IterOf[Symbol], C::Bool]
+      contract C::KeywordArgs[raw_content: C::Optional[C_RAW_CONTENT], attributes: C::Optional[C_ATTRS], compiled_content: C::Optional[C::Bool], path: C::Optional[C::Bool]] => C::Any
+      def initialize(raw_content: false, attributes: false, compiled_content: false, path: false)
+        @compiled_content = compiled_content
+        @path = path
+
+        @attributes =
+          case attributes
+          when Set
+            attributes
+          when Enumerable
+            Set.new(attributes)
+          else
+            attributes
+          end
+
+        @raw_content =
+          case raw_content
+          when Set
+            raw_content
+          when Enumerable
+            Set.new(raw_content)
+          else
+            raw_content
+          end
+      end
+
+      contract C::None => String
+      def inspect
+        (+'').tap do |s|
+          s << 'Props('
+          s << (raw_content? ? 'r' : '_')
+          s << (attributes? ? 'a' : '_')
+          s << (compiled_content? ? 'c' : '_')
+          s << (path? ? 'p' : '_')
+          s << ')'
+        end
+      end
+
+      contract C::None => String
+      def to_s
+        (+'').tap do |s|
+          s << (raw_content? ? 'r' : '_')
+          s << (attributes? ? 'a' : '_')
+          s << (compiled_content? ? 'c' : '_')
+          s << (path? ? 'p' : '_')
+        end
+      end
+
+      contract C::None => C::Bool
+      def raw_content?
+        case @raw_content
         when Enumerable
-          Set.new(attributes)
+          @raw_content.any?
         else
-          attributes
+          @raw_content
         end
+      end
 
-      @raw_content =
-        case raw_content
-        when Set
-          raw_content
+      contract C::None => C::Bool
+      def attributes?
+        case @attributes
         when Enumerable
-          Set.new(raw_content)
+          @attributes.any?
         else
-          raw_content
+          @attributes
         end
-    end
-
-    contract C::None => String
-    def inspect
-      (+'').tap do |s|
-        s << 'Props('
-        s << (raw_content? ? 'r' : '_')
-        s << (attributes? ? 'a' : '_')
-        s << (compiled_content? ? 'c' : '_')
-        s << (path? ? 'p' : '_')
-        s << ')'
       end
-    end
 
-    contract C::None => String
-    def to_s
-      (+'').tap do |s|
-        s << (raw_content? ? 'r' : '_')
-        s << (attributes? ? 'a' : '_')
-        s << (compiled_content? ? 'c' : '_')
-        s << (path? ? 'p' : '_')
+      contract C::None => C::Bool
+      def compiled_content?
+        @compiled_content
       end
-    end
 
-    contract C::None => C::Bool
-    def raw_content?
-      case @raw_content
-      when Enumerable
-        @raw_content.any?
-      else
-        @raw_content
+      contract C::None => C::Bool
+      def path?
+        @path
       end
-    end
 
-    contract C::None => C::Bool
-    def attributes?
-      case @attributes
-      when Enumerable
-        @attributes.any?
-      else
-        @attributes
+      contract Nanoc::Int::Props => Nanoc::Int::Props
+      def merge(other)
+        Props.new(
+          raw_content: merge_raw_content(other),
+          attributes: merge_attributes(other),
+          compiled_content: compiled_content? || other.compiled_content?,
+          path: path? || other.path?,
+        )
       end
-    end
 
-    contract C::None => C::Bool
-    def compiled_content?
-      @compiled_content
-    end
-
-    contract C::None => C::Bool
-    def path?
-      @path
-    end
-
-    contract Nanoc::Int::Props => Nanoc::Int::Props
-    def merge(other)
-      Props.new(
-        raw_content: merge_raw_content(other),
-        attributes: merge_attributes(other),
-        compiled_content: compiled_content? || other.compiled_content?,
-        path: path? || other.path?,
-      )
-    end
-
-    def merge_raw_content(other)
-      merge_prop(raw_content, other.raw_content)
-    end
+      def merge_raw_content(other)
+        merge_prop(raw_content, other.raw_content)
+      end
 
-    def merge_attributes(other)
-      merge_prop(attributes, other.attributes)
-    end
+      def merge_attributes(other)
+        merge_prop(attributes, other.attributes)
+      end
 
-    def merge_prop(own, other)
-      case own
-      when true
-        true
-      when false
-        other
-      else
-        case other
+      def merge_prop(own, other)
+        case own
         when true
           true
         when false
-          own
+          other
         else
-          own + other
+          case other
+          when true
+            true
+          when false
+            own
+          else
+            own + other
+          end
         end
       end
-    end
 
-    contract C::None => Set
-    def active
-      Set.new.tap do |pr|
-        pr << :raw_content if raw_content?
-        pr << :attributes if attributes?
-        pr << :compiled_content if compiled_content?
-        pr << :path if path?
+      contract C::None => Set
+      def active
+        Set.new.tap do |pr|
+          pr << :raw_content if raw_content?
+          pr << :attributes if attributes?
+          pr << :compiled_content if compiled_content?
+          pr << :path if path?
+        end
       end
-    end
 
-    contract C::None => Hash
-    def to_h
-      {
-        raw_content: raw_content,
-        attributes: attributes,
-        compiled_content: compiled_content?,
-        path: path?,
-      }
+      contract C::None => Hash
+      def to_h
+        {
+          raw_content: raw_content,
+          attributes: attributes,
+          compiled_content: compiled_content?,
+          path: path?,
+        }
+      end
     end
   end
 end

data/lib/nanoc/base/entities/site.rb

@@ -1,68 +1,64 @@
 # frozen_string_literal: true
 
-module Nanoc::Int
-  # @api private
-  class Site
-    include Nanoc::Int::ContractsSupport
+module Nanoc
+  module Int
+    # @api private
+    class Site
+      include Nanoc::Core::ContractsSupport
 
-    attr_reader :code_snippets
-    attr_reader :config
-    attr_accessor :data_source
+      attr_reader :code_snippets
+      attr_reader :config
+      attr_accessor :data_source
 
-    contract C::KeywordArgs[config: Nanoc::Int::Configuration, code_snippets: C::IterOf[Nanoc::Int::CodeSnippet], data_source: C::Named['Nanoc::DataSource']] => C::Any
-    def initialize(config:, code_snippets:, data_source:)
-      @config = config
-      @code_snippets = code_snippets
-      @data_source = data_source
+      contract C::KeywordArgs[config: Nanoc::Core::Configuration, code_snippets: C::IterOf[Nanoc::Core::CodeSnippet], data_source: C::Named['Nanoc::DataSource']] => C::Any
+      def initialize(config:, code_snippets:, data_source:)
+        @config = config
+        @code_snippets = code_snippets
+        @data_source = data_source
 
-      @preprocessed = false
+        @preprocessed = false
 
-      ensure_identifier_uniqueness(@data_source.items, 'item')
-      ensure_identifier_uniqueness(@data_source.layouts, 'layout')
-    end
+        ensure_identifier_uniqueness(@data_source.items, 'item')
+        ensure_identifier_uniqueness(@data_source.layouts, 'layout')
+      end
 
-    contract C::None => self
-    def compile
-      Nanoc::Int::Compiler.new_for(self).run_until_end
-      self
-    end
+      def mark_as_preprocessed
+        @preprocessed = true
+      end
 
-    def mark_as_preprocessed
-      @preprocessed = true
-    end
+      def preprocessed?
+        @preprocessed
+      end
 
-    def preprocessed?
-      @preprocessed
-    end
+      def items
+        @data_source.items
+      end
 
-    def items
-      @data_source.items
-    end
+      def layouts
+        @data_source.layouts
+      end
 
-    def layouts
-      @data_source.layouts
-    end
+      contract C::None => self
+      def freeze
+        config.freeze
+        items.freeze
+        layouts.freeze
+        code_snippets.__nanoc_freeze_recursively
+        self
+      end
 
-    contract C::None => self
-    def freeze
-      config.freeze
-      items.freeze
-      layouts.freeze
-      code_snippets.__nanoc_freeze_recursively
-      self
-    end
+      contract C::IterOf[C::Or[Nanoc::Core::Item, Nanoc::Core::Layout]], String => self
+      def ensure_identifier_uniqueness(objects, type)
+        seen = Set.new
+        objects.each do |obj|
+          if seen.include?(obj.identifier)
+            raise Nanoc::Int::Errors::DuplicateIdentifier.new(obj.identifier, type)
+          end
 
-    contract C::IterOf[C::Or[Nanoc::Int::Item, Nanoc::Int::Layout]], String => self
-    def ensure_identifier_uniqueness(objects, type)
-      seen = Set.new
-      objects.each do |obj|
-        if seen.include?(obj.identifier)
-          raise Nanoc::Int::Errors::DuplicateIdentifier.new(obj.identifier, type)
+          seen << obj.identifier
         end
-
-        seen << obj.identifier
+        self
       end
-      self
     end
   end
 end

data/lib/nanoc/base/errors.rb

@@ -1,248 +1,233 @@
 # frozen_string_literal: true
 
-module Nanoc::Int
-  # Module that contains all Nanoc-specific errors.
-  #
-  # @api private
-  module Errors
-    Generic = ::Nanoc::Error
-
-    # Generic trivial error. Superclass for all Nanoc-specific errors that are
-    # considered "trivial", i.e. errors that do not require a full crash report.
-    class GenericTrivial < Generic
-    end
-
-    # Error that is raised when compilation of an item rep fails. The
-    # underlying error is available by calling `#unwrap`.
-    class CompilationError < Generic
-      attr_reader :item_rep
+module Nanoc
+  module Int
+    # Module that contains all Nanoc-specific errors.
+    #
+    # @api private
+    module Errors
+      Generic = ::Nanoc::Error
+
+      # Generic trivial error. Superclass for all Nanoc-specific errors that are
+      # considered "trivial", i.e. errors that do not require a full crash report.
+      class GenericTrivial < Generic
+      end
+
+      # Error that is raised when compilation of an item rep fails. The
+      # underlying error is available by calling `#unwrap`.
+      class CompilationError < Generic
+        attr_reader :item_rep
+
+        def initialize(wrapped, item_rep)
+          @wrapped = wrapped
+          @item_rep = item_rep
+        end
 
-      def initialize(wrapped, item_rep)
-        @wrapped = wrapped
-        @item_rep = item_rep
+        def unwrap
+          @wrapped
+        end
       end
 
-      def unwrap
-        @wrapped
+      # Error that is raised when a site is loaded that uses a data source with
+      # an unknown identifier.
+      class UnknownDataSource < Generic
+        # @param [String] data_source_name The data source name for which no
+        #   data source could be found
+        def initialize(data_source_name)
+          super("The data source specified in the site’s configuration file, “#{data_source_name}”, does not exist.")
+        end
       end
-    end
 
-    # Error that is raised when a site is loaded that uses a data source with
-    # an unknown identifier.
-    class UnknownDataSource < Generic
-      # @param [String] data_source_name The data source name for which no
-      #   data source could be found
-      def initialize(data_source_name)
-        super("The data source specified in the site’s configuration file, “#{data_source_name}”, does not exist.")
+      # Error that is raised during site compilation when an item uses a layout
+      # that is not present in the site.
+      class UnknownLayout < Generic
+        # @param [String] layout_identifier The layout identifier for which no
+        #   layout could be found
+        def initialize(layout_identifier)
+          super("The site does not have a layout with identifier “#{layout_identifier}”.")
+        end
       end
-    end
 
-    # Error that is raised during site compilation when an item uses a layout
-    # that is not present in the site.
-    class UnknownLayout < Generic
-      # @param [String] layout_identifier The layout identifier for which no
-      #   layout could be found
-      def initialize(layout_identifier)
-        super("The site does not have a layout with identifier “#{layout_identifier}”.")
+      # Error that is raised during site compilation when a layout is compiled
+      # for which the filter cannot be determined. This is similar to the
+      # {UnknownFilter} error, but specific for filters for layouts.
+      class CannotDetermineFilter < Generic
+        # @param [String] layout_identifier The identifier of the layout for
+        #   which the filter could not be determined
+        def initialize(layout_identifier)
+          super("The filter to be used for the “#{layout_identifier}” layout could not be determined. Make sure the layout does have a filter.")
+        end
       end
-    end
 
-    # Error that is raised during site compilation when an item uses a filter
-    # that is not known.
-    class UnknownFilter < Generic
-      # @param [Symbol] filter_name The filter name for which no filter could
-      #   be found
-      def initialize(filter_name)
-        super("The requested filter, “#{filter_name}”, does not exist.")
-      end
-    end
+      # Error that is raised during site compilation when an item (directly or
+      # indirectly) includes its own item content, leading to endless recursion.
+      class DependencyCycle < Generic
+        def initialize(stack)
+          start_idx = stack.index(stack.last)
+          cycle = stack[start_idx..-2]
 
-    # Error that is raised during site compilation when a layout is compiled
-    # for which the filter cannot be determined. This is similar to the
-    # {UnknownFilter} error, but specific for filters for layouts.
-    class CannotDetermineFilter < Generic
-      # @param [String] layout_identifier The identifier of the layout for
-      #   which the filter could not be determined
-      def initialize(layout_identifier)
-        super("The filter to be used for the “#{layout_identifier}” layout could not be determined. Make sure the layout does have a filter.")
-      end
-    end
-
-    # Error that is raised during site compilation when an item (directly or
-    # indirectly) includes its own item content, leading to endless recursion.
-    class DependencyCycle < Generic
-      def initialize(stack)
-        start_idx = stack.index(stack.last)
-        cycle = stack[start_idx..-2]
+          msg_bits = []
+          msg_bits << 'The site cannot be compiled because there is a dependency cycle:'
+          msg_bits << ''
+          cycle.each.with_index do |r, i|
+            msg_bits << "    (#{i + 1}) item #{r.item.identifier}, rep #{r.name.inspect}, uses compiled content of"
+          end
+          msg_bits << msg_bits.pop + ' (1)'
 
-        msg_bits = []
-        msg_bits << 'The site cannot be compiled because there is a dependency cycle:'
-        msg_bits << ''
-        cycle.each.with_index do |r, i|
-          msg_bits << "    (#{i + 1}) item #{r.item.identifier}, rep #{r.name.inspect}, uses compiled content of"
+          super(msg_bits.map { |x| x + "\n" }.join(''))
         end
-        msg_bits << msg_bits.pop + ' (1)'
-
-        super(msg_bits.map { |x| x + "\n" }.join(''))
       end
-    end
 
-    # Error that is raised when no rules file can be found in the current
-    # working directory.
-    class NoRulesFileFound < Generic
-      def initialize
-        super('This site does not have a rules file, which is required for Nanoc sites.')
+      # Error that is raised when no rules file can be found in the current
+      # working directory.
+      class NoRulesFileFound < Generic
+        def initialize
+          super('This site does not have a rules file, which is required for Nanoc sites.')
+        end
       end
-    end
 
-    # Error that is raised when no compilation rule that can be applied to the
-    # current item can be found.
-    class NoMatchingCompilationRuleFound < Generic
-      # @param [Nanoc::Int::Item] item The item for which no compilation rule
-      #   could be found
-      def initialize(item)
-        super("No compilation rules were found for the “#{item.identifier}” item.")
+      # Error that is raised when no compilation rule that can be applied to the
+      # current item can be found.
+      class NoMatchingCompilationRuleFound < Generic
+        # @param [Nanoc::Core::Item] item The item for which no compilation rule
+        #   could be found
+        def initialize(item)
+          super("No compilation rules were found for the “#{item.identifier}” item.")
+        end
       end
-    end
 
-    # Error that is raised when no routing rule that can be applied to the
-    # current item can be found.
-    class NoMatchingRoutingRuleFound < Generic
-      # @param [Nanoc::Int::ItemRep] rep The item repiresentation for which no
-      #   routing rule could be found
-      def initialize(rep)
-        super("No routing rules were found for the “#{rep.item.identifier}” item (rep “#{rep.name}”).")
+      # Error that is raised when no routing rule that can be applied to the
+      # current item can be found.
+      class NoMatchingRoutingRuleFound < Generic
+        # @param [Nanoc::Core::ItemRep] rep The item repiresentation for which no
+        #   routing rule could be found
+        def initialize(rep)
+          super("No routing rules were found for the “#{rep.item.identifier}” item (rep “#{rep.name}”).")
+        end
       end
-    end
 
-    # Error that is raised when an rep cannot be compiled because it depends
-    # on other representations.
-    class UnmetDependency < Generic
-      # @return [Nanoc::Int::ItemRep] The item representation that cannot yet be
-      #   compiled
-      attr_reader :rep
+      # Error that is raised when an rep cannot be compiled because it depends
+      # on other representations.
+      class UnmetDependency < Generic
+        # @return [Nanoc::Core::ItemRep] The item representation that cannot yet be
+        #   compiled
+        attr_reader :rep
 
-      # @param [Nanoc::Int::ItemRep] rep The item representation that cannot yet be
-      #   compiled
-      def initialize(rep)
-        @rep = rep
-        super("The current item cannot be compiled yet because of an unmet dependency on the “#{rep.item.identifier}” item (rep “#{rep.name}”).")
-      end
-    end
+        # @return [Symbol] The name of the snapshot that cannot yet be compiled
+        attr_reader :snapshot_name
 
-    # Error that is raised when a binary item is attempted to be laid out.
-    class CannotLayoutBinaryItem < Generic
-      # @param [Nanoc::Int::ItemRep] rep The item representation that was attempted
-      #   to be laid out
-      def initialize(rep)
-        super("The “#{rep.item.identifier}” item (rep “#{rep.name}”) cannot be laid out because it is a binary item. If you are getting this error for an item that should be textual instead of binary, make sure that its extension is included in the text_extensions array in the site configuration.")
-      end
-    end
+        # @param [Nanoc::Core::ItemRep] rep The item representation that cannot yet be
+        #   compiled
+        def initialize(rep, snapshot_name)
+          @rep = rep
+          @snapshot_name = snapshot_name
 
-    # Error that is raised when a textual filter is attempted to be applied to
-    # a binary item representation.
-    class CannotUseTextualFilter < Generic
-      # @param [Nanoc::Int::ItemRep] rep The item representation that was
-      #   attempted to be filtered
-      #
-      # @param [Class] filter_class The filter class that was used
-      def initialize(rep, filter_class)
-        super("The “#{filter_class.inspect}” filter cannot be used to filter the “#{rep.item.identifier}” item (rep “#{rep.name}”), because textual filters cannot be used on binary items.")
+          super("The current item cannot be compiled yet because of an unmet dependency on the “#{rep.item.identifier}” item (rep “#{rep.name}”, snapshot “#{snapshot_name}”).")
+        end
       end
-    end
 
-    # Error that is raised when a binary filter is attempted to be applied to
-    # a textual item representation.
-    class CannotUseBinaryFilter < Generic
-      # @param [Nanoc::Int::ItemRep] rep The item representation that was
-      #   attempted to be filtered
-      #
-      # @param [Class] filter_class The filter class that was used
-      def initialize(rep, filter_class)
-        super("The “#{filter_class.inspect}” filter cannot be used to filter the “#{rep.item.identifier}” item (rep “#{rep.name}”), because binary filters cannot be used on textual items. If you are getting this error for an item that should be textual instead of binary, make sure that its extension is included in the text_extensions array in the site configuration.")
+      # Error that is raised when a binary item is attempted to be laid out.
+      class CannotLayoutBinaryItem < Generic
+        # @param [Nanoc::Core::ItemRep] rep The item representation that was attempted
+        #   to be laid out
+        def initialize(rep)
+          super("The “#{rep.item.identifier}” item (rep “#{rep.name}”) cannot be laid out because it is a binary item. If you are getting this error for an item that should be textual instead of binary, make sure that its extension is included in the text_extensions array in the site configuration.")
+        end
       end
-    end
 
-    # Error that is raised when the compiled content at a non-existing snapshot
-    # is requested.
-    class NoSuchSnapshot < Generic
-      # @return [Nanoc::Int::ItemRep] The item rep from which the compiled content
-      #   was requested
-      attr_reader :item_rep
-
-      # @return [Symbol] The requested snapshot
-      attr_reader :snapshot
-
-      # @param [Nanoc::Int::ItemRep] item_rep The item rep from which the compiled
-      #   content was requested
-      #
-      # @param [Symbol] snapshot The requested snapshot
-      def initialize(item_rep, snapshot)
-        @item_rep = item_rep
-        @snapshot = snapshot
-        super("The “#{item_rep.inspect}” item rep does not have a snapshot “#{snapshot.inspect}”")
+      # Error that is raised when a textual filter is attempted to be applied to
+      # a binary item representation.
+      class CannotUseTextualFilter < Generic
+        # @param [Nanoc::Core::ItemRep] rep The item representation that was
+        #   attempted to be filtered
+        #
+        # @param [Class] filter_class The filter class that was used
+        def initialize(rep, filter_class)
+          super("The “#{filter_class.inspect}” filter cannot be used to filter the “#{rep.item.identifier}” item (rep “#{rep.name}”), because textual filters cannot be used on binary items.")
+        end
       end
-    end
 
-    # Error that is raised when a snapshot with an existing name is made.
-    class CannotCreateMultipleSnapshotsWithSameName < Generic
-      # @param [Nanoc::Int::ItemRep] rep The item representation for which a
-      #   snapshot was attempted to be made
-      #
-      # @param [Symbol] snapshot The name of the snapshot that was attempted to
-      #   be made
-      def initialize(rep, snapshot)
-        super("Attempted to create a snapshot with a duplicate name #{snapshot.inspect} for the item rep #{rep}")
+      # Error that is raised when a binary filter is attempted to be applied to
+      # a textual item representation.
+      class CannotUseBinaryFilter < Generic
+        # @param [Nanoc::Core::ItemRep] rep The item representation that was
+        #   attempted to be filtered
+        #
+        # @param [Class] filter_class The filter class that was used
+        def initialize(rep, filter_class)
+          super("The “#{filter_class.inspect}” filter cannot be used to filter the “#{rep.item.identifier}” item (rep “#{rep.name}”), because binary filters cannot be used on textual items. If you are getting this error for an item that should be textual instead of binary, make sure that its extension is included in the text_extensions array in the site configuration.")
+        end
       end
-    end
 
-    # Error that is raised when the compiled content of a binary item is attempted to be accessed.
-    class CannotGetCompiledContentOfBinaryItem < Generic
-      # @param [Nanoc::Int::ItemRep] rep The binary item representation whose compiled content was attempted to be accessed
-      def initialize(rep)
-        super("You cannot access the compiled content of a binary item representation (but you can access the path). The offending item rep is #{rep}.")
+      # Error that is raised when the compiled content at a non-existing snapshot
+      # is requested.
+      class NoSuchSnapshot < Generic
+        # @return [Nanoc::Core::ItemRep] The item rep from which the compiled content
+        #   was requested
+        attr_reader :item_rep
+
+        # @return [Symbol] The requested snapshot
+        attr_reader :snapshot
+
+        # @param [Nanoc::Core::ItemRep] item_rep The item rep from which the compiled
+        #   content was requested
+        #
+        # @param [Symbol] snapshot The requested snapshot
+        def initialize(item_rep, snapshot)
+          @item_rep = item_rep
+          @snapshot = snapshot
+          super("The “#{item_rep.inspect}” item rep does not have a snapshot “#{snapshot.inspect}”")
+        end
       end
-    end
 
-    # Error that is raised when multiple items or layouts with the same identifier exist.
-    class DuplicateIdentifier < Generic
-      def initialize(identifier, type)
-        super("There are multiple #{type}s with the #{identifier} identifier.")
+      # Error that is raised when a snapshot with an existing name is made.
+      class CannotCreateMultipleSnapshotsWithSameName < Generic
+        # @param [Nanoc::Core::ItemRep] rep The item representation for which a
+        #   snapshot was attempted to be made
+        #
+        # @param [Symbol] snapshot The name of the snapshot that was attempted to
+        #   be made
+        def initialize(rep, snapshot)
+          super("Attempted to create a snapshot with a duplicate name #{snapshot.inspect} for the item rep #{rep}")
+        end
       end
-    end
 
-    # Error that is raised when attempting to call #parent or #children on an item with a legacy identifier.
-    class CannotGetParentOrChildrenOfNonLegacyItem < Generic
-      def initialize(identifier)
-        super("You cannot get the parent or children of an item that has a “full” identifier (#{identifier}). Getting the parent or children of an item is only possible for items that have a legacy identifier.")
+      # Error that is raised when the compiled content of a binary item is attempted to be accessed.
+      class CannotGetCompiledContentOfBinaryItem < Generic
+        # @param [Nanoc::Core::ItemRep] rep The binary item representation whose compiled content was attempted to be accessed
+        def initialize(rep)
+          super("You cannot access the compiled content of a binary item representation (but you can access the path). The offending item rep is #{rep}.")
+        end
       end
-    end
 
-    class UndefinedFilterForLayout < Generic
-      def initialize(layout)
-        super("There is no filter defined for the layout #{layout.identifier}")
+      # Error that is raised when multiple items or layouts with the same identifier exist.
+      class DuplicateIdentifier < Generic
+        def initialize(identifier, type)
+          super("There are multiple #{type}s with the #{identifier} identifier.")
+        end
       end
-    end
 
-    class OutputNotWritten < Generic
-      def initialize(filter_name, output_filename)
-        super("The #{filter_name.inspect} filter did not write anything to the required output file, #{output_filename}.")
+      # Error that is raised when attempting to call #parent or #children on an item with a legacy identifier.
+      class CannotGetParentOrChildrenOfNonLegacyItem < Generic
+        def initialize(identifier)
+          super("You cannot get the parent or children of an item that has a “full” identifier (#{identifier}). Getting the parent or children of an item is only possible for items that have a legacy identifier.")
+        end
       end
-    end
 
-    class FilterReturnedNil < Generic
-      def initialize(filter_name)
-        super("The #{filter_name.inspect} filter returned nil, but is required to return a String.")
+      class UndefinedFilterForLayout < Generic
+        def initialize(layout)
+          super("There is no filter defined for the layout #{layout.identifier}")
+        end
       end
-    end
 
-    class AmbiguousMetadataAssociation < Generic
-      def initialize(content_filenames, meta_filename)
-        super("There are multiple content files (#{content_filenames.join(', ')}) that could match the file containing metadata (#{meta_filename}).")
+      class AmbiguousMetadataAssociation < Generic
+        def initialize(content_filenames, meta_filename)
+          super("There are multiple content files (#{content_filenames.sort.join(', ')}) that could match the file containing metadata (#{meta_filename}).")
+        end
       end
-    end
 
-    class InternalInconsistency < Generic
+      class InternalInconsistency < Generic
+      end
     end
   end
 end