chore: merge pull request #4 from threeal/add-error-package

Add Error Package

Author: threeal

.github/workflows/build.yml

@@ -14,5 +14,5 @@ jobs:
       - name: Configure and build this project
         uses: threeal/cmake-action@v1.1.0
         with:
-          source-dir: example
-          build-dir: example/build
+          source-dir: error
+          build-dir: error/build

.github/workflows/test.yml

@@ -14,18 +14,18 @@ jobs:
       - name: Configure, build, and test this project
         uses: threeal/cmake-action@v1.1.0
         with:
-          source-dir: example
-          build-dir: example/build
+          source-dir: error
+          build-dir: error/build
           args: -DBUILD_TESTING=ON
           run-test: true
 
       - name: Check code coverage
         uses: threeal/gcovr-action@main
         with:
-          root: example
+          root: error
           excludes: |
-            example/build/*
-            example/test/*
+            error/build/*
+            error/test/*
           fail-under-line: 100
 
   check-warning:
@@ -37,8 +37,8 @@ jobs:
       - name: Configure and build this project
         uses: threeal/cmake-action@v1.1.0
         with:
-          source-dir: example
-          build-dir: example/build
+          source-dir: error
+          build-dir: error/build
           cxx-flags: -Werror
           args: -DBUILD_TESTING=ON
 
@@ -52,9 +52,9 @@ jobs:
         run: pip3 install cmake-format
 
       - name: Configure CMake
-        run: cmake example -B example/build
+        run: cmake error -B error/build
 
       - name: Check code formatting
         run: |
-          cmake --build example/build --target format
-          cmake --build example/build --target check-format
+          cmake --build error/build --target format
+          cmake --build error/build --target check-format

README.md

@@ -5,6 +5,10 @@
 
 A comprehensive collection of [C++](https://isocpp.org/) utility packages.
 
+## Packages
+
+- [Error](./error) [WIP]: Provides utilities for error handling.
+
 ## License
 
 This project is licensed under the terms of the [MIT License](./LICENSE).

example/.clang-format renamed to error/.clang-format

@@ -1,11 +1,12 @@
 cmake_minimum_required(VERSION 3.0)
 
-project(example)
+project(error)
 
-set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -Wshadow -Wnon-virtual-dtor -Wpedantic")
+set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -Wnon-virtual-dtor -Wpedantic")
+set(CMAKE_CXX_STANDARD 11)
 
-add_library(example src/example.cpp)
-target_include_directories(example PUBLIC include)
+add_library(error src/error.cpp)
+target_include_directories(error PUBLIC include)
 
 if(CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)
   include(cmake/CPM.cmake)
@@ -19,8 +20,8 @@ if(CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)
 
     set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fprofile-arcs -ftest-coverage -fPIC -O0")
 
-    add_executable(example_test test/example_test.cpp)
-    target_link_libraries(example_test PRIVATE example Catch2::Catch2WithMain)
-    catch_discover_tests(example_test)
+    add_executable(error_test test/error_test.cpp)
+    target_link_libraries(error_test PRIVATE error Catch2::Catch2WithMain)
+    catch_discover_tests(error_test)
   endif()
 endif()

example/.cmake-format renamed to error/.cmake-format

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Alfi Maulana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

example/CMakeLists.txt renamed to error/CMakeLists.txt

@@ -0,0 +1,9 @@
+# Error
+
+A C++ package that provides utilities for error handling.
+
+## License
+
+This project is licensed under the terms of the [MIT License](./LICENSE).
+
+Copyright © 2023 [Alfi Maulana](https://github.com/threeal)

error/LICENSE

@@ -0,0 +1,28 @@
+#pragma once
+
+#include <exception>
+
+namespace error {
+
+/**
+ * @brief A class that represents error information.
+ */
+class Error : public std::exception {
+ private:
+  const char* message; /**< The error message. */
+
+ public:
+  /**
+   * @brief Constructs a new error with the given message.
+   * @param message An error message.
+   */
+  Error(const char* message);
+
+  /**
+   * @brief Returns the explanatory string.
+   * @return Pointer to a null-terminated string with explanatory information.
+   */
+  const char* what() const noexcept override;
+};
+
+}  // namespace error