configuration mechanism

.github/workflows/self-hosted.yml

@@ -90,7 +90,7 @@ jobs:
 
       - name: Check for tests results
         run: |
-          ! grep -qi "FAILED" ${{ env.test-file }}
+          ! grep -qE "\[  FAILED  \]" ${{ env.test-file }}
 
   clean:
     name: Cleanup workspace

.github/workflows/ubuntu.yml

@@ -106,4 +106,4 @@ jobs:
 
       - name: Check for tests results
         run: |
-          ! grep -qi "FAILED" ${{ env.test-file }}
+          ! grep -qE "\[  FAILED  \]" ${{ env.test-file }}

CMakeLists.txt

@@ -178,6 +178,22 @@ endfunction()
 add_subdirectory(deps/robin_hood)
 add_subdirectory(deps/svector)
 
+message(STATUS "Add CLI11 as CLI/ENV parser")
+include(FetchContent)
+
+FetchContent_Declare(CLI11
+    GIT_REPOSITORY https://github.com/CLIUtils/CLI11.git
+    GIT_TAG        v2.4.2
+)
+FetchContent_MakeAvailable(CLI11)
+
+message(STATUS "Add nlohmann/json as JSON parser")
+FetchContent_Declare(nlohmann_json
+    GIT_REPOSITORY https://github.com/nlohmann/json.git
+    GIT_TAG        v3.11.3
+)
+FetchContent_MakeAvailable(nlohmann_json)
+
 if (SPLA_BUILD_OPENCL)
     if (SPLA_TARGET_MACOSX)
         message(STATUS "Add standard Apple OpenCL package")
@@ -235,6 +251,8 @@ set(SRC_OPENCL)
 
 if (SPLA_BUILD_OPENCL)
     set(SRC_OPENCL
+            src/opencl/cl_configure.cpp
+            src/opencl/cl_configure.hpp
             src/opencl/cl_debug.hpp
             src/opencl/cl_accelerator.cpp
             src/opencl/cl_accelerator.hpp
@@ -371,11 +389,13 @@ target_compile_definitions(spla PRIVATE SPLA_EXPORTS)
 
 target_link_libraries(spla PRIVATE robin_hood)
 target_link_libraries(spla PRIVATE svector)
+target_link_libraries(spla PRIVATE CLI11::CLI11)
+target_link_libraries(spla PRIVATE nlohmann_json::nlohmann_json)
 
 if (SPLA_BUILD_OPENCL)
     target_link_libraries(spla PUBLIC OpenCL)
     target_link_libraries(spla PUBLIC OpenCL::HeadersCpp)
-    target_compile_definitions(spla PUBLIC CL_TARGET_OPENCL_VERSION=120)
+    target_compile_definitions(spla PUBLIC CL_TARGET_OPENCL_VERSION=300)
     list(APPEND SPLA_DEFINES SPLA_BUILD_OPENCL)
 endif ()
 

deps/opencl-headers/tests/pkgconfig/bare/CMakeLists.txt

@@ -19,7 +19,7 @@ target_link_libraries(${PROJECT_NAME}
 
 target_compile_definitions(${PROJECT_NAME}
   PRIVATE
-    CL_TARGET_OPENCL_VERSION=120
+    CL_TARGET_OPENCL_VERSION=300
 )
 
 include(CTest)

deps/opencl-headers/tests/pkgconfig/sdk/CMakeLists.txt

@@ -20,7 +20,7 @@ target_link_libraries(${PROJECT_NAME}
 
 target_compile_definitions(${PROJECT_NAME}
   PRIVATE
-    CL_TARGET_OPENCL_VERSION=120
+    CL_TARGET_OPENCL_VERSION=300
 )
 
 include(CTest)

deps/opencl-icd-loader/test/pkgconfig/bare/CMakeLists.txt

@@ -25,7 +25,7 @@ target_link_libraries(${PROJECT_NAME}
 
 target_compile_definitions(${PROJECT_NAME}
   PRIVATE
-    CL_TARGET_OPENCL_VERSION=120
+    CL_TARGET_OPENCL_VERSION=300
 )
 
 include(CTest)

deps/opencl-icd-loader/test/pkgconfig/pkgconfig/CMakeLists.txt

@@ -39,7 +39,7 @@ target_compile_options(${PROJECT_NAME}
 
 target_compile_definitions(${PROJECT_NAME}
   PRIVATE
-    CL_TARGET_OPENCL_VERSION=120
+    CL_TARGET_OPENCL_VERSION=300
 )
 
 include(CTest)

deps/opencl-icd-loader/test/pkgconfig/sdk/CMakeLists.txt

@@ -24,7 +24,7 @@ target_link_libraries(${PROJECT_NAME}
 
 target_compile_definitions(${PROJECT_NAME}
   PRIVATE
-    CL_TARGET_OPENCL_VERSION=120
+    CL_TARGET_OPENCL_VERSION=300
 )
 
 include(CTest)

include/spla/library.hpp

@@ -114,6 +114,21 @@ namespace spla {
          */
         SPLA_API Status set_message_callback(MessageCallback callback);
 
+        /**
+         * @brief Set verbosity level for library logger
+         *
+         * Controls which messages are shown:
+         *   0 - no output
+         *   1 - errors only
+         *   2 - errors + warnings
+         *   3 - all messages (info, warnings, errors)
+         *
+         * @param verbosity Verbosity level [0, 3]
+         *
+         * @return Function call status
+         */
+        SPLA_API Status set_verbosity(int verbosity);
+
         /**
          * @brief Sets default library callback to log messages to console
          *

src/core/logger.cpp

@@ -31,15 +31,48 @@
 
 namespace spla {
 
-    void Logger::log_msg(Status status, const std::string& msg, const std::string& file, const std::string& function, int line) {
+    static int status_to_level(Status status) {
+        switch (status) {
+            case Status::Error:
+            case Status::PlatformNotFound:
+            case Status::DeviceNotFound:
+            case Status::InvalidArgument:
+            case Status::CompilationError:
+                return 1;
+
+            case Status::NoAcceleration:
+            case Status::InvalidState:
+            case Status::NoValue:
+            case Status::NotImplemented:
+                return 2;
+
+            case Status::Ok:
+            default:
+                return 3;
+        }
+    }
+
+    void Logger::log_msg(Status status, const std::string& msg,
+                         const std::string& file, const std::string& function, int line) {
+
+        int level = status_to_level(status);
+        if (level > m_verbosity) return;
+
         std::lock_guard       guard(m_mutex);
         std::filesystem::path file_path(file);
-        if (m_callback) m_callback(status, msg, file_path.filename().string(), function, line);
+        if (m_callback) {
+            m_callback(status, msg, file_path.filename().string(), function, line);
+        }
     }
 
     void Logger::set_msg_callback(MessageCallback callback) {
         std::lock_guard guard(m_mutex);
         m_callback = std::move(callback);
     }
 
+    void Logger::set_verbosity(int verbosity) {
+        std::lock_guard guard(m_mutex);
+        m_verbosity = verbosity;
+    }
+
 }// namespace spla

src/core/logger.hpp

@@ -49,10 +49,11 @@ namespace spla {
     public:
         void log_msg(Status status, const std::string& msg, const std::string& file, const std::string& function, int line);
         void set_msg_callback(MessageCallback callback);
+        void set_verbosity(int verbosity);
 
     private:
-        MessageCallback m_callback;
-
+        MessageCallback    m_callback;
+        int                m_verbosity = 3;
         mutable std::mutex m_mutex;
     };
 

src/library.cpp

@@ -143,6 +143,12 @@ namespace spla {
         return Status::Ok;
     }
 
+    Status Library::set_verbosity(int verbosity) {
+        m_logger->set_verbosity(verbosity);
+        LOG_MSG(Status::Ok, "set verbosity: " << verbosity);
+        return Status::Ok;
+    }
+
     Status Library::set_default_callback() {
         auto callback = [](spla::Status       status,
                            const std::string& msg,

src/opencl/LibsCompare.md

@@ -0,0 +1,126 @@
+# Сравнение библиотек для создания механизма конфигурирования
+Вся информация взята из репозиториев соответствующих проектов. Дата обращения: 21.04.26.
+
+## Критерии сравнения
+
+| Критерий | Метрика | Единицы измерения |
+|:---|:---|:---|
+| **Зависимости** | наличие | +/- |
+| **Источники** | CLI (argv) / env / файлы | +/-, форматы |
+| **Стандарт C++** | минимальная версия | C++хх |
+| **Поддерживает стандарт иерархии** | Linux/Windows/MacOS | +/- |
+| **Способ распространения** | header-only / статическая / динамическая | — |
+| **ОС** | Linux / Windows / macOS | +/-, компиляторы |
+| **Активность** | среднее число коммитов | коммитов/мес (за последний мес) |
+| **Issues** | open, closed/open | n, коэффициент |
+| **Сообщество** | GitHub Stars | n |
+| **Проходит ли CI** | CI | +/- |
+
+> ? - не указано в README.
+
+
+## Сравнение парсеров командной строки (CLI)
+
+| Критерий | CLI11 | cxxopts | 
+|:---|:---:|:---:|
+| Зависимости | - | - |
+| **Источники** | | |
+|  CLI (argv) | + | + | 
+|  env | + | - | 
+|  Файлы | - | - | 
+| Стандарт C++ | ≥ C++11 | ≥ C++11 | 
+| **Поддерживает стандарт иерархии** | | |
+|  Linux | + | + |
+|  Windows | + | + | 
+|  MacOS | + | + |  
+| Способ распространения | header-only | header-only 
+| **ОС** | | |
+|  Linux | + (GCC 4.8+, Clang 3.5+) | + (GCC ≥ 4.9, Clang ≥ 3.1) |
+|  Windows | + (MSVC ≥ 2015) | + (MSVC ≥ 2015) |
+|  macOS | + (AppleClang 7+) | + (Clang ≥ 3.1 с libc++) |
+| **Сообщество** | | | 
+|  Активность (коммитов/мес) | 4 | 1 |
+|  Issues всего | 506 | 307 | 
+|  Issues closed/open | 9 | 6 | 
+|  Stars | 4.3k | 4.7k | 
+| Проходит ли CI | + | + | + |
+
+
+## Парсеры файлов
+
+| Критерий | nlohmann/json  | yaml-cpp | toml++ | toml11 | config-cxx | taocpp/config
+|:---|:---:|:---:|:---:|:---:|:---:|:---:|
+| Зависимости | - | - | - | - | - | - |
+| **Источники** |
+|  CLI (argv) | - | - | - | - | - | - |
+|  env | - | - | - | - | + | + |
+|  Файлы | JSON | YAML | TOML | TOML | JSON, YAML, XML | JSON, JAXN |
+| Стандарт C++ | ≥ C++11 | ≥ C++11 | ≥ C++17 | ≥ C++11 | ≥ C++20 | ≥ C++17 |
+| **Поддерживает стандарт иерархии** |
+|  Linux | + | + | + | + | + | + |
+|  Windows | + | + | + | + | + | + |
+|  MacOS | + | + | + | + | + | + |
+| Способ распространения | header-only | статическая/динамическая¹ | header-only/статическая/динамическая¹ | header-only/статическая/динамическая¹ | header-only | header-only |
+| **ОС** | | |
+|  Linux | + (GCC 4.8–14.2, Clang 3.4–21.0) | + (GCC, Clang) | + (Clang 8+, GCC 8+) | + (GCC, Clang) | + (GCC 13+, Clang 16+) | +
+|  Windows | + (MSVC 2015–2022) | + (MSVC) | + (MSVC VS2019+) | + (MSVC, MinGW) | + (MSVC 143+ (VS 2022)) | +
+|  macOS | + (AppleClang 9.1–16.0) | + (Xcode, AppleClang) | + (AppleClang) | + (AppleClang) | + (AppleClang 16+) | +
+| **Сообщество** | | | 
+|  Активность (коммитов/мес) | 2 | 9 | 2 | 4 | 2 | 13 |
+|  Issues всего | 3271 | 905 | 193 | 194 | 24 | 5 |
+|  Issues closed/open | 68 | 3 | 8 | 5 | 0 open | 0 open |
+|  Stars | 49.4k | 15k | 2k | 1.3k | 31 | 194 |
+| Проходит ли CI | + | + | + | - | + | ? |
+
+> ¹ Опционально.
+
+## Сравнение универсальных инструментов
+
+| Критерий | Boost.Program_options
+|:---|:---:|
+| Зависимости | +¹ |
+| **Источники** | | |
+|  CLI (argv) | + | + |
+|  env | + | + |
+|  Файлы | INI |
+| Стандарт C++ | ≥ C++3 | 
+| **Поддерживает стандарт иерархии** | | |
+|  Linux | + | 
+|  Windows | + | 
+|  MacOS | + |
+| Способ распространения | статическая/динамическая² | 
+| **ОС** | | |
+|  Linux | + (GCC 5+, Clang 3.6+) | 
+|  Windows | + (MSVC 2015 (vc140)+) |
+|  macOS | + (AppleClang) |
+| **Сообщество** | | | 
+|  Активность (коммитов/мес) | 12 | 
+|  Issues всего | 400 | 
+|  Issues closed/open | 1 | 
+|  Stars | 9.4k |
+| Проходит ли CI | + | + |
+
+> ¹ Список зависимостей: 
+> 1. Boost.Any
+> 2. Boost.Bind
+> 3. Boost.Config
+> 4. Boost.Core
+> 5. Boost.Detail
+> 6. Boost.Function
+> 7. Boost.Iterator
+> 8. Boost.Lexical Cast
+> 9. Boost.Smart Ptr
+> 10. Boost.ThrowException
+> 11. Boost.Tokenizer
+> 12. Boost.Type Traits 
+
+> ² Опционально.
+
+
+### Итог:
+По результатам сравнения, вероятно, лучшим вариантом будет использование `CLI11` и `nlohmann/json`, так как они, в отличие от `Boost.program_options`, не требуют зависимостей и являются header-only.
+
+
+# Механизм конфигурирования библиотеки SPLA
+
+Механизм конфигурирования описывается в разделах: [Мануал пользователя](#UserManual) и [Руководство пользователя](#UserGuide)