# ln: The Natural Logger for Lua

This is a clone of [ln](https://github.com/Xe/ln) for Lua. ln works by using
key->value pairs to create structured logging output. By default, this outputs
logs formatted similar to [logfmt][logfmt].

[logfmt]: https://www.brandur.org/logfmt

Example:

```lua
local ln = require "ln"

ln.log {foo = "bar"}
-- time="2019-12-25T13:24:00" foo=bar
```

It also supports multiple tables:

```lua
local ln = require "ln"

ln.log({foo = "bar"}, {needs_space = "a string value with spaces"})
-- time="2019-12-25T13:24:00" foo=bar needs_space="a string value with spaces"
```

And logging errors:

```lua
local ln = require "ln"

local result, err = thing_that_could_fail()
if err ~= nil then
  ln.err(err, {tried = "thing_that_could_fail()"})
end
-- time="2019-12-25T13:27:32" err="vibe check failed" tried=thing_that_could_fail()
```

And outputting logs as JSON:

```
local ln = require "ln"

ln.default_logger.formatter = ln.JSONFormatter:new()
ln.log {foo = "bar"}
-- {"foo":"bar","time":"2019-12-25T13:27:32"}
```

Or creating your own logger instance:

```lua
local ln = require "ln"

local lgr = ln.Logger:new()
lgr:log {foo = "bar"}
-- time="2019-12-25T13:27:32" foo=bar
```