tiararodney/esm-logging
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
68 commits 4 branches 1 tag 306 KiB
Find a file
Tiara Rodney 3a6332a855
feat(handler): implement StreamHandler, ConsoleHandler, StderrHandler emit 
StreamHandler.emit() writes formatted output to a Writable stream.
ConsoleHandler maps log levels to console.warn/error/log. StderrHandler
emits via console.error. handleError() logs diagnostics instead of
throwing. FileHandler throws NotImplementedError on construction.
Removed Node.js stream import and conditional require() block.
2026-03-13 23:57:37 +01:00
docs chore: rename docs source directory 2025-04-25 18:49:41 +02:00
scripts chore: remove redundant script 2025-04-25 18:44:19 +02:00
src feat(handler): implement StreamHandler, ConsoleHandler, StderrHandler emit 2026-03-13 23:57:37 +01:00
tests/unit test(formatter): add tests for formatting, formatTime, formatError 2026-03-13 23:22:10 +01:00
vendor chore: add tiara-gitflow-spec as vendor submodule 2026-03-13 22:38:27 +01:00
.gitignore chore: make tests work 2025-04-25 19:19:40 +02:00
.gitmodules chore: add tiara-gitflow-spec as vendor submodule 2026-03-13 22:38:27 +01:00
bitbucket-pipelines.yml style(ci): add commands for removing test-reports 2025-05-01 22:50:33 +02:00
configure refactor: change autoconf script to be more verbose 2025-04-25 18:04:23 +02:00
configure.ac refactor: change autoconf script to be more verbose 2025-04-25 18:04:23 +02:00
CONTRIBUTING.md feat(init): publishing 2025-04-25 16:17:37 +02:00
eslint.config.mjs chore: add eslint with typescript-eslint, align package.json scripts 2026-03-13 22:38:36 +01:00
jest.config.mjs fix: correct jest roots and test import path 2026-03-13 22:38:41 +01:00
LICENSE refactor: update build environment 2025-04-25 18:43:19 +02:00
Makefile feat(make): introduce build flags 2025-04-25 19:32:14 +02:00
package-lock.json chore: add eslint with typescript-eslint, align package.json scripts 2026-03-13 22:38:36 +01:00
package.json chore: add eslint with typescript-eslint, align package.json scripts 2026-03-13 22:38:36 +01:00
README.md doc(README): init rudimentary README 2025-05-01 22:50:33 +02:00
TODO todo(8): in-progress 2026-03-13 23:27:50 +01:00
tsconfig.debug.json chore: redefine tsc config 2025-04-25 17:50:00 +02:00
tsconfig.json chore: redefine tsc config 2025-04-25 17:50:00 +02:00
tsconfig.node.json feat(init): publishing 2025-04-25 16:17:37 +02:00
typedoc.json feat: initialize tests, docs and refactor 2025-04-25 16:17:46 +02:00

README.md

esm-logging

This README is a stub. Working on it. Currently stabilizing the build environment after that I'll make it nice around here.

A quasi-port of the Python standard library logging module to ECMAScript.

Why?

First of, because logging is important. It is important for debugging purposes, leading to faster and more resilient development, for traceability leading to better security. Most logging libraries I've discovered didn't satisfy me, introduced weird concepts and all in all just weren't great. Other programming language ecosystems offer way nicer logging facilities. Take Rust for example, or... Python! Python has PEP, giving it a very structured approach towards implementing new features and that's also how its logging facilities came to be (PEP 282). Python's logging facilities are implemented by the logging module, which is part of the standard library and has been since 2002. It was originally authored by Vinay Sajip

Roadmap

  • do a quasi-port of the logging module with minimal amount of adaption
  • add documentation
  • add support for asynchronous calls
  • implement Open Cybersecurity Framework (OCSF) formatter
  • implement (Browser) local storage handler as a replacement for file handler

Usage

For the time being, please check out my CI service, for an idea on how to build this.