vagrant-dnsdock-hostupdater 0.0.21 → 0.0.22

data/lib/hosts/aef/hosts.rb

@@ -1,51 +0,0 @@
-# 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

@@ -1,73 +0,0 @@
-# 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

@@ -1,108 +0,0 @@
-# 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

@@ -1,50 +0,0 @@
-# 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

@@ -1,123 +0,0 @@
-# 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

@@ -1,252 +0,0 @@
-# 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