Sha256: eb159fe3e62107a67a829dce57ec8e199cfa1f891c934095e3b8411458c228e7

Contents?: true

Size: 1.34 KB

Versions: 10

Compression:

Stored size: 1.34 KB

Contents

module Nanoc::Extra

  # Nanoc::Extra::VCS is a very simple representation of a version control
  # system that abstracts the add, remove and move operations. It does not
  # commit. This class is primarily used by data sources that store data as
  # flat files on the disk.
  #
  # This is the abstract superclass for all VCSes. Subclasses should implement
  # the indicated methods. 
  class VCS < Nanoc::Plugin

    # Adds the file with the given filename to the working copy.
    #
    # Subclasses must implement this method.
    def add(filename)
      not_implemented('add')
    end

    # Removes the file with the given filename from the working copy. When
    # this method is executed, the file should no longer be present on the
    # disk.
    #
    # Subclasses must implement this method.
    def remove(filename)
      not_implemented('remove')
    end

    # Moves the file with the given filename to a new location. When this
    # method is executed, the original file should no longer be present on the
    # disk.
    #
    # Subclasses must implement this method.
    def move(src, dst)
      not_implemented('move')
    end

  private

    def not_implemented(name)
      raise NotImplementedError.new(
        "#{self.class} does not override ##{name}, which is required for " +
        "this data source to be used."
      )
    end

  end

end

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
nanoc-2.1 lib/nanoc/extra/vcs.rb
nanoc-2.1.1 lib/nanoc/extra/vcs.rb
nanoc-2.1.2 lib/nanoc/extra/vcs.rb
nanoc-2.1.3 lib/nanoc/extra/vcs.rb
nanoc-2.1.4 lib/nanoc/extra/vcs.rb
nanoc-2.1.5 lib/nanoc/extra/vcs.rb
nanoc-2.1.6 lib/nanoc/extra/vcs.rb
nanoc-2.2 lib/nanoc/extra/vcs.rb
nanoc-2.2.1 lib/nanoc/extra/vcs.rb
nanoc-2.2.2 lib/nanoc/extra/vcs.rb