[−][src]Struct fern_colored::Output
Configuration for a logger output.
Implementations
impl Output
[src]
pub fn file<T: Into<Cow<'static, str>>>(file: File, line_sep: T) -> Self
[src]
Returns a file logger using a custom separator.
If the default separator of \n
is acceptable, an fs::File
instance can be passed into Dispatch::chain
directly.
fern::Dispatch::new().chain(std::fs::File::create("log")?)
fern::Dispatch::new().chain(fern::log_file("log")?)
Example usage (using fern::log_file
):
fern::Dispatch::new().chain(fern::Output::file(fern::log_file("log")?, "\r\n"))
pub fn writer<T: Into<Cow<'static, str>>>(
writer: Box<dyn Write + Send>,
line_sep: T
) -> Self
[src]
writer: Box<dyn Write + Send>,
line_sep: T
) -> Self
Returns a logger using arbitrary write object and custom separator.
If the default separator of \n
is acceptable, an Box<Write + Send>
instance can be passed into Dispatch::chain
directly.
// Anything implementing 'Write' works. let mut writer = std::io::Cursor::new(Vec::<u8>::new()); fern::Dispatch::new() // as long as we explicitly cast into a type-erased Box .chain(Box::new(writer) as Box<std::io::Write + Send>)
Example usage:
let writer = Box::new(std::io::Cursor::new(Vec::<u8>::new())); fern::Dispatch::new().chain(fern::Output::writer(writer, "\r\n"))
pub fn reopen<T: Into<Cow<'static, str>>>(
reopen: Reopen<File>,
line_sep: T
) -> Self
[src]
reopen: Reopen<File>,
line_sep: T
) -> Self
Returns a reopenable logger, i.e., handling SIGHUP.
If the default separator of \n
is acceptable, a Reopen
instance can be passed into Dispatch::chain
directly.
This function is not available on Windows, and it requires the reopen-03
feature to be enabled.
use std::fs::OpenOptions; let reopenable = reopen::Reopen::new(Box::new(|| { OpenOptions::new() .create(true) .write(true) .append(true) .open("/tmp/output.log") })) .unwrap(); fern::Dispatch::new().chain(fern::Output::reopen(reopenable, "\n"))
pub fn stdout<T: Into<Cow<'static, str>>>(line_sep: T) -> Self
[src]
Returns an stdout logger using a custom separator.
If the default separator of \n
is acceptable, an io::Stdout
instance can be passed into Dispatch::chain()
directly.
fern::Dispatch::new().chain(std::io::stdout())
Example usage:
fern::Dispatch::new() // some unix tools use null bytes as message terminators so // newlines in messages can be treated differently. .chain(fern::Output::stdout("\0"))
pub fn stderr<T: Into<Cow<'static, str>>>(line_sep: T) -> Self
[src]
Returns an stderr logger using a custom separator.
If the default separator of \n
is acceptable, an io::Stderr
instance can be passed into Dispatch::chain()
directly.
fern::Dispatch::new().chain(std::io::stderr())
Example usage:
fern::Dispatch::new().chain(fern::Output::stderr("\n\n\n"))
pub fn sender<T: Into<Cow<'static, str>>>(
sender: Sender<String>,
line_sep: T
) -> Self
[src]
sender: Sender<String>,
line_sep: T
) -> Self
Returns a mpsc::Sender logger using a custom separator.
If the default separator of \n
is acceptable, an
mpsc::Sender<String>
instance can be passed into Dispatch:: chain()
directly.
Each log message will be suffixed with the separator, then sent as a single String to the given sender.
use std::sync::mpsc::channel; let (tx, rx) = channel(); fern::Dispatch::new().chain(tx)
pub fn syslog_5424<F>(
logger: Logger<LoggerBackend, (i32, HashMap<String, HashMap<String, String>>, String), Formatter5424>,
transform: F
) -> Self where
F: Fn(&Record<'_>) -> (i32, HashMap<String, HashMap<String, String>>, String) + Sync + Send + 'static,
[src]
logger: Logger<LoggerBackend, (i32, HashMap<String, HashMap<String, String>>, String), Formatter5424>,
transform: F
) -> Self where
F: Fn(&Record<'_>) -> (i32, HashMap<String, HashMap<String, String>>, String) + Sync + Send + 'static,
Returns a logger which logs into an RFC5424 syslog.
This method takes an additional transform method to turn the log data into RFC5424 data.
I've honestly got no clue what the expected keys and values are for this kind of logging, so I'm just going to link the rfc instead.
If you're an expert on syslog logging and would like to contribute an example to put here, it would be gladly accepted!
This requires the "syslog-4"
feature.
pub fn call<F>(func: F) -> Self where
F: Fn(&Record<'_>) + Sync + Send + 'static,
[src]
F: Fn(&Record<'_>) + Sync + Send + 'static,
Returns a logger which simply calls the given function with each message.
The function will be called inline in the thread the log occurs on.
Example usage:
fern::Dispatch::new().chain(fern::Output::call(|record| { // this is mundane, but you can do anything here. println!("{}", record.args()); }))
Trait Implementations
impl Debug for Output
[src]
impl From<&'static (dyn Log + 'static)> for Output
[src]
pub fn from(log: &'static dyn Log) -> Self
[src]
Creates an output logger forwarding all messages to the custom logger.
impl From<Box<Logger, Global>> for Output
[src]
pub fn from(log: Box<Logger>) -> Self
[src]
Creates an output logger which writes all messages to the given syslog output.
Log levels are translated trace => debug, debug => debug, info => informational, warn => warning, and error => error.
Note that while this takes a Boxsyslog::Logger
.
This requires the "syslog-3"
feature.
impl From<Box<dyn Log + 'static, Global>> for Output
[src]
pub fn from(log: Box<dyn Log>) -> Self
[src]
Creates an output logger forwarding all messages to the custom logger.
impl From<Box<dyn Write + 'static + Send, Global>> for Output
[src]
pub fn from(writer: Box<dyn Write + Send>) -> Self
[src]
Creates an output logger which writes all messages to the writer with
\n
as the separator.
This does no buffering and it is up to the writer to do buffering as
needed (eg. wrap it in BufWriter
). However, flush is called after
each log record.
impl From<DateBased> for Output
[src]
pub fn from(config: DateBased) -> Self
[src]
Create an output logger which defers to the given date-based logger. Use configuration methods on DateBased to set line separator and filename.
impl From<Dispatch> for Output
[src]
pub fn from(log: Dispatch) -> Self
[src]
Creates an output logger forwarding all messages to the dispatch.
impl From<File> for Output
[src]
pub fn from(file: File) -> Self
[src]
Creates an output logger which writes all messages to the file with
\n
as the separator.
File writes are buffered and flushed once per log record.
impl From<Logger<LoggerBackend, String, Formatter3164>> for Output
[src]
pub fn from(log: Logger<LoggerBackend, String, Formatter3164>) -> Self
[src]
Creates an output logger which writes all messages to the given syslog.
Log levels are translated trace => debug, debug => debug, info => informational, warn => warning, and error => error.
Note that due to https://github.com/Geal/rust-syslog/issues/41, logging to this backend requires one allocation per log call.
This is for RFC 3164 loggers. To use an RFC 5424 logger, use the
Output::syslog_5424
helper method.
This requires the "syslog-4"
feature.
impl From<Logger> for Output
[src]
pub fn from(log: Logger) -> Self
[src]
Creates an output logger which writes all messages to the given syslog output.
Log levels are translated trace => debug, debug => debug, info => informational, warn => warning, and error => error.
This requires the "syslog-3"
feature.
impl From<Panic> for Output
[src]
pub fn from(_: Panic) -> Self
[src]
Creates an output logger which will panic with message text for all messages.
impl From<Reopen<File>> for Output
[src]
pub fn from(reopen: Reopen<File>) -> Self
[src]
Creates an output logger which writes all messages to the file contained
in the Reopen struct, using \n
as the separator.
impl From<Sender<String>> for Output
[src]
pub fn from(stream: Sender<String>) -> Self
[src]
Creates an output logger which writes all messages to the given mpsc::Sender with '\n' as the separator.
All messages sent to the mpsc channel are suffixed with '\n'.
impl From<Stderr> for Output
[src]
pub fn from(stream: Stderr) -> Self
[src]
Creates an output logger which writes all messages to stderr with the
given handle and \n
as the separator.
impl From<Stdout> for Output
[src]
Auto Trait Implementations
impl !RefUnwindSafe for Output
impl Send for Output
impl !Sync for Output
impl Unpin for Output
impl !UnwindSafe for Output
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,