Pre 0.1.6

.gdbinit

@@ -0,0 +1,9 @@
+set unwind-on-signal on
+set pagination off
+python
+import sys
+import os
+sys.path.insert(0, os.path.join(os.getcwd(), 'debug'))
+import gdbinit
+print("GDB pretty-printer for original initialized.")
+end

.github/workflows/basic-tests.yml

@@ -3,7 +3,7 @@
 name: Test Branch CI - Basic Tests
 
 on:
-  push:
+  pull_request:
     branches: [ test ]
 
 jobs:

.github/workflows/deploy-docs-latest.yml

@@ -8,6 +8,7 @@ on:
 
 jobs:
   build-and-deploy:
+    if: github.repository == 'FrozenLemonTee/original'
     runs-on: ubuntu-latest
 
     steps:

.github/workflows/deploy-docs-stable.yml

@@ -5,9 +5,12 @@ name: Deploy Documentation - Stable
 on:
   push:
     branches: [ master ]
+    tags:
+      - 'v*.*.*'
 
 jobs:
   build-and-deploy:
+    if: github.repository == 'FrozenLemonTee/original'
     runs-on: ubuntu-latest
 
     steps:

.github/workflows/deploy-docs-tags.yml

@@ -9,6 +9,7 @@ on:
 
 jobs:
   build-and-deploy:
+    if: github.repository == 'FrozenLemonTee/original'
     runs-on: ubuntu-latest
 
     steps:

.github/workflows/full-tests.yml

@@ -56,7 +56,7 @@ jobs:
 
       - name: Run tests
         run: |
-          cd build && ctest --output-on-failure
+          cd build && ctest --verbose --output-on-failure
 
   windows-tests:
     runs-on: windows-latest
@@ -75,4 +75,32 @@ jobs:
 
       - name: Run tests
         run: |
-          cd build && ctest -C ${{ matrix.build_type }} --output-on-failure
+          cd build && ctest --verbose -C ${{ matrix.build_type }} --output-on-failure
+
+  macos-tests:
+    runs-on: macos-latest
+    continue-on-error: true
+    strategy:
+      matrix:
+        build_type: [ Debug, Release ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          brew update
+          brew install cmake ninja
+
+      - name: Configure and Build
+        run: |
+          export CC=clang
+          export CXX=clang++
+
+          cmake -B build -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} -G Ninja
+          cmake --build build --config ${{ matrix.build_type }}
+
+      - name: Run tests
+        run: |
+          cd build && ctest --verbose --output-on-failure

.gitignore

@@ -1,10 +1,15 @@
-cmake-build-debug/
-.idea/
-test.exe
-original.zip
-original.rar
+cmake-build-*/
+**/.idea/
 build/
 install/
 .vs/
+.vscode/
 out/
-original/
+original/
+**/__pycache__/
+.cache/
+
+test.exe
+original.zip
+original.rar
+src/.DS_Store

CMakeLists.txt

@@ -1,10 +1,53 @@
 # CMakeLists.txt Main
 
-cmake_minimum_required(VERSION 3.31)
+set(CMAKE_VERSION_MINIMUM 3.31)
+cmake_minimum_required(VERSION ${CMAKE_VERSION_MINIMUM})
+message(STATUS "Cmake version: ${CMAKE_VERSION} (>= ${CMAKE_VERSION_MINIMUM} ✓)")
+if(CMAKE_GENERATOR MATCHES "Visual Studio" OR CMAKE_GENERATOR MATCHES "Ninja Multi-Config")
+    set(CMAKE_GENERATOR_PLATFORM x64 CACHE STRING "Platform" FORCE)
+endif()
 project(original LANGUAGES CXX)
-set(ORIGINAL_VERSION 0.1.5)
+set(ORIGINAL_VERSION 0.1.6)
 set(CMAKE_CXX_STANDARD 23)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+find_package(Threads REQUIRED)
+
+if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+    set(COMPILER_GCC_VERSION_MINIMUM 13.0)
+    if(CMAKE_CXX_COMPILER_VERSION VERSION_LESS ${COMPILER_GCC_VERSION_MINIMUM})
+        message(FATAL_ERROR "GCC version too old. Minimum required: ${COMPILER_GCC_VERSION_MINIMUM}. Current: ${CMAKE_CXX_COMPILER_VERSION}")
+    else()
+        message(STATUS "GCC version: ${CMAKE_CXX_COMPILER_VERSION} (>= ${COMPILER_GCC_VERSION_MINIMUM} ✓)")
+    endif()
+endif()
+
+if(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
+    set(COMPILER_CLANG_VERSION_MINIMUM 20.0)
+    if(CMAKE_CXX_COMPILER_VERSION VERSION_LESS ${COMPILER_CLANG_VERSION_MINIMUM})
+        message(FATAL_ERROR "Clang version too old. Minimum required: ${COMPILER_CLANG_VERSION_MINIMUM}. Current: ${CMAKE_CXX_COMPILER_VERSION}")
+    else()
+        message(STATUS "Clang version: ${CMAKE_CXX_COMPILER_VERSION} (>= ${COMPILER_CLANG_VERSION_MINIMUM} ✓)")
+    endif()
+endif()
+if(MSVC)
+    set(COMPILER_MSVC_VERSION_MINIMUM 1944)
+    if(MSVC_VERSION LESS ${COMPILER_MSVC_VERSION_MINIMUM})
+        message(FATAL_ERROR "MSVC version too old. Minimum required: ${COMPILER_MSVC_VERSION_MINIMUM}. Current: ${MSVC_VERSION}")
+    else()
+        message(STATUS "MSVC version: ${MSVC_VERSION} (>= ${COMPILER_MSVC_VERSION_MINIMUM} ✓)")
+    endif()
+    set(CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION "10.0" CACHE STRING "Windows Target Platform Version")
+endif()
+if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
+    include(CheckCXXCompilerFlag)
+    check_cxx_compiler_flag("-std=c++23" HAS_CXX23_FLAG)
+    if(NOT HAS_CXX23_FLAG)
+        message(WARNING "Compiler may not fully support C++23 standard")
+    endif()
+endif()
+
 if (NOT CMAKE_BUILD_TYPE)
     set(CMAKE_BUILD_TYPE Release CACHE STRING "Build type (default Release)" FORCE)
 endif()
@@ -20,6 +63,7 @@ file(GLOB ORIGINAL_HEADERS
         "${ORIGINAL_SRC_DIR}/vibrant/*.h"
 )
 add_library(original STATIC ${ORIGINAL_HEADERS} src/original.cpp)
+target_link_libraries(original PUBLIC Threads::Threads)
 
 target_include_directories(original PUBLIC
         $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src>
@@ -69,24 +113,12 @@ install(FILES
         DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/original
 )
 
+add_subdirectory(debug)
+
 option(BUILD_TESTING "Build the testing directories" ON)
 
 if (BUILD_TESTING)
     include(CTest)
-    if(MSVC)
-        set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /Zi")
-        set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} /Zi")
-    else()
-        if (NOT CMAKE_SYSTEM_NAME STREQUAL "Windows")
-            set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fsanitize=address -g")
-            set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fsanitize=address -g")
-        else()
-            set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g")
-            set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -g")
-        endif()
-    endif()
-
-    # test cases
-    add_subdirectory(test/other)
-    add_subdirectory(test/unit_test)
+    enable_testing()
+    add_subdirectory(test)
 endif ()

README.md

@@ -9,6 +9,19 @@ Original是一个C++基础工具库,也是本人的第一个正式项目，用
 ## 文档
 [文档-Original](https://documents-original.vercel.app/)
 
+## 环境要求
+
+为了编译和使用 Original，请确保开发环境满足以下最低版本要求：
+
+- **C++ 标准**: C++23
+- **CMake**: 3.31 或更高版本
+- **编译器**（任选其一）：
+    - **GCC**: 13.0 或更高版本
+    - **Clang**: 20.0 或更高版本
+    - **MSVC**（Visual Studio 2022）：17.10 (版本 14.44.35207) 或更高版本
+
+> 注意：如果使用 GCC 或 Clang，请确保支持 `-std=c++23` 标志。
+
 ## 安装
 
 这里以项目`hello_original`为例：
@@ -21,7 +34,7 @@ Original是一个C++基础工具库,也是本人的第一个正式项目，用
 
 配置`CMakeLists.txt`：
 ```cmake
-cmake_minimum_required(VERSION 3.30)
+cmake_minimum_required(VERSION 3.31)
 project(hello_original)
 
 set(CMAKE_CXX_STANDARD 23)
@@ -60,7 +73,7 @@ cmake -P install.cmake
 
 配置`CMakeLists.txt`：
 ```cmake
-cmake_minimum_required(VERSION 3.30)
+cmake_minimum_required(VERSION 3.31)
 project(hello_original)
 
 set(CMAKE_CXX_STANDARD 23)
@@ -103,7 +116,7 @@ array("hello world!")
 
 ##### 容器接口：
 
-格式化输出接口 printable，元素比较接口 comparable，堆对象深拷贝接口 cloneable，可迭代接口 iterable
+格式化输出接口 printable，元素比较接口 comparable，堆对象深拷贝接口 cloneable，可迭代接口 iterable，数组视图 arrayView
 
 ##### 算法库：
 
@@ -166,6 +179,10 @@ array("hello world!")
 
 任务包装类 taskBase/task，任务委派器 taskDelegator
 
+##### 协程：
+
+生成器 coroutine::generator
+
 #### matrix
 
 计划实现，包含张量，线性代数工具功能。

debug/CMakeLists.txt

@@ -0,0 +1,42 @@
+# debug/CMakeLists.txt
+
+if(CMAKE_BUILD_TYPE MATCHES "Debug")
+    if(CMAKE_CXX_COMPILER_ID MATCHES "GNU" OR CMAKE_CXX_COMPILER_ID MATCHES "MinGW")
+        message(STATUS "[GDB CONFIG] Detected GNU/MinGW toolchain, setting up GDB auto-load permissions")
+
+        if(WIN32)
+            file(TO_CMAKE_PATH "$ENV{USERPROFILE}" USER_HOME)
+        else()
+            file(TO_CMAKE_PATH "$ENV{HOME}" USER_HOME)
+        endif()
+
+        set(GDB_GLOBAL_INIT "${USER_HOME}/.config/gdb/gdbinit")
+        if(NOT EXISTS "${GDB_GLOBAL_INIT}")
+            set(GDB_GLOBAL_INIT "${USER_HOME}/.gdbinit")
+        endif()
+
+        set(PROJECT_GDBINIT "${CMAKE_SOURCE_DIR}/.gdbinit")
+
+        set(GDB_CONFIG_LINES
+                "set auto-load local-gdbinit on
+add-auto-load-safe-path ${PROJECT_GDBINIT}\n"
+        )
+
+        get_filename_component(GDB_CONFIG_DIR "${GDB_GLOBAL_INIT}" DIRECTORY)
+        file(MAKE_DIRECTORY "${GDB_CONFIG_DIR}")
+
+        if(EXISTS "${GDB_GLOBAL_INIT}")
+            file(READ "${GDB_GLOBAL_INIT}" EXISTING_CONTENT)
+            string(FIND "${EXISTING_CONTENT}" "${PROJECT_GDBINIT}" ALREADY_ADDED)
+        else()
+            set(ALREADY_ADDED -1)
+        endif()
+
+        if(ALREADY_ADDED EQUAL -1)
+            file(APPEND "${GDB_GLOBAL_INIT}" "\n# Added by Original CMake auto-config\n${GDB_CONFIG_LINES}")
+            message(STATUS "[GDB CONFIG] Added safe-path for ${PROJECT_GDBINIT} in ${GDB_GLOBAL_INIT}")
+        else()
+            message(STATUS "[GDB CONFIG] Safe-path already configured in ${GDB_GLOBAL_INIT}")
+        endif()
+    endif()
+endif()

debug/gdbinit.py

@@ -0,0 +1,58 @@
+# debug/gdbinit.py
+
+import gdb
+import sys
+import os
+import importlib.util
+import inspect
+
+
+def load_printers_from_directory(pretty_printer_collection, directory):
+    """Load all pretty-printer scripts from the specified directory."""
+    if not os.path.isdir(directory):
+        print(f"[WARN] Skipped non-existent directory: {directory}")
+        return
+
+    for file_name in os.listdir(directory):
+        if not file_name.endswith("_printer.py"):
+            continue
+
+        file_path = os.path.join(directory, file_name)
+        module_name = os.path.splitext(file_name)[0]
+
+        try:
+            spec = importlib.util.spec_from_file_location(module_name, file_path)
+            module = importlib.util.module_from_spec(spec)
+            spec.loader.exec_module(module)
+
+            printer_class = None
+            for name, cls in inspect.getmembers(module, inspect.isclass):
+                if name == "Printer":
+                    printer_class = cls
+                    break
+
+            if printer_class is None:
+                print(f"[SKIP] {module_name}: no 'Printer' class found")
+                continue
+            type_name = module_name.replace("_printer", "")
+            type_regex = f"^original::{type_name}(<.*>)?$"
+
+            pretty_printer_collection.add_printer(module_name, type_regex, printer_class)
+            print(f"Registered pretty-printer: {type_name}")
+
+        except Exception as e:
+            print(f"Failed to load {file_name}: {e}")
+
+
+this_dir = os.path.dirname(__file__)
+printers_dir = os.path.join(this_dir, "printers")
+core_dir = os.path.join(printers_dir, "core")
+
+sys.path.insert(0, printers_dir)
+sys.path.insert(0, core_dir)
+
+pp = gdb.printing.RegexpCollectionPrettyPrinter("original")
+load_printers_from_directory(pp, core_dir)
+gdb.printing.register_pretty_printer(None, pp)
+
+print("GDB pretty-printers for 'original' registered successfully.")