Logging

The CLI embraces the swift-log interface for logging. The package abstracts away the implementation details of logging, allowing the CLI to be agnostic to the logging backend. The logger is dependency-injected using task locals and can be accessed anywhere using:

Logger.current

NOTE

Task locals don't propagate the value when using Dispatch or detached tasks, so if you use them, you'll need to get it and pass it to the asynchronous operation.

What to log

Logs are not the CLI's UI. They are a tool to diagnose issues when they arise. Therefore, the more information you provide, the better. When building new features, put yourself in the shoes of a developer coming across unexpected behavior, and think about what information would be helpful to them. Ensure you you use the right log level. Otherwise developers won't be able to filter out the noise.