feat(fmt): Expose ConfigurableFormat

Author: epage

src/fmt/mod.rs

@@ -276,10 +276,9 @@ impl<T: Display> Display for StyledValue<T> {
 #[cfg(not(feature = "color"))]
 type StyledValue<T> = T;
 
-/// The default format.
-///
-/// This format needs to work with any combination of crate features.
-pub(crate) struct ConfigurableFormat {
+/// A [custom format][crate::Builder::format] with settings for which fields to show
+pub struct ConfigurableFormat {
+    // This format needs to work with any combination of crate features.
     pub(crate) timestamp: Option<TimestampPrecision>,
     pub(crate) module_path: bool,
     pub(crate) target: bool,
@@ -294,7 +293,7 @@ pub(crate) struct ConfigurableFormat {
 
 impl ConfigurableFormat {
     /// Format the [`Record`] as configured for outputting
-    pub(crate) fn format(&self, formatter: &mut Formatter, record: &Record<'_>) -> io::Result<()> {
+    pub fn format(&self, formatter: &mut Formatter, record: &Record<'_>) -> io::Result<()> {
         let fmt = ConfigurableFormatWriter {
             format: self,
             buf: formatter,
@@ -307,52 +306,52 @@ impl ConfigurableFormat {
 
 impl ConfigurableFormat {
     /// Whether or not to write the level in the default format.
-    pub(crate) fn level(&mut self, write: bool) -> &mut Self {
+    pub fn level(&mut self, write: bool) -> &mut Self {
         self.level = write;
         self
     }
 
     /// Whether or not to write the source file path in the default format.
-    pub(crate) fn file(&mut self, write: bool) -> &mut Self {
+    pub fn file(&mut self, write: bool) -> &mut Self {
         self.source_file = write;
         self
     }
 
     /// Whether or not to write the source line number path in the default format.
     ///
     /// Only has effect if `format_file` is also enabled
-    pub(crate) fn line_number(&mut self, write: bool) -> &mut Self {
+    pub fn line_number(&mut self, write: bool) -> &mut Self {
         self.source_line_number = write;
         self
     }
 
     /// Whether or not to write the module path in the default format.
-    pub(crate) fn module_path(&mut self, write: bool) -> &mut Self {
+    pub fn module_path(&mut self, write: bool) -> &mut Self {
         self.module_path = write;
         self
     }
 
     /// Whether or not to write the target in the default format.
-    pub(crate) fn target(&mut self, write: bool) -> &mut Self {
+    pub fn target(&mut self, write: bool) -> &mut Self {
         self.target = write;
         self
     }
 
     /// Configures the amount of spaces to use to indent multiline log records.
     /// A value of `None` disables any kind of indentation.
-    pub(crate) fn indent(&mut self, indent: Option<usize>) -> &mut Self {
+    pub fn indent(&mut self, indent: Option<usize>) -> &mut Self {
         self.indent = indent;
         self
     }
 
     /// Configures if timestamp should be included and in what precision.
-    pub(crate) fn timestamp(&mut self, timestamp: Option<TimestampPrecision>) -> &mut Self {
+    pub fn timestamp(&mut self, timestamp: Option<TimestampPrecision>) -> &mut Self {
         self.timestamp = timestamp;
         self
     }
 
     /// Configures the end of line suffix.
-    pub(crate) fn suffix(&mut self, suffix: &'static str) -> &mut Self {
+    pub fn suffix(&mut self, suffix: &'static str) -> &mut Self {
         self.suffix = suffix;
         self
     }
@@ -368,7 +367,7 @@ impl ConfigurableFormat {
     /// The default format uses a space to separate each key-value pair, with an "=" between
     /// the key and value.
     #[cfg(feature = "kv")]
-    pub(crate) fn key_values<F>(&mut self, format: F) -> &mut Self
+    pub fn key_values<F>(&mut self, format: F) -> &mut Self
     where
         F: Fn(&mut Formatter, &dyn log::kv::Source) -> io::Result<()> + Sync + Send + 'static,
     {