Build: Make Build just a tool rather than a library

Pagghiu · Pagghiu · commit b079772ccfe9 · 2025-09-24T23:41:57.000+02:00
diff --git a/Documentation/Doxygen/Doxyfile b/Documentation/Doxygen/Doxyfile
@@ -17,7 +17,6 @@ INPUT                  = ../../Documentation/Pages \
                          ../../Documentation/LibrariesExtra \
                          ../../Libraries/Async \
                          ../../Libraries/AsyncStreams \
-                         ../../Libraries/Build \
                          ../../Libraries/Containers \
                          ../../Libraries/File \
                          ../../Libraries/FileSystem \
diff --git a/Documentation/Libraries/Hashing.md b/Documentation/Libraries/Hashing.md
@@ -26,7 +26,7 @@ The Hashing library abstracts OS API to compute MD5, SHA1 and SHA256 hashes.
 
 # Status
 🟩 Usable  
-The library is very simple it it has what is needed so far (mainly by [Build](@ref library_build)). 
+The library is very simple it it has what is needed so far (mainly by [Build](@ref page_build)). 
 
 # Description
 
diff --git a/Documentation/Libraries/Plugin.md b/Documentation/Libraries/Plugin.md
@@ -96,7 +96,7 @@ any system or compiler header.
 
 🟦 Complete Features:
 - Create minimal clang toolchain to compile scripts on non-developer machines
-- Integrate with [Build](@ref library_build) library (once it will gain capability to build standalone without needing Xcode or Visual Studio)
+- Integrate with [Build](@ref page_build) library (once it will gain capability to build standalone without needing Xcode or Visual Studio)
 - Evaluate possibility to achieve some minimal error recovery
 - Easily integration with some RPC mechanism
 
diff --git a/Documentation/Pages/Build.md b/Documentation/Pages/Build.md
@@ -1,22 +1,9 @@
-@page library_build Build
+@page page_build SC::Build
 
-@brief 🟨 Minimal build system where builds are described in C++
-
-Build uses C++ to imperatively describe a sequence of build operations.  
+`SC::Build` is a [Tool](@ref page_tools) implementing a build system generator where builds are imperatively described in C++.  
 
 [TOC]
 
-# Dependencies
-- Direct dependencies: [Containers](@ref library_containers), [FileSystem](@ref library_file_system), [FileSystemIterator](@ref library_file_system_iterator), [Foundation](@ref library_foundation), [Hashing](@ref library_hashing), [Memory](@ref library_memory), [Process](@ref library_process), [Strings](@ref library_strings)
-- All dependencies: [Containers](@ref library_containers), [File](@ref library_file), [FileSystem](@ref library_file_system), [FileSystemIterator](@ref library_file_system_iterator), [Foundation](@ref library_foundation), [Hashing](@ref library_hashing), [Memory](@ref library_memory), [Process](@ref library_process), [Strings](@ref library_strings), [Time](@ref library_time)
-
-# Statistics
-| Type      | Lines Of Code | Comments  | Sum   |
-|-----------|---------------|-----------|-------|
-| Headers   | 315			| 171		| 486	|
-| Sources   | 3840			| 539		| 4379	|
-| Sum       | 4155			| 710		| 4865	|
-
 # Features
 
 - Describe builds in a `.cpp` file
@@ -46,26 +33,6 @@ Projects are generated by invoking `./SC.sh build` or `SC.bat build`.
 This is for example the `Tools/SC-build.cpp` file for the `SCTest` test suite and the [SCExample](@ref page_examples):
 \include Tools/SC-build.cpp
 
-The abstraction is described by the following (top-down) hierarchy:
-
-| Class                         | Description                           |
-|:------------------------------|---------------------------------------|
-| SC::Build::Definition         | @copybrief SC::Build::Definition      |
-| SC::Build::Workspace          | @copybrief SC::Build::Workspace       |
-| SC::Build::Project            | @copybrief SC::Build::Project         |
-| SC::Build::Configuration      | @copybrief SC::Build::Configuration   |
-
-Some additional types allow describing detailed properties of the build:
-
-| Class                         | Description                           |
-|:------------------------------|---------------------------------------|
-| SC::Build::Platform           | @copybrief SC::Build::Platform        |
-| SC::Build::Architecture       | @copybrief SC::Build::Architecture    |
-| SC::Build::Generator          | @copybrief SC::Build::Generator       |
-| SC::Build::Optimization       | @copybrief SC::Build::Optimization    |
-| SC::Build::CompileFlags       | @copybrief SC::Build::CompileFlags    |
-| SC::Build::LinkFlags          | @copybrief SC::Build::LinkFlags       |
-
 # Videos
 
 This is the list of videos that have been recorded showing some of the internal thoughts that have been going into this library:
@@ -99,10 +66,6 @@ Some relevant blog posts are:
 - The unity build file `SC.cpp` is linked together in the same invocation
     - Provides all needed Platform abstraction features to enumerate files and directories, launch processes etc.
 - The generated executable is run as specified in SC::Build::Parameters
-- SC::Build::Parameters specifies a combination of:
-    - SC::Build::Platform @copybrief SC::Build::Platform
-    - SC::Build::Configuration @copybrief SC::Build::Configuration
-    - SC::Build::Generator @copybrief SC::Build::Generator
 - `SC-build.cpp` calls SC::Build::ConfigurePresets::generateAllPlatforms or manually invokes SC::Build::Definition::generate
 - Debugging the build script means just debugging a regular C++ executable
 
diff --git a/Documentation/Pages/BuildingContributor.md b/Documentation/Pages/BuildingContributor.md
@@ -6,7 +6,7 @@ Follow this guide if you're interested in building the library to contribute (ch
 
 # Generate projects
 
-The test suite and example projects uses the handmade / self-hosted [SC::Build](@ref library_build) system, that describes builds in C++
+The test suite and example projects uses the handmade / self-hosted [SC::Build](@ref page_build) system, that describes builds in C++
 
 ## Command-line
 - Generate projects
diff --git a/Documentation/Pages/Dependencies.md b/Documentation/Pages/Dependencies.md
@@ -9,7 +9,7 @@ This file describes what each library depends on.
 - Direct dependencies: [Async](@ref library_async), [Foundation](@ref library_foundation)
 - All dependencies: [Async](@ref library_async), [File](@ref library_file), [FileSystem](@ref library_file_system), [Foundation](@ref library_foundation), [Socket](@ref library_socket), [Threading](@ref library_threading), [Time](@ref library_time)
 
-# [Build](@ref library_build)
+# [Build](@ref page_build)
 - Direct dependencies: [Containers](@ref library_containers), [FileSystem](@ref library_file_system), [FileSystemIterator](@ref library_file_system_iterator), [Foundation](@ref library_foundation), [Hashing](@ref library_hashing), [Memory](@ref library_memory), [Process](@ref library_process), [Strings](@ref library_strings)
 - All dependencies: [Containers](@ref library_containers), [File](@ref library_file), [FileSystem](@ref library_file_system), [FileSystemIterator](@ref library_file_system_iterator), [Foundation](@ref library_foundation), [Hashing](@ref library_hashing), [Memory](@ref library_memory), [Process](@ref library_process), [Strings](@ref library_strings), [Time](@ref library_time)
 
diff --git a/Documentation/Pages/Examples.md b/Documentation/Pages/Examples.md
@@ -16,7 +16,7 @@ After compiling (`SC build compile`) executables will be at `_Build/_Outputs/${p
 |:--------------|:----------------------------------------------------------------------------------------------------------------------------------|
 | Location      | `Examples/SCExample`                                                                                                              |
 | Description   | Simple immediate mode gui application using sokol and dear imgui libraries pausing in absence of inputs and I/O to save CPU time  |
-| Purposes      | Use [SC::Build](@ref library_build) to build on macOS, windows and linux and [SC::Async](@ref library_async) as I/O event Loop    |
+| Purposes      | Use [SC::Build](@ref page_build) to build on macOS, windows and linux and [SC::Async](@ref library_async) as I/O event Loop    |
 |               | Use [Plugin](@ref library_plugin) and [FileSystemWatcher](@ref library_file_system_watcher) libraries implementing hot-reload     |
 | Prerequisites | Linux - Fedora: `sudo dnf install mesa-libGL-devel mesa-libEGL-devel libX11-devel libXi-devel libXcursor-devel`                   |
 |               | Linux - Ubuntu: `sudo apt-get install libgles2-mesa-dev libx11-dev libxi-dev libxcursor-dev`                                      |
diff --git a/Documentation/Pages/FAQ.md b/Documentation/Pages/FAQ.md
@@ -40,7 +40,7 @@ Targeting:
 
 Usage:
 
-- [Build](@ref library_build) is setting them up automatically for XCode and Visual Studio projects.
+- [Build](@ref page_build) is setting them up automatically for XCode and Visual Studio projects.
 - Starting the VSCode `launch.json` configurations for lldb and gdb should will load them in your debugger session.
 - You can manually `source` or add them to your project or build system
 
diff --git a/Documentation/Pages/Libraries.md b/Documentation/Pages/Libraries.md
@@ -6,7 +6,6 @@ Library                                     | Description
 :-------------------------------------------|:----------------------------------------------|---------------
 @subpage library_async                      | @copybrief library_async                      |   5726
 @subpage library_async_streams              | @copybrief library_async_streams              |   1977
-@subpage library_build                      | @copybrief library_build                      |   4155
 @subpage library_containers                 | @copybrief library_containers                 |   874
 @subpage library_file                       | @copybrief library_file                       |   736
 @subpage library_file_system                | @copybrief library_file_system                |   1332
diff --git a/Documentation/Pages/Tools.md b/Documentation/Pages/Tools.md
@@ -9,7 +9,7 @@ They leverage the growing shell, system and network programming capabilities of
 Another way to look at them is just as small _C++ scripts_ for which you don't need to setup or maintain a build system, as long as you only use Sane C++ Libraries.
 
 @note Name is `SC::Tools` and not `SC::Scripts` because they're still just small programs.  
-If the system will be generalized even more, maybe acquiring more advanced capabilities from [SC::Plugin](@ref library_plugin) and [SC::Build](@ref library_build) or sandboxing capabilities, this naming will be re-evaluated and/or changed.
+If the system will be generalized even more, maybe acquiring more advanced capabilities from [SC::Plugin](@ref library_plugin) and [SC::Build](@ref page_build) or sandboxing capabilities, this naming will be re-evaluated and/or changed.
 
 # Blog
 
@@ -112,7 +112,7 @@ This is the list of tools that currently exist in the Sane C++ repository.
 
 # SC-build.cpp
 
-`SC-build` configures (generating projects) and compiles Sane C++ repository projects using [SC::Build](@ref library_build).
+`SC-build` configures (generating projects) and compiles Sane C++ repository projects using [SC::Build](@ref page_build).
 
 ## Actions
 
@@ -247,7 +247,7 @@ This is because all Sane C++ Libraries are compiled just once (the first time, i
 # Roadmap
 
 - Generate ready made .vscode configurations to debug the programs easily
-- When and if [SC::Build](@ref library_build) will be capable of launching build commands autonomously, get rid of the tool `Tools\Build\$(PLATFORM)` makefiles.
+- When and if [SC::Build](@ref page_build) will be capable of launching build commands autonomously, get rid of the tool `Tools\Build\$(PLATFORM)` makefiles.
 - Investigate better way of expressing the dependencies chain between scripts
 - Investigate if Tools (scripts) can be sandboxed using os facilities
 - Do not require to have a C++ toolchain already installed on the system [*]
diff --git a/README.md b/README.md
@@ -37,7 +37,6 @@ Library
 :---------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------|---------
 [Async](https://pagghiu.github.io/SaneCppLibraries/library_async.html)                                          | 🟨 Async I/O (files, sockets, timers, processes, fs events, threads)      |   5726
 [Async Streams](https://pagghiu.github.io/SaneCppLibraries/library_async_streams.html)                          | 🟨 Concurrently read, write and transform byte streams                    |   1977
-[Build](https://pagghiu.github.io/SaneCppLibraries/library_build.html)                                          | 🟨 Minimal build system where builds are described in C++                 |   4155
 [Containers](https://pagghiu.github.io/SaneCppLibraries/library_containers.html)                                | 🟨 Generic containers (SC::Vector, SC::SmallVector, SC::Array etc.)       |   874
 [File](https://pagghiu.github.io/SaneCppLibraries/library_file.html)                                            | 🟩 Synchronous Disk File I/O                                              |   736
 [File System](https://pagghiu.github.io/SaneCppLibraries/library_file_system.html)                              | 🟩 File System operations (like copy / delete) for files / directories    |   1332
@@ -114,7 +113,7 @@ https://github.com/Pagghiu/SaneCppLibraries/assets/5406873/5c7d4036-6e0c-4262-ad
 
 # Tests
 
-Tests are built with the self-hosted [SC::Build](https://pagghiu.github.io/SaneCppLibraries/library_build.html) project generator, describing the builds in C++.    
+Tests are built with the self-hosted [SC::Build](https://pagghiu.github.io/SaneCppLibraries/page_build.html) project generator, describing the builds in C++.    
 Check [Building (contributor)](https://pagghiu.github.io/SaneCppLibraries/page_building_contributor.html) to run the tests.
 
 # Getting in touch
diff --git a/SC.cpp b/SC.cpp
@@ -4,7 +4,6 @@
 #include "Libraries/AsyncStreams/AsyncRequestStreams.cpp"
 #include "Libraries/AsyncStreams/AsyncStreams.cpp"
 #include "Libraries/AsyncStreams/ZLibTransformStreams.cpp"
-#include "Libraries/Build/Build.cpp"
 #include "Libraries/File/File.cpp"
 #include "Libraries/FileSystem/FileSystem.cpp"
 #include "Libraries/FileSystemIterator/FileSystemIterator.cpp"
diff --git a/Tests/Libraries/Build/BuildTest.cpp b/Tests/Libraries/Build/BuildTest.cpp
@@ -1,6 +1,6 @@
 // Copyright (c) Stefano Cristiano
 // SPDX-License-Identifier: MIT
-#include "Libraries/Build/Build.h"
+#include "Tools/SC-build/Build.h"
 #include "Libraries/Strings/Path.h"
 #include "Libraries/Testing/Testing.h"
 
diff --git a/Tools/SC-build.cpp b/Tools/SC-build.cpp
@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 #include "SC-build.h"
 #include "../Libraries/FileSystemIterator/FileSystemIterator.h"
+#include "SC-build/Build.inl"
 
 namespace SC
 {
diff --git a/Tools/SC-build.h b/Tools/SC-build.h
@@ -1,11 +1,11 @@
 // Copyright (c) Stefano Cristiano
 // SPDX-License-Identifier: MIT
 #pragma once
-#include "../Libraries/Build/Build.h"
 #include "../Libraries/Process/Process.h"
 #include "../Libraries/Strings/Console.h"
 #include "../Libraries/Strings/Path.h"
 #include "../Libraries/Strings/StringBuilder.h"
+#include "SC-build/Build.h"
 #include "Tools.h"
 
 #include "SC-package.h"
diff --git a/Tools/SC-build/Build.h b/Tools/SC-build/Build.h
@@ -1,18 +1,17 @@
 // Copyright (c) Stefano Cristiano
 // SPDX-License-Identifier: MIT
 #pragma once
-#include "../Containers/Vector.h"
-#include "../Foundation/Result.h"
-#include "../Memory/String.h"
-#include "../Strings/StringView.h"
+#include "../../Libraries/Containers/Vector.h"
+#include "../../Libraries/Foundation/Result.h"
+#include "../../Libraries/Memory/String.h"
+#include "../../Libraries/Strings/StringView.h"
 
 namespace SC
 {
-/// @brief Minimal build system where builds are described in C++ (see @ref library_build)
+/// @brief Minimal build system where builds are described in C++ (see @ref page_build)
 namespace Build
 {
 //! @defgroup group_build Build
-//! @copybrief library_build (see @ref library_build for more details)
 
 //! @addtogroup group_build
 //! @{
diff --git a/Tools/SC-build/Build.inl b/Tools/SC-build/Build.inl
@@ -2,14 +2,14 @@
 // SPDX-License-Identifier: MIT
 #include "Build.h"
 
-#include "Internal/BuildWriterMakefile.inl"
-#include "Internal/BuildWriterVisualStudio.inl"
-#include "Internal/BuildWriterXCode.inl"
-
-#include "../Containers/Vector.h"
-#include "../FileSystem/FileSystem.h"
-#include "../FileSystemIterator/FileSystemIterator.h"
-#include "../Process/Process.h" // for Actions::compile
+#include "BuildWriterMakefile.inl"
+#include "BuildWriterVisualStudio.inl"
+#include "BuildWriterXCode.inl"
+
+#include "../../Libraries/Containers/Vector.h"
+#include "../../Libraries/FileSystem/FileSystem.h"
+#include "../../Libraries/FileSystemIterator/FileSystemIterator.h"
+#include "../../Libraries/Process/Process.h" // for Actions::compile
 
 struct SC::Build::CompileFlags::Internal
 {
diff --git a/Tools/SC-build/BuildWriter.h b/Tools/SC-build/BuildWriter.h
@@ -1,13 +1,13 @@
 // Copyright (c) Stefano Cristiano
 // SPDX-License-Identifier: MIT
 #pragma once
-#include "../Build.h"
+#include "Build.h"
 
-#include "../../Containers/Algorithms/AlgorithmBubbleSort.h"
-#include "../../Containers/VectorMap.h"
-#include "../../Containers/VectorSet.h"
-#include "../../Strings/Path.h"
-#include "../../Strings/StringBuilder.h"
+#include "../../Libraries/Containers/Algorithms/AlgorithmBubbleSort.h"
+#include "../../Libraries/Containers/VectorMap.h"
+#include "../../Libraries/Containers/VectorSet.h"
+#include "../../Libraries/Strings/Path.h"
+#include "../../Libraries/Strings/StringBuilder.h"
 
 namespace SC
 {
diff --git a/Tools/SC-build/BuildWriterMakefile.inl b/Tools/SC-build/BuildWriterMakefile.inl
@@ -1,8 +1,8 @@
 // Copyright (c) Stefano Cristiano
 // SPDX-License-Identifier: MIT
-#include "../Build.h"
+#include "Build.h"
 
-#include "../../Strings/StringBuilder.h"
+#include "../../Libraries/Strings/StringBuilder.h"
 #include "BuildWriter.h"
 
 struct SC::Build::ProjectWriter::WriterMakefile
diff --git a/Tools/SC-build/BuildWriterVisualStudio.inl b/Tools/SC-build/BuildWriterVisualStudio.inl
@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 #include "BuildWriter.h"
 
-#include "../../Hashing/Hashing.h"
+#include "../../Libraries/Hashing/Hashing.h"
 
 struct SC::Build::ProjectWriter::WriterVisualStudio
 {
diff --git a/Tools/SC-build/BuildWriterXCode.inl b/Tools/SC-build/BuildWriterXCode.inl
@@ -2,8 +2,8 @@
 // SPDX-License-Identifier: MIT
 #include "BuildWriter.h"
 
-#include "../../FileSystem/FileSystem.h" // for FileSystem::existsAndIsFile
-#include "../../Hashing/Hashing.h"
+#include "../../Libraries/FileSystem/FileSystem.h" // for FileSystem::existsAndIsFile
+#include "../../Libraries/Hashing/Hashing.h"
 
 struct SC::Build::ProjectWriter::WriterXCode
 {
