vagrant-dnsdock-hostupdater 0.0.24 → 0.0.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a0dced9da0ff736e5641dd7d6e5e0154f9db87a4
-  data.tar.gz: ab09fc9827e6618275ca8eb3d86fc8d0f6c0afa6
+  metadata.gz: ada68a3e31b09151f2826aaad5a5faa817738fa1
+  data.tar.gz: 9a58213c4d6542524501de34ae33607790f91ffc
 SHA512:
-  metadata.gz: 8c9a89a41498583338779437ed08ca5b08a3fc313b20ae7f2f75194b8fdbd4a6b4c030de210b76eac59c93c1829b49f2b1dc2872fb31669ef46737bead77e954
-  data.tar.gz: b8fac1c93d16df2f9f056ae1c990fb364156e339599fc7c00b49fc3e45269fe62f6246cba578af698cdfd29e9d120dc343bcf209307fca7d476ebbd9f6e2b407
+  metadata.gz: ae27144af3b31d9dd6d3b137344e221c344e221c91daeeeaf0b4e2198ff690c496b75ff5027b661ec19cafda97ae85fa0bdf390b23c280c050395166c7ce4495
+  data.tar.gz: 656747b8e6040cde091d960994b155e6d7f2cfd9f8bb3e6cf2acba411a69397f11cee864ebe6a8c1ca977635a5b62b275c0943bb7ff32b328f2a293e8614db2a

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    vagrant-dnsdock-hostupdater (0.0.24)
+    vagrant-dnsdock-hostupdater (0.0.25)
       docker-api (~> 1.33)
       linebreak (~> 2.1.0)
       log4r (~> 1.1.10)

data/lib/hosts/aef/hosts.rb

@@ -0,0 +1,51 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'set'
+require 'pathname'
+require_relative 'linebreak/linebreak'
+
+# Namespace for projects of Alexander E. Fischer <aef@raxys.net>.
+#
+# If you want to be able to simply type Example instead of Aef::Example to
+# address classes in this namespace simply write the following before using the
+# classes.
+#
+# @example Including the namespace
+#   include Aef
+# @author Alexander E. Fischer
+module Aef
+
+  # Namespace for the hosts library
+  module Hosts
+
+    # An exception for errors happening while parsing a hosts file
+    class ParserError < RuntimeError; end
+  end
+end
+
+require_relative 'hosts/version'
+require_relative 'hosts/helpers'
+require_relative 'hosts/file'
+require_relative 'hosts/element'
+require_relative 'hosts/section'
+require_relative 'hosts/entry'
+require_relative 'hosts/comment'
+require_relative 'hosts/empty_element'
+

data/lib/hosts/aef/hosts/comment.rb

@@ -0,0 +1,73 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative '../hosts'
+
+module Aef
+  module Hosts
+
+    # Represents a comment-only line as element of a hosts file
+    class Comment < Element
+      
+      # The comment
+      #
+      # @return [String]
+      attr_reader :comment
+
+      # Initializes a comment
+      #
+      # @param comment [String] the comment
+      # @param options [Hash]
+      # @option options [String] :cache sets a cached String representation
+      def initialize(comment, options = {})
+        validate_options(options, :cache)
+        
+        raise ArgumentError, 'Comment cannot be empty' unless comment
+
+        @comment = comment.to_s
+        @cache   = options[:cache].to_s unless options[:cache].nil?
+      end
+
+      # Sets the comment
+      def comment=(comment)
+        set_if_changed(:comment, comment.to_s) do
+          invalidate_cache!
+        end
+      end
+
+      # A String representation for debugging purposes
+      #
+      # @return [String]
+      def inspect
+        generate_inspect(self, :comment, :cache)
+      end
+
+      protected
+
+      # Defines the algorithm to generate a String representation from scratch.
+      #
+      # @return [String] a generated String representation
+      def generate_string(options = {})
+        "##{comment}\n"
+      end
+    end
+
+  end
+end
+

data/lib/hosts/aef/hosts/element.rb

@@ -0,0 +1,108 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative '../hosts'
+
+module Aef
+  module Hosts
+
+    # The base class for elements which are aggregated by the Aef::Hosts::File
+    # class.
+    #
+    # @abstract This class is not supposed to be instantiated.
+    class Element
+
+      include Helpers
+
+      # Cached String representation
+      #
+      # @return [String, Hash, nil]
+      attr_reader :cache
+
+      # Deletes the cached String representation
+      #
+      # @return [Aef::Hosts::Element] a self reference
+      def invalidate_cache!
+        @cache = nil
+
+        self
+      end
+
+      # Tells if a String representation is cached or not
+      #
+      # @return [true, false] true if cache is not empty
+      def cache_filled?
+        @cache ? true : false
+      end
+
+      # A String representation for debugging purposes
+      #
+      # @return [String]
+      def inspect
+        generate_inspect(self, :cache)
+      end
+
+      # Provides a String representation of the element
+      #
+      # @param [Hash] options
+      # @option options [true, false] :force_generation if set to true, the
+      #   cache won't be used, even if it not empty
+      # @option options [:unix, :windows, :mac] :linebreak_encoding the
+      #   linebreak encoding of the result. If nothing is specified the result
+      #   will be encoded as if :unix was specified.
+      # @see Aef::Linebreak#encode
+      def to_s(options = {})
+        validate_options(options, :force_generation, :linebreak_encoding)
+
+        string = ''
+
+        if !cache_filled? || options[:force_generation]
+          string << generate_string(options)
+        else
+          string << cache_string(options)
+        end
+
+        if options[:linebreak_encoding]
+          string = Aef::Linebreak.encode(string, options[:linebreak_encoding])
+        end
+
+        string
+      end
+
+      protected
+
+      # Defines the algorithm to generate a String representation from scratch.
+      #
+      # @abstract This method needs to be implemented in descendant classes.
+      # @return [String] a generated String representation
+      def generate_string(options = {})
+        raise NotImplementedError
+      end
+
+      # Defines the algorithm to construct the String representation from cache
+      #
+      # @return [String] the cached String representation
+      def cache_string(options = {})
+        @cache.dup
+      end
+    end
+
+  end
+end
+

data/lib/hosts/aef/hosts/empty_element.rb

@@ -0,0 +1,50 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative '../hosts'
+
+module Aef
+  module Hosts
+
+    # Represents an empty line as element of a hosts file
+    class EmptyElement < Element
+
+      # Initializes an empty Element
+      #
+      # @param [Hash] options
+      # @option options [String] :cache sets a cached String representation
+      def initialize(options = {})
+        validate_options(options, :cache)
+
+        @cache = options[:cache].to_s unless options[:cache].nil?
+      end
+
+      protected
+
+      # Defines the algorithm to generate a String representation from scratch.
+      #
+      # @return [String] a generated String representation
+      def generate_string(options = {})
+        "\n"
+      end
+
+    end
+  end
+end
+

data/lib/hosts/aef/hosts/entry.rb

@@ -0,0 +1,123 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative '../hosts'
+
+module Aef
+  module Hosts
+
+    # Represents an entry line as element of a hosts file
+    class Entry < Element
+      
+      # The network address
+      #
+      # @return [String]
+      attr_reader :address
+
+      # The primary hostname for the address
+      #
+      # @return [String]
+      attr_reader :name
+
+      # Optional comment
+      #
+      # @return [String]
+      attr_reader :comment
+
+      # Optional alias hostnames
+      #
+      # @return [Array<String>]
+      attr_reader :aliases
+
+      # Initializes an entry.
+      #
+      # @param [String] address the network address
+      # @param [String] name the primary hostname for the address
+      # @param [Hash] options
+      # @option options [Array<String>] :aliases a list of aliases for the
+      #   address
+      # @option options [String] :comment a comment for the entry
+      # @option options [String] :cache a cached String representation
+      def initialize(address, name, options = {})
+        validate_options(options, :aliases, :comment, :cache)
+
+        raise ArgumentError, 'Address cannot be empty' unless address
+        raise ArgumentError, 'Name cannot be empty' unless name
+
+        @address = address.to_s
+        @name    = name.to_s
+        @aliases = options[:aliases] || []
+        @comment = options[:comment].to_s unless options[:comment].nil?
+        @cache   = options[:cache].to_s unless options[:cache].nil?
+      end
+
+      # Sets the network address
+      def address=(address)
+        set_if_changed(:address, address.to_s) do
+          invalidate_cache!
+        end
+      end
+
+      # Sets the primary hostname for the address
+      def name=(name)
+        set_if_changed(:name, name.to_s) do
+          invalidate_cache!
+        end
+      end
+
+      # Sets the optional comment
+      def comment=(comment)
+        set_if_changed(:comment, comment.to_s) do
+          invalidate_cache!
+        end
+      end
+
+      # Sets the optional alias hostnames
+      def aliases=(aliases)
+        set_if_changed(:aliases, [*aliases]) do
+          invalidate_cache!
+        end
+      end
+
+      # A String representation for debugging purposes
+      #
+      # @return [String]
+      def inspect
+        generate_inspect(self, :address, :name, :aliases, :comment, :cache)
+      end
+
+      protected
+
+      # Defines the algorithm to generate a String representation from scratch.
+      #
+      # @abstract This method needs to be implemented in descendant classes.
+      # @return [String] a generated String representation
+      def generate_string(options = nil)
+        if comment
+          suffix = " ##{comment}\n"
+        else
+          suffix = "\n"
+        end
+
+        [address, name, *aliases].join(' ') << suffix
+      end
+
+    end
+  end
+end

data/lib/hosts/aef/hosts/file.rb

@@ -0,0 +1,252 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative '../hosts'
+
+module Aef
+  module Hosts
+
+    # This class represents a hosts file and aggregates its elements.
+    #
+    # It is able to parse host files from file-system or String and can
+    # generate a String representation of itself to String or file-system.
+    class File
+
+      include Helpers
+
+      # Regular expression to extract a comment line.
+      #
+      # @private
+      COMMENT_LINE_PATTERN   = /^\s*#(.*)$/
+
+      # Regular expression to extract section headers and footers.
+      #
+      # @private
+      SECTION_MARKER_PATTERN = /^ -----(BEGIN|END) SECTION (.*)-----(?:[\r])?$/
+
+      # Regular expression to extract entry lines.
+      #
+      # @private
+      ENTRY_LINE_PATTERN     = /^([^#]*)(?:#(.*))?$/
+
+      # The hosts file's elements.
+      #
+      # @return [Array<Aef::Hosts::Element>]
+      attr_accessor :elements
+
+      # The filesystem path of the hosts file.
+      #
+      # @return [Pathname, nil]
+      attr_reader :path
+
+      class << self
+        # Parses a hosts file given as path.
+        #
+        # @param [Pathname] path the hosts file path
+        # @return [Aef::Hosts::File] a file
+        def read(path)
+          new(path).read
+        end
+
+        # Parses a hosts file given as String.
+        #
+        # @param [String] data a String representation of the hosts file
+        # @return [Aef::Hosts::File] a file
+        def parse(data)
+          new.parse(data)
+        end
+      end
+
+      # Initializes a file.
+      #
+      # @param [Pathname] path path to the hosts file
+      def initialize(path = nil)
+        reset
+        self.path = path
+      end
+
+      # Removes all elements.
+      #
+      # @return [Aef::Hosts::File] a self reference
+      def reset
+        @elements = []
+
+        self
+      end
+
+      # Deletes the cached String representations of all elements.
+      #
+      # @return [Aef::Hosts::File] a self reference
+      def invalidate_cache!
+        elements.each do |element|
+          element.invalidate_cache!
+        end
+
+        self
+      end
+
+      # Sets the filesystem path of the hosts file.
+      def path=(path)
+        @path = to_pathname(path)
+      end
+
+      # Parses a hosts file given as path.
+      #
+      # @param [Pathname] path override the path attribute for this operation
+      # @return [Aef::Hosts::File] a self reference
+      def read(path = nil)
+        path = path.nil? ? @path : to_pathname(path)
+
+        raise ArgumentError, 'No path given' unless path
+
+        parse(path.read)
+
+        self
+      end
+
+      # Parses a hosts file given as String.
+      #
+      # @param [String] data a String representation of the hosts file
+      # @return [Aef::Hosts::File] a self reference
+      def parse(data)
+        current_section = self
+
+        data.to_s.lines.each_with_index do |line, line_number|
+          line = Linebreak.encode(line, :unix)
+
+          if COMMENT_LINE_PATTERN =~ line
+            comment = $1
+
+            if SECTION_MARKER_PATTERN =~ comment
+              type = $1
+              name = $2
+
+              case type
+              when 'BEGIN'
+                unless current_section.is_a?(Section)
+                  current_section = Section.new(
+                    name,
+                    :cache => {:header => line, :footer => nil}
+                  )
+                else
+                  raise ParserError, "Invalid cascading of sections. Cannot start new section '#{name}' without first closing section '#{current_section.name}' on line #{line_number + 1}."
+                end
+              when 'END'
+                if name == current_section.name
+                  current_section.cache[:footer] = line
+                  elements << current_section
+                  current_section = self
+                else
+                  raise ParserError, "Invalid closing of section. Found attempt to close section '#{name}' in body of section '#{current_section.name}' on line #{line_number + 1}."
+                end
+              end
+            else
+              current_section.elements << Comment.new(
+                comment,
+                :cache => line
+              )
+            end
+          else
+            ENTRY_LINE_PATTERN =~ line
+
+            entry   = $1
+            comment = $2
+
+            if entry and not entry =~ /^\s+$/
+
+              split = entry.split(/\s+/)
+              split.shift if split.first == ''
+
+              address, name, *aliases = *split
+
+              current_section.elements << Entry.new(
+                address, name,
+                :aliases => aliases,
+                :comment => comment,
+                :cache   => line
+              )
+            else
+              current_section.elements << EmptyElement.new(
+                :cache => line
+              )
+            end
+          end
+        end
+
+        self
+      end
+
+      # Generates a hosts file and writes it to a path.
+      #
+      # @param [Hash] options
+      # @option options [Pathname] :path overrides the path attribute for this
+      #   operation
+      # @option options [true, false] :force_generation if set to true, the
+      #   cache won't be used, even if it not empty
+      # @option options [:unix, :windows, :mac] :linebreak_encoding the
+      #   linebreak encoding of the result. If nothing is specified the result
+      #   will be encoded as if :unix was specified.
+      # @see Aef::Linebreak#encode
+      def write(options = {})
+        validate_options(options, :force_generation, :linebreak_encoding, :path)
+
+        path = options[:path].nil? ? @path : to_pathname(options[:path])
+
+        raise ArgumentError, 'No path given' unless path
+
+        options.delete(:path)
+
+        path.open('w') do |file|
+          file.write(to_s(options))
+        end
+
+        true
+      end
+
+      # A String representation for debugging purposes.
+      #
+      # @return [String]
+      def inspect
+        generate_inspect(self, :path, :elements)
+      end
+
+      # A String representation of the hosts file.
+      #
+      # @param [Hash] options
+      # @option options [true, false] :force_generation if set to true, the
+      #   cache won't be used, even if it not empty
+      # @option options [:unix, :windows, :mac] :linebreak_encoding the
+      #   linebreak encoding of the result. If nothing is specified the result
+      #   will be encoded as if :unix was specified.
+      # @see Aef::Linebreak#encode
+      def to_s(options = {})
+        validate_options(options, :force_generation, :linebreak_encoding)
+
+        string = ''
+
+        @elements.each do |element|
+          string << element.to_s(options)
+        end
+
+        string
+      end
+
+    end
+  end
+end

data/lib/hosts/aef/hosts/helpers.rb

@@ -0,0 +1,121 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative '../hosts'
+
+module Aef
+  module Hosts
+
+    # Helper methods used internally in the hosts library
+    #
+    # @private
+    module Helpers
+
+      protected
+
+      # Ensures that an options Hash has includes only valid keys
+      #
+      # @param [Hash] options the options Hash to verify
+      # @param [Array<Symbol>] valid_keys a list of valid keys for the Hash
+      # @raise [ArgumentError] if Hash includes invalid keys
+      def validate_options(options, *valid_keys)
+        remainder = options.keys - valid_keys
+
+        unless remainder.empty?
+          raise ArgumentError, "Invalid option keys: #{remainder.map(&:inspect).join(',')}"
+        end
+      end
+
+      # Casts a given object to Pathname or passes through a given nil
+      #
+      # @param [String, Pathname, nil] path a filesystem path
+      # @return [Pathname, nil]
+      def to_pathname(path)
+        path.nil? ? nil : Pathname.new(path)
+      end
+
+      # Generates a String representation for debugging purposes.
+      #
+      # @param [Object] model a model for which the String is generated
+      # @param [Array<Symbol, String>] attributes Attributes to be displayed.
+      #   If given as Symbol, the attribute's value will be presented by name
+      #   and the inspect output of its value. If given as String, the String
+      #   will represent it instead.
+      # @return [String] a string representation for debugging purposes
+      def generate_inspect(model, *attributes)
+        string = "#<#{model.class}"
+
+        components = []
+
+        attributes.each do |attribute|
+          if attribute == :cache
+            components << 'cached!' if model.send(:cache_filled?)
+          elsif attribute == :elements
+            components << generate_elements_partial(model.elements)
+          elsif attribute.is_a?(Symbol)
+            components << "#{attribute}=#{model.send(attribute).inspect}"
+          else
+            components << attribute
+          end
+        end
+
+        components.unshift(':') unless components.empty?
+        
+        string << components.join(' ')
+        string << '>'
+      end
+
+      # Generate a partial String for an element listing in inspect output.
+      #
+      # @return [String] element partial
+      def generate_elements_partial(elements)
+        elements_string = 'elements=['
+
+        unless elements.empty?
+          elements_string << "\n"
+          elements_string << elements.map{|element|
+            element.inspect.lines.map{|line| "  #{line}"}.join
+          }.join(",\n")
+          elements_string << "\n"
+        end
+
+        elements_string << "]"
+      end
+
+      # Sets a given attribute and executes the block if the current value
+      # differs from the given.
+      #
+      # @param [Symbol] attribute the attribute's name
+      # @param [Object] new_value the value to be assigned to the attribute if
+      #   it differs from its current value
+      # @yield Executed if current value differs from the given
+      def set_if_changed(attribute, new_value)
+        variable_name = :"@#{attribute}"
+        old_value = instance_variable_get(variable_name)
+
+        if new_value != old_value
+          instance_variable_set(variable_name, new_value)
+
+          yield if block_given?
+        end
+      end
+
+    end
+  end
+end

data/lib/hosts/aef/hosts/section.rb

@@ -0,0 +1,141 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative '../hosts'
+
+module Aef
+  module Hosts
+
+    # This represents a section as element of a hosts file. It consists of a
+    # header, futher included elements and a footer
+    class Section < Element
+
+      # Title of the section
+      #
+      # @return [String]
+      attr_reader :name
+
+      # Elements inside the section
+      #
+      # @note If the Array is modified in place, you need to manually
+      #   invalidate the cache with option :only_section => true.
+      # @see #invalidate_cache!
+      # @return [Array<Aef::Host::Element>]
+      attr_reader :elements
+
+      # Initializes a section
+      #
+      # @param [String] name title of the section
+      # @param [Hash] options
+      # @option options [String] :cache sets a cached String representation
+      # @option options [Array<Aef::Hosts::Element>] :elements a list of
+      #   elements in the section
+      def initialize(name, options = {})
+        validate_options(options, :cache, :elements)
+
+        raise ArgumentError, 'Name cannot be empty' unless name
+
+        @name     = name.to_s
+        @elements = options[:elements] || []
+        @cache    = options[:cache] || {:header => nil, :footer => nil}
+      end
+
+      # Deletes the cached String representation
+      #
+      # @param [Hash] options
+      # @option [true, false] :only_section if set to true, the invalidation
+      #   will not cascade onto the elements. Default is false.
+      # @return [Aef::Hosts::Section] a self reference
+      def invalidate_cache!(options = {})
+        @cache = {:header => nil, :footer => nil}
+
+        unless options[:only_section]
+          elements.each do |element|
+            element.invalidate_cache!
+          end
+        end
+      end
+
+      # Tells if a String representation is cached or not
+      #
+      # @return [true, false] true if cache is not empty
+      def cache_filled?
+        !!@cache[:header] && !!@cache[:footer]
+      end
+
+      # Sets the title of the section
+      def name=(name)
+        set_if_changed(:name, name.to_s) do
+          invalidate_cache!(:only_section => true)
+        end
+      end
+
+      # Sets the elements inside the section
+      def elements=(elements)
+        set_if_changed(:elements, [*elements]) do
+          invalidate_cache!(:only_section => true)
+        end
+      end
+
+      # A String representation for debugging purposes
+      #
+      # @return [String]
+      def inspect
+        generate_inspect(self, :name, :cache, :elements)
+      end
+
+      protected
+
+      # Defines the algorithm to generate a String representation from scratch.
+      #
+      # @return [String] a generated String representation
+      def generate_string(options = {})
+        string = ''
+
+        string << "# -----BEGIN SECTION #{name}-----\n"
+
+        @elements.each do |element|
+          string << element.to_s(options)
+        end
+
+        string << "# -----END SECTION #{name}-----\n"
+
+        string
+      end
+
+      # Defines the algorithm to construct the String representation from cache
+      #
+      # @return [String] the cached String representation
+      def cache_string(options = {})
+        string = ''
+
+        string << @cache[:header]
+
+        @elements.each do |element|
+          string << element.to_s(options)
+        end
+
+        string << @cache[:footer]
+
+        string
+      end
+
+    end
+  end
+end

data/lib/hosts/aef/hosts/version.rb

@@ -0,0 +1,29 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module Aef
+  module Hosts
+
+    # The currently loaded library version
+    #
+    # Using Semantic Versioning (2.0.0-rc.1) rules
+    # @see http://semver.org/
+    VERSION = '0.1.1'.freeze
+  end
+end

data/lib/hosts/aef/linebreak/linebreak.rb

@@ -0,0 +1,148 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2009-2013
+
+This file is part of Linebreak.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'set'
+
+# Namespace for projects of Alexander E. Fischer <aef@raxys.net>.
+#
+# If you want to be able to simply type Example instead of Aef::Example to
+# address classes in this namespace simply write the following before using the
+# classes.
+#
+# @example Including the namespace
+#   include Aef
+# @author Alexander E. Fischer
+module Aef
+
+  # Namespace for the linebreak library
+  module Linebreak
+
+    # Mapping table from symbol to actual linebreak sequence
+    #
+    # @private
+    BREAK_BY_SYSTEM = {
+        :unix => "\n",
+        :windows => "\r\n",
+        :mac => "\r"
+    }
+
+    # Mapping table from actual linebreak sequence to symbol
+    #
+    # @private
+    SYSTEM_BY_BREAK = BREAK_BY_SYSTEM.invert
+
+    # Regular expression for linebreak detection and extraction
+    #
+    # @private
+    BREAK_REGEXP = /(\r\n|[\r\n])/
+
+    # Detects encoding systems of a string.
+    #
+    # @param [String] input a String to be analysed
+    # @return [Set<Symbol>] the encoding systems present in the given String
+    def self.encodings(input)
+      if input.respond_to?(:to_s) then input = input.to_s
+      else raise ArgumentError, 'Input needs to be a string or must support to_s' end
+
+      occurences = Set.new
+
+      input.scan(BREAK_REGEXP).each do |linebreak|
+        occurences << SYSTEM_BY_BREAK[linebreak.first]
+      end
+
+      occurences
+    end
+
+    # Checks whether a string includes linebreaks of all the given encoding
+    # systems.
+    #
+    # @param [String] input a String to be analysed
+    # @param [Array<Symbol>] encodings one or more encoding systems
+    # @return [true, false] true if all of the given linebreak systems are
+    #   present in the given String
+    def self.encoding?(input, *encodings)
+      systems = BREAK_BY_SYSTEM.keys
+
+      encodings.flatten!
+      encodings.each do |encoding|
+        unless systems.include?(encoding)
+          raise ArgumentError,
+                %{Invalid encoding system. Available systems: #{systems.join(', ')}. Arguments are expected as symbols or an array of symbols.}
+        end
+      end
+
+      Aef::Linebreak.encodings(input) == Set.new(encodings)
+    end
+
+    # Create a copy of a string with all the string's linebreaks replaced by
+    # linebreaks of a specific system or a given replacement.
+    #
+    # @overload encode(input, system)
+    #   @param [String] input a String as conversion template
+    #   @param [:unix, :windows, :mac] system a target linebreak system
+    #
+    # @overload encode(input, replacement)
+    #   @param [String] input a String as conversion template
+    #   @param [String] replacement a String to be the replacement for all
+    #     linebreaks in the template
+    def self.encode(input, system_or_replacement = :unix)
+      if input.respond_to?(:to_s) then input = input.to_s
+      else raise ArgumentError, 'Input needs to be a string or must support to_s' end
+
+      input.gsub(BREAK_REGEXP,
+                 BREAK_BY_SYSTEM[system_or_replacement] || system_or_replacement)
+    end
+
+    # Detects encoding systems of a string.
+    #
+    # This method is supposed to be used as a method of String.
+    #
+    # @return [Set<Symbol>] the encoding systems present in the String
+    def linebreak_encodings
+      Aef::Linebreak.encodings(self)
+    end
+
+    # Checks whether a string includes linebreaks of all the given encoding
+    # systems.
+    #
+    # This method is supposed to be used as a method of String.
+    #
+    # @param [Array<Symbol>] encodings one or more encoding systems
+    # @return [true, false] true if all of the given linebreak systems are
+    #   present in the given String
+    def linebreak_encoding?(*encodings)
+      Aef::Linebreak.encoding?(self, encodings)
+    end
+
+    # Create a copy of a string with all the string's linebreaks replaced by
+    # linebreaks of a specific system or a given replacement.
+    #
+    # This method is supposed to be used as a method of String.
+    #
+    # @overload encode(system)
+    #   @param [:unix, :windows, :mac] system a target linebreak system
+    #
+    # @overload encode(replacement)
+    #   @param [String] replacement a String to be the replacement for all
+    #     linebreaks in the template
+    def linebreak_encode(system_or_replacement = :unix)
+      Aef::Linebreak.encode(self, system_or_replacement)
+    end
+  end
+end

data/lib/hosts/hosts.rb

@@ -0,0 +1,25 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+# Helper file to allow loading by gem name. Creates an alias for Aef::Hosts
+# named simply Hosts if this name isn't used otherwise.
+
+require_relative 'aef/hosts'
+
+::Hosts = Aef::Hosts unless defined?(::Hosts)

data/lib/hosts/hosts/bare.rb

@@ -0,0 +1,23 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of Hosts.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+# Require this file if you don't want an alias for Aef::Hosts named simply
+# Hosts.
+
+require_relative '../hosts'

data/lib/vagrant-dnsdock-hostupdater/command.rb

@@ -0,0 +1,12 @@
+module Vagrant
+  module DnsdockHostUpdater
+    class Command < Vagrant.plugin('2', :command)
+      def execute
+        puts 'command firing...'
+        exec('echo "Command fired!"')
+        0
+      end
+    end
+  end
+
+end

data/lib/vagrant-dnsdock-hostupdater/plugin.rb

@@ -0,0 +1,90 @@
+module Vagrant
+  module DnsdockHostUpdater
+
+    module OS
+      def OS.windows?
+        (/cygwin|mswin|mingw|bccwin|wince|emx/ =~ RUBY_PLATFORM) != nil
+      end
+
+      def OS.mac?
+        (/darwin/ =~ RUBY_PLATFORM) != nil
+      end
+
+      def OS.unix?
+        !OS.windows?
+      end
+
+      def OS.linux?
+        OS.unix? and not OS.mac?
+      end
+    end
+
+    class Plugin < Vagrant.plugin('2')
+      name "dnsdock-host-updater"
+
+      description <<-DESC
+          Updates hosts for docker containers on guest VM.
+      DESC
+
+      @started = false
+
+      # Add command for `$ vagrant dnsdock-host-updater`
+      # command 'dnsdock-host-updater' do
+      #   require_relative 'command'
+      #   Command
+      # end
+
+      def self.pid_path
+        File.expand_path('~/.docker-host-manager.pid')
+      end
+
+      def self.log(msg)
+        puts "[vagrant-dnsdock-hostupdater] #{msg}"
+      end
+
+      def self.pid
+        File.exist?(pid_path) ? File.read(pid_path) : nil
+      end
+
+      def self.close_manager
+        if pid
+          log "Already running with PID: #{pid}"
+          begin
+            log "Attempting to stop server with PID: #{pid}"
+            Process.kill('KILL', pid.to_i)
+          rescue
+            log "Unable to kill process with ID: #{pid}. This may be because the process has already been terminated."
+          end
+
+          log "Cleaning up PID file: #{pid_path}"
+          File.delete(pid_path)
+        end
+      end
+
+      def self.init_plugin
+        server_path = File.expand_path('../../server.rb', __FILE__)
+
+        if @started
+          return
+        end
+
+        close_manager
+
+        pid = Process.spawn("ruby #{server_path}")
+        log "Started server with PID: #{pid}"
+
+        if pid
+          pid_file = File.open(pid_path, 'w')
+          pid_file << pid
+          pid_file.close
+          log "Wrote server PID (#{pid}) to #{pid_path}"
+          Process.detach(pid)
+          @started = true
+        end
+      end
+
+      action_hook(:up, :machine_action_up) { init_plugin }
+
+    end
+  end
+end

data/lib/version.rb

@@ -1,5 +1,5 @@
 module Vagrant
   module DnsdockHostUpdater
-    VERSION = '0.0.24'.freeze
+    VERSION = '0.0.25'.freeze
   end
 end

data/vagrant-dnsdock-hostupdater.gemspec

@@ -11,7 +11,7 @@ DNSDock should be configured on the guest machine to enable containers to resolv
   DESCRIPTION
   s.authors         = ['Brian Coit']
   s.email           = 'brian.coit@cellosignal.com'
-  s.files           = Dir['{lib}/**'] + ['Rakefile', 'Gemfile', 'Gemfile.lock', 'vagrant-dnsdock-hostupdater.gemspec']
+  s.files           = Dir['{lib}/**/*'] + ['Rakefile', 'Gemfile', 'Gemfile.lock', 'vagrant-dnsdock-hostupdater.gemspec']
   s.executables     = s.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   s.require_paths   = ['lib']
   s.homepage        = 'https://bitbucket.org/briancoit'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vagrant-dnsdock-hostupdater
 version: !ruby/object:Gem::Version
-  version: 0.0.24
+  version: 0.0.25
 platform: ruby
 authors:
 - Brian Coit
@@ -67,9 +67,23 @@ files:
 - lib/client.rb
 - lib/event-watcher.rb
 - lib/host-manager.rb
+- lib/hosts/aef/hosts.rb
+- lib/hosts/aef/hosts/comment.rb
+- lib/hosts/aef/hosts/element.rb
+- lib/hosts/aef/hosts/empty_element.rb
+- lib/hosts/aef/hosts/entry.rb
+- lib/hosts/aef/hosts/file.rb
+- lib/hosts/aef/hosts/helpers.rb
+- lib/hosts/aef/hosts/section.rb
+- lib/hosts/aef/hosts/version.rb
+- lib/hosts/aef/linebreak/linebreak.rb
+- lib/hosts/hosts.rb
+- lib/hosts/hosts/bare.rb
 - lib/launch-control
 - lib/server.rb
 - lib/vagrant-dnsdock-hostupdater.rb
+- lib/vagrant-dnsdock-hostupdater/command.rb
+- lib/vagrant-dnsdock-hostupdater/plugin.rb
 - lib/version.rb
 - vagrant-dnsdock-hostupdater.gemspec
 homepage: https://bitbucket.org/briancoit