[esp] Add Rust no-std example.

.gitignore

@@ -10,3 +10,5 @@
 **/Makefile
 **/*.cbp
 **/node-modules/
+**/CMakeLists.txt.user
+**/catch2/bin/

README.md

@@ -2,15 +2,16 @@
 
 This repository is a collection of useful code snippets and configurations.
 
-```
+```bash
-github.com/shaunrd0/klips/
+shaunrd0/klips/
 ├── ansible     # Ansible roles, playbooks, and examples
 ├── blockchain  # Blockchain related project templates and examples
 ├── cpp         # C++ programs, datastructures, and other examples
 ├── dotnet      # .NET projects and examples
+├── esp         # ESP32 projects and examples
 ├── figlet      # Figlet fonts I like :)
 ├── javascript  # Javascript projects and examples
-├── python      # Python scripts or tools I've made   
+├── python      # Python scripts and tools I've made
-├── README.md   
+├── scripts     # Bash scripts
-└── scripts     # Bash scripts
+└── README.md
 ```

ansible/README.md

@@ -1,4 +1,4 @@
-# Ansible 
+# ansible
 
 A few simple roles / plays I've put together in learning how to use Ansible can be found under their corresponding directories.
 

blockchain/eth/truffle-solidity/README.md

@@ -1,3 +1,4 @@
+# blockchain
 
 A template project for getting started working on the Ethereum blockchain.
 This project comes with basic packages for compiling and deploying Solidity contracts with Truffle.

cpp/CMakeLists.txt

@@ -1,6 +1,6 @@
 ################################################################################
 ## Author: Shaun Reed                                                         ##
-## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## Legal: All Content (c) 2025 Shaun Reed, all rights reserved                ##
 ## About: A root project for practicing C++                                   ##
 ##        This project can be built to debug and run all nested projects      ##
 ##        Or, any subdirectory with a project() statement can be selected     ##
@@ -16,14 +16,49 @@ project(
     DESCRIPTION "A root project for several small cpp practice projects"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 add_compile_options("-Wall")
 
+option(KLIPS_CCACHE "Enable ccache" ON)
+
+if (KLIPS_CCACHE)
+  find_program(SCCACHE_PATH sccache)
+  if(SCCACHE_PATH)
+    message(STATUS "[Klips] Found sccache: ${SCCACHE_PATH}")
+    set(CMAKE_CXX_COMPILER_LAUNCHER ${SCCACHE_PATH})
+    set(CMAKE_C_COMPILER_LAUNCHER ${SCCACHE_PATH})
+  else()
+    message(STATUS "[Klips] Failed to find sccache, falling back to ccache.")
+    find_program(CCACHE_PATH ccache)
+    if(CCACHE_PATH)
+      message(STATUS "[Klips] Found ccache: ${CCACHE_PATH}")
+      set(CMAKE_CXX_COMPILER_LAUNCHER ${CCACHE_PATH})
+      set(CMAKE_C_COMPILER_LAUNCHER ${CCACHE_PATH})
+    else()
+      message(WARNING "[Klips] Failed to find sccache and ccache. Compilation will not be cached.")
+    endif()
+  endif()
+endif()
+
 add_subdirectory(algorithms)
+add_subdirectory(catch2)
 add_subdirectory(cmake-example)
 add_subdirectory(cryptography)
 add_subdirectory(datastructs)
 add_subdirectory(graphics)
 add_subdirectory(multithreading)
 add_subdirectory(patterns)
+
+find_package(Qt6 COMPONENTS UiPlugin Core Gui Widgets)
+if (NOT Qt6_FOUND)
+  message(
+      WARNING
+      "[Klips] Qt examples will not be built.\n"
+      "On Ubuntu 24.04 Qt6 can be installed using apt:\n"
+      "  sudo apt install qt6-base-dev qt6-tools-dev\n"
+  )
+else()
+  add_subdirectory(qt)
+endif()

cpp/README.md

@@ -1,4 +1,4 @@
-# Cpp
+# cpp
 
 ```bash
 shaunrd0/klips/cpp/
@@ -9,6 +9,7 @@ shaunrd0/klips/cpp/
 ├── graphics       # Examples of graphics projects written in C++
 ├── multithreading # Basic multithreading examples in C++
 ├── patterns       # Examples of various design patterns written in C++
+├── qt             # Qt project examples using C++
 └── README.md
 ```
 

cpp/algorithms/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing various algorithms in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/algorithms/graphs/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing algorithms using graphs in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/algorithms/graphs/object/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "Practice implementing and using object graphs in C++"
     LANGUAGES CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-graphs-object graph.cpp

cpp/algorithms/graphs/simple/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "Practice implementing and using simple graphs in C++"
     LANGUAGES CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-graphs-simple graph.cpp

cpp/algorithms/graphs/simple/lib-graph.cpp

@@ -8,9 +8,8 @@
 ################################################################################
 */
 
-#include <algorithm>
 #include "lib-graph.hpp"
-
+#include <algorithm>
 
 void Graph::BFS(int startNode)
 {

cpp/algorithms/graphs/simple/lib-graph.hpp

@@ -15,6 +15,7 @@
 #include <unordered_map>
 #include <unordered_set>
 #include <vector>
+#include <cstdint>
 
 
 class Graph {

cpp/algorithms/graphs/templated/CMakeLists.txt

@@ -14,5 +14,6 @@ project(
     DESCRIPTION "Practice implementing and using templated graphs in C++"
     LANGUAGES CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(algo-graphs-templated graph.cpp)

cpp/algorithms/graphs/templated/lib-graph.hpp

@@ -18,6 +18,7 @@
 #include <unordered_set>
 #include <utility>
 #include <vector>
+#include <cstdint>
 
 
 /******************************************************************************/

cpp/algorithms/graphs/weighted/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "Practice implementing and using weighted graphs in C++"
     LANGUAGES CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-graphs-weighted graph.cpp

cpp/algorithms/graphs/weighted/lib-graph.hpp

@@ -18,6 +18,7 @@
 #include <unordered_set>
 #include <utility>
 #include <vector>
+#include <cstdint>
 
 
 /******************************************************************************/

cpp/algorithms/sorting/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing various sorting algorithms in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/algorithms/sorting/insertion/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing insertion sort in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-sort-insertion insertion-sort.cpp

cpp/algorithms/sorting/merge/CMakeLists.txt

@@ -14,6 +14,8 @@ project (
     DESCRIPTION "A project for practicing merge sort in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
+
 add_executable(
     algo-sort-merge merge-sort.cpp
     lib-merge.cpp lib-merge.h

cpp/algorithms/sorting/merge/lib-merge.cpp

@@ -12,6 +12,7 @@
 #include <algorithm>
 #include <iostream>
 #include <vector>
+#include <cstdint>
 
 void MergeSort(std::vector<int> &array, size_t lhs, size_t rhs)
 {

cpp/algorithms/sorting/quick/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing quick sort in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-sort-quick quick-sort.cpp

cpp/algorithms/sorting/radix/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing radix sort in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-sort-radix radix-sort.cpp

cpp/algorithms/sorting/selection/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing selection sort in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-sort-select select-sort.cpp

cpp/algorithms/trees/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing algorithms using trees in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/algorithms/trees/binary/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing BST algorithms"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-trees-bst driver.cpp

cpp/algorithms/trees/redblack/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing red-black tree algorithms"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     algo-trees-redblack driver.cpp

cpp/algorithms/trees/redblack/redblack.h

@@ -12,6 +12,7 @@
 #define REDBLACK_H
 
 #include <iostream>
+#include <cstdint>
 
 enum Color {Black, Red};
 

cpp/catch2/CMakeLists.txt

@@ -0,0 +1,35 @@
+################################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Practice project for testing with catch2 framework                  ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+
+cmake_minimum_required(VERSION 3.15)
+
+project(
+    #[[NAME]]       Catch2
+    VERSION         1.0
+    DESCRIPTION     "Practice project for learning Catch2"
+    LANGUAGES       CXX
+)
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
+
+add_compile_options(-Wall)
+
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
+
+Include(FetchContent)
+FetchContent_Declare(
+    Catch2
+    GIT_REPOSITORY https://github.com/catchorg/Catch2.git
+    GIT_TAG        v3.4.0
+)
+FetchContent_MakeAvailable(Catch2)
+
+add_library(klips SHARED src/klips.cpp)
+target_include_directories(klips PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)
+
+add_executable(test_klips src/test_klips.cpp)
+target_link_libraries(test_klips PUBLIC Catch2::Catch2WithMain klips)

cpp/catch2/include/klips.hpp

@@ -0,0 +1,10 @@
+
+#ifndef KLIPS_KLIPS_H
+#define KLIPS_KLIPS_H
+
+
+class klips { };
+
+unsigned int factorial(unsigned int);
+
+#endif  // KLIPS_KLIPS_H

cpp/catch2/include/type_name.hpp

@@ -0,0 +1,29 @@
+// Authored by 康桓瑋 on SO: https://stackoverflow.com/a/56766138
+#ifndef CATCH2_TYPE_NAME_HPP
+
+#include <string_view>
+
+template <typename T>
+constexpr auto type_name() {
+  std::string_view name, prefix, suffix;
+#ifdef __clang__
+  name = __PRETTY_FUNCTION__;
+  prefix = "auto type_name() [T = ";
+  suffix = "]";
+#elif defined(__GNUC__)
+  name = __PRETTY_FUNCTION__;
+  prefix = "constexpr auto type_name() [with T = ";
+  suffix = "]";
+#elif defined(_MSC_VER)
+  name = __FUNCSIG__;
+  prefix = "auto __cdecl type_name<";
+  suffix = ">(void)";
+#endif
+  name.remove_prefix(prefix.size());
+  name.remove_suffix(suffix.size());
+  return name;
+}
+
+#define CATCH2_TYPE_NAME_HPP
+
+#endif  // CATCH2_TYPE_NAME_HPP

cpp/catch2/src/klips.cpp

@@ -0,0 +1,4 @@
+
+unsigned int factorial( unsigned int number ) {
+  return number <= 1 ? number : factorial(number-1)*number;
+}

cpp/catch2/src/test_klips.cpp

@@ -0,0 +1,148 @@
+#define CATCH_CONFIG_MAIN
+
+#include <iostream>
+
+#include "catch2/catch_all.hpp"
+
+#include "klips.hpp"
+#include "type_name.hpp"
+
+#define TT() std::cout << "T = " << type_name<TestType>() << std::endl;
+#define TD(x)                                                                  \
+  std::cout << type_name<decltype(x)>() << " " << #x << " = " << x << std::endl;
+#define T(x) std::cout << "T = " << type_name<x>() << std::endl;
+
+TEST_CASE("factorials are computed", "[factorial]") {
+  REQUIRE(factorial(1) == 1);
+  REQUIRE(factorial(2) == 2);
+  REQUIRE(factorial(3) == 6);
+  REQUIRE(factorial(10) == 3628800);
+}
+
+TEST_CASE("Generators") {
+  auto i = GENERATE(1, 3, 5);
+  TD(i);
+}
+
+TEST_CASE("Generators 2") {
+  auto i = GENERATE(1, 2);
+  SECTION("one") {
+    auto j = GENERATE(-3, -2);
+    REQUIRE(j < i);
+    std::cout << "i = " << i << "; j = " << j << std::endl;
+  }
+  SECTION("two") {
+    auto k = GENERATE(4, 5, 6);
+    REQUIRE(i != k);
+    std::cout << "i = " << i << "; k = " << k << std::endl;
+  }
+}
+
+TEST_CASE("Complex mix of sections and generates") {
+  auto i = GENERATE(1, 2);
+  SECTION("A") {
+    std::cout << "i = " << i << "; A passed" << std::endl;
+    SUCCEED("A");
+  }
+  std::cout << "left A\n";
+  auto j = GENERATE(3, 4);
+  std::cout << "i = " << i << "; j = " << j << std::endl;
+  SECTION("B") {
+    std::cout << "i = " << i << "; j = " << j << "; B passed;" << std::endl;
+    SUCCEED("B");
+  }
+  auto k = GENERATE(5, 6);
+  std::cout << "i = " << i << "; k = " << k << std::endl;
+  SUCCEED();
+}
+
+TEST_CASE("Test generaators 3", "[test]") { GENERATE(values({1, 2})); }
+
+TEMPLATE_TEST_CASE("Testing template tests", "[test][template]", int8_t,
+                   int16_t, int32_t, int64_t) {
+  TT();
+}
+
+template <typename T> struct Foo {
+  size_t size() { return 0; }
+};
+
+template <typename T> struct Test {
+  T test() {
+    T x;
+    return x;
+  }
+};
+
+TEMPLATE_PRODUCT_TEST_CASE("A Template product test case",
+                           "[template][product]", (std::vector, Test),
+                           (int, float)) {
+  TT();
+}
+
+TEMPLATE_PRODUCT_TEST_CASE("Product with differing arities",
+                           "[template][product]", std::tuple,
+                           (int, (int, double), (int, double, float))) {
+  TT();
+}
+
+using types = std::tuple<int8_t, int16_t, int32_t, int64_t>;
+
+TEMPLATE_LIST_TEST_CASE("Testing template list tests", "[test][template][list]",
+                        types) {
+  TT();
+}
+
+TEMPLATE_TEST_CASE_SIG(
+    "TemplateTestSig: arrays can be created from NTTP arguments",
+    "[vector][template][nttp]", ((typename T, int V), T, V), (int, 5),
+    (float, 4), (std::string, 15), ((std::tuple<int, float>), 6)) {
+  T(T);
+  std::cout << "V = " << V;
+  std::array<T, V> v;
+  REQUIRE(v.size() > 1);
+}
+
+template <typename T, size_t S> struct Bar {
+  size_t size() { return S; }
+};
+
+TEMPLATE_PRODUCT_TEST_CASE_SIG(
+    "A Template product test case with array signature",
+    "[template][product][nttp]", ((typename T, size_t S), T, S),
+    (std::array, Bar), ((int, 9), (float, 42))) {
+  TT();
+  TestType x;
+  REQUIRE(x.size() > 0);
+}
+
+template <typename T> struct test_config_get {
+  template <bool must_find> void run() {
+    //    Config c{};
+    //    std::string key{"the_key"};
+    //    std::string value{"the_value"};
+    //    c.set(key, value);
+    if constexpr (must_find) {
+      std::cout << "Test 1 ran";
+    } else {
+      std::cout << "Test 2 ran";
+    }
+  }
+};
+template <> template <bool must_find> void test_config_get<std::string>::run() {
+  if constexpr (must_find) {
+    std::cout << "Test 1 ran for strings";
+  } else {
+    std::cout << "Test 2 ran for strings";
+  }
+}
+
+TEMPLATE_PRODUCT_TEST_CASE("Test", "[test]", test_config_get,
+                           (int, std::string)) {
+  TT();
+  // TestType t;
+  test_config_get<int> s;
+  s.template run<true>();
+  //  TestType t;
+  //  t.run<true>();
+}

cpp/cmake-example/CMakeLists.txt

@@ -22,6 +22,7 @@ project (
     DESCRIPTION "A basic CMake template for C++ projects"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 # Include any directories the compiler may need
 include_directories(./include)

cpp/cryptography/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing cryptography in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/cryptography/columnar-transposition/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "Practice implementing columnar transposition in C++"
     LANGUAGES CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     crypto-columnar-transposition driver.cpp

cpp/datastructs/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing various data structures in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/datastructs/binarysearchtree/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing a basic implementation of a BST"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-bst driver.cpp

cpp/datastructs/binarysearchtree/bst.cpp

@@ -10,10 +10,11 @@
 
 #include "bst.h"
 
+#include <cstdint>
 
 /********************************************************************************
-* Constructors, Destructors, Operators
+ * Constructors, Destructors, Operators
-*********************************************************************************/
+ *********************************************************************************/
 
 /** Copy Assignment Operator
  * @brief Empty the calling object's root BinaryNode, and copy the rhs data

cpp/datastructs/circledoublelist/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "Project for testing circular doubly linked list implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-circular-doubly-linked-list driver.cpp

cpp/datastructs/circledoublelist/circledoublelist.cpp

@@ -10,6 +10,7 @@
 
 #include "circledoublelist.h"
 
+#include <cstdint>
 
 /******************************************************************************
  * Constructors, Destructors, Operators

cpp/datastructs/circlesinglelist/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "Project for testing circular singly linked list implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-circular-singly-linked-list driver.cpp

cpp/datastructs/circlesinglelist/circlesinglelist.cpp

@@ -10,6 +10,7 @@
 
 #include "circlesinglelist.h"
 
+#include <cstdint>
 
 /******************************************************************************
  * Constructors, Destructors, Operators

cpp/datastructs/doublelist/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing a doubly linked list implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-doubly-linked-list driver.cpp

cpp/datastructs/doublelist/doublelist.cpp

@@ -10,6 +10,7 @@
 
 #include "doublelist.h"
 
+#include <cstdint>
 
 /******************************************************************************
  * Constructors, Destructors, Operators

cpp/datastructs/maxheap/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing a max heap implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-max-heap driver.cpp

cpp/datastructs/maxheap/maxheap.cpp

@@ -10,10 +10,11 @@
 
 #include "maxheap.h"
 
+#include <cstdint>
 
 /********************************************************************************
-* Constructors, Destructors, Operators
+ * Constructors, Destructors, Operators
-*********************************************************************************/
+ *********************************************************************************/
 
 /** default constructor
  *  Constructs a heap with the given default values

cpp/datastructs/queuelist/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "Project for testing queue implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-queue driver.cpp

cpp/datastructs/queuelist/queuelist.cpp

@@ -10,6 +10,7 @@
 
 #include "queuelist.h"
 
+#include <cstdint>
 
 /******************************************************************************
  * Constructors, Destructors, Operators

cpp/datastructs/singlelist/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing a singly linked list implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-singly-linked-list driver.cpp

cpp/datastructs/singlelist/singlelist.cpp

@@ -10,6 +10,7 @@
 
 #include "singlelist.h"
 
+#include <cstdint>
 
 /******************************************************************************
  * Constructors, Destructors, Operators

cpp/datastructs/stacklist/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing a Stack implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-stack driver.cpp

cpp/datastructs/stacklist/stacklist.cpp

@@ -10,6 +10,7 @@
 
 #include "stacklist.h"
 
+#include <cstdint>
 
 /******************************************************************************
  * Constructors, Destructors, Operators

cpp/datastructs/templates/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for practicing templated data structures in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_subdirectory(doublelist)
 add_subdirectory(queuelist)

cpp/datastructs/templates/doublelist/CMakeLists.txt

@@ -14,5 +14,6 @@ project (
     DESCRIPTION "A project for practicing templated doubly linked list implementations"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(data-templates-doubly-linked-list driver.cpp)

cpp/datastructs/templates/queuelist/CMakeLists.txt

@@ -14,5 +14,6 @@ project (
     DESCRIPTION "A project for practicing templated queue implementations"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(data-templates-queue driver.cpp)

cpp/datastructs/templates/stacklist/CMakeLists.txt

@@ -14,5 +14,6 @@ project (
     DESCRIPTION "A project for practicing templated Stack implementations"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(data-templates-stack driver.cpp)

cpp/datastructs/templates/vector/CMakeLists.txt

@@ -14,5 +14,6 @@ project (
     DESCRIPTION "A project for practicing templated Vector implementations"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(data-templates-vectors driver.cpp)

cpp/datastructs/vector/CMakeLists.txt

@@ -14,6 +14,7 @@ project (
     DESCRIPTION "A project for testing a basic Vector implementation"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     data-vectors driver.cpp

cpp/datastructs/vector/vector.cpp

@@ -10,6 +10,7 @@
 
 #include "vector.h"
 
+#include <cstdint>
 
 /******************************************************************************
  * Constructors, Destructors, Operators

cpp/graphics/CMakeLists.txt

@@ -1,6 +1,6 @@
 ################################################################################
 ## Author: Shaun Reed                                                         ##
-## Legal: All Content (c) 2021 Shaun Reed, all rights reserved                ##
+## Legal: All Content (c) 2025 Shaun Reed, all rights reserved                ##
 ## About: A root project for practicing C++                                   ##
 ##        This project can be built to debug and run all nested projects      ##
 ##        Or, any subdirectory with a project() statement can be selected     ##
@@ -16,6 +16,7 @@ project(
     DESCRIPTION "A root project for practicing graphics programming in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/graphics/opengl-cmake/CMakeLists.txt

@@ -1,6 +1,6 @@
 ################################################################################
 ## Author: Shaun Reed                                                         ##
-## Legal: All Content (c) 2021 Shaun Reed, all rights reserved                ##
+## Legal: All Content (c) 2025 Shaun Reed, all rights reserved                ##
 ##                                                                            ##
 ## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
 ################################################################################
@@ -8,40 +8,46 @@
 # Define CMake version
 cmake_minimum_required(VERSION 3.15)
 
+include(FetchContent)
 project(
     #[[NAME]]    OpenGL-Cmake
     DESCRIPTION  "Example project for building OpenGL projects with CMake"
     LANGUAGES    CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_library(graphics-lib-opengl src/lib-opengl-test.cpp)
 target_include_directories(graphics-lib-opengl PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/src)
 
 # Find OpenGL package
-find_package(OpenGL REQUIRED)
+find_package(OpenGL)
-if (OPENGL_FOUND)
+if (NOT OPENGL_FOUND)
-  # Link opengl-test executable to OpenGL
-  target_include_directories(graphics-lib-opengl PUBLIC ${OPENGL_INCLUDE_DIR})
-  target_link_libraries(graphics-lib-opengl PUBLIC ${OPENGL_LIBRARIES})
-else()
   message(
-      "Error: CMake was unable to find the OpenGL package\n"
+      "[Klips] Error: CMake was unable to find OpenGL.\n"
-      "Please install OpenGL and try again\n"
+      "On Ubuntu 24.04 OpenGL can be installed using apt:\n"
+      "  sudo apt install libopengl-dev libgl1-mesa-dev mesa-common-dev libglu1-mesa-dev\n"
   )
 endif()
+# Link opengl-test executable to OpenGL
+message(STATUS "[Klips] Found OpenGL: ${OPENGL_INCLUDE_DIR}")
+target_include_directories(graphics-lib-opengl PUBLIC ${OPENGL_INCLUDE_DIR})
+target_link_libraries(graphics-lib-opengl PUBLIC ${OPENGL_LIBRARIES})
 
-# Find GLUT package
+find_package(GLUT QUIET)
-find_package(GLUT REQUIRED)
+if(NOT GLUT_FOUND)
-if (GLUT_FOUND)
-  # Link lib-opengl-test executable to GLUT
-  target_include_directories(graphics-lib-opengl PUBLIC ${GLUT_INCLUDE_DIR})
-  target_link_libraries(graphics-lib-opengl PUBLIC ${GLUT_LIBRARIES})
-else()
   message(
-      "Error: CMake was unable to find the GLUT package\n"
+      FATAL_ERROR
-      "Please install GLUT (freeglut3-dev) and try again\n"
+      "[Klips] Failed to fetch GLUT. Could not find dependency X11 input libraries.\n"
+      "On Ubuntu 24.04 Xi can be installed using apt:\n"
+      "  sudo apt install libxi-dev\n"
+      "Alternatively, on Ubuntu 24.04 GLUT can be installed with apt:\n"
+      "  sudo apt install freeglut3-dev\n"
   )
 endif()
+message(STATUS "[Klips] Found GLUT: ${GLUT_INCLUDE_DIR}")
+# Link lib-opengl-test executable to GLUT
+target_include_directories(graphics-lib-opengl PUBLIC ${GLUT_INCLUDE_DIR})
+target_link_libraries(graphics-lib-opengl PUBLIC ${GLUT_LIBRARIES})
 
 # Add test executable
 add_executable(graphics-cmake-opengl apps/test-gl.cpp)

cpp/graphics/sdl-cmake/CMakeLists.txt

@@ -1,6 +1,6 @@
 ################################################################################
 ## Author: Shaun Reed                                                         ##
-## Legal: All Content (c) 2021 Shaun Reed, all rights reserved                ##
+## Legal: All Content (c) 2025 Shaun Reed, all rights reserved                ##
 ##                                                                            ##
 ## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
 ################################################################################
@@ -13,6 +13,7 @@ project(
     DESCRIPTION  "Example project for building SDL projects with CMake"
     LANGUAGES    CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 # Add Library
 add_library(
@@ -27,31 +28,30 @@ target_include_directories(            # When calling library, include a directo
 )
 
 # Search for SDL2 package
-find_package(SDL2 REQUIRED sdl2)
+find_package(SDL2 QUIET)
-
+if (NOT SDL2_FOUND)
-# If SDL2 was found successfully, link to lib-sdl-test
+  message(FATAL_ERROR
-if (SDL2_FOUND)
+      "[Klips] Failed to find SDL2.\n"
-  # Any target that links with this library will also link to SDL2
+      "On Ubuntu 24.04 SDL2 can be installed using apt:\n"
-  # + Because we choose PUBLIC visibility
+      "  sudo apt install libsdl2-dev\n"
-  target_include_directories(graphics-lib-sdl PUBLIC ${SDL2_INCLUDE_DIRS})
-  target_link_libraries(graphics-lib-sdl PUBLIC "${SDL2_LIBRARIES}")
-
-  # Creating executable
-  add_executable(
-      graphics-cmake-sdl  # Exe name
-      apps/sdl-test.cpp   # Exe Source(s)
-  )
-
-  # Linking the exe to library
-  target_link_libraries(
-      graphics-cmake-sdl    # Executable to link
-      PRIVATE               # Visibility
-      graphics-lib-sdl      # Library to link
-  )
-
-else()
-  message(
-      "Error: CMake was unable to find SDL2 package.\n"
-      "Please install the libsdl2-dev package and try again.\n"
   )
 endif()
+message(STATUS "[Klips] Found SDL2: ${SDL2_INCLUDE_DIRS}")
+
+# Any target that links with this library will also link to SDL2
+# + Because we choose PUBLIC visibility
+target_include_directories(graphics-lib-sdl PUBLIC ${SDL2_INCLUDE_DIRS})
+target_link_libraries(graphics-lib-sdl PUBLIC "${SDL2_LIBRARIES}")
+
+# Creating executable
+add_executable(
+    graphics-cmake-sdl  # Exe name
+    apps/sdl-test.cpp   # Exe Source(s)
+)
+
+# Linking the exe to library
+target_link_libraries(
+    graphics-cmake-sdl    # Executable to link
+    PRIVATE               # Visibility
+    graphics-lib-sdl      # Library to link
+)

cpp/multithreading/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "Practice with multithreaded programming in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 add_compile_options("-Wall")

cpp/multithreading/conditions/CMakeLists.txt

@@ -18,6 +18,7 @@ project(
     DESCRIPTION "Example of condition_variables in multithreaded C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     multithread-conditions driver.cpp

cpp/multithreading/deadlock/CMakeLists.txt

@@ -18,6 +18,7 @@ project(
     DESCRIPTION "Example and solution for deadlocks in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     multithread-deadlock driver.cpp

cpp/multithreading/livelock/CMakeLists.txt

@@ -18,6 +18,7 @@ project(
     DESCRIPTION "Example and solution for livelocks in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     multithread-livelock driver.cpp

cpp/multithreading/race-condition/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "Example and solution for race conditions"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     multithread-race-condition driver.cpp

cpp/patterns/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "A project for practicing various design patterns in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 

cpp/patterns/abstract-factory/CMakeLists.txt

@@ -13,6 +13,7 @@ project(
     DESCRIPTION "An example of the abstract factory design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/patterns/adapter/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the adapter design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/patterns/adapter/adapter.hpp

@@ -2,6 +2,7 @@
 #ifndef ADAPTER_HPP
 #define ADAPTER_HPP
 
+#include <ctime>
 #include <random>
 
 // Target implementation to adapt to a new interface

cpp/patterns/bridge/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the bridge design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/patterns/factory/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the factory design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/patterns/observer/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the state design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/patterns/prototype/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the prototype design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/patterns/singleton/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the singleton design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 
 add_executable(
     patterns-singleton main.cpp

cpp/patterns/state/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the state design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/patterns/visitor/CMakeLists.txt

@@ -14,6 +14,7 @@ project(
     DESCRIPTION "An example of the visitor design pattern in C++"
     LANGUAGES   CXX
 )
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
 add_compile_options("-Wall")
 
 add_executable(

cpp/qt/CMakeLists.txt

@@ -0,0 +1,25 @@
+################################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: A root project for practicing Qt 6 projects in C++                  ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+
+cmake_minimum_required(VERSION 3.15)
+
+project(
+    #[[NAME]]   Klips
+    VERSION     1.0
+    DESCRIPTION "A root project for several small Qt6 practice projects"
+    LANGUAGES   CXX
+)
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
+
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
+add_compile_options("-Wall")
+
+add_subdirectory(designer)
+add_subdirectory(designer-plugin)
+add_subdirectory(designer-plugin-collection)
+add_subdirectory(slots)

cpp/qt/README.md

@@ -0,0 +1,32 @@
+# Cpp
+
+```bash
+shaunrd0/klips/cpp/qt/
+├── designer                    # Using Qt Designer to create application GUI
+├── designer-plugin             # Adding custom widgets as Qt Designer plugins
+├── designer-plugin-collection  # Adding a collection of widget plugins to Qt Designer
+└── README.md
+```
+
+This directory contains a `CMakeLists.txt`, which can be selected to open as a 
+project within your preferred IDE. From there, all nested examples can be built,
+debugged, and ran.
+
+The plugin examples will need to be installed for Qt Designer integration to work.
+On Linux, Qt Designer looks under `/some/path/to/Qt/Tools/QtCreator/lib/Qt/plugins/designer/`.
+On windows or Mac, this path may differ. Unfortunately I don't have these machines to test for myself.
+
+```bash
+cd klips/cpp/qt/designer-plugin-collection
+mkdir build && cd build
+cmake .. && cmake --build . --target install
+```
+
+After installing the plugin collection example above, we can open Qt Creator and navigate to the Designer.
+We should see the custom collection is available within the Designer, and the contents of the widgets render correctly in the application view.
+
+
+![side-panel-view.png](side-panel-view.png)
+
+
+![plugin-render-view.png](plugin-render-view.png)

cpp/qt/designer-plugin-collection/CMakeLists.txt

@@ -0,0 +1,127 @@
+################################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Example of making a collection of widget plugins for Qt Designer    ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+
+cmake_minimum_required(VERSION 3.15)
+
+project(
+    #[[NAME]]       DesignerPluginCollection
+    VERSION         1.0
+    DESCRIPTION     "Example of a widget plugin collection for Qt Designer"
+    LANGUAGES       CXX
+)
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
+# Lowercase string to use as a slug for executable names for identification.
+string(TOLOWER ${PROJECT_NAME} PROJECT_NAME_LOWER)
+
+include(GenerateExportHeader)
+
+add_compile_options(-Wall)
+set(CMAKE_INCLUDE_CURRENT_DIR ON)
+set(CMAKE_AUTOUIC ON)
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTORCC ON)
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set(CMAKE_SHARED_MODULE_PREFIX "")
+
+set(QT_DIR "$ENV{HOME}/Code/Clones/Qt/" CACHE PATH "Path to Qt6")
+# Qt Designer will look in different locations if WIN / Unix.
+# These paths are for using Qt Designer integrated within Qt Creator.
+# Standalone Qt Designer may use different paths.
+if (WIN32)
+    set(QT_PLUGIN_INSTALL_DIR
+        "${QT_DIR}/Tools/QtCreator/bin/plugins/designer"
+    )
+    # This path may be different on windows. I have not tested this.
+    set(QT_PLUGIN_LIBRARY_DIR
+        "${QT_DIR}/Tools/QtCreator/lib/Qt/lib"
+    )
+else()
+    set(QT_PLUGIN_INSTALL_DIR
+        "${QT_DIR}/Tools/QtCreator/lib/Qt/plugins/designer"
+    )
+    set(QT_PLUGIN_LIBRARY_DIR
+        "${QT_DIR}/Tools/QtCreator/lib/Qt/lib"
+    )
+endif()
+# This should be set to your Qt6 installation directory.
+set(QT_INSTALL_DIR "${QT_DIR}/6.3.1/gcc_64/" CACHE PATH "Path to Qt6 install")
+list(APPEND CMAKE_PREFIX_PATH "${QT_INSTALL_DIR}")
+
+find_package(Qt6 COMPONENTS UiPlugin Core Gui Widgets)
+if (NOT Qt6_FOUND)
+    message(
+        FATAL_ERROR
+        "[Klips] Error: CMake was unable to find Qt6 libraries.\n"
+        "The example will not be built until the build is configured with these packages installed.\n"
+        "On Ubuntu 24.04 Qt6 can be installed using apt:\n"
+        "  sudo apt-get install qt6-base-dev qt6-tools-dev\n"
+    )
+endif()
+
+# Creating a library with two plugins for the collection.
+set(WIDGET_PLUGIN_LIBRARY widget-plugin-library_${PROJECT_NAME_LOWER})
+qt_add_library(${WIDGET_PLUGIN_LIBRARY}
+    textview.cpp textview.h
+    widgetplugin.cpp widgetplugin.h
+)
+target_sources(${WIDGET_PLUGIN_LIBRARY} PRIVATE
+    textview.cpp textview.h
+    treeview.cpp treeview.h
+    widgetplugin.cpp widgetplugin.h
+)
+set_target_properties(${WIDGET_PLUGIN_LIBRARY} PROPERTIES
+    WIN32_EXECUTABLE TRUE
+    MACOSX_BUNDLE TRUE
+)
+target_link_libraries(${WIDGET_PLUGIN_LIBRARY}
+    PUBLIC Qt::UiPlugin Qt::Core Qt::Gui Qt::Widgets
+)
+
+install(TARGETS ${WIDGET_PLUGIN_LIBRARY}
+    RUNTIME DESTINATION "${QT_PLUGIN_LIBRARY_DIR}"
+    BUNDLE DESTINATION "${QT_PLUGIN_LIBRARY_DIR}"
+    LIBRARY DESTINATION "${QT_PLUGIN_LIBRARY_DIR}"
+)
+
+generate_export_header(${WIDGET_PLUGIN_LIBRARY}
+    BASE_NAME widget_plugin_library
+    EXPORT_FILE_NAME "${CMAKE_CURRENT_BINARY_DIR}/widget-plugin-library_export.h"
+)
+
+# Creating the collection
+set(WIDGET_PLUGIN_COLLECTION widget-plugin-collection_${PROJECT_NAME_LOWER})
+qt_add_library(${WIDGET_PLUGIN_COLLECTION}
+    widgetplugincollection.cpp widgetplugincollection.h
+)
+target_link_libraries(${WIDGET_PLUGIN_COLLECTION}
+    Qt6::Widgets Qt6::UiPlugin ${WIDGET_PLUGIN_LIBRARY}
+)
+install(TARGETS ${WIDGET_PLUGIN_COLLECTION}
+    RUNTIME DESTINATION "${QT_PLUGIN_INSTALL_DIR}"
+    BUNDLE DESTINATION "${QT_PLUGIN_INSTALL_DIR}"
+    LIBRARY DESTINATION "${QT_PLUGIN_INSTALL_DIR}"
+)
+
+# Application that will use the widget plugin
+
+set(APP_DIR ${CMAKE_CURRENT_SOURCE_DIR})
+configure_file("${CMAKE_CURRENT_SOURCE_DIR}/app-dir.h.in"
+    "${CMAKE_CURRENT_SOURCE_DIR}/app-dir.h"
+    @ONLY
+)
+
+set(WIDGET_APP widget-app_${PROJECT_NAME_LOWER})
+qt_add_executable(${WIDGET_APP}
+    widgetapp.cpp widgetapp.h widgetapp.ui
+    main.cpp
+)
+target_link_libraries(${WIDGET_APP}
+    PRIVATE Qt::Widgets ${WIDGET_PLUGIN_LIBRARY}
+)

cpp/qt/designer-plugin-collection/app-dir.h

@@ -0,0 +1,6 @@
+#ifndef APPDIR_H_IN
+#define APPDIR_H_IN
+
+#define APP_DIR "/media/shaun/Storage/Code/klips/cpp/qt/designer-plugin-collection"
+
+#endif // APPDIR_H_IN

cpp/qt/designer-plugin-collection/app-dir.h.in

@@ -0,0 +1,6 @@
+#ifndef APPDIR_H_IN
+#define APPDIR_H_IN
+
+#define APP_DIR "@APP_DIR@"
+
+#endif // APPDIR_H_IN

cpp/qt/designer-plugin-collection/main.cpp

@@ -0,0 +1,18 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Main driver fprogram for practice using signals and slots in Qt     ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "widgetapp.h"
+#include <QApplication>
+
+int main(int argc, char *argv[]) {
+  QApplication app(argc, argv);
+  WidgetApp widgetApp;
+  widgetApp.show();
+  return app.exec();
+}

cpp/qt/designer-plugin-collection/textview.cpp

@@ -0,0 +1,10 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Text viewer for signals and slots examples                          ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "textview.h"

cpp/qt/designer-plugin-collection/textview.h

@@ -0,0 +1,44 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Text viewer for signals and slots examples                          ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#ifndef KLIPS_TEXTVIEW_H
+#define KLIPS_TEXTVIEW_H
+
+#include "widget-plugin-library_export.h"
+#include <QPlainTextEdit>
+
+class WIDGET_PLUGIN_LIBRARY_EXPORT TextView : public QPlainTextEdit {
+  Q_OBJECT
+
+public:
+  explicit TextView(QWidget *parent = nullptr) : QPlainTextEdit(parent) {
+    appendPlainText("This is an example of a custom QTextView widget.");
+  }
+
+  ~TextView() = default;
+
+  QString includeFile() const { return QStringLiteral("text-view.h"); };
+public:
+signals:
+  void sendTest();
+
+private:
+signals:
+  void sentTestPrivate();
+
+public slots:
+  void test() { appendPlainText("Test signal received by TextView."); }
+
+  void testArgs(const QString &message) { appendPlainText(message); }
+
+private slots:
+  void testPrivate() {}
+};
+
+#endif // KLIPS_TEXTVIEW_H

cpp/qt/designer-plugin-collection/treeview.cpp

@@ -0,0 +1,10 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Tree viewer                                                         ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "treeview.h"

cpp/qt/designer-plugin-collection/treeview.h

@@ -0,0 +1,36 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Tree viewer                                                         ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#ifndef KLIPS_TREEVIEW_H
+#define KLIPS_TREEVIEW_H
+
+#include "widget-plugin-library_export.h"
+#include <app-dir.h>
+
+#include <QFileSystemModel>
+#include <QSortFilterProxyModel>
+#include <QTreeView>
+
+class WIDGET_PLUGIN_LIBRARY_EXPORT TreeView : public QTreeView {
+  Q_OBJECT
+
+public:
+  explicit TreeView(QWidget *parent = nullptr) : QTreeView(parent) {
+    QFileSystemModel *model = new QFileSystemModel;
+    QSortFilterProxyModel *proxy = new QSortFilterProxyModel(this);
+    QModelIndex rootModelIndex = model->setRootPath(APP_DIR);
+    proxy->setSourceModel(model);
+    setModel(proxy);
+    setRootIndex(proxy->mapFromSource(rootModelIndex));
+  }
+
+  ~TreeView() = default;
+};
+
+#endif // KLIPS_TREEVIEW_H

cpp/qt/designer-plugin-collection/widgetapp.cpp

@@ -0,0 +1,15 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Application that uses widget from the collection                    ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "widgetapp.h"
+
+WidgetApp::WidgetApp(QWidget *parent) : QMainWindow(parent) {
+  m_widgetApp = new Ui::MainWindow;
+  m_widgetApp->setupUi(this);
+}

cpp/qt/designer-plugin-collection/widgetapp.h

@@ -0,0 +1,37 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Application that uses a custom Qt Designer widget plugin            ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#ifndef KLIPS_WIDGETAPP_H
+#define KLIPS_WIDGETAPP_H
+
+#include <QDockWidget>
+#include <QMainWindow>
+#include <QPlainTextEdit>
+#include <QVBoxLayout>
+#include <QWidget>
+
+#include "ui_widgetapp.h"
+
+class WidgetApp : public QMainWindow {
+  Q_OBJECT
+
+public:
+  explicit WidgetApp(QWidget *parent = nullptr);
+  ~WidgetApp() = default;
+
+  Ui::MainWindow * m_widgetApp;
+public:
+signals:
+  void sendTest();
+
+public slots:
+  void test(){};
+};
+
+#endif // KLIPS_WIDGETAPP_H

cpp/qt/designer-plugin-collection/widgetapp.ui

@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>MainWindow</class>
+ <widget class="QMainWindow" name="MainWindow">
+  <property name="geometry">
+   <rect>
+    <x>0</x>
+    <y>0</y>
+    <width>800</width>
+    <height>600</height>
+   </rect>
+  </property>
+  <property name="windowTitle">
+   <string>MainWindow</string>
+  </property>
+  <widget class="QWidget" name="centralwidget">
+   <property name="enabled">
+    <bool>true</bool>
+   </property>
+   <property name="sizePolicy">
+    <sizepolicy hsizetype="Preferred" vsizetype="Preferred">
+     <horstretch>0</horstretch>
+     <verstretch>0</verstretch>
+    </sizepolicy>
+   </property>
+   <layout class="QHBoxLayout" name="horizontalLayout_9">
+    <item>
+     <widget class="TextView" name="text-view_4" native="true"/>
+    </item>
+   </layout>
+  </widget>
+  <widget class="QMenuBar" name="menubar">
+   <property name="geometry">
+    <rect>
+     <x>0</x>
+     <y>0</y>
+     <width>800</width>
+     <height>22</height>
+    </rect>
+   </property>
+   <widget class="QMenu" name="menuFile">
+    <property name="title">
+     <string>File</string>
+    </property>
+    <addaction name="actionOption1"/>
+    <addaction name="actionOption2"/>
+    <addaction name="separator"/>
+    <addaction name="actionCategory_2"/>
+   </widget>
+   <widget class="QMenu" name="menuEdit">
+    <property name="title">
+     <string>Edit</string>
+    </property>
+   </widget>
+   <widget class="QMenu" name="menuHelp">
+    <property name="title">
+     <string>Help</string>
+    </property>
+   </widget>
+   <addaction name="menuFile"/>
+   <addaction name="menuEdit"/>
+   <addaction name="menuHelp"/>
+  </widget>
+  <widget class="QStatusBar" name="statusbar"/>
+  <widget class="QDockWidget" name="dockWidget_5">
+   <attribute name="dockWidgetArea">
+    <number>1</number>
+   </attribute>
+   <widget class="QWidget" name="dockWidgetContents_8">
+    <layout class="QHBoxLayout" name="horizontalLayout_10">
+     <item>
+      <widget class="TreeView" name="tree-view"/>
+     </item>
+    </layout>
+   </widget>
+  </widget>
+  <action name="actionOption1">
+   <property name="text">
+    <string>Option1</string>
+   </property>
+  </action>
+  <action name="actionOption2">
+   <property name="text">
+    <string>Option2</string>
+   </property>
+  </action>
+  <action name="actionCategory_2">
+   <property name="text">
+    <string>Section 2</string>
+   </property>
+  </action>
+ </widget>
+ <customwidgets>
+  <customwidget>
+   <class>TreeView</class>
+   <extends>QWidget</extends>
+   <header>treeview.h</header>
+  </customwidget>
+  <customwidget>
+   <class>TextView</class>
+   <extends>QWidget</extends>
+   <header>textview.h</header>
+  </customwidget>
+ </customwidgets>
+ <resources/>
+ <connections/>
+</ui>

cpp/qt/designer-plugin-collection/widgetplugin.cpp

@@ -0,0 +1,52 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Example of a generic Qt Designer widget plugin                      ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "widgetplugin.h"
+#include "textview.h"
+
+#include <QtPlugin>
+#include <utility>
+
+WidgetPlugin::WidgetPlugin(QString group, QString name,
+                           WidgetPlugin::Factory factory)
+    : m_group(std::move(group)), m_name(std::move(name)),
+      m_includeFile(name + ".h"), m_factory(std::move(factory)) {}
+
+WidgetPlugin::WidgetPlugin(QString group, QString name, QString include,
+                           WidgetPlugin::Factory factory)
+    : m_group(std::move(group)), m_name(std::move(name)),
+      m_includeFile(std::move(include)), m_factory(std::move(factory)) {}
+
+QString WidgetPlugin::toolTip() const { return {}; }
+
+QString WidgetPlugin::whatsThis() const { return {}; }
+
+QIcon WidgetPlugin::icon() const { return {}; }
+
+bool WidgetPlugin::isContainer() const { return false; }
+
+QString WidgetPlugin::group() const { return m_group; }
+
+QString WidgetPlugin::name() const { return m_name; }
+
+// TODO: The generated UI headers do not use this member appropriately.
+QString WidgetPlugin::includeFile() const { return m_includeFile; }
+
+QWidget *WidgetPlugin::createWidget(QWidget *parent) {
+  return m_factory(parent);
+}
+
+bool WidgetPlugin::isInitialized() const { return m_initialized; }
+
+void WidgetPlugin::initialize(QDesignerFormEditorInterface *) {
+  if (m_initialized)
+    return;
+
+  m_initialized = true;
+}

cpp/qt/designer-plugin-collection/widgetplugin.h

@@ -0,0 +1,52 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Example Qt Designer widget plugin                                   ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#ifndef KLIPS_WIDGETPLUGIN_H
+#define KLIPS_WIDGETPLUGIN_H
+
+#include <QDesignerCustomWidgetInterface>
+
+class WidgetPlugin : public QObject, public QDesignerCustomWidgetInterface {
+  Q_OBJECT
+  Q_PLUGIN_METADATA(IID "com.Klips.WidgetPlugin")
+  Q_INTERFACES(QDesignerCustomWidgetInterface)
+
+  using Factory = std::function<QWidget *(QWidget *)>;
+
+public:
+  WidgetPlugin(QString group, QString name, Factory factory);
+  WidgetPlugin(QString group, QString name, QString include, Factory factory);
+
+  explicit WidgetPlugin(QObject *parent = nullptr) : QObject(parent) {}
+
+  ~WidgetPlugin() = default;
+
+public:
+  [[nodiscard]] QString group() const override;
+  [[nodiscard]] QString name() const override;
+  [[nodiscard]] QString includeFile() const override;
+  QWidget *createWidget(QWidget *parent) override;
+
+  [[nodiscard]] QString toolTip() const override;
+  [[nodiscard]] QString whatsThis() const override;
+  [[nodiscard]] QIcon icon() const override;
+  [[nodiscard]] bool isContainer() const override;
+  [[nodiscard]] bool isInitialized() const override;
+  void initialize(QDesignerFormEditorInterface *core) override;
+
+private:
+  bool m_initialized = false;
+
+  QString m_group;
+  QString m_name;
+  QString m_includeFile;
+  Factory m_factory;
+};
+
+#endif // KLIPS_WIDGETPLUGIN_H

cpp/qt/designer-plugin-collection/widgetplugincollection.cpp

@@ -0,0 +1,28 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Collection of widget plugins for Qt Designer                        ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "widgetplugincollection.h"
+#include "textview.h"
+#include "treeview.h"
+#include "widgetplugin.h"
+
+WidgetPluginCollection::WidgetPluginCollection(QObject *parent)
+    : QObject(parent), m_collectionName("Klips Widget Plugin Collection") {
+  m_collection = {
+      new WidgetPlugin(m_collectionName, "Text View Widget", "text-view.h",
+                       [](QWidget *parent) { return new TextView(parent); }),
+      new WidgetPlugin(m_collectionName, "tree-view",
+                       [](QWidget *parent) { return new TreeView(parent); }),
+
+  };
+}
+QList<QDesignerCustomWidgetInterface *>
+WidgetPluginCollection::customWidgets() const {
+  return m_collection;
+}

cpp/qt/designer-plugin-collection/widgetplugincollection.h

@@ -0,0 +1,22 @@
+
+#ifndef DESIGNERPLUGINCOLLECTION_WIDGETPLUGINCOLLECTION_H
+#define DESIGNERPLUGINCOLLECTION_WIDGETPLUGINCOLLECTION_H
+
+#include <QDesignerCustomWidgetCollectionInterface>
+
+class WidgetPluginCollection : public QObject,
+                               public QDesignerCustomWidgetCollectionInterface {
+  Q_OBJECT
+  Q_PLUGIN_METADATA(IID "com.Klips.WidgetPluginCollection")
+  Q_INTERFACES(QDesignerCustomWidgetCollectionInterface)
+
+public:
+  explicit WidgetPluginCollection(QObject *parent = nullptr);
+  [[nodiscard]] QList<QDesignerCustomWidgetInterface *> customWidgets() const;
+
+private:
+  QList<QDesignerCustomWidgetInterface *> m_collection;
+  QString m_collectionName;
+};
+
+#endif // DESIGNERPLUGINCOLLECTION_WIDGETPLUGINCOLLECTION_H

cpp/qt/designer-plugin/CMakeLists.txt

@@ -0,0 +1,88 @@
+################################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2025 Shaun Reed, all rights reserved                ##
+## About: Example of making widget plugins for Qt Designer                    ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+
+cmake_minimum_required(VERSION 3.15)
+
+project(
+    #[[NAME]]       DesignerPlugin
+    VERSION         1.0
+    DESCRIPTION     "Example of a widget plugin for Qt Designer"
+    LANGUAGES       CXX
+)
+message(STATUS "[Klips] Configuring example: ${PROJECT_NAME}")
+# Lowercase string to use as a slug for executable names for identification.
+string(TOLOWER ${PROJECT_NAME} PROJECT_NAME_LOWER)
+
+include(GenerateExportHeader)
+
+add_compile_options(-Wall)
+set(CMAKE_INCLUDE_CURRENT_DIR ON)
+set(CMAKE_AUTOUIC ON)
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTORCC ON)
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set(CMAKE_SHARED_MODULE_PREFIX "")
+
+set(QT_DIR "$ENV{HOME}/Code/Clones/Qt/" CACHE PATH "Path to Qt6")
+# Qt Designer will look in different locations if WIN / Unix.
+if (WIN32)
+    set(QT_PLUGIN_INSTALL_DIR
+        "${QT_DIR}/Tools/QtCreator/bin/plugins/designer"
+    )
+else()
+    set(QT_PLUGIN_INSTALL_DIR
+        "${QT_DIR}/Tools/QtCreator/lib/Qt/plugins/designer"
+    )
+endif()
+# This should be set to your Qt6 installation directory.
+set(QT_INSTALL_DIR "${QT_DIR}/6.3.1/gcc_64/" CACHE PATH "Path to Qt6 install")
+list(APPEND CMAKE_PREFIX_PATH "${QT_INSTALL_DIR}")
+
+find_package(Qt6 COMPONENTS UiPlugin Core Gui Widgets)
+if (NOT Qt6_FOUND)
+    message(
+        FATAL_ERROR
+        "[Klips] Error: CMake was unable to find Qt6 libraries.\n"
+        "The example will not be built until the build is configured with these packages installed.\n"
+        "On Ubuntu 24.04 Qt6 can be installed using apt:\n"
+        "  sudo apt-get install qt6-base-dev qt6-tools-dev\n"
+    )
+endif()
+
+# Creating the plugin
+set(WIDGET_PLUGIN widget-plugin_${PROJECT_NAME_LOWER})
+qt_add_library(${WIDGET_PLUGIN})
+target_sources(${WIDGET_PLUGIN} PRIVATE
+    text-view.cpp text-view.h
+    widget-plugin.cpp widget-plugin.h
+)
+set_target_properties(${WIDGET_PLUGIN} PROPERTIES
+    WIN32_EXECUTABLE TRUE
+    MACOSX_BUNDLE TRUE
+)
+target_link_libraries(${WIDGET_PLUGIN} PUBLIC
+    Qt::UiPlugin Qt::Core Qt::Gui Qt::Widgets
+)
+
+install(TARGETS ${WIDGET_PLUGIN}
+    RUNTIME DESTINATION "${QT_PLUGIN_INSTALL_DIR}"
+    BUNDLE DESTINATION "${QT_PLUGIN_INSTALL_DIR}"
+    LIBRARY DESTINATION "${QT_PLUGIN_INSTALL_DIR}"
+)
+
+# Application that will use the widget plugin
+set(WIDGET_APP widget-app_${PROJECT_NAME_LOWER})
+qt_add_executable(${WIDGET_APP}
+    widget-app.cpp widget-app.h widget-app.ui
+    main.cpp
+)
+target_link_libraries(${WIDGET_APP} PRIVATE
+    Qt::Widgets ${WIDGET_PLUGIN}
+)

cpp/qt/designer-plugin/main.cpp

@@ -0,0 +1,18 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Main driver fprogram for practice using signals and slots in Qt     ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "widget-app.h"
+#include <QApplication>
+
+int main(int argc, char *argv[]) {
+  QApplication app(argc, argv);
+  WidgetApp widgetApp;
+  widgetApp.show();
+  return app.exec();
+}

cpp/qt/designer-plugin/text-view.cpp

@@ -0,0 +1,10 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Text viewer for signals and slots examples                          ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "text-view.h"

cpp/qt/designer-plugin/text-view.h

@@ -0,0 +1,40 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Text viewer for signals and slots examples                          ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#ifndef KLIPS_TEXTVIEW_H
+#define KLIPS_TEXTVIEW_H
+
+#include <QPlainTextEdit>
+
+class TextView : public QPlainTextEdit {
+  Q_OBJECT
+
+public:
+  explicit TextView(QWidget *parent = nullptr) : QPlainTextEdit(parent) { }
+
+  ~TextView() = default;
+
+public:
+signals:
+  void sendTest();
+
+private:
+signals:
+  void sentTestPrivate();
+
+public slots:
+  void test() { appendPlainText("Test signal received by TextView."); }
+
+  void testArgs(const QString &message) { appendPlainText(message); }
+
+private slots:
+  void testPrivate() {}
+};
+
+#endif // KLIPS_TEXTVIEW_H

cpp/qt/designer-plugin/widget-app.cpp

@@ -0,0 +1,16 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2022 Shaun Reed, all rights reserved                ##
+## About: Application that uses a custom Qt Designer widget plugin            ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+################################################################################
+*/
+
+#include "widget-app.h"
+#include "widget-plugin.h"
+
+WidgetApp::WidgetApp(QWidget *parent) : QMainWindow(parent) {
+  m_ui = new Ui::MainWindow;
+  m_ui->setupUi(this);
+}