likle / cargs Goto Github PK

Is there a way to get an invalid option, like an option that doesn't exist in array of cag_option?

while (cag_option_fetch(&context)) {
  ident = cag_option_get(&context);
  switch (ident) {
  case 'h':
    printf("%s\n", "Usage: program [-h]");
    exit(EXIT_SUCCESS);
    break;
  default:
    // here's where it handle invalid option; below is an example
    printf("Error: invalid option '%s'\n", cag_option_get_invalid(&context));
    exit(EXIT_FAILURE);
    break;
  }
}

Hi.

Are you interested following API change?

#ifndef NO_FILE_SUPPORT
CAG_PUBLIC void cag_option_print(const cag_option *options, size_t option_count,
  FILE *destination);
#endif

typedef int(*cag_printer)(void *ctx, const char *fmt, ...);

CAG_PUBLIC void cag_option_print_cb(const cag_option* options, size_t option_count, cag_printer printer, void *ctx);

My embedded system does not have file support so I refactored API so that I could use callback to print help texts. Are you interested to receive PR ? I am too lazy to make it if you are not interested to extending API for embedded usage.

Hi,
Yesterday I was trying to use cargs. First I tried building with mingw gcc in windows. But everything went ok before testing help command. help command only printed "demonstra...." line and then paused for a second then stopped execution. But I tried doing this in wsl2 and msvc, and they worked perfectly there. Can you figure out the issue?

From rpmbuild:

W: wrong-file-end-of-line-encoding /usr/share/doc/lib64cargs-devel/README.md

Update: added #11 for easier update

--- CMakeLists.org	2023-08-23 13:30:44.000000000 +0200
+++ CMakeLists.txt	2023-08-23 13:34:12.000000000 +0200
@@ -19,11 +19,15 @@
 
 # setup target and directory names
 set(LIBRARY_TARGET "cargs")
-set(TEST_TARGET "cargstest")
 set(INCLUDE_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/include")
 set(SOURCE_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/src")
+
+set(TEST_TARGET "cargstest")
 set(TEST_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/test")
 
+set(DEMO_TARGET "cargsdemo")
+set(DEMO_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/demo")
+
 # enable coverage if requested
 if(ENABLE_COVERAGE)
   message("-- Coverage enabled")
@@ -85,6 +89,12 @@
   enable_warnings(${TEST_TARGET})
 endif()
 
+if(ENABLE_DEMO)
+  message("-- Demo enabled")
+  add_executable(${DEMO_TARGET} "${DEMO_DIRECTORY}/main.c")
+  target_link_libraries(${DEMO_TARGET} PUBLIC ${LIBRARY_TARGET})
+endif()
+
 # version file
 configure_package_config_file("cmake/CargsConfig.cmake.in"
   ${CMAKE_CURRENT_BINARY_DIR}/CargsConfig.cmake

The project looks nice.

Hi,

I've been using cargs for a small project where I want to be cross-platform and still offer a reasonably full-featured command-line interface, and it's been working really well.

However, I seem to have a problem. If I compile this test program (foo.c):

#include <stdio.h>
#include "cargs.h"

static struct cag_option options[] = {
    { .identifier = 'h',
      .access_letters = "h",
      .access_name = "help",
      .description = "show this help and exit" },
};

int main(int argc, char *argv[]) {
    cag_option_context context;
    cag_option_prepare(&context, options, CAG_ARRAY_SIZE(options), argc, argv);
    while (cag_option_fetch(&context)) {
        char identifier = cag_option_get(&context);
        switch (identifier) {
            case 'h':
                printf("Help...\n");
                break;
            default:
                printf("?\n");
                break;
        }
    }
    for (int i = context.index; i < context.argc; ++i) {
        printf("arg %d: %s\n", i, context.argv[i]);
    }
}

the non-option arguments seem to be permuted inconsistently. Normally the order is preserved:

$ gcc -Wall foo.c cargs.c
$ ./a.out foo bar
arg 1: foo
arg 2: bar
$ ./a.out -h foo bar
Help...
arg 2: foo
arg 3: bar
$ ./a.out foo -h bar
Help...
arg 2: foo
arg 3: bar

but if I have an option as the last argument, things change:

$ ./a.out foo bar -h
Help...
arg 2: bar
arg 3: foo

arg 2 is now "bar", whereas it used to be "foo".

As my program is trying to accept two non-option arguments which are input and output files, this breaks things. Would it be possible to have the order of non-option arguments preserved in all cases please?

If you need any more information please let me know.

Thanks.

Steve

Thank you for this nice project.

Could you please add an example with non-option arguments and how to read them?

I guess the following example is self-explanatory, the src and dst arguments would be non-option file paths:

filecopy --recursive --overwrite=newer src dst

I've tried to understand the source code (quickly), but failed.

Thank you.

_Mark