Merge pull request #52 from lucocozz/develop

0.2.0

Author: lucocozz

CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- Printing subcommand list on command execution that cannot be executed directly.
+- Support for variadic positional arguments, allowing multiple values for a single positional argument.
+
+### Changed
+- Changed help output DEFAULT_MAX_LINE_WIDTH from 80 to 100.
+- Changed `ARGUS_RELEASE` into `ARGUS_DEBUG`
+
+### Fixed
+- Disabled pedantic option on library compilation.
+- Defining `argus_init()` as a `static inline` function.
+- Fixed unexecuted validators in subcommand.
+
+### Removed
+- Group description option.
+- Cleanup non essential regex patterns.
+
+
 ## [0.1.0] - 2025-07-02
 
 ### Added

Justfile

@@ -165,6 +165,7 @@ examples:
             basic_usage)          desc="Basic flags, string, and integer options" ;; \
             subcommands)          desc="Git-like subcommands implementation" ;; \
             positional_args)      desc="Handling positional arguments" ;; \
+            variadic_positional)  desc="Handling variadic positional arguments" ;; \
             custom_handlers)      desc="Creating custom option handlers" ;; \
             advanced_options)     desc="Dependencies, conflicts, and exclusive groups" ;; \
             nested_commands)      desc="Complex nested subcommands (like git or docker)" ;; \

README.md

@@ -244,7 +244,7 @@ Consider traditional approaches for embedded systems with strict constraints, le
 
 📚 **[Complete Documentation](https://argus-lib.com)** - Comprehensive guides and tutorials  
 🚀 **[Quick Start Guide](https://argus-lib.com/getting-started/quickstart)** - Get running in minutes  
-💡 **[Examples](https://argus-lib.com/examples/simple-cli)** - Real-world usage patterns  
+💡 **[Example](https://github.com/lucocozz/argus-git-demo)** - Git clone demonstration  
 🔧 **[API Reference](https://argus-lib.com/api-reference/overview)** - Complete function documentation
 
 ## Requirements

argus.def

@@ -38,6 +38,10 @@ EXPORTS
     free_map_int_handler
     free_map_float_handler
     free_map_bool_handler
+    variadic_string_handler
+    variadic_int_handler
+    variadic_float_handler
+    free_variadic_string_handler
     range_validator
     length_validator
     count_validator

benchmarks/benchmark_release_mode.c

@@ -12,20 +12,20 @@ ARGUS_OPTIONS(
     HELP_OPTION(),
     VERSION_OPTION(),
 
-    GROUP_START("Input Options", GROUP_DESC("Options related to input")),
+    GROUP_START("Input Options"),
         OPTION_FLAG('v', "verbose", HELP("Enable verbose output")),
         OPTION_STRING('i', "input", HELP("Input file"), DEFAULT("input.txt")),
         OPTION_ARRAY_STRING('I', "include", HELP("Include files"), FLAGS(FLAG_SORTED | FLAG_UNIQUE)),
     GROUP_END(),
 
-    GROUP_START("Output Options", GROUP_DESC("Options related to output")),
+    GROUP_START("Output Options"),
         OPTION_STRING('o', "output", HELP("Output file"), DEFAULT("output.txt")),
         OPTION_STRING('f', "format", HELP("Output format"),
             VALIDATOR(V_CHOICE_STR("text", "json", "xml", "binary"))),
         OPTION_FLAG('s', "silent", HELP("Suppress output"), CONFLICT("verbose")),
     GROUP_END(),
 
-    GROUP_START("Processing Options", GROUP_DESC("Options controlling processing")),
+    GROUP_START("Processing Options"),
         OPTION_INT('l', "level", HELP("Processing level"),
             VALIDATOR(V_RANGE(1, 10)), DEFAULT(5)),
         OPTION_INT('j', "jobs", HELP("Number of parallel jobs"),
@@ -35,7 +35,7 @@ ARGUS_OPTIONS(
         OPTION_MAP_STRING('D', "define", HELP("Define variables"), FLAGS(FLAG_SORTED_KEY)),
     GROUP_END(),
 
-    GROUP_START("Advanced Options", GROUP_DESC("Advanced configuration")),
+    GROUP_START("Advanced Options"),
         OPTION_FLAG('d', "debug", HELP("Enable debug mode")),
         OPTION_STRING('c', "config", HELP("Configuration file")),
         OPTION_ARRAY_INT('p', "ports", HELP("Port numbers"), FLAGS(FLAG_SORTED | FLAG_UNIQUE)),

docs/docs/api-reference/overview.md

@@ -76,6 +76,11 @@ POSITIONAL_STRING(name, ...)         // String positional
 POSITIONAL_INT(name, ...)            // Integer positional
 POSITIONAL_BOOL(name, ...)           // Boolean positional
 POSITIONAL_FLOAT(name, ...)          // Float positional
+
+// Variadic positionals (accept multiple values)
+POSITIONAL_MANY_STRING(name, ...)    // Variadic string positional
+POSITIONAL_MANY_INT(name, ...)       // Variadic integer positional
+POSITIONAL_MANY_FLOAT(name, ...)     // Variadic float positional
 ```
 
 ### Structure Macros

docs/docs/api-reference/regex-patterns.md

@@ -22,29 +22,22 @@ OPTION_STRING('e', "email", HELP("Email address"),
 | Pattern | Validates | Example |
 |---------|-----------|---------|
 | `ARGUS_RE_IPV4` | IPv4 addresses | `192.168.1.1` |
-| `ARGUS_RE_IP4CIDR` | IPv4 with optional CIDR | `192.168.1.0/24` |
 | `ARGUS_RE_IPV6` | IPv6 addresses | `2001:db8::1` |
 
 ```c
 OPTION_STRING('i', "ip", HELP("Server IP address"),
               VALIDATOR(V_REGEX(ARGUS_RE_IPV4)))
 
-OPTION_STRING('n', "network", HELP("Network range"),
-              VALIDATOR(V_REGEX(ARGUS_RE_IP4CIDR)))
 ```
 
 ### Network Infrastructure
 
 | Pattern | Validates | Example |
 |---------|-----------|---------|
-| `ARGUS_RE_MAC` | MAC addresses | `01:23:45:67:89:AB` |
 | `ARGUS_RE_DOMAIN` | Domain names (FQDN) | `example.com` |
 | `ARGUS_RE_PORT` | Port numbers (1-65535) | `8080` |
 
 ```c
-OPTION_STRING('m', "mac", HELP("MAC address"),
-              VALIDATOR(V_REGEX(ARGUS_RE_MAC)))
-
 OPTION_STRING('d', "domain", HELP("Domain name"),
               VALIDATOR(V_REGEX(ARGUS_RE_DOMAIN)))
 ```
@@ -55,7 +48,6 @@ OPTION_STRING('d', "domain", HELP("Domain name"),
 |---------|-----------|---------|
 | `ARGUS_RE_URL` | Any protocol URL | `https://example.com/path` |
 | `ARGUS_RE_HTTP` | HTTP(S) URLs only | `http://example.com` |
-| `ARGUS_RE_FILE_URL` | File URLs | `file:///path/to/file` |
 
 ```c
 OPTION_STRING('u', "url", HELP("Website URL"),
@@ -82,78 +74,44 @@ OPTION_STRING('c', "contact", HELP("Contact email (strict)"),
               VALIDATOR(V_REGEX(ARGUS_RE_EMAIL_STRICT)))
 ```
 
-### Phone Numbers
-
-| Pattern | Validates | Example |
-|---------|-----------|---------|
-| `ARGUS_RE_PHONE_INTL` | International format | `+12345678901` |
-| `ARGUS_RE_PHONE_US` | US phone numbers | `123-456-7890` |
-| `ARGUS_RE_PHONE_EU` | European phone numbers | `+33 123456789` |
-
-```c
-OPTION_STRING('p', "phone", HELP("Phone number"),
-              VALIDATOR(V_REGEX(ARGUS_RE_PHONE_US)))
-```
 
 ## // Date and Time Patterns
 
 | Pattern | Validates | Example |
 |---------|-----------|---------|
 | `ARGUS_RE_ISO_DATE` | ISO date (YYYY-MM-DD) | `2024-03-15` |
 | `ARGUS_RE_ISOTIME` | ISO datetime | `2024-03-15T14:30:00` |
-| `ARGUS_RE_US_DATE` | US date format | `03/15/2024` |
-| `ARGUS_RE_EU_DATE` | European date format | `15/03/2024` |
-| `ARGUS_RE_TIME24` | 24-hour time | `14:30:00` |
 
 ```c
 OPTION_STRING('d', "date", HELP("Date (YYYY-MM-DD)"),
               VALIDATOR(V_REGEX(ARGUS_RE_ISO_DATE)))
 
-OPTION_STRING('t', "time", HELP("Time (HH:MM:SS)"),
-              VALIDATOR(V_REGEX(ARGUS_RE_TIME24)))
+OPTION_STRING('t', "datetime", HELP("DateTime (ISO format)"),
+              VALIDATOR(V_REGEX(ARGUS_RE_ISOTIME)))
 ```
 
-## // Geographic Patterns
-
-| Pattern | Validates | Example |
-|---------|-----------|---------|
-| `ARGUS_RE_ZIP` | US ZIP codes | `12345` or `12345-6789` |
-| `ARGUS_RE_UK_POST` | UK postcodes | `SW1A 1AA` |
-| `ARGUS_RE_CA_POST` | Canadian postal codes | `A1A 1A1` |
-| `ARGUS_RE_LATITUDE` | Latitude (-90 to 90) | `40.7128` |
-| `ARGUS_RE_LONGITUDE` | Longitude (-180 to 180) | `-74.0060` |
-
-```c
-OPTION_STRING('z', "zip", HELP("ZIP code"),
-              VALIDATOR(V_REGEX(ARGUS_RE_ZIP)))
-
-OPTION_STRING('l', "lat", HELP("Latitude"),
-              VALIDATOR(V_REGEX(ARGUS_RE_LATITUDE)))
-```
 
 ## // Security Patterns
 
 | Pattern | Validates | Example |
 |---------|-----------|---------|
 | `ARGUS_RE_USER` | Username (3-20 chars) | `user_123` |
 | `ARGUS_RE_PASSWD` | Basic password | `password123` |
-| `ARGUS_RE_PASSWD_STRONG` | Strong password | `Pass123!` |
 | `ARGUS_RE_UUID` | UUID v4 format | `550e8400-e29b-41d4-a716-446655440000` |
 
 ```c
 OPTION_STRING('u', "username", HELP("Username"),
               VALIDATOR(V_REGEX(ARGUS_RE_USER)))
 
-OPTION_STRING('p', "password", HELP("Strong password"),
-              VALIDATOR(V_REGEX(ARGUS_RE_PASSWD_STRONG)))
+OPTION_STRING('p', "password", HELP("Password"),
+              VALIDATOR(V_REGEX(ARGUS_RE_PASSWD)))
 ```
 
 ## // File System Patterns
 
 | Pattern | Validates | Example |
 |---------|-----------|---------|
 | `ARGUS_RE_UNIX_PATH` | Unix absolute paths | `/path/to/file` |
-| `ARGUS_RE_WIN_PATH` | Windows absolute paths | `C:\folder\file` |
 | `ARGUS_RE_FILENAME` | Filename with extension | `document.pdf` |
 
 ```c
@@ -164,21 +122,7 @@ OPTION_STRING('n', "name", HELP("Filename"),
               VALIDATOR(V_REGEX(ARGUS_RE_FILENAME)))
 ```
 
-## // Visual and Data Patterns
-
-### Colors
-
-| Pattern | Validates | Example |
-|---------|-----------|---------|
-| `ARGUS_RE_HEX_COLOR` | Hex colors | `#FF0000` or `#F00` |
-| `ARGUS_RE_RGB` | RGB color format | `rgb(255,0,0)` |
-
-```c
-OPTION_STRING('c', "color", HELP("Hex color"),
-              VALIDATOR(V_REGEX(ARGUS_RE_HEX_COLOR)))
-```
-
-### Numbers and Formats
+## // Numbers and Formats
 
 | Pattern | Validates | Example |
 |---------|-----------|---------|
@@ -236,7 +180,6 @@ Each pattern includes helpful error hints:
 
 - `ARGUS_RE_EMAIL`: "Enter email: [email protected]"
 - `ARGUS_RE_IPV4`: "Enter valid IPv4: 192.168.1.1"  
-- `ARGUS_RE_PHONE_US`: "Enter US phone: 123-456-7890"
 - `ARGUS_RE_ISO_DATE`: "Enter date: YYYY-MM-DD"
 
 Custom patterns should include similar hints:

docs/docs/appendices/cheat-sheet.md

@@ -54,8 +54,14 @@ OPTION_MAP_BOOL('f', "features", HELP("Feature flags"))
 ## // Positional Arguments
 
 ```c
+// Single positionals
 POSITIONAL_STRING("input", HELP("Input file"))
 POSITIONAL_INT("count", HELP("Count"), FLAGS(FLAG_OPTIONAL))
+
+// Variadic positionals (accept multiple values)
+POSITIONAL_MANY_STRING("files", HELP("Files to process"))
+POSITIONAL_MANY_INT("numbers", HELP("Numbers to calculate"))
+POSITIONAL_MANY_FLOAT("values", HELP("Decimal values"))
 ```
 
 ## // Option Modifiers
@@ -90,7 +96,6 @@ ARGUS_RE_EMAIL          // [email protected]
 ARGUS_RE_IPV4           // 192.168.1.1
 ARGUS_RE_URL            // https://example.com
 ARGUS_RE_ISO_DATE       // 2024-03-15
-ARGUS_RE_PHONE_US       // 123-456-7890
 ARGUS_RE_UUID           // 550e8400-e29b-41d4-a716-446655440000
 ```
 
@@ -208,6 +213,9 @@ int main(int argc, char **argv)
 # Positional
 program input.txt output.txt
 
+# Variadic positionals
+program file1.c file2.c file3.c ...
+
 # Stop parsing
 program --option -- --not-an-option
 ```
@@ -251,12 +259,12 @@ endpoint_t *ep = (endpoint_t*)argus_get(&argus, "endpoint").as_ptr;
 ## // Groups
 
 ```c
-GROUP_START("Connection", GROUP_DESC("Network options")),
+GROUP_START("Connection"),
     OPTION_STRING('h', "host", HELP("Hostname")),
     OPTION_INT('p', "port", HELP("Port")),
 GROUP_END(),
 
-GROUP_START("Output", GROUP_DESC("Output options")),
+GROUP_START("Output"),
     OPTION_STRING('o', "output", HELP("Output file")),
     OPTION_STRING('f', "format", HELP("Format")),
 GROUP_END(),

docs/docs/features/collections.md

@@ -178,6 +178,75 @@ ARGUS_OPTIONS(
 </TabItem>
 </Tabs>
 
+## // Variadic Positional
+
+Accept multiple values for positional arguments, similar to array options but for positional parameters:
+
+<Tabs>
+<TabItem value="variadic-types" label="Variadic Types" default>
+
+```c
+ARGUS_OPTIONS(
+    options,
+    HELP_OPTION(),
+    
+    // Multiple string values
+    POSITIONAL_MANY_STRING("files", HELP("Input files to process"), 
+                           HINT("FILE..."),
+                           FLAGS(FLAG_UNIQUE | FLAG_SORTED)),
+    
+    // Multiple integer values
+    POSITIONAL_MANY_INT("numbers", HELP("Numbers to process"),
+                        HINT("NUM..."),
+                        VALIDATOR(V_COUNT(1, 10))),
+    
+    // Multiple float values
+    POSITIONAL_MANY_FLOAT("values", HELP("Float values"),
+                          HINT("VAL...")),
+)
+```
+
+**Supported types:**
+- `POSITIONAL_MANY_STRING` - Multiple text values
+- `POSITIONAL_MANY_INT` - Multiple integer values  
+- `POSITIONAL_MANY_FLOAT` - Multiple decimal values
+
+**Important restrictions:**
+- Only one `POSITIONAL_MANY` argument allowed per command
+- Must be placed after all regular positional arguments
+- Cannot mix with optional positional arguments
+- Cannot be used with subcommands at the same level
+
+</TabItem>
+<TabItem value="variadic-usage" label="Usage Examples">
+
+```bash
+# Process multiple files
+./program file1.c file2.c file3.c
+
+# Process numbers
+./program 1 2 3 4 5
+
+# No arguments (if optional)
+./program
+
+# With other options
+./program --verbose file1.txt file2.txt
+```
+
+**Key characteristics:**
+- Accepts zero or more values
+- Values are collected into an array
+- Supports same flags as array options (`FLAG_SORTED`, `FLAG_UNIQUE`)
+- Can use validation like `V_COUNT()` to enforce limits
+
+**Access methods:**
+- Same as array collections: `argus_get().as_array`, `argus_count()`, `argus_array_it()`
+- See [Accessing Values](../fundamentals/accessing-values#variadic-positional) for detailed examples
+
+</TabItem>
+</Tabs>
+
 ## // Accessing Collection Values
 
 <Tabs>

docs/docs/features/validation.md

@@ -297,7 +297,6 @@ ARGUS_OPTIONS(
 - `ARGUS_RE_IPV6` - IPv6 addresses
 - `ARGUS_RE_URL` - URLs (any protocol)
 - `ARGUS_RE_ISO_DATE` - ISO dates (YYYY-MM-DD)
-- `ARGUS_RE_PHONE_US` - US phone numbers
 - `ARGUS_RE_UUID` - UUID v4 format
 
 </TabItem>