Class Logging::Appenders::File
In: lib/logging/appenders/file.rb
Parent: ::Logging::Appenders::IO

This class provides an Appender that can write to a File.

Methods

assert_valid_logfile   new  

Public Class methods

File.assert_valid_logfile( filename ) => true

Asserts that the given filename can be used as a log file by ensuring that if the file exists it is a regular file and it is writable. If the file does not exist, then the directory is checked to see if it is writable.

An ArgumentError is raised if any of these assertions fail.

File.new( name, :filename => 'file' )
File.new( name, :filename => 'file', :truncate => true )
File.new( name, :filename => 'file', :layout => layout )

Creates a new File Appender that will use the given filename as the logging destination. If the file does not already exist it will be created. If the :truncate option is set to true then the file will be truncated before writing begins; otherwise, log messages will be appened to the file.

[Validate]