https://github.com/thanhit95/log4sh

log4sh library providing various logging features for shell scripts (bash, zsh)
https://github.com/thanhit95/log4sh

bash log logger logging syslog zsh

Last synced: about 2 months ago
JSON representation

log4sh library providing various logging features for shell scripts (bash, zsh)

• Host: GitHub
• URL: https://github.com/thanhit95/log4sh
• Owner: thanhit95
• License: bsd-3-clause
• Created: 2024-11-16T07:22:21.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-01T05:06:10.000Z (about 2 months ago)
• Last Synced: 2024-12-01T05:28:30.813Z (about 2 months ago)
• Topics: bash, log, logger, logging, syslog, zsh
• Language: Shell
• Homepage:
• Size: 90.8 KB
• Stars: 9
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# log4sh

## Introduction

Logging library supporting various features:

- Log level control (min/max threshold)

- Log message formatting

- Multiple output channels (stdout, stderr, file, cmd, syslog)

- Stack trace dump

- Configuration file

Output example:

```shell

# Using the API fuctions:

#   t_logdbg "msg with debug level"

#   t_loginfo "msg with info level"

#   t_log INFO "msg with info level (alias API)"

#   t_log_st WARN "illegal argument value"

#

# Output:

2024-11-30 16:25:14.862 [DEBUG] demo.sh:16: check_data: msg with debug level

2024-11-30 16:25:14.864 [INFO ] demo.sh:17: check_data: msg with info level

2024-11-30 16:25:14.866 [INFO ] demo.sh:18: check_data: msg with info level (alias API)

2024-11-30 16:25:14.868 [WARN ] demo.sh:19: check_data: illegal argument value

    at check_data (./demo.sh:19)

    at send_request (./demo.sh:24)

    at main (./demo.sh:29)

```

## Tutorials

You may checkout `examples` directory. It provides complete, step-by-step demonstrations.

## History

This repository was originally named `linux_shell_kit`. At that time, it had some features such as `log4sh`, `proc_stat`, and others. I decided to change the development direction, so now it focuses solely on `log4sh` (and, of course, I've renamed this repository to `log4sh`).

Other features, like `proc_stat`, will be moved to a new repository with original name: [https://github.com/thanhit95/linux_shell_kit](https://github.com/thanhit95/linux_shell_kit)

## Author & license

Author: Thanh Nguyen

Email: thanh.it1995 (at) gmail.com

This repo is licensed under the 3-Clause BSD License.