mirror of
https://github.com/KjellKod/g3log.git
synced 2024-12-12 18:30:25 +01:00
parent
0e3fef50bb
commit
fec09b2bba
6
.github/workflows/codeql-analysis.yml
vendored
6
.github/workflows/codeql-analysis.yml
vendored
@ -47,7 +47,7 @@ jobs:
|
|||||||
|
|
||||||
# Initializes the CodeQL tools for scanning.
|
# Initializes the CodeQL tools for scanning.
|
||||||
- name: Initialize CodeQL
|
- name: Initialize CodeQL
|
||||||
uses: github/codeql-action/init@v1
|
uses: github/codeql-action/init@v2
|
||||||
with:
|
with:
|
||||||
languages: ${{ matrix.language }}
|
languages: ${{ matrix.language }}
|
||||||
# If you wish to specify custom queries, you can do so here or in a config file.
|
# If you wish to specify custom queries, you can do so here or in a config file.
|
||||||
@ -58,7 +58,7 @@ jobs:
|
|||||||
# Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
|
# Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
|
||||||
# If this step fails, then you should remove it and run the build manually (see below)
|
# If this step fails, then you should remove it and run the build manually (see below)
|
||||||
- name: Autobuild
|
- name: Autobuild
|
||||||
uses: github/codeql-action/autobuild@v1
|
uses: github/codeql-action/autobuild@v2
|
||||||
|
|
||||||
# ℹ️ Command-line programs to run using the OS shell.
|
# ℹ️ Command-line programs to run using the OS shell.
|
||||||
# 📚 https://git.io/JvXDl
|
# 📚 https://git.io/JvXDl
|
||||||
@ -72,4 +72,4 @@ jobs:
|
|||||||
# make release
|
# make release
|
||||||
|
|
||||||
- name: Perform CodeQL Analysis
|
- name: Perform CodeQL Analysis
|
||||||
uses: github/codeql-action/analyze@v1
|
uses: github/codeql-action/analyze@v2
|
||||||
|
@ -1,9 +1,19 @@
|
|||||||
|
|
||||||
***PULL REQUEST DESCRIPTION***
|
# PULL REQUEST DESCRIPTION
|
||||||
|
|
||||||
`ADD CONTENT HERE TO DESCRIBE THE PURPOSE OF THE PULL REQUEST`
|
`ADD CONTENT HERE TO DESCRIBE THE PURPOSE OF THE PULL REQUEST`
|
||||||
|
|
||||||
**Testing Advice**
|
# Testing
|
||||||
|
|
||||||
|
- [] This new/modified code was covered by unit tests.
|
||||||
|
|
||||||
|
- [] (insight) Was all tests written using TDD (Test Driven Development) style?
|
||||||
|
|
||||||
|
- [] The CI (Windows, Linux, OSX) are working without issues.
|
||||||
|
|
||||||
|
- [] Was new functionality documented?
|
||||||
|
|
||||||
|
- [] The testing steps 1 - 2 below were followed
|
||||||
|
|
||||||
_step 1_
|
_step 1_
|
||||||
|
|
||||||
@ -18,13 +28,3 @@ _step 2: use one of these alternatives to run tests:_
|
|||||||
- Cross-Platform: `ctest`
|
- Cross-Platform: `ctest`
|
||||||
- or `ctest -V` for verbose output
|
- or `ctest -V` for verbose output
|
||||||
- Linux: `make test`
|
- Linux: `make test`
|
||||||
|
|
||||||
|
|
||||||
***CHECKLIST TO COMPLETE***
|
|
||||||
- [ ] **TDD**: New/modified code must be backed down with unit test - preferably _Test Driven Development_ style development)
|
|
||||||
- [ ] **Documentation**: All new/modified functionality should be backed up with API documentation (API.markdown or README.markdown)
|
|
||||||
|
|
||||||
|
|
||||||
**Cross-Platform Testing**
|
|
||||||
- [ ] CI GitActions: (Linux, OSX) + AppVeyor-CI (Windows)\
|
|
||||||
- [ ] Local/VM testing, at least one of the following: Windows, Linux, OSX
|
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
# How to use G3log
|
# How to use g3log
|
||||||
G3log is an asynchronous logger with dynamic sinks
|
G3log is an asynchronous logger with dynamic sinks
|
||||||
|
|
||||||
|
|
||||||
@ -10,7 +10,7 @@ LOG(INFO) << "streaming API is as easy as ABC or " << 123;
|
|||||||
LOGF(WARNING, "Printf-style syntax is also %s", "available");
|
LOGF(WARNING, "Printf-style syntax is also %s", "available");
|
||||||
```
|
```
|
||||||
|
|
||||||
## <a name="what-g3log-is">What G3Log is</a>
|
## <a name="what-g3log-is">What g3Log is</a>
|
||||||
|
|
||||||
* ***G3log*** is the acting name for the third version of g2log and it stands for **g3log with dynamic sinks**
|
* ***G3log*** is the acting name for the third version of g2log and it stands for **g3log with dynamic sinks**
|
||||||
* G3log is an asynchronous, "crash-safe" logger. You can read more about it here [[g2log version]](
|
* G3log is an asynchronous, "crash-safe" logger. You can read more about it here [[g2log version]](
|
||||||
@ -44,7 +44,7 @@ CHECK(less > more) << "CHECK(false) triggers a FATAL message";
|
|||||||
Please look at [API.md](API.md) for detailed API documentation
|
Please look at [API.md](API.md) for detailed API documentation
|
||||||
|
|
||||||
|
|
||||||
## <a name="benefits-with-g3log">Benefits you get when using G3log</a>
|
## <a name="benefits-with-g3log">Benefits you get when using g3log</a>
|
||||||
1. Easy to use, clean syntax and a blazing fast logger.
|
1. Easy to use, clean syntax and a blazing fast logger.
|
||||||
|
|
||||||
2. All the slow log I/O disk access is done in a background thread. This ensures that the LOG caller can immediately continue with other tasks and do not have to wait for the LOG call to finish.
|
2. All the slow log I/O disk access is done in a background thread. This ensures that the LOG caller can immediately continue with other tasks and do not have to wait for the LOG call to finish.
|
||||||
@ -68,11 +68,11 @@ The logger will catch certain fatal events *(Linux/OSX: signals, Windows: fatal
|
|||||||
|
|
||||||
|
|
||||||
## <a name="g3log-with-sinks">G3log with sinks</a>
|
## <a name="g3log-with-sinks">G3log with sinks</a>
|
||||||
[Sinks](http://en.wikipedia.org/wiki/Sink_(computing)) are receivers of LOG calls. G3log comes with a default sink (*the same as G3log uses*) that can be used to save log to file. A sink can be of *any* class type without restrictions as long as it can either receive a LOG message as a *std::string* **or** as a *g3::LogMessageMover*.
|
[Sinks](http://en.wikipedia.org/wiki/Sink_(computing)) are receivers of LOG calls. G3log comes with a default sink (*the same as g3log uses*) that can be used to save log to file. A sink can be of *any* class type without restrictions as long as it can either receive a LOG message as a *std::string* **or** as a *g3::LogMessageMover*.
|
||||||
|
|
||||||
The *std::string* comes pre-formatted. The *g3::LogMessageMover* is a wrapped struct that contains the raw data for custom handling in your own sink.
|
The *std::string* comes pre-formatted. The *g3::LogMessageMover* is a wrapped struct that contains the raw data for custom handling in your own sink.
|
||||||
|
|
||||||
A sink is *owned* by the G3log and is added to the logger inside a ```std::unique_ptr```. The sink can be called though its public API through a *handler* which will asynchronously forward the call to the receiving sink.
|
A sink is *owned* by the g3log and is added to the logger inside a ```std::unique_ptr```. The sink can be called though its public API through a *handler* which will asynchronously forward the call to the receiving sink.
|
||||||
|
|
||||||
It is <a name="crazy-simple">crazy simple to create a custom sink</a>. This example show what is needed to make a custom sink that is using custom log formatting but only using that
|
It is <a name="crazy-simple">crazy simple to create a custom sink</a>. This example show what is needed to make a custom sink that is using custom log formatting but only using that
|
||||||
for adding color to the default log formatting. The sink forwards the colored log to cout
|
for adding color to the default log formatting. The sink forwards the colored log to cout
|
||||||
|
@ -1,6 +1,5 @@
|
|||||||
site_name: G3log, an asynchronous "crash-safe" logger
|
site_name: G3log, an asynchronous "crash-safe" logger
|
||||||
site_author: 'Kjell Hedström'
|
site_author: 'Kjell Hedström'
|
||||||
docs_dir: docs/
|
|
||||||
repo_name: 'KjellKod/g3log'
|
repo_name: 'KjellKod/g3log'
|
||||||
repo_url: 'https://github.com/KjellKod/g3log'
|
repo_url: 'https://github.com/KjellKod/g3log'
|
||||||
theme:
|
theme:
|
||||||
|
Loading…
Reference in New Issue
Block a user