https://github.com/smooll-d/slou
"Smooll" LOgging Utility.
https://github.com/smooll-d/slou
cpp logger loggers logging logging-library meson
Last synced: 5 days ago
JSON representation
"Smooll" LOgging Utility.
- Host: GitHub
- URL: https://github.com/smooll-d/slou
- Owner: smooll-d
- License: mit
- Created: 2023-03-11T16:34:49.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-03-21T23:10:24.000Z (over 3 years ago)
- Last Synced: 2024-11-16T09:07:48.298Z (over 1 year ago)
- Topics: cpp, logger, loggers, logging, logging-library, meson
- Language: C++
- Homepage: https://reallysmooll.github.io/slou-docs/
- Size: 192 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# slou
"Smooll" LOgging Utility (pronounced `slew`).
`slou` is a simple logging library made in C++ that's easy to use and can be used in both small and big projects.
## Installation
slou uses the Meson build system which means that you can install your project on all platforms that are supported by Meson.
Linux users can download a binary of the library on the [Releases](https://www.github.com/reallySmooll/slou/releases) page.
Windows users can now also download a binary of the library on the [Releases](https://www.github.com/reallySmooll/slou/releases) page.
### Dependencies
- Meson
- git
- Doxygen (optional, if you want to help with documentation, install it)
### Building
Building slou is as easy as 1-2-3. The following commands are directed at Linux users but it should work for any operating system as Meson will generate the necessary files for building the project.
```bash
$ git clone --recursive https://github.com/reallySmooll/slou.git
$ cd slou/
$ meson setup build/
$ meson compile -C build/
```
If you're on Linux and want to install the library system-wide, you can use these commands (after cloning the repository and entering into the directory):
```bash
$ meson setup --prefix /usr build/
$ sudo meson install -C build
```
## Quickstart
slou was designed to be very easy to use. And as it is a small library it doesn't require anymore setup than this:
```cpp
#include
int main()
{
slou::Logger logger;
logger.Log(logger.INFO, "Hello, world!");
return 0;
}
```
That is the default setup for slou. The logs will be saved to a file called (by default) `slou.log` but the logs will not be displayed on the screen.
You can obviously change this and customize it to your liking. If you'd like to see more, you can check out the documentation [here](https://reallysmooll.github.io/slou-docs) or [USAGE.md](https://www.github.com/reallySmooll/slou/blob/master/USAGE.md).
**NOTE: There are problems with images on the `Usage and configuration` section on the documentation page for slou, we are fixing them but until this note disappears, please use the [USAGE.md](https://www.github.com/reallySmooll/slou/blob/master/USAGE.md) if you want to see proof that the configuration works. Sorry for the inconvenience. :)**
## Contributing
If you'd like to contribute, please refer to the [contributing guide](https://www.github.com/reallySmooll/slou/blob/master/CONTRIBUTING.md).
Here are some contributions:
- Testing on Windows - Marcel Zdziechowicz ([@marcel-zdziechowicz](https://www.github.com/marcel-zdziechowicz))
## Code of Conduct
If you'd like to see it, check out the [CODE_OF_CONDUCT.md](https://www.github.com/reallySmooll/slou/blob/master/CODE_OF_CONDUCT.md).