Skip to content

Shared Layer

The EasyBarShared target contains code used across multiple executables.

Responsibilities

Typical responsibilities include:

  • shared config models and config loading
  • shared IPC request and response models
  • shared socket path helpers
  • shared environment-key definitions and runtime-directory resolution
  • common logging utilities and log-level definitions
  • value types used by both the app and helper processes

This target exists to keep the transport and configuration contracts consistent across the app, CLI, and agents.

If a type is part of a process boundary, it usually belongs here.

Logging architecture

Logging is intentionally shared across the app, agents, and CLI.

The core pieces live in EasyBarShared:

  • ProcessLogger
  • the shared log level enum
  • shared runtime logging config resolution
  • startup snapshot logging helpers

The app and helper agents use config-driven logging:

[logging]
enabled = true
level = "info"
directory = "~/.local/state/easybar"

Supported levels:

  • trace
  • debug
  • info
  • warn
  • error

That keeps the normal runtime logging model explicit and consistent across all long-lived processes.

EASYBAR_LOG_LEVEL is intentionally kept as a narrow diagnostic override for the minimum log level. It does not enable file logging and does not change the configured log directory.

The CLI remains slightly different on purpose:

  • --debug enables extra diagnostics from the CLI process itself
  • easybar logs --follow --level LEVEL registers temporary live sinks in every selected process logger

A live sink can request a more verbose level than the persistent process configuration. Records are routed per sink: a trace subscriber receives trace messages, while an info file sink still omits them. The app, calendar agent, and network agent use the same shared socket-sink adapter. Socket writes use bounded serial queues, so log producers enqueue delivery without waiting for a client to read. Each sink is removed automatically when its socket connection closes.