Draft: Release 0.3.0

Release 0.3.0:

This release uses (nearly everywhere) the same interfaces (as in 0.2.5) but changed the implementation under the hood. These changes are a preparation for future features of libClaPP (where options and parameters can be combined logically and grouped together).

Release 0.3.0 contains the following changes:

• added support for leak sanitzier.
• new Gitlab-CI-pipelines (added the following new architectures and OSs):
  • includes amd64 (debian 10, ubuntu 20.04, ubuntu 21.04)
  • includes arm64 (debian 10, ubuntu 20.04, ubuntu 21.04)
  • includes armhf (debian 10)
• added support for clang- and gcc-compilers up to version 12 (however, C++17 is still a mandatory requirement).
• moved clang-tidy build-options to cmake/clang_tidy.cmake (including a transition to clang-tidy-12 and several code-fixes newer clang-tidy-versions complained about).
• moved compiler build-options to cmake/compiler_flags.cmake.
• bump clang-format-7 to clang-format-11 (as clang-format-7 formatted code leads to compound-token-split-by-space warning in clang-12).
• bump submodule third_party/googletest to version 1.11.0.
• bump submodule third_party/GSL to version 3.1.0.
• fixed documentation.
• fixed and added new tests.
• renamed test-names from snake-case to camel-case. (as suggested by google-test framework documentation)
• updated help text generation.

.gitlab-ci.yml

@@ -139,601 +139,3 @@ test_gcov_debian_10_amd64:
         - job: compile_debian_10_amd64
           artifacts: true
     <<: *test_gcov_definition
-
-#compile_debian_10_arm64:
-#    tags:
-#        - compiler
-#        - debian-10-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_definition
-#
-#test_gcov_debian_10_arm64:
-#    tags:
-#        - compiler
-#        - debian-10-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    needs:
-#        - job: compile_debian_10_arm64
-#          artifacts: true
-#    <<: *test_gcov_definition
-#
-#compile_debian_10_armhf:
-#    tags:
-#        - compiler
-#        - debian-10-armhf
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_definition
-#
-#test_gcov_debian_10_armhf:
-#    tags:
-#        - compiler
-#        - debian-10-armhf
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    needs:
-#        - job: compile_debian_10_armhf
-#          artifacts: true
-#    <<: *test_gcov_definition
-#
-#compile_ubuntu_20.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-20.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_definition
-#
-#test_gcov_ubuntu_20.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-20.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    needs:
-#        - job: compile_ubuntu_20.04_amd64
-#          artifacts: true
-#    <<: *test_gcov_definition
-#
-#compile_ubuntu_20.04_arm64:
-#    tags:
-#        - compiler
-#        - ubuntu-20.04-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_definition
-#
-#test_gcov_ubuntu_20.04_arm64:
-#    tags:
-#        - compiler
-#        - ubuntu-20.04-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    needs:
-#        - job: compile_ubuntu_20.04_arm64
-#          artifacts: true
-#    <<: *test_gcov_definition
-#
-#compile_ubuntu_21.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-21.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [11, 12]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [11]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_definition
-#
-#test_gcov_ubuntu_21.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-21.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [11, 12]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [11]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    needs:
-#        - job: compile_ubuntu_21.04_amd64
-#          artifacts: true
-#    <<: *test_gcov_definition
-#
-#compile_ubuntu_21.04_arm64:
-#    tags:
-#        - compiler
-#        - ubuntu-21.04-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [11, 12]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [11]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_definition
-#
-#test_gcov_ubuntu_21.04_arm64:
-#    tags:
-#        - compiler
-#        - ubuntu-21.04-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [11, 12]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [11]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    needs:
-#        - job: compile_ubuntu_21.04_arm64
-#          artifacts: true
-#    <<: *test_gcov_definition
-#
-#compile_clang_tidy_ubuntu_20.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-20.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_clang_tidy_definition
-#
-#compile_clang_tidy_ubuntu_21.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-21.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [11, 12]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_clang_tidy_definition
-#
-#compile_install_debian_10_amd64:
-#    tags:
-#        - compiler
-#        - debian-10-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_install_definition
-#
-#compile_install_debian_10_arm64:
-#    tags:
-#        - compiler
-#        - debian-10-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_install_definition
-#
-#compile_install_debian_10_armhf:
-#    tags:
-#        - compiler
-#        - debian-10-armhf
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_install_definition
-#
-#compile_install_ubuntu_20.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-20.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_install_definition
-#
-#compile_install_ubuntu_20.04_arm64:
-#    tags:
-#        - compiler
-#        - ubuntu-20.04-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [7, 8, 9, 10]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_install_definition
-#
-#compile_install_ubuntu_21.04_amd64:
-#    tags:
-#        - compiler
-#        - ubuntu-21.04-amd64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [11, 12]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [11]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_install_definition
-#
-#compile_install_ubuntu_21.04_arm64:
-#    tags:
-#        - compiler
-#        - ubuntu-21.04-arm64
-#    parallel:
-#        matrix:
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: clang
-#              COMPILER_VERSION: [11, 12]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#            - BUILD_TYPE: [Debug, Release]
-#              COMPILER: gcc
-#              COMPILER_VERSION: [11]
-#              GENERATOR: ["Unix Makefiles", "Ninja"]
-#    <<: *compile_install_definition
-#
-#compile_release_address_leak_sanitizer_gcc11_amd64:
-#    variables:
-#        CXX: "g++-11"
-#        CC: "gcc-11"
-#        BUILD_TYPE: "Release"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_ADDRESS=On -DlibClaPP_ENABLE_SANITIZER_LEAK=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_release_address_leak_sanitizer_gcc11_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_release_address_leak_sanitizer_gcc11_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_debug_address_leak_sanitizer_gcc11_amd64:
-#    variables:
-#        CXX: "g++-11"
-#        CC: "gcc-11"
-#        BUILD_TYPE: "Debug"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_ADDRESS=On -DlibClaPP_ENABLE_SANITIZER_LEAK=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_debug_address_leak_sanitizer_gcc11_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_debug_address_leak_sanitizer_gcc11_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_release_thread_sanitizer_gcc11_amd64:
-#    variables:
-#        CXX: "g++-11"
-#        CC: "gcc-11"
-#        BUILD_TYPE: "Release"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_THREAD=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_release_thread_sanitizer_gcc11_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_release_thread_sanitizer_gcc11_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_debug_thread_sanitizer_gcc11_amd64:
-#    variables:
-#        CXX: "g++-11"
-#        CC: "gcc-11"
-#        BUILD_TYPE: "Debug"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_THREAD=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_debug_thread_sanitizer_gcc11_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_debug_thread_sanitizer_gcc11_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_release_undefined_behavior_sanitizer_gcc11_amd64:
-#    variables:
-#        CXX: "g++-11"
-#        CC: "gcc-11"
-#        BUILD_TYPE: "Release"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_UNDEFINED_BEHAVIOR=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_release_undefined_behavior_sanitizer_gcc11_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_release_undefined_behavior_sanitizer_gcc11_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_debug_undefined_behavior_sanitizer_gcc11_amd64:
-#    variables:
-#        CXX: "g++-11"
-#        CC: "gcc-11"
-#        BUILD_TYPE: "Debug"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_UNDEFINED_BEHAVIOR=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_debug_undefined_behavior_sanitizer_gcc11_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_debug_undefined_behavior_sanitizer_gcc11_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_release_address_leak_sanitizer_clang12_amd64:
-#    variables:
-#        CXX: "clang++-12"
-#        CC: "clang-12"
-#        BUILD_TYPE: "Release"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_ADDRESS=On -DlibClaPP_ENABLE_SANITIZER_LEAK=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_release_address_leak_sanitizer_clang12_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_release_address_leak_sanitizer_clang12_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_debug_address_leak_sanitizer_clang12_amd64:
-#    variables:
-#        CXX: "clang++-12"
-#        CC: "clang-12"
-#        BUILD_TYPE: "Debug"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_ADDRESS=On -DlibClaPP_ENABLE_SANITIZER_LEAK=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_debug_address_leak_sanitizer_clang12_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_debug_address_leak_sanitizer_clang12_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_release_undefined_behavior_sanitizer_clang12_amd64:
-#    variables:
-#        CXX: "clang++-12"
-#        CC: "clang-12"
-#        BUILD_TYPE: "Release"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_UNDEFINED_BEHAVIOR=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_release_undefined_behavior_sanitizer_clang12_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_release_undefined_behavior_sanitizer_clang12_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_debug_undefined_behavior_sanitizer_clang12_amd64:
-#    variables:
-#        CXX: "clang++-12"
-#        CC: "clang-12"
-#        BUILD_TYPE: "Debug"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_UNDEFINED_BEHAVIOR=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_debug_undefined_behavior_sanitizer_clang12_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_debug_undefined_behavior_sanitizer_clang12_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_release_thread_sanitizer_clang12_amd64:
-#    variables:
-#        CXX: "clang++-12"
-#        CC: "clang-12"
-#        BUILD_TYPE: "Release"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_THREAD=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_release_thread_sanitizer_clang12_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_release_thread_sanitizer_clang12_amd64
-#          artifacts: true
-#    <<: *test_definition
-#
-#compile_debug_thread_sanitizer_clang12_amd64:
-#    variables:
-#        CXX: "clang++-12"
-#        CC: "clang-12"
-#        BUILD_TYPE: "Debug"
-#        GENERATOR: "Unix Makefiles"
-#        ADDITIONAL_OPTION: "-DlibClaPP_ENABLE_SANITIZER_THREAD=On"
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    <<: *compile_definition
-#
-#test_debug_thread_sanitizer_clang12_amd64:
-#    tags:
-#        - ubuntu-21.04-amd64
-#        - compiler
-#    needs:
-#        - job: compile_debug_thread_sanitizer_clang12_amd64
-#          artifacts: true
-#    <<: *test_definition