New dependency CLI11 for better CLI support.

Author: nos1dot618

CMakeLists.txt

@@ -20,8 +20,15 @@ FetchContent_Declare(
     GIT_TAG master
 )
 
+FetchContent_Declare(
+    CLI11
+    GIT_REPOSITORY https://github.com/CLIUtils/CLI11.git
+    GIT_TAG v2.5.0
+)
+
 FetchContent_MakeAvailable(fmt)
 FetchContent_MakeAvailable(replxx)
+FetchContent_MakeAvailable(CLI11)
 
 ###### WARNINGS ######
 
@@ -31,9 +38,9 @@ if (CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
     target_compile_options(lbdWarnings INTERFACE
         -Wall
         -Wextra
-#        -Wpedantic
-#        -Wconversion
-#        -Wshadow
+        #        -Wpedantic
+        #        -Wconversion
+        #        -Wshadow
     )
 endif ()
 
@@ -118,6 +125,8 @@ target_link_libraries(lbdRuntime PUBLIC
 file(GLOB LBD_SOURCE_FILES CONFIGURE_DEPENDS
     ${PROJECT_SOURCE_DIR}/src/*.cpp
     ${PROJECT_SOURCE_DIR}/src/utils/terminal/*.cpp
+    ${PROJECT_SOURCE_DIR}/src/cli/*.cpp
+    ${PROJECT_SOURCE_DIR}/src/cli/commands/*.cpp
 )
 
 add_executable(lbd
@@ -134,6 +143,7 @@ target_link_libraries(lbd PRIVATE
     lbdFrontend
     lbdRuntime
     replxx
+    CLI11::CLI11
 )
 
 target_link_options(lbd PRIVATE -static-libstdc++)

README.md

@@ -9,7 +9,7 @@
 ### Prerequisites
 
 - **CMake** (version 3.20+ recommended)
-- A C++23 capable compiler (e.g. `g++`, `clang++`, or MSVC on Windows)
+- A C++20 capable compiler (e.g. `g++`, `clang++`, or MSVC on Windows)
 
 ### Setup
 
@@ -94,20 +94,23 @@ $ ./cmake-build-debug/lbd -f ./examples/math_demos.lbd
 After building, you can run the interpreter with:
 
 ```bash
-lbd [options]
+lbd [subcommands] <options>
 ```
 
 ### Options
 
 ```
--f, --file <filepath>   Specify input source filepath to run
--h, --help              Show this help message and exit
--d, --debug             Enable debug mode
--r, --repl              Run in interactive REPL node
---docs                  Generate language-reference-document
+OPTIONS:
+  -h,     --help              Print this help message and exit
+  -d,     --debug
+
+SUBCOMMANDS:
+  run                         Run a Lambda Discipline source file
+  docs                        Generate native function signatures for reference
+  repl                        Start an interactive Read-Eval-Print Loop (REPL)
 ```
 
-> Generate the language-reference-document by using the `--docs` flag, and use it as the source of truth for
+> Generate the language-reference-document by using the `docs` subcommand, and use it as the source of truth for
 > native-function-signatures.
 
 ## Editor Plugins
@@ -116,5 +119,6 @@ lbd [options]
 
 ## Dependencies
 
-1. [readline](https://man7.org/linux/man-pages/man3/readline.3.html): For better REPL user experience.
-2. [fmt](https://github.com/fmtlib/fmt): For formatting strings.
+1. [fmt](https://github.com/fmtlib/fmt.git): For formatting strings.
+2. [replxx](https://github.com/AmokHuginnsson/replxx.git): For better REPL user experience.
+3. [CLI11](https://github.com/CLIUtils/CLI11.git): For better CLI support.

include/lbd/cli/Command.hpp

@@ -0,0 +1,17 @@
+#pragma once
+
+#include <CLI/App.hpp>
+#include <lbd/Context.hpp>
+
+namespace lbd::cli
+{
+  class ICommand
+  {
+  public:
+    virtual ~ICommand() = default;
+
+    virtual void configure(CLI::App &command) = 0;
+
+    virtual int execute(Context &context) = 0;
+  };
+}

include/lbd/cli/Registry.hpp

@@ -0,0 +1,22 @@
+#pragma once
+
+#include <memory>
+#include <lbd/Context.hpp>
+#include <lbd/cli/Command.hpp>
+
+namespace lbd::cli
+{
+  class CommandRegistry
+  {
+  public:
+    void add(std::unique_ptr<ICommand> command);
+
+    void registerCommands(CLI::App &app);
+
+    int dispatch(Context &context) const;
+
+  private:
+    std::vector<std::unique_ptr<ICommand>> commands;
+    ICommand *selectedCommand = nullptr;
+  };
+}

include/lbd/cli/commands/DocsCommand.hpp

@@ -0,0 +1,14 @@
+#pragma once
+
+#include <lbd/cli/Command.hpp>
+
+namespace lbd::cli
+{
+  class DocsCommand final : public ICommand
+  {
+  public:
+    void configure(CLI::App &command) override;
+
+    int execute(Context &context) override;
+  };
+}

include/lbd/cli/commands/REPLCommand.hpp

@@ -0,0 +1,14 @@
+#pragma once
+
+#include <lbd/cli/Command.hpp>
+
+namespace lbd::cli
+{
+  class REPLCommand final : public ICommand
+  {
+  public:
+    void configure(CLI::App &command) override;
+
+    int execute(Context &context) override;
+  };
+}

include/lbd/cli/commands/RunCommand.hpp

@@ -0,0 +1,17 @@
+#pragma once
+
+#include <lbd/cli/Command.hpp>
+
+namespace lbd::cli
+{
+  class RunCommand final : public ICommand
+  {
+  public:
+    void configure(CLI::App &command) override;
+
+    int execute(Context &context) override;
+
+  private:
+    std::filesystem::path filepath;
+  };
+}

include/lbd/cmd/Command.hpp

@@ -4,13 +4,14 @@
 #ifndef NOMINMAX
 #define NOMINMAX
 #endif
-#include <cstdio>
 #include <io.h>
 #include <windows.h>
 #else
 #include <unistd.h>
 #endif
 
+#include <cstdio>
+
 namespace lbd::utils::terminal
 {
   inline bool enableVirtualTerminal() noexcept