new

  $tailer = File::Tail::Scribe->new(%options);

Creates a new instance. Options are:

• directories, filter, exclude, follow_symlinks, sleep_interval, statefilename, no_init, max_age

  See the equivalent options in File::Tail::Dir: "directories" in File::Tail::Dir, "filter" in File::Tail::Dir, "exclude" in File::Tail::Dir, "follow_symlinks" in File::Tail::Dir, "sleep_interval" in File::Tail::Dir, "statefilename" in File::Tail::Dir, "no_init" in File::Tail::Dir, "max_age" in File::Tail::Dir.

• scribe_options

  This is a hash containing all of the options to pass to <Log::Dispatch::Scribe/new>.

• msg_filter

  An optional coderef that can be used to preprocess messages before they are sent to Scribe. The code is passed ($self, $filename, $line), i.e. the File::Tail::Scribe instance, the filename of the file that changed, and the line of text that was added. It must return ($level, $category, $message), i.e. the log level (info, debug etc), the Scribe category, and the log line that will be sent to Scribe. An example:

    msg_filter => sub {
      my $self = shift;
      my $filename = shift;
      my $line = shift;
      $filename =~ s{^.*/}{};                   # remove leading dirs
      $filename =~ s{\.[^.]*$}{};               # remove extension
      $filename ||= 'default';                  # in case everything gets removed
  
      return ('info', 'httpd', "$filename\t$line");
    };
      

  If no msg_filter is provided, the log level is given by default_level, the category is the filename after removing leading paths and filename extensions, and the message is the log line as given.

• default_level

  Default logging level. May be set to any valid Log::Dispatch level (debug, info, notice, warning, error, critical, alert, emergency). Defaults to 'info'.