Склеенные коммиты

.editorconfig

@@ -0,0 +1,15 @@
+# Заставляем IDE сохранять файлы в кодировке UTF-8
+# https://editorconfig.org
+
+# В родительских папках .editorconfig искаться не будет
+root = true
+
+[*]
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+
+# Не меняем формат разделителя строк. Может возникнуть конфликт с настройками git
+#end_of_line = lf

.gitattributes

@@ -0,0 +1,8 @@
+# Автоматически нормализуем концы строк, если у пользователя не настроен параметр autocrlf
+# https://docs.github.com/en/get-started/getting-started-with-git/configuring-git-to-handle-line-endings
+# https://www.aleksandrhovhannisyan.com/blog/crlf-vs-lf-normalizing-line-endings-in-git/
+* text=auto
+
+# Батники с юниксовыми концами строк глючат
+*.bat text eol=crlf
+*.cmd text eol=crlf

.github/workflows/tester.yml

@@ -0,0 +1,121 @@
+name: Tester
+
+on:
+  push:
+    paths-ignore: 'docs/**'
+  pull_request:
+    paths-ignore: 'docs/**'
+  workflow_dispatch:
+
+jobs:
+  linux:
+    runs-on: ubuntu-24.04
+
+    strategy:
+      fail-fast: false
+      matrix:
+        compiler:
+        - {
+            id: gcc,
+            c: gcc-13,
+            cxx: g++-13,
+          }
+        - {
+            id: clang,
+            c: clang-16,
+            cxx: clang++-16,
+          }
+        build_type: [debug, release]
+
+    name: 🐧-${{ matrix.compiler.id }}-${{ matrix.build_type }}
+
+    steps:
+    - name: Скачиваем репозиторий
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        path: repo
+
+    - name: Генерируем проекты
+      run: |
+        cmake repo -B build -G "Unix Makefiles" \
+          -D CMAKE_C_COMPILER=${{ matrix.compiler.c }} -D CMAKE_CXX_COMPILER=${{ matrix.compiler.cxx }} \
+          -D CMAKE_BUILD_TYPE=${{ matrix.build_type }} \
+          -D DV_BIG_INT_BUILD_TESTER=1 -D DV_BIG_INT_UB_SANITIZER=1
+
+    - name: Компилируем
+      run: |
+        cmake --build build
+
+    - name: CTest
+      run: |
+        ctest --verbose --test-dir build --timeout 60
+
+  windows:
+    runs-on: windows-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        compiler: [vs, mingw]
+        build_type: [debug, release]
+
+    name: 🔲-${{ matrix.compiler }}-${{ matrix.build_type }}
+
+    steps:
+    - name: Устанавливаем MinGW
+      if: matrix.compiler == 'mingw'
+      uses: msys2/setup-msys2@v2
+      with:
+        update: true
+        install: mingw-w64-x86_64-toolchain
+
+    - name: Добавляем в PATH путь к MinGW
+      if: matrix.compiler == 'mingw'
+      shell: bash
+      run: echo "${RUNNER_TEMP}/msys64/mingw64/bin" >> $GITHUB_PATH
+
+    - name: Скачиваем репозиторий
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        path: repo
+
+    - name: Генерируем проекты
+      shell: bash
+      run: |
+        args=(repo -B build -D DV_BIG_INT_BUILD_TESTER=1 -D DV_BIG_INT_UB_SANITIZER=1)
+
+        if [ "${{ matrix.compiler }}" == "vs" ]
+        then
+          args+=(-G "Visual Studio 17 2022")
+        else
+          args+=(-G "MinGW Makefiles")
+          args+=(-D CMAKE_BUILD_TYPE=${{ matrix.build_type }})
+        fi
+
+        cmake "${args[@]}"
+
+    - name: Компилируем
+      shell: bash
+      run: |
+        args=(--build build)
+
+        if [ "${{ matrix.compiler }}" == "vs" ]
+        then
+          args+=(--config ${{ matrix.build_type }})
+        fi
+
+        cmake "${args[@]}"
+
+    - name: CTest
+      shell: bash
+      run: |
+        args=(--verbose --test-dir build --timeout 60)
+
+        if [ "${{ matrix.compiler }}" == "vs" ]
+        then
+          args+=(-C ${{ matrix.build_type }})
+        fi
+
+        ctest "${args[@]}"

.gitignore

@@ -0,0 +1,6 @@
+# https://git-scm.com/docs/gitignore
+# https://www.atlassian.com/ru/git/tutorials/saving-changes/gitignore
+
+# Игнорируем папки, которые создаёт VS Code
+/.vscode/
+/build/

CMakeLists.txt

@@ -0,0 +1,108 @@
+# Указываем минимальную версию CMake
+cmake_minimum_required(VERSION 3.16)
+
+# Название проекта
+project(dv_big_int)
+
+option(DV_BIG_INT_BUILD_TESTER "Компилировать Тестер" OFF)
+option(DV_BIG_INT_UB_SANITIZER "Детектировать undefined behavior" OFF)
+
+# Версия стандарта C++
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+# Если используется одноконфигурационный генератор и конфигурация не указана
+if(NOT CMAKE_CONFIGURATION_TYPES AND NOT CMAKE_BUILD_TYPE)
+    # то конфигурацией по умолчанию будет Release
+    set(CMAKE_BUILD_TYPE Release)
+    # Нельзя оставлять переменную CMAKE_BUILD_TYPE пустой (подробности в Dviglo2D)
+endif()
+
+# Указываем Студии на то, что исходники в кодировке UTF-8.
+# Это позволяет писать U'🍌'. У других компиляторов, похоже, нет с этим проблем
+# https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2295r6.pdf
+if(MSVC)
+    add_compile_options(/utf-8)
+endif()
+
+# Статически линкуем библиотеки, чтобы не копировать dll-ки
+if(MINGW)
+    add_link_options(-static)
+endif()
+
+# Включаем поддержку папок в IDE
+set_property(GLOBAL PROPERTY USE_FOLDERS ON)
+
+# ============================================== Библиотека ==============================================
+
+# Название таргета
+set(target_name dv_big_int)
+
+# Создаём список файлов
+file(GLOB source_files lib/*)
+
+# Создаём статическую библиотеку
+add_library(${target_name} STATIC ${source_files})
+
+# Делаем заголовочные файлы доступными библиотеке и приложениям
+target_include_directories(${target_name} PUBLIC lib)
+
+# Выводим больше предупреждений
+if(MSVC)
+    target_compile_options(${target_name} PRIVATE /W4)
+else() # GCC, Clang или MinGW
+    target_compile_options(${target_name} PRIVATE -Wall -Wextra -Wpedantic)
+
+    if(NOT MINGW AND DV_BIG_INT_UB_SANITIZER)
+        target_compile_options(${target_name} PRIVATE -fsanitize=undefined)
+        # PUBLIC, чтобы не было ошибок при линковке к приложению без опции
+        target_link_options(${target_name} PUBLIC -fsanitize=undefined)
+    endif()
+endif()
+
+# Заставляем VS отображать дерево каталогов
+source_group(TREE ${CMAKE_CURRENT_SOURCE_DIR} FILES ${source_files})
+
+# ============================================== Тестер ==============================================
+
+if(DV_BIG_INT_BUILD_TESTER)
+    # Название таргета
+    set(target_name tester)
+
+    # Создаём список файлов
+    file(GLOB source_files tester/*)
+
+    # Создаём приложение
+    add_executable(${target_name} ${source_files})
+
+    # Подключаем библиотеку
+    target_link_libraries(${target_name} PRIVATE dv_big_int)
+
+    # Выводим больше предупреждений
+    if(MSVC)
+        target_compile_options(${target_name} PRIVATE /W4)
+    else() # GCC, Clang или MinGW
+        target_compile_options(${target_name} PRIVATE -Wall -Wextra -Wpedantic)
+
+        if(NOT MINGW AND DV_BIG_INT_UB_SANITIZER)
+            target_compile_options(${target_name} PRIVATE -fsanitize=undefined)
+        endif()
+    endif()
+
+    # Отладочная версия приложения будет иметь суффикс _d
+    set_property(TARGET ${target_name} PROPERTY DEBUG_POSTFIX _d)
+
+    # Заставляем VS отображать дерево каталогов
+    source_group(TREE ${CMAKE_CURRENT_SOURCE_DIR} FILES ${source_files})
+
+    # Включаем тестирование
+    enable_testing()
+
+    # Добавляем приложение в список тестируемых
+    add_test(NAME ${target_name} COMMAND ${target_name})
+
+    # В Visual Studio таргет будет назначен стартовым вместо ALL_BUILD,
+    # чтобы потом не делать это вручную при отладке приложения
+    set_property(DIRECTORY ${CMAKE_SOURCE_DIR} PROPERTY VS_STARTUP_PROJECT ${target_name})
+endif()

build_linux.sh

@@ -0,0 +1,17 @@
+#!/bin/sh
+
+build_type="-D CMAKE_BUILD_TYPE=Debug"
+#build_type="-D CMAKE_BUILD_TYPE=Release"
+#build_type="-D CMAKE_BUILD_TYPE=MinSizeRel"
+#build_type="-D CMAKE_BUILD_TYPE=RelWithDebInfo"
+
+compiler="-D CMAKE_C_COMPILER=gcc-13 -D CMAKE_CXX_COMPILER=g++-13"
+#compiler="-D CMAKE_C_COMPILER=clang-15 -D CMAKE_CXX_COMPILER=clang++-15"
+
+repo_dir=$(dirname "$0")
+
+# Генерируем проект
+cmake "$repo_dir" -B "$repo_dir/../build" -G "Unix Makefiles" $build_type $compiler
+
+# Компилируем проект
+cmake --build "$repo_dir/../build"

build_mingw.bat

@@ -0,0 +1,23 @@
+:: Меняем кодировку консоли на UTF-8
+chcp 65001
+
+:: Указываем путь к cmake.exe и MinGW. Без system32 в PATH ссылки на папки не создаются
+set "PATH=%SystemRoot%\system32;c:\programs\cmake\bin;c:\msys64\ucrt64\bin"
+
+set build_type=Debug
+::set build_type=Release
+::set build_type=MinSizeRel
+::set build_type=RelWithDebInfo
+
+set "repo_dir=%~dp0"
+:: Удаляем обратный слэш в конце
+set "repo_dir=%repo_dir:~0,-1%"
+
+:: Генерируем проект
+cmake "%repo_dir%" -B "%repo_dir%/../build_mingw" -G "MinGW Makefiles" -D CMAKE_BUILD_TYPE=%build_type%
+
+:: Компилируем проект
+cmake --build "%repo_dir%/../build_mingw"
+
+:: Ждём нажатие Enter перед закрытием консоли
+pause

build_vs.bat

@@ -0,0 +1,25 @@
+:: Меняем кодировку консоли на UTF-8
+chcp 65001
+
+:: Указываем путь к cmake.exe. Без system32 в PATH ссылки на папки не создаются
+set "PATH=%SystemRoot%\system32;c:\programs\cmake\bin"
+
+set build_type=Debug
+::set build_type=Release
+::set build_type=MinSizeRel
+::set build_type=RelWithDebInfo
+
+set "generator=Visual Studio 17"
+
+set "repo_dir=%~dp0"
+:: Удаляем обратный слэш в конце
+set "repo_dir=%repo_dir:~0,-1%"
+
+:: Генерируем проект
+cmake "%repo_dir%" -B "%repo_dir%/../build_vs" -G "%generator%" -A x64
+
+:: Компилируем проект
+cmake --build "%repo_dir%/../build_vs" --config %build_type%
+
+:: Ждём нажатие Enter перед закрытием консоли
+pause