• Add redirect standard log functions

• Fix missing field in copy fields to child logger.

Changed

• Fixed New, was missing setting defaultIoWriterLevel, fields, status.
• Changed default io.Writer level to None.

Added

• For convenience, conforms with io.Writer interface. Default level: error. SetIoWriterLevel changes the default level.

Changed

• Fixed chained example.
• Lowercased all levels.
• It now warns when an application tries to write to a closed writer.

• All SetXYZ methods returns its proper interface allowing method chaining.
• Breakpoint is now variadic.
• Properly handle cases where sypl writes to a piped output, but it's broken.

• Fixed ExampleNew_globalFields test.

Added the ability to set breakpoints. If a Breakpoint is set it'll stop execution waiting the user press /n ("enter") to continue. It helps users doing quick, and effective log-to-console debug. A message with the breakpoint name, and PID of the process will be printed using the debug level. Arbitrary data can optionally be set - if set, it'll be printed. Errors are printed using the standard error level. Set logging level to trace for more.

Previously, flow would look like:

• Log markers are set, e.g.: logger.Debugln("Here 1", whatever)
• Application runs
• Scan visually output, or a file - via grep for the markers.

Now:

• Named Breakpoints are set
• Application runs
• Breakpoint is hit. Information about it is printed.
• Runtime is paused, allowing analysis of data - if any, right way. Additionally, an external and more advanced debugger can be attached.
• Dev controls the flow, pressing enter at any time, continue.

• Exported sypl.Name to deal with https://github.com/golang/go/issues/5819.

• Renamed logging component filtering env var from SYPL_DEBUG to SYPL_FILTER.

In a application with many loggers, and child loggers, sometimes more fine control is needed, specially when debugging applications. Sypl offers two powerful ways to achieve that: SYPL_FILTER, and SYPL_DEBUG env vars.

SYPL_FILTER allows to specify the name(s) of the component(s) that should be logged, for example, for a given application with the following loggers: svc, pv, and cm, if a developer wants only to see svc, and pv logging, it's achieved just setting SYPL_FILTER="svc,pv".

SYPL_DEBUG allows to specify the max level, for example, for a given application with the following loggers: svc, pv, and cm, if a developer sets:

• SYPL_DEBUG="debug": any application running using Sypl, any component, any output, will log messages bellow the debug level
• SYPL_DEBUG="console:debug": any application running using Sypl with an output called console, will log messages bellow the debug level
• SYPL_DEBUG="warn,console:debug": any application running using Sypl, any component, any output, will log messages bellow the warn level, AND any application running using Sypl with an output called console, will log messages bellow the debug level.

NOTE: warn is specified first. Only for this case - global scope, it's a requirement. SYPL_DEBUG="console:debug,warn": In this case warn will be discarded!.

• SYPL_DEBUG="svc:console:debug": any application running using Sypl with a component called svc with an output called console, will log messages bellow the debug level
• SYPL_DEBUG="file:warn,svc:console:debug": any application running using Sypl with an output called file will log messages bellow the warn level, and any application running using Sypl with a component called svc with an output called console will log messages bellow the debug.

Possible scopes:

• {componentName:outputName:level}: Component, and output scoped
• {outputName:level}: Output scoped
• {level}: Global scope

The possibilities are endless! Checkout the debugAndFilter example for more.

• Fix bug where setting fields for a message would set globally too.

• Level FromString, and MustFromString methods validates if level param is empty.

• Sypl SetFields is chainable.

• Adds the ability to set global Fields.

• FromString error now prints also available levels.
• LevelsNames returns lower-cased levels.

• StdErr now only prints Error AND Fatal instead of only Error.
• Console now ignores Error AND Fatal instead of only Error.
• PrintOnlyAtLevel now handle multiples levels.
• FromString now returns the level, and error instead of level, and bool (ok).
• Internal sypl.process is now validated. In case of failure it throws ErrSyplNotInitialized.
• All error.go files were renamed to errors.go, following Go standards.

• Adds PrintNewLine
• Skip and SkipAndForce flags now skips formatters too.

• Removes unused entries from Makefile
• sypl.New now returns *Sypl

• Adds PrintMessagesToOutputsWithOptions

• Allows to specify the name of dashHandler output.
  • Now, when - is specified as a path, dashHandler is named after the original output.

• Fixed names of the factories, so it doesn't stutters.

Note: Breaking change.

• Adds LevelsNames

• Improved FromString

• Adds MustFromString

• Adds the ability to get and set outputs' max level.

• NewDefault only prints errors to stderr.

• Adds PrintOnlyIfTagged built-in processor.
• Renames PrintOnlyLevel to PrintOnlyAtLevel.

• StdErr only prints @ Error Level.

• Creates StdErr built-in Output.
• Removes path (unused) from FileBased Output.

• Improved linebreak detection and restoration.

• Adds PrintMessagerPerOutput which allows you to concurrently print messages, each one, at the specified level and to the specified output. If the named output doesn't exits, the message will not be printed.
  • Covered with test.
• Adds output field to Text and JSON formatters.