Feature: sink level

.clang-format

@@ -6,13 +6,22 @@
 #
 
 BasedOnStyle: Google
+BreakStringLiterals: true
 NamespaceIndentation: All
 BreakBeforeBinaryOperators: NonAssignment
-AlignOperands: false
+AlignOperands: AlignAfterOperator
 DerivePointerAlignment: false
 PointerAlignment: Right
-BinPackArguments: true
-BinPackParameters: true
+BinPackArguments: false
+BinPackParameters: false
 AllowShortFunctionsOnASingleLine: Empty
-AllowShortIfStatementsOnASingleLine: false
 IncludeBlocks: Preserve
+InsertBraces: true
+InsertTrailingCommas: Wrapped
+SortIncludes: CaseSensitive
+QualifierAlignment: Custom
+QualifierOrder: ['inline', 'static', 'constexpr', 'const', 'volatile', 'type', 'restrict']
+ReferenceAlignment: Right
+ReflowComments: true
+#RemoveSemicolon: true
+InsertNewlineAtEOF: true

.clang-tidy

@@ -6,9 +6,50 @@
 #
 
 ---
-Checks:          '-*,clang-analyzer-*,clang-diagnostic-*,readability-*,modernize-*,-modernize-use-trailing-return-type,boost-*,bugprone-*,cppcoreguidelines-*,google-*,hicpp-*,performance-*,readability-*,-google-readability-namespace-comments,-readability-inconsistent-declaration-parameter-name,-readability-braces-around-statements,-hicpp-signed-bitwise,-google-runtime-references,-cppcoreguidelines-avoid-magic-numbers,-cppcoreguidelines-pro-bounds-array-to-pointer-decay,-readability-magic-numbers,-hicpp-explicit-conversions,-hicpp-uppercase-literal-suffix,-readability-uppercase-literal-suffix,-hicpp-no-array-decay,-hicpp-special-member-functions,-bugprone-narrowing-conversions,-modernize-use-nodiscard,-google-readability-braces-around-statements,-hicpp-braces-around-statements,-bugprone-suspicious-semicolon,-readability-named-parameter,-hicpp-named-parameter,-readability-identifier-naming'
-WarningsAsErrors: 'modernize-*,cppcoreguidelines-*,boost-*,google-build-using-namespace,readability-else-after-return,google-readability-todo'
-AnalyzeTemporaryDtors: false
+Checks: "-*,
+  clang-analyzer-*, \
+  clang-diagnostic-*, \
+    -clang-diagnostic-missing-template-arg-list-after-template-kw, \
+  modernize-*, \
+    -modernize-use-nodiscard, \
+    -modernize-use-trailing-return-type, \
+  boost-*, \
+  bugprone-*, \
+    -bugprone-narrowing-conversions, \
+    -bugprone-suspicious-semicolon, \
+  cppcoreguidelines-*, \
+    -cppcoreguidelines-rvalue-reference-param-not-moved, \
+    -cppcoreguidelines-avoid-magic-numbers, \
+    -cppcoreguidelines-pro-bounds-array-to-pointer-decay, \
+  google-*, \
+    -google-readability-namespace-comments, \
+    -google-readability-braces-around-statements, \
+    -google-runtime-references, \
+  hicpp-*, \
+    -hicpp-explicit-conversions, \
+    -hicpp-uppercase-literal-suffix, \
+    -hicpp-signed-bitwise, \
+    -hicpp-no-array-decay, \
+    -hicpp-special-member-functions, \
+    -hicpp-braces-around-statements, \
+    -hicpp-named-parameter, \
+  performance-*, \
+  readability-*, \
+    -readability-magic-numbers, \
+    -readability-named-parameter, \
+    -readability-identifier-naming, \
+    -readability-uppercase-literal-suffix, \
+    -readability-inconsistent-declaration-parameter-name, \
+    -readability-braces-around-statements"
+WarningsAsErrors: "modernize-*, \
+  cppcoreguidelines-*, \
+  boost-*, \
+  performance-*, \
+  google-build-using-namespace, \
+  readability-else-after-return, \
+  readability-container-contains, \
+  google-readability-todo"
+HeaderFilterRegex: '\(hpp|h|pb\.h)'
 FormatStyle:     .clang-format
 User:            user
 CheckOptions:

.githooks/pre-commit

@@ -15,12 +15,12 @@ fi
 
 # check clang-format binary
 CLANG_FORMAT_ENABLED=1
-CLANG_FORMAT=$(which clang-format-15)
+CLANG_FORMAT=$(which clang-format-19)
 if [ -z "${CLANG_FORMAT}" ]; then
   CLANG_FORMAT=$(which clang-format)
   if [ -z "${CLANG_FORMAT}" ]; then
     echo "Command clang-format is not found" >&2
-    echo "Please, install clang-format version 15 to enable checkup C++-files formatting over git pre-commit hook" >&2
+    echo "Please, install clang-format version 19 to enable checkup C++-files formatting over git pre-commit hook" >&2
     CLANG_FORMAT_ENABLED=0
   fi
 fi
@@ -29,8 +29,8 @@ fi
 if [ $CLANG_FORMAT_ENABLED ]; then
   CLANG_FORMAT_VERSION=$($CLANG_FORMAT --version | sed -r "s/.*version ([[:digit:]]+).*/\1/")
 
-  if [ "$CLANG_FORMAT_VERSION" != "15" ]; then
-    echo "Please, install clang-format version 15 to enable checkup C++-files formatting over git pre-commit hook" >&2
+  if [ "$CLANG_FORMAT_VERSION" != "19" ]; then
+    echo "Please, install clang-format version 19 to enable checkup C++-files formatting over git pre-commit hook" >&2
     CLANG_FORMAT_ENABLED=0
   fi
 fi

.github/aux/github_venv.sh

@@ -0,0 +1,11 @@
+#
+# Copyright Quadrivium LLC
+# All Rights Reserved
+# SPDX-License-Identifier: Apache-2.0
+#
+
+GITHUB_ENV="${GITHUB_ENV:?}"
+export VIRTUAL_ENV="${1:?venv path not set}"
+export PATH="$VIRTUAL_ENV/bin:$PATH"
+echo "VIRTUAL_ENV=$VIRTUAL_ENV" >> "$GITHUB_ENV"
+echo "PATH=$PATH" >> "$GITHUB_ENV"

.github/workflows/clang-tidy.yml

@@ -17,7 +17,7 @@ on:
 
 jobs:
   build:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v1
       name: checkout
@@ -29,20 +29,20 @@ jobs:
       run: |
         set -e
         sudo apt-get update || true
-        sudo apt-get install -y ninja-build gcovr gcc-13 g++-13 clang-15 clang++-15 llvm-15
+        sudo apt-get install -y ninja-build gcovr gcc-13 g++-13 llvm-18 clang-18 clang++-18 clang-tidy-18 clang-format-18
 
         sudo update-alternatives --install /usr/bin/python       python       /usr/bin/python3               90
-        sudo update-alternatives --install /usr/bin/clang-tidy   clang-tidy   /usr/bin/clang-tidy-15         999 
-        sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-15       999 
-        sudo update-alternatives --install /usr/bin/clang        clang        /usr/lib/llvm-15/bin/clang-15  999
-        sudo update-alternatives --install /usr/bin/clang++      clang++      /usr/bin/clang++-15            999
+        sudo update-alternatives --install /usr/bin/clang-tidy   clang-tidy   /usr/bin/clang-tidy-18         999 
+        sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-18       999 
+        sudo update-alternatives --install /usr/bin/clang        clang        /usr/lib/llvm-18/bin/clang-18  999
+        sudo update-alternatives --install /usr/bin/clang++      clang++      /usr/bin/clang++-18            999
         sudo update-alternatives --install /usr/bin/gcc          gcc          /usr/bin/gcc-13                90
         sudo update-alternatives --install /usr/bin/g++          g++          /usr/bin/g++-13                90
         sudo update-alternatives --install /usr/bin/gcov         gcov         /usr/bin/gcov-13               90
 
-        sudo python3 -m pip install --upgrade pip
-        sudo python3 -m pip install scikit-build
-        sudo python3 -m pip install cmake==3.25 requests gitpython gcovr pyyaml
+#        sudo python3 -m pip install --upgrade pip
+#        sudo python3 -m pip install scikit-build
+#        sudo python3 -m pip install cmake==3.25 requests gitpython gcovr pyyaml
     - name: run checks
       run: |
         #!/bin/bash

.github/workflows/compilers.yml

@@ -21,7 +21,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-22.04, macOS-14]
+        os: [ubuntu-latest, macOS-latest]
         compiler: [{
           "cc": "gcc",
           "cxx": "g++"
@@ -30,7 +30,7 @@ jobs:
           "cxx": "clang++"
          }]
         exclude:
-          - os: macOS-14
+          - os: macOS-latest
             compiler:
               cc: gcc
     steps:
@@ -41,6 +41,9 @@ jobs:
         clean: true
         fetch-depth: 1
 
+    - name: venv
+      run: python3 -m venv --upgrade-deps ~/venv && .github/aux/github_venv.sh $_
+
     - name: install dependencies
       run: |
         set -e
@@ -49,20 +52,20 @@ jobs:
           brew install ninja
         else
           sudo apt-get update || true
-          sudo apt-get install -y ninja-build gcc-13 g++-13 clang-15 clang++-15
+          sudo apt-get install -y ninja-build gcovr gcc-13 g++-13 clang-18 clang++-18 clang-tidy-18 clang-format-18
+
           sudo update-alternatives --install /usr/bin/python       python       /usr/bin/python3               90
-          sudo update-alternatives --install /usr/bin/clang-tidy   clang-tidy   /usr/bin/clang-tidy-15         999 
-          sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-15       999 
-          sudo update-alternatives --install /usr/bin/clang        clang        /usr/lib/llvm-15/bin/clang-15  999
-          sudo update-alternatives --install /usr/bin/clang++      clang++      /usr/bin/clang++-15            999
+          sudo update-alternatives --install /usr/bin/clang-tidy   clang-tidy   /usr/bin/clang-tidy-18         999 
+          sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-18       999 
+          sudo update-alternatives --install /usr/bin/clang        clang        /usr/lib/llvm-18/bin/clang-18  999
+          sudo update-alternatives --install /usr/bin/clang++      clang++      /usr/bin/clang++-18            999
           sudo update-alternatives --install /usr/bin/gcc          gcc          /usr/bin/gcc-13                90
           sudo update-alternatives --install /usr/bin/g++          g++          /usr/bin/g++-13                90
           sudo update-alternatives --install /usr/bin/gcov         gcov         /usr/bin/gcov-13               90
         fi
 
-        sudo python3 -m pip install --upgrade pip
-        sudo python3 -m pip install scikit-build
-        sudo python3 -m pip install cmake==3.25 requests gitpython gcovr pyyaml
+        pip3 install scikit-build
+        pip3 install cmake==3.25 requests gitpython gcovr pyyaml
 
     - name: cmake
       env:

.github/workflows/coverage.yml

@@ -18,7 +18,7 @@ on:
 jobs:
   coverage:
     name: "codecov"
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
     - name: checkout
       uses: actions/checkout@v1
@@ -30,20 +30,20 @@ jobs:
       run: |
         set -e
         sudo apt-get update || true
-        sudo apt-get install -y ninja-build gcovr gcc-13 g++-13 clang-15 clang++-15
+        sudo apt-get install -y ninja-build gcovr gcc-13 g++-13 clang-18 clang++-18 clang-tidy-18 clang-format-18
 
         sudo update-alternatives --install /usr/bin/python       python       /usr/bin/python3               90
-        sudo update-alternatives --install /usr/bin/clang-tidy   clang-tidy   /usr/bin/clang-tidy-15         999 
-        sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-15       999 
-        sudo update-alternatives --install /usr/bin/clang        clang        /usr/lib/llvm-15/bin/clang-15  999
-        sudo update-alternatives --install /usr/bin/clang++      clang++      /usr/bin/clang++-15            999
+        sudo update-alternatives --install /usr/bin/clang-tidy   clang-tidy   /usr/bin/clang-tidy-18         999 
+        sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-18       999 
+        sudo update-alternatives --install /usr/bin/clang        clang        /usr/lib/llvm-18/bin/clang-18  999
+        sudo update-alternatives --install /usr/bin/clang++      clang++      /usr/bin/clang++-18            999
         sudo update-alternatives --install /usr/bin/gcc          gcc          /usr/bin/gcc-13                90
         sudo update-alternatives --install /usr/bin/g++          g++          /usr/bin/g++-13                90
         sudo update-alternatives --install /usr/bin/gcov         gcov         /usr/bin/gcov-13               90
 
-        sudo python3 -m pip install --upgrade pip
-        sudo python3 -m pip install scikit-build
-        sudo python3 -m pip install cmake==3.25 requests gitpython gcovr pyyaml
+#        sudo python3 -m pip install --upgrade pip
+#        sudo python3 -m pip install scikit-build
+#        sudo python3 -m pip install cmake==3.25 requests gitpython gcovr pyyaml
 
     - name: "cmake"
       env:

.github/workflows/tests.yml

@@ -38,7 +38,7 @@ jobs:
          - name: "Undefined Behavior Sanitizer"
            sanitizer: UBSAN
     name: "${{ matrix.options.name }}"
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     steps:
       - name: checkout
         uses: actions/checkout@v1
@@ -52,8 +52,8 @@ jobs:
           set -e
           sudo apt-get update || true
           sudo apt-get install -y ninja-build
-          sudo python3 -m pip install --upgrade pip
-          sudo pip3 install cmake requests gitpython gcovr pyyaml
+#          sudo python3 -m pip install --upgrade pip
+#          sudo pip3 install cmake requests gitpython gcovr pyyaml
 
       - name: cmake
         env:

example/01-simple/logger.yml

@@ -5,64 +5,53 @@
 # SPDX-License-Identifier: Apache-2.0
 #
 
-sinks:
-  - name: colored_stdout
-    type: console
-    stream: stdout
-    color: true
-    thread: name
-    capacity: 64
-    max_message_length: 120
-    buffer: 131072
-    latency: 100
-  - name: simple_stderr
-    type: console
-    stream: stderr
-    color: false
-    thread: name
-    capacity: 64
-    max_message_length: 120
-    buffer: 131072
-    latency: 100
-  - name: file
-    type: file
-    path: /tmp/solalog_example.log
-    thread: name
-    capacity: 2048
-    buffer: 4194304
-    latency: 1000
-  - name: syslog
-    type: syslog
-    ident: solalog_example
-    thread: name
-    capacity: 2048
-    buffer: 4194304
-    latency: 1000
-  - name: sink_to_everywhere
-    type: multisink
-    sinks:
+sinks:                             # List of sink configurations
+  - name: colored_stdout           # Unique name of the sink
+    type: console                  # Sink type: 'console' means output to the standard output or error stream
+    stream: stdout                 # Output stream type (stdout or stderr)
+    color: true                    # Whether to insert escape sequences for colored output
+    thread: name                   # Thread differentiation method: 'name' for named threads, 'id' for enumerated threads, 'none' for no print (default)
+    capacity: 64                   # Maximum number of buffered messages; affects memory usage
+    max_message_length: 120        # Maximum length of a single message; extra characters are dropped, affects memory usage
+    buffer: 131072                 # Maximum buffered data size in bytes before forcing a flush
+    latency: 100                   # Maximum delay in milliseconds before forcing a buffer flush; 0 means immediate flushing (default)
+    level: trace                   # Maximum log level this sink accepts (from trace and above)
+  - name: simple_stderr            # Unique name of the sink
+    type: console                  # Sink type: 'console' means output to the standard output or error stream
+    stream: stderr                 # Output stream type (stdout or stderr)
+    color: false                   # Whether to insert escape sequences for colored output
+    thread: name                   # Thread differentiation method: 'name' for named threads, 'id' for enumerated threads, 'none' for no print (default)
+    capacity: 64                   # Maximum number of buffered messages; affects memory usage
+    max_message_length: 120        # Maximum length of a single message; extra characters are dropped, affects memory usage
+    buffer: 131072                 # Maximum buffered data size in bytes before forcing a flush
+    latency: 100                   # Maximum delay in milliseconds before forcing a buffer flush
+    level: info                    # Maximum log level this sink accepts (from info and above)
+  - name: file                     # Unique name of the sink
+    type: file                     # Sink type: 'file' means output to a file
+    path: /tmp/solalog_example.log # Path to the output file
+    thread: name                   # Thread differentiation method: 'name' for named threads, 'id' for enumerated threads, 'none' for no print (default)
+    capacity: 2048                 # Maximum number of buffered messages; affects memory usage
+    buffer: 4194304                # Maximum buffered data size in bytes before forcing a flush
+    latency: 1000                  # Maximum delay in milliseconds before forcing a buffer flush; 0 means immediate flushing (default)
+  - name: syslog                   # Unique name of the sink
+    type: syslog                   # Sink type: 'syslog' means messages are sent to the system's syslog daemon
+    ident: solalog_example         # Identifier for the syslog channel
+    thread: name                   # Thread differentiation method: 'name' for named threads, 'id' for enumerated threads, 'none' for no print (default)
+    capacity: 2048                 # Maximum number of buffered messages; affects memory usage
+    buffer: 4194304                # Maximum buffered data size in bytes before forcing a flush
+    latency: 1000                  # Maximum delay in milliseconds before forcing a buffer flush; 0 means immediate flushing (default)
+  - name: sink_to_everywhere       # Unique name of the sink
+    type: multisink                # Sink type: 'multisink' means messages are broadcasted to the specified underlying sinks
+    sinks:                         # List of underlying sinks by name
       - file
       - colored_stdout
       - simple_stderr
       - syslog
-groups:
-  - name: main
-    sink: sink_to_everywhere
-    level: trace
-    children:
-      - name: blockchain
-      - name: consensus
-        level: debug
-        children:
-          - name: grandpa
-            level: info
-          - name: babe
-            children:
-              - name: block_executor
-                level: trace
-      - name: runtime
-        level: off
-        children:
-          - name: transaction
-            sink: file
-            level: debug
+groups:                            # List of group configurations
+  - name: main                     # Unique name of the group
+    sink: sink_to_everywhere       # Name of the sink used for output from loggers in this group; must be defined for a root group
+    level: trace                   # Maximum log level this group accepts; must be defined for a root group
+    is_fallback: true              # If true, this group is the default fallback group; only one group can be marked as fallback
+    children:                      # Nested groups; these groups inherit properties from the parent
+      - name: example_group
+      - name: another_group