Ent - simple & easy to use logging library

[Lafolie]

Hello guys & gals, here is my logging lib 'Ent'. Here's some features straight from the readme:

• Minimal, simple API
• Threaded to prevent disk I/O lag spikes
• Outputs to HTML or plaintext
• Automatically removes old log files (configurable)
• Customisable log levels
• Easy to integrate

And here is the example code:

Code: Select all

ent = require "ent"

function love.load()
	-- create the logfile & writer thread
	ent.init()
end

function love.keypressed(key)
	-- log keypresses from the player
	ent.echo(key)
end

function love.quit()
	-- close the logfile & writer thread
	ent.close()
end

The main caveat to using Ent is by design - only 1 log file can be created per session. This is to emphasise ease of use (no need to be juggling filenames).

Another thing to note is that the output functions are created dynamically from the configured log levels. By default it comes with 7 levels which can be accessed as such:

Code: Select all

ent.echo
ent.info
ent.warn
ent.error
ent.edit
ent.client
ent.server

All ouput functions use the same signature as `string.format` and will perform the formatting. The output will have the timestamp and log level prepended to the input.

Code: Select all

local str = ent.info("Obey %s", "love")

Repo link: https://github.com/Lafolie/ent

[KayleMaster]

Looks great! Probably time to replace my print statements.
Can I request a feature?

Code: Select all

local map_logger = ent.logger("map")
map_logger.info("Loaded map Abyss")

-- Output
[map] Loaded map Abyss

Would be nice to have a built in wrapper so I can differentiate between various systems.

[Lafolie]

Looks great! Probably time to replace my print statements.
Can I request a feature?

Hey KayleMaster, thanks for your interest. Regarding your question, you can already do this by providing custom log levels. You can pass in a table to override the defaults with the init function. Each log level entry should be a table with 2 strings: the level lable, and a hex colour for HTML output. Ent will generate a function using the key of the table in the log levels table.

For example:

Code: Select all

local ent = require "ent"
local logLevels = 
{
	-- these are the defaults
	echo = {"Echo", "#aaaaaa"},
	info = {"Info", "#2288dd"},
	warn = {"Warning", "#dddd22"},
	error = {"Error!", "#ff44aa"},
	edit = {"Editor", "#88ddbb"},
	client = {"NetClient", "#aaaaaa"},
	server = {"NetServer", "#aaaaaa"},
	-- custom levels
	map = {"Map", "#ff8833"}
}

ent.init {logLevels = logLevels}

ent.map "Chocolate cake" -- will output "[00:00:00:00] (Map) Chocolate cake" in blueish text

--these also work
ent.info "Lemon cake"
ent.error "Bacon cake"
--etc

[KayleMaster]

That will work for me, although I was thinking of in conjuction with log levels. That being said, I think this is the better option anyways. Thanks!

[GVovkiv]

neat

[Lafolie]

That will work for me, although I was thinking of in conjuction with log levels. That being said, I think this is the better option anyways. Thanks!

No worries. Thanks for the feedback

Do let me know if you have any more suggestions or if you encounter any issues - feel free to file a ticket on github.