✨ Add library logger facades

src-async/BitLoggerAsync_test.mbt

@@ -242,3 +242,40 @@ async test "run drains queued records in compatibility backends too" {
   inspect(written.val[0], content="one")
   inspect(written.val[1], content="two")
 }
+
+async test "library async logger keeps a smaller async facade" {
+  let written_targets : Ref[Array[String]] = Ref::new([])
+  let written_messages : Ref[Array[String]] = Ref::new([])
+  let written_field_counts : Ref[Array[Int]] = Ref::new([])
+  let logger = LibraryAsyncLogger::new(
+    @bitlogger.callback_sink(fn(rec) {
+      written_targets.val.push(rec.target)
+      written_messages.val.push(rec.message)
+      written_field_counts.val.push(rec.fields.length())
+    }),
+    config=AsyncLoggerConfig::new(max_pending=4),
+    min_level=@bitlogger.Level::Info,
+    target="async.lib",
+  ).with_context_fields([@bitlogger.field("service", "bitlogger")]).child("worker")
+
+  @async.with_task_group(group => {
+    group.spawn_bg(() => logger.run())
+    logger.info("ready", fields=[@bitlogger.field("mode", "test")])
+    logger.shutdown()
+  })
+
+  inspect(written_targets.val.length(), content="1")
+  inspect(written_targets.val[0], content="async.lib.worker")
+  inspect(written_messages.val[0], content="ready")
+  inspect(written_field_counts.val[0], content="2")
+}
+
+async test "library async logger can be built from config" {
+  let logger = parse_and_build_library_async_logger(
+    "{\"logger\":{\"min_level\":\"warn\",\"target\":\"async.lib.config\",\"sink\":{\"kind\":\"console\"}},\"async_config\":{\"max_pending\":2,\"overflow\":\"DropNewest\",\"max_batch\":1,\"linger_ms\":0,\"flush\":\"Never\"}}",
+  )
+  let full = logger.to_async_logger()
+  inspect(logger.is_enabled(@bitlogger.Level::Error), content="true")
+  inspect(logger.is_enabled(@bitlogger.Level::Info), content="false")
+  inspect(full.target, content="async.lib.config")
+}

src-async/library_async_logger.mbt

@@ -0,0 +1,133 @@
+pub struct LibraryAsyncLogger[S] {
+  inner : AsyncLogger[S]
+}
+
+pub fn[S] library_async_logger(logger : AsyncLogger[S]) -> LibraryAsyncLogger[S] {
+  { inner: logger }
+}
+
+pub fn[S] LibraryAsyncLogger::new(
+  sink : S,
+  config~ : AsyncLoggerConfig = AsyncLoggerConfig::new(),
+  min_level~ : @bitlogger.Level = @bitlogger.Level::Info,
+  target~ : String = "",
+  flush~ : (S) -> Int = fn(_) { 0 },
+) -> LibraryAsyncLogger[S] {
+  library_async_logger(
+    async_logger(
+      sink,
+      config=config,
+      min_level=min_level,
+      target=target,
+      flush=flush,
+    ),
+  )
+}
+
+pub fn[S] LibraryAsyncLogger::to_async_logger(self : LibraryAsyncLogger[S]) -> AsyncLogger[S] {
+  self.inner
+}
+
+pub fn[S] configured_library_async_logger(
+  logger : AsyncLogger[S],
+) -> LibraryAsyncLogger[S] {
+  library_async_logger(logger)
+}
+
+pub fn build_library_async_logger(
+  config : AsyncLoggerBuildConfig,
+) -> LibraryAsyncLogger[@bitlogger.RuntimeSink] {
+  configured_library_async_logger(build_async_logger(config))
+}
+
+pub fn build_library_async_text_logger(
+  config : AsyncLoggerBuildConfig,
+) -> LibraryAsyncLogger[@bitlogger.FormattedConsoleSink] {
+  configured_library_async_logger(build_async_text_logger(config))
+}
+
+pub fn parse_and_build_library_async_logger(
+  input : String,
+) -> LibraryAsyncLogger[@bitlogger.RuntimeSink] raise {
+  build_library_async_logger(parse_async_logger_build_config_text(input))
+}
+
+pub fn[S] LibraryAsyncLogger::with_target(
+  self : LibraryAsyncLogger[S],
+  target : String,
+) -> LibraryAsyncLogger[S] {
+  library_async_logger(self.inner.with_target(target))
+}
+
+pub fn[S] LibraryAsyncLogger::child(
+  self : LibraryAsyncLogger[S],
+  target : String,
+) -> LibraryAsyncLogger[S] {
+  library_async_logger(self.inner.child(target))
+}
+
+pub fn[S] LibraryAsyncLogger::with_context_fields(
+  self : LibraryAsyncLogger[S],
+  fields : Array[@bitlogger.Field],
+) -> LibraryAsyncLogger[S] {
+  library_async_logger(self.inner.with_context_fields(fields))
+}
+
+pub fn[S] LibraryAsyncLogger::bind(
+  self : LibraryAsyncLogger[S],
+  fields : Array[@bitlogger.Field],
+) -> LibraryAsyncLogger[S] {
+  self.with_context_fields(fields)
+}
+
+pub fn[S] LibraryAsyncLogger::is_enabled(
+  self : LibraryAsyncLogger[S],
+  level : @bitlogger.Level,
+) -> Bool {
+  self.inner.is_enabled(level)
+}
+
+pub async fn[S] LibraryAsyncLogger::log(
+  self : LibraryAsyncLogger[S],
+  level : @bitlogger.Level,
+  message : String,
+  fields~ : Array[@bitlogger.Field] = [],
+  target? : String = "",
+) -> Unit {
+  self.inner.log(level, message, fields=fields, target=target)
+}
+
+pub async fn[S] LibraryAsyncLogger::info(
+  self : LibraryAsyncLogger[S],
+  message : String,
+  fields~ : Array[@bitlogger.Field] = [],
+) -> Unit {
+  self.inner.info(message, fields=fields)
+}
+
+pub async fn[S] LibraryAsyncLogger::warn(
+  self : LibraryAsyncLogger[S],
+  message : String,
+  fields~ : Array[@bitlogger.Field] = [],
+) -> Unit {
+  self.inner.warn(message, fields=fields)
+}
+
+pub async fn[S] LibraryAsyncLogger::error(
+  self : LibraryAsyncLogger[S],
+  message : String,
+  fields~ : Array[@bitlogger.Field] = [],
+) -> Unit {
+  self.inner.error(message, fields=fields)
+}
+
+pub async fn[S : @bitlogger.Sink] LibraryAsyncLogger::run(self : LibraryAsyncLogger[S]) -> Unit {
+  self.inner.run()
+}
+
+pub async fn[S] LibraryAsyncLogger::shutdown(
+  self : LibraryAsyncLogger[S],
+  clear? : Bool = false,
+) -> Unit {
+  self.inner.shutdown(clear=clear)
+}