This class can be used to coordinate tailing of many files, which have been added to the group.

Methods
#
A
E
N
S
T
Class Public methods
[](*files)

Creates a group for files (IO instances or filename strings).

Source: show 

# File lib/file/tail/group.rb, line 21
      def self.[](*files)
        new(:files => files)
      end
new(opts = {})

Creates a new File::Tail::Group instance.

The following options can be given as arguments:

:files:an array of files (or filenames to open) that are placed into the group.

Source: show 

# File lib/file/tail/group.rb, line 13
      def initialize(opts = {})
        @tailers = ThreadGroup.new
        if files = opts[:files]
          Array(files).each { |file| add file }
        end
      end
Instance Public methods
<<(file_or_filename)

Alias for add

add(file_or_filename)

Add a file (IO instance) or filename (responding to to_str) to this group.

This method is also aliased as <<

Source: show 

# File lib/file/tail/group.rb, line 27
      def add(file_or_filename)
        if file_or_filename.respond_to?(:to_io)
          add_file file_or_filename.to_io
        elsif file_or_filename.respond_to?(:to_str)
          add_filename file_or_filename
        end
      end
add_file(file)

Add the IO instance file to this group.

Source: show 

# File lib/file/tail/group.rb, line 38
      def add_file(file)
        setup_file_tailer file
        self
      end
add_filename(filename, n = 0)

Add a file created by opening filename to this group after stepping n lines backwards from the end of it.

Source: show 

# File lib/file/tail/group.rb, line 45
      def add_filename(filename, n = 0)
        file = Logfile.open(filename.to_str, :backward => n)
        file.backward n
        setup_file_tailer file
        self
      end
each_file(&block)

Iterate over all files contained in this group yielding to block for each of them.

Source: show 

# File lib/file/tail/group.rb, line 54
      def each_file(&block)
        each_tailer { |t| t.file }.map(&block)
      end
each_tailer(&block)

Iterate over all tailers in this group yielding to block for each of them.

Source: show 

# File lib/file/tail/group.rb, line 60
      def each_tailer(&block)
        @tailers.list.map { |t| t }.map(&block)
      end
stop()

Stop all tailers in this group at once.

Source: show 

# File lib/file/tail/group.rb, line 65
      def stop
        each_tailer { |t| t.stop }
        each_tailer { |t| t.join }
        self
      end
tail()

Tail all the lines of all the files in the Tail::Group instance, that is yield to each of them.

Every line is extended with the LineExtension module, that adds some methods to the line string. To get the path of the file this line was received from call line.file.path.

Source: show 

# File lib/file/tail/group.rb, line 77
      def tail
        wait_for_activity do |tailer|
          tailer.pending_lines.each do |line|
            line.extend LineExtension
            line.instance_variable_set :@tailer, tailer
            yield line
          end
        end
      end