- Notifications
You must be signed in to change notification settings - Fork9
🦒 Beautiful Logger for Node.js: the best alternative to the console.log statement
License
ptkdev/ptkdev-logger
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
The best alternative to the console.log statement
This project isfree,open source and I try to provide excellentfree support. Why donate? I work on this project several hours in my spare time and try to keep it up to date and working.THANK YOU!
- 💡Features
- 👔Screenshot
- 🚀How to use
- 📚Documentation
- 🤹♂️LogRotate
- 👨💻Contributing
- 🐛Known Bugs
- 🍻 Community:
- [✔️] Easy to use
- [✔️] MIT License
- [✔️] Palette (🎨 Customize colors)
- [✔️] Logrotate 🤹♂️
- [✔️] Typescript support
- [✔️] The best alternative to the console.log statement
- [✔️] Write stdout logs to file (supported format: text/log and json)
- [✔️] The JSON logs format is compatible withpinojs
- [✔️] Translations: 🇬🇧 🇮🇹 🇵🇱 🇪🇸 🇵🇹 🇷🇺 🇩🇪 🇫🇷 (Help me ❤️)
- In your node project run:
npm install @ptkdev/logger --save
- Usage:
constLogger=require("@ptkdev/logger");constlogger=newLogger();logger.info("message");
You can setoptions
tonew Logger(options);
example:
constLogger=require("@ptkdev/logger");constoptions={language:"en",colors:true,debug:true,info:true,warning:true,error:true,sponsor:true,write:true,type:"log",rotate:{size:"10M",encoding:"utf8",},path:{// remember: add string *.log to .gitignoredebug_log:"./debug.log",error_log:"./errors.log",},};constlogger=newLogger(options);logger.info("message");
See folderexamples
, run withnode example.js
. Below is available a description ofoptions
values.
Parameter | Description | Values | Default value | Available since |
---|---|---|---|---|
language | Set language of log type | en / it / pl / es / pt / de / ru / fr | en | v1.0.0 |
colors | Enable colors in terminal | true / enabled / false / disabled | true | v1.0.0 |
debug | Enable all logs with method debug | true / enabled / false / disabled | true | v1.0.0 |
info | Enable all logs with method info | true / enabled / false / disabled | true | v1.0.0 |
warning | Enable all logs with method warning | true / enabled / false / disabled | true | v1.0.0 |
error | Enable all logs with method errors | true / enabled / false / disabled | true | v1.0.0 |
sponsor | Enable all logs with method sponsor | true / enabled / false / disabled | true | v1.0.0 |
write | Write the logs into a file, you need set path values | true / enabled / false / disabled | false | v1.0.0 |
type | Format of logs in files | log / json | log | v1.0.0 |
rotate | Rotates the log files when size exceeds this value | 10B /10K /10M /10G | "rotate": {"size": "10M"} | v1.5.0 |
palette | Change palette with hexcode colors | Object | default palette | v1.5.0 |
path | If write is true, the library writes the logs to a path | Object | {"debug_log": "./debug.log", "error_log": "./errors.log"} | v1.0.0 |
Method | Description | Parameters |
---|---|---|
debug(message ,tag ) | message : Display debug log messagetag : prefix of message | message : string (mandatory)tag : string (optional) |
info(message ,tag ) | message : Display info log messagetag : prefix of message | message : string (mandatory)tag : string (optional) |
warning(message ,tag ) | message : Display warning log messagetag : prefix of message | message : string (mandatory)tag : string (optional) |
error(message ,tag ) | message : Display errors log messagetag : prefix of message | message : string (mandatory)tag : string (optional) |
sponsor(message ,tag ) | message : Display sponsor log messagetag : prefix of message | message : string (mandatory)tag : string (optional) |
stackoverflow(message ,tag ,error_string ) | message : Display stackoverflow log messagetag : prefix of messageerror_string : query for stackoverflow, if empty we use message param | message : string (mandatory)tag : string (optional)error_string : string (optional) |
docs(message ,url ,tag ) | message : Display docs log messageurl : link of documentationtag : prefix of message | message : string (mandatory)url : string (optional)tag : string (optional) |
You can customize palette colors with Objectpalette
and with hexcode values.
label
is text on left (INFORMATION / ERROR / DOCS, etc..)text
is message of log on rightbackground
is background color on left side
{..."palette":{"info":{// method name"label":"#ffffff",// label on left"text":"#4CAF50",// log message"background":"#4CAF50"// background},"warning":{"label":"#ffffff","text":"#FF9800","background":"#FF9800"},"error":{"label":"#ffffff","text":"#FF5252","background":"#FF5252"},"stackoverflow":{"label":"#ffffff","text":"#9C27B0","background":"#9C27B0"},"docs":{"label":"#ffffff","text":"#FF4081","background":"#FF4081"},"debug":{"label":"#ffffff","text":"#1976D2","background":"#1976D2"},"sponsor":{"label":"#ffffff","text":"#607D8B","background":"#607D8B"},"time":{"label":"#ffffff","background":"#795548"}}...}
See folderexamples
, run withnode example.js
.
Rotates the file when size exceeds 10 megabytes (optional, default 10M - values: 10B (byte) / 10K (kilobyte)/ 10M (megabyte)/ 10G (gigabyte))
..."rotate":{"size":"10M","encoding":"utf8"},...
Runnpm run docs
Support this project by becoming a sponsor. 🙏 Become a sponsor onpatreon or become top3 sponsor onko-fi. Your logo will show up here with a link to your website.
Thank you to all our backers! 🙏 Become a backer onpatreon.
I ❤️ contributions! I will happily accept your pull request! Translations, grammatical corrections (GrammarNazi you are welcome! Yes my English is bad, sorry), etc... Do not be afraid, if the code is not perfect we will work together 👯 and remember to insert your name in.all-contributorsrc
andpackage.json
file.
Thanks goes to these wonderful people (emoji key):
Patryk Rzucidło 💻🌍📖🐛 | Ilua Chubarov 💻 | Bruno Kümmel 💻🌍 | Alina Osv 🌍 | Sylvain Téchené 🌍 | Giovanni Cardamone 💻 |
💰 In the future, if the donations allow it, I would like to share some of the success with those who helped me the most. For me open source is share of code, share development knowledges and share donations!
I love snake_case syntax sorry for this 😭 don't hate me.
- Code and Contributions haveMIT License
- Images and logos haveCC BY-NC 4.0 License (Freepik Premium License)
- Documentations and Translations haveCC BY 4.0 License
Copyleft (c) 2020Patryk Rzucidło (@PTKDev) <support@ptkdev.io>
About
🦒 Beautiful Logger for Node.js: the best alternative to the console.log statement