Initial commit

Author: prevter

.gitattributes

@@ -0,0 +1,2 @@
+* text=auto eol=lf
+

.github/workflows/build-and-test.yml

@@ -0,0 +1,24 @@
+name: Build and Test
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - "**"
+
+jobs:
+  build-and-test:
+    name: Build and Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Configure CMake project
+        run: cmake -S . -B build
+
+      - name: Build project
+        run: cmake --build build --config Release -- -j$(nproc)
+
+      - name: Run tests
+        run: ctest --test-dir build --output-on-failure

.gitignore

@@ -0,0 +1,57 @@
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+# macOS files
+**/.DS_Store
+
+# Cache files for Sublime Text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+
+# Ignore build folders
+**/build
+**/cmake-build-*/
+build-*/
+
+# Workspace files are user-specific
+*.sublime-workspace
+
+# IDE files
+**/.vscode
+.idea/
+.vs/
+CMakeSettings.json
+
+# clangd
+.cache/

CMakeLists.txt

@@ -0,0 +1,28 @@
+cmake_minimum_required(VERSION 3.21)
+project(slic)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+add_library(${PROJECT_NAME} INTERFACE)
+target_include_directories(${PROJECT_NAME} INTERFACE include/)
+
+if (CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME)
+    include(FetchContent)
+    FetchContent_Declare(
+        googletest
+        GIT_REPOSITORY https://github.com/google/googletest.git
+        GIT_TAG v1.14.0
+    )
+    set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
+    FetchContent_MakeAvailable(googletest)
+
+    enable_testing()
+
+    add_executable(${PROJECT_NAME}_test tests/tests.cpp)
+    target_link_libraries(${PROJECT_NAME}_test PRIVATE ${PROJECT_NAME} GTest::gtest_main)
+
+    include(GoogleTest)
+    gtest_discover_tests(${PROJECT_NAME}_test)
+endif()

LICENSE

@@ -0,0 +1,16 @@
+The MIT License (MIT)
+
+Copyright © 2026 Prevter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the “Software”), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,94 @@
+# slic
+
+Simple C++20 command line argument parser.
+
+## Features
+
+- Single header file
+- Zero allocations
+- No dependencies
+- Compile-time configuration and validation
+- Supports positional and named arguments
+- Variadic arguments support
+- Type-safe parsing of arguments
+- Help message generation
+- Error handling
+
+## Usage
+
+Here's a simple example of how to use `slic` to parse command line arguments:
+
+```cpp
+#include <slic.hpp>
+
+// Define your argument struct
+struct MyArgs {
+    std::string_view input;
+    std::string_view output;
+    std::string_view test;
+    int number = 0;
+    bool version = false;
+    slic::ArgSpan args;
+
+    static constexpr std::string_view Description = "My awesome CLI tool";
+    static constexpr std::tuple Options = {
+        slic::Option{"--number", "-n", &MyArgs::number, "Some number"},
+        slic::Option{"--version", "-v", &MyArgs::version, "Show version"},
+        slic::Option{"--test", "-t", &MyArgs::test, "Test argument"},
+        slic::Arg{"INPUT", &MyArgs::input, "Input file"},
+        slic::Arg{"OUTPUT", &MyArgs::output, "Output file"},
+        slic::VarArgs{"Extra files", &MyArgs::args}
+    };
+};
+
+int main(int argc, char** argv) {
+    // Create the parser
+    slic::ArgParser<MyArgs> parser(argc, argv);
+    
+    // Parse the arguments and handle errors
+    auto result = parser.parse();
+    if (!result) {
+        result.print();
+        // you can also print help message if needed
+        parser.printHelp();
+        return 1;
+    }
+    
+    MyArgs const& args = parser.result(); // parser holds your struct
+    
+    // access members directly
+    if (args.version) {
+        std::cout << "My CLI Tool version 1.0.0\n";
+        return 0;
+    }
+    
+    // access variadic arguments
+    for (std::string_view arg : args.args) {
+        std::cout << "Extra arg: " << arg << "\n";
+    }
+    
+    return 0;
+}
+```
+
+Help message output for the above example:
+
+```
+My awesome CLI tool
+
+Usage: my_program [OPTIONS] <INPUT> <OUTPUT> [...]
+
+Arguments:
+  INPUT: Input file
+  OUTPUT: Output file
+  [...]: Extra files
+
+Options:
+  -n, --number <value>: Some number
+  -v, --version: Show version
+  -t, --test <value>: Test argument
+```
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.