Module gravel_ffi::logging

Plumbing for using the log crate across FFI-boundaries.

By setting up a chain from ForwardLogger => LogTarget => Log, a dynamically loaded library can effectively log to the calling library’s logging implementation.

Usage

• Set up logging as usual
• Construct a StaticLogTarget in the same library
• Pass the LogTarget through FFI
• Register a ForwardLogger in the dynamic library
• Use the log crate as usual

Note: The max logging level is only set once, when the ForwardLogger is registered.

Modules

• LogTarget_trait
  This module is generated by the #[sabi_trait] attribute on LogTarget

Structs

• ForwardLogger
  Logger that forwards calls to a LogTarget.
• LogTarget_TO
  The trait object for LogTarget.
• NoOpLogTarget
  LogTarget that does nothing.
• StaticLogTarget
  LogTarget that forwards calls to the statically registered logger of the library it was constructed in.

Traits

• LogTarget
  FFI-safe version of Log.

Type Aliases

• BoxDynLogTarget
  FFI-safe LogTarget trait object.
• LogTarget_CTO
  A type alias for the const-constructible LogTarget_TO.