Set up the repository

.clang-format

@@ -0,0 +1,87 @@
+---
+Language: Cpp
+BasedOnStyle: Google
+AccessModifierOffset: -2
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+AlignOperands: true
+AlignTrailingComments: true
+AllowShortBlocksOnASingleLine: Never
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakTemplateDeclarations: Yes
+BinPackArguments: false
+BinPackParameters: false
+BraceWrapping:
+  AfterCaseLabel: false
+  AfterClass: false
+  AfterControlStatement: false
+  AfterEnum: false
+  AfterFunction: false
+  AfterNamespace: false
+  AfterStruct: false
+  AfterUnion: false
+  AfterExternBlock: false
+  BeforeCatch: false
+  BeforeElse: false
+  BeforeLambdaBody: false
+  BeforeWhile: false
+  SplitEmptyFunction: false
+  SplitEmptyRecord: false
+  SplitEmptyNamespace: false
+  AfterObjCDeclaration: false
+  IndentBraces: false
+BreakBeforeBraces: Custom
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializers: AfterColon
+BreakConstructorInitializersBeforeComma: false
+ColumnLimit: 120
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+ContinuationIndentWidth: 4
+EmptyLineAfterAccessModifier: Never
+EmptyLineBeforeAccessModifier: LogicalBlock
+IncludeBlocks: Preserve
+IncludeCategories:
+  - Regex: '^<.*'
+    Priority: 1
+  - Regex: '^".*'
+    Priority: 2
+  - Regex: '.*'
+    Priority: 3
+IncludeIsMainRegex: ([-_](test|unittest))?$'([-_](test|unittest))?$'
+IndentCaseBlocks: false
+IndentCaseLabels: true
+IndentGotoLabels: true
+IndentPPDirectives: None
+IndentWidth: 2
+IndentWrappedFunctionNames: false
+InsertNewlineAtEOF: true
+MacroBlockBegin: ''
+MacroBlockEnd: ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+PointerAlignment: Left
+SpaceAfterCStyleCast: true
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeSquareBrackets: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles: false
+SpacesInConditionalStatement: false
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+TabWidth: 4
+UseTab: Never
+...

.clang-tidy

@@ -0,0 +1,20 @@
+Checks: '-*,
+  modernize-*,
+  performance-*,
+  cppcoreguidelines-*,
+  bugprone-*,
+  -modernize-use-trailing-return-type,
+  -performance-no-int-to-ptr,
+  -cppcoreguidelines-avoid-const-or-ref-data-members,
+  -cppcoreguidelines-pro-type-reinterpret-cast,
+  -cppcoreguidelines-pro-type-union-access,
+  -cppcoreguidelines-pro-bounds-pointer-arithmetic,
+  -bugprone-exception-escape,
+  -bugprone-easily-swappable-parameters'
+
+WarningsAsErrors: ''
+HeaderFilterRegex: ''
+FormatStyle: none
+CheckOptions:
+  - key: modernize-use-using.IgnoreMacros
+    value: 'true'

.github/workflows/ci_tests.yml

@@ -18,23 +18,23 @@ jobs:
       - name: Build main target
         shell: bash
         run: |
-          cmake --build cmake-build-release --target cpp_tests || echo Built with errors
+          cmake --build cmake-build-release || echo Built with errors
 
       - name: Build tests target
         shell: bash
         run: |
-          cmake --build cmake-build-debug --target cpp_tests_tests || echo Built with errors
+          cmake --build cmake-build-debug --target ovum_tests || echo Built with errors
 
       - name: Run program
         working-directory: .\cmake-build-release
         run: |
-          .\cpp_tests.exe --help
+          .\ovum.exe --help
 
       - name: Run tests
         working-directory: .\cmake-build-debug
         run: |
           echo "Currently unable to run tests on Windows Latest MinGW. See https://gitmemories.com/cristianadam/HelloWorld/issues/12 and https://github.com/microsoft/vscode-cmake-tools/issues/2451"
-          % .\cpp_tests_tests.exe
+          % .\ovum_tests.exe
 
   build-matrix:
     name: Tests and application run on ${{ matrix.config.name }}
@@ -72,33 +72,33 @@ jobs:
       - name: Build main target
         shell: bash
         run: |
-          cmake --build cmake-build-release --target cpp_tests || echo "Built with errors"
+          cmake --build cmake-build-release --target ovum || echo "Built with errors"
 
       - name: Build tests target
         shell: bash
         run: |
-          cmake --build cmake-build-debug --target cpp_tests_tests || echo "Built with errors"
+          cmake --build cmake-build-debug --target ovum_tests || echo "Built with errors"
 
       - name: Run program
         shell: bash
         working-directory: ./cmake-build-release
         run: |
           if [ "$RUNNER_OS" == "Windows" ]; then
-            ./cpp_tests.exe --help
+            ./ovum.exe --help
           else 
             cd bin
-            ./cpp_tests --help
+            ./ovum --help
           fi
 
       - name: Run tests
         shell: bash
         working-directory: ./cmake-build-debug
         run: |
           if [ "$RUNNER_OS" == "Windows" ]; then
-            ./cpp_tests_tests.exe
+            ./ovum_tests.exe
           else
             cd tests
-            ./cpp_tests_tests
+            ./ovum_tests
           fi
 
   memory-leaks:
@@ -117,9 +117,9 @@ jobs:
 
       - name: Build tests target
         run: |
-          cmake --build cmake-build --target cpp_tests_tests
+          cmake --build cmake-build --target ovum_tests
 
       - name: Run valgrind
         working-directory: ./cmake-build/tests
         run: |
-          valgrind --leak-check=full --track-origins=yes --error-exitcode=1 ./cpp_tests_tests
+          valgrind --leak-check=full --track-origins=yes --error-exitcode=1 ./ovum_tests

.gitignore

@@ -1,5 +1,6 @@
 # CMake
 **cmake-build*/
+build/
 
 # All idea files
 **.idea*/
@@ -10,6 +11,15 @@
 # IntelliJ
 **out/
 
+# Visual Studio Code
+**.vscode/
+**.history/
+
+# Clangd
+compile_commands.json
+compile_flags.txt
+.clangd
+
 # mpeltonen/sbt-idea plugin
 **.idea_modules/
 
@@ -22,6 +32,18 @@ crashlytics.properties
 crashlytics-build.properties
 fabric.properties
 
+# Notepad++ temporary file
+*.bak
+
+# API keys
+*.apikey
+
+# Cache directories
+**cache*/
+
+# Program settings files
+**.config*/compiler/*
+
 # Prerequisites
 *.d
 

CMakeLists.txt

@@ -1,30 +1,14 @@
 cmake_minimum_required(VERSION 3.12)
 
 project(
-        cpp_tests # Rename the project here and in ci_tests.yml
-        VERSION 0.1
-        DESCRIPTION "C++ Project with Google tests"
-        LANGUAGES CXX
+    ovum
+    VERSION 0.1
+    DESCRIPTION "Ovum programming language toolset"
+    LANGUAGES CXX
 )
 
-set(CMAKE_CXX_STANDARD 20)
-
-if (WIN32) # Install dlls in the same directory as the executable on Windows
-    set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR})
-    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR})
-    set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR})
-    set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR})
-    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR})
-    set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR})
-endif ()
-
-if (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
-    set(CMAKE_CXX_FLAGS_DEBUG "/MDd")
-    set(CMAKE_CXX_FLAGS_RELEASE "/O2")
-else ()
-    set(CMAKE_CXX_FLAGS_DEBUG "-g")
-    set(CMAKE_CXX_FLAGS_RELEASE "-O3")
-endif ()
+include(cmake/SetCompilerOptions.cmake)
+include(cmake/IncludeExternalLibraries.cmake)
 
 add_subdirectory(lib)
 add_subdirectory(bin)

CODEBASE_STRUCTURE.md

@@ -0,0 +1,33 @@
+# Базовая структура репозитория
+
+## Назначение директорий
+
+### Корневая директория
+- **Документация проекта** - README, инструкции по сборке, руководства для разработчиков
+- **Конфигурация сборки** - CMakeLists.txt, вспомогательные CMake-скрипты
+- **Настройки инструментов** - конфигурации для форматирования, линтеров, Git
+- **Скрипты автоматизации** - установка зависимостей, подготовка окружения
+
+### bin/
+- **Исполняемые файлы** - точка входа приложения
+- **CLI-интерфейс** - командная строка для взаимодействия с пользователем
+
+### docs/
+- **Документация проекта** - README, инструкции по сборке, руководства для разработчиков
+
+### lib/
+- **Основная библиотека** - ядро функциональности проекта
+- **UI-модуль** - пользовательский интерфейс и CLI-утилиты
+- **Общие компоненты** - переиспользуемые части кода. Добавляйте новые модули только в эту директорию.
+
+### tests/
+- **Модульные тесты** - тестирование отдельных компонентов
+- **Интеграционные тесты** - тестирование взаимодействия между модулями
+- **Вспомогательные функции** - утилиты для тестирования
+- **Тестовые данные** - примеры и фикстуры для тестов
+
+### .github/workflows/
+- **CI/CD конфигурация** - автоматическая сборка и тестирование
+- **Проверки качества кода** - статический анализ, форматирование
+- **Развертывание** - автоматическая публикация релизов
+

CODE_OF_CONDUCT.md

@@ -0,0 +1,66 @@
+# Кодекс поведения участников Соглашения
+
+## Наше обещание
+
+В интересах создания открытой и доброжелательной среды мы, как участники и сопровождающие, обязуемся сделать участие в
+нашем проекте и нашем сообществе свободным от преследований для всех, независимо от возраста, размера тела,
+инвалидности, этнической принадлежности, половых характеристик, гендерной идентичности, самовыражение, уровня опыта,
+образования, социально-экономического статус, национальности, внешнего вида, расы, религии или сексуальной идентичности
+и ориентации.
+
+## Наши стандарты
+
+Примеры поведения, которое способствует созданию благоприятной среды, включают:
+
+- Использование приветливого и инклюзивного языка
+- Уважительное отношение к различным точкам зрения и опыту
+- Изящно принимаю конструктивную критику
+- Сосредоточение внимания на том, что лучше для сообщества
+- Проявление сочувствия к другим членам сообщества
+
+Примеры недопустимого поведения участников включают:
+
+- Использование сексуализированной лексики или образов и нежелательное сексуальное внимание или заигрывания
+- Троллинг, оскорбительные / уничижительные комментарии, а также личные или политические нападки
+- Публичное или частное преследование
+- Публикация частной информации других лиц, такой как физический или электронный адрес, без явного разрешения
+- Другое поведение, которое можно обоснованно считать неуместным в профессиональной среде.
+
+## Наши обязанности
+
+Сопровождающие проекта несут ответственность за разъяснение стандартов приемлемого поведения и от них ожидают принятия
+соответствующих и справедливых корректирующих действий в ответ на любые случаи неприемлемого поведения.
+
+Сопровождающие проекта имеют право и обязаны удалять, редактировать или отклонять комментарии, коммиты, код, правки
+вики, проблемы и другие материалы, которые не соответствуют настоящему Кодексу поведения, или временно или навсегда
+заблокировать любого участника за другое поведение, которое они считают неуместным, угрожающим, оскорбительным или
+вредным.
+
+## Сфера
+
+Этот Кодекс поведения применяется как в проектных, так и в общественных местах, когда человек представляет проект или
+его сообщество. Примеры представления проекта или сообщества включают использование официального адреса электронной
+почты проекта, размещение сообщений через официальную учетную запись в социальных сетях или выполнение функций
+назначенного представителя на онлайн- или офлайн-мероприятии. Представление проекта может быть дополнительно определено
+и уточнено сопровождающими проекта.
+
+## Исполнение
+
+О случаях оскорбления, преследования или иного недопустимого поведения можно сообщить, связавшись с командой проекта по
+адресу [bigulov.sasha@gmail.com](mailto:bigulov.sasha@gmail.com). Все жалобы будут рассмотрены и исследованы, и в результате будет дан ответ, который будет
+сочтен необходимым и соответствующим обстоятельствам. Команда проекта обязана сохранять конфиденциальность в отношении
+лица, сообщившего об инциденте. Более подробная информация о конкретных правилах применения может быть опубликована
+отдельно.
+
+Сопровождающие проекта, которые не соблюдают и не соблюдают Кодекс поведения добросовестно, могут столкнуться с
+временными или постоянными последствиями, как это определено другими членами руководства проекта.
+
+## Атрибуция
+
+Этот Кодекс поведения адаптирован из [Соглашения для авторов], версия 1.4, доступного по
+адресу https://www.contributor-covenant.org/version/1/4/code-of-conduct.html.
+
+Ответы на распространенные вопросы об этом кодексе поведения см. https://www.contributor-covenant.org/faq.
+
+
+[Соглашения для авторов]: https://www.contributor-covenant.org