m + add non-static prototypes to .h file

Signed-off-by: Mattias Andrée <maandree@operamail.com>

2 files changed, 348 insertions, 1 deletions

diff --git a/src/argparser.c b/src/argparser.c
index 313c267..4df594b 100644
--- a/src/argparser.c
+++ b/src/argparser.c
@@ -84,7 +84,7 @@ static args_Map args_opts;
 
 
 /**
- * Constructor.
+ * Initialiser.
  * The short description is printed on same line as the program name
  * 
  * @param  description      Short, single-line, description of the program
diff --git a/src/argparser.h b/src/argparser.h
index 6862f2c..72f2265 100644
--- a/src/argparser.h
+++ b/src/argparser.h
@@ -157,3 +157,350 @@ char** args_files;
 long args_files_count;
 
 
+
+/**
+ * Initialiser.
+ * The short description is printed on same line as the program name
+ * 
+ * @param  description      Short, single-line, description of the program
+ * @param  usage            Formated, multi-line, usage text, may be `null`
+ * @param  longdescription  Long, multi-line, description of the program, may be `null`
+ * @param  program          The name of the program, `null` for automatic
+ * @param  usestderr        Whether to use stderr instead of stdout
+ */
+extern void args_init(char* description, char* usage, char* longdscription, char* program, long usestderr);
+
+
+/**
+ * Disposes of all resources, run this when you are done
+ */
+extern void args_dispose();
+
+
+/**
+ * Creates, but does not add, a option that takes no arguments
+ * 
+ * @param   standard  The index of the standard alternative name
+ * @param   count...  The alterntive names
+ * @return            The created option
+ */
+extern args_Option args_new_argumentless(int standard, int count, ...);
+
+/**
+ * Creates, but does not add, a option that takes one argument per use
+ * 
+ * @param   argument  The new of the argument
+ * @param   standard  The index of the standard alternative name
+ * @param   count...  The alterntive names
+ * @return            The created option
+ */
+extern args_Option args_new_argumented(char* argument, int standard, int count, ...);
+
+/**
+ * Creates, but does not add, a option that takes all following arguments
+ * 
+ * @param   argument  The new of the argument
+ * @param   standard  The index of the standard alternative name
+ * @param   count...  The alterntive names
+ * @return            The created option
+ */
+extern args_Option args_new_variadic(char* argument, int standard, int count, ...);
+
+
+/**
+ * Gets an array of all options
+ * 
+ * @return  All options
+ */
+extern args_Option* args_get_options();
+
+/**
+ * Gets the number of elements in the array returned by `args_get_options`
+ * 
+ * @return  The number of elements in the array returned by `args_get_options`
+ */
+extern long args_get_options_count();
+
+/**
+ * Gets the option with a specific index
+ * 
+ * @param   index  The option's index
+ * @return         The option
+ */
+extern args_Option args_options_get(long index);
+
+/**
+ * Gets the type of a option with a specific index
+ * 
+ * @param   index  The option's index
+ * @return         The option's type
+ */
+extern long args_options_get_type(long index);
+
+/**
+ * Gets the number of alternative option names for a option with a specific index
+ * 
+ * @param   index  The option's index
+ * @return         The option's number of alternative option names
+ */
+extern long args_options_get_alternatives_count(long index);
+
+/**
+ * Gets the alternative option names for a option with a specific index
+ * 
+ * @param   index  The option's index
+ * @return         The option's alternative option names
+ */
+extern char** args_options_get_alternatives(long index);
+
+/**
+ * Gets the argument name for a option with a specific index
+ * 
+ * @param   index  The option's index
+ * @return         The option's argument name
+ */
+extern char* args_options_get_argument(long index);
+
+/**
+ * Gets the standard option name for a option with a specific index
+ * 
+ * @param   index  The option's index
+ * @return         The option's standard option name
+ */
+extern char* args_options_get_standard(long index);
+
+/**
+ * Gets the help text for a option with a specific index
+ * 
+ * @param   index  The option's index
+ * @return         The option's help text
+ */
+extern char* args_options_get_help(long index);
+
+
+/**
+ * Gets the available options
+ * 
+ * @return  The available options
+ */
+extern char** args_get_opts();
+
+/**
+ * Gets the number of available options
+ * 
+ * @return  The number of available options
+ */
+extern long args_get_opts_count();
+
+/**
+ * Gets whether an option is available
+ * 
+ * @param   name  The option
+ * @return        Whether an option is available
+ */
+extern long args_opts_contains(char* name);
+
+/**
+ * Initialise an option
+ * 
+ * @param  name  The option
+ */
+extern void args_opts_new(char* name);
+
+/**
+ * Appends a value to an option
+ * 
+ * @param  name   The option
+ * @param  value  The new value
+ */
+extern void args_opts_append(char* name, char* value);
+
+/**
+ * Removes all values from an option
+ * 
+ * @param  name  The option
+ */
+extern void args_opts_clear(char* name);
+
+/**
+ * Gets the values for an option
+ * 
+ * @param   name  The option
+ * @return        The values
+ */
+extern char** args_opts_get(char* name);
+
+/**
+ * Gets the number of values for an option
+ * 
+ * @param   name  The option
+ * @return        The number of values
+ */
+extern long args_opts_get_count(char* name);
+
+/**
+ * Sets the values for an option
+ * 
+ * @param  name   The option
+ * @param  count  The values
+ */
+extern void args_opts_put(char* name, char** values);
+
+/**
+ * Sets the number of values for an option
+ * 
+ * @param  name   The option
+ * @param  count  The number of values
+ */
+extern void args_opts_put_count(char* name, long count);
+
+/**
+ * Checks whether an option is used
+ * 
+ * @param   name  The option
+ * @return        Whether the option is used
+ */
+extern long args_opts_used(char* name);
+
+
+/**
+ * Gets all alternativ names that exists for all options combined
+ * 
+ * @return  All alternativ names that exists for all options
+ */
+extern char** args_get_optmap();
+
+/**
+ * Gets the number of elements returned by `args_get_optmap`
+ * 
+ * @return  The number of elements returned by `args_get_optmap`
+ */
+extern long args_get_optmap_count();
+
+/**
+ * Maps alternative name for a option
+ * 
+ * @param  name   The option's alternative name
+ * @param  index  The option's index
+ */
+extern void args_optmap_put(char* name, long index);
+
+/**
+ * Gets the option with a specific alternative name
+ * 
+ * @param   name  The option's alternative name
+ * @return        The option
+ */
+extern args_Option args_optmap_get(char* name);
+
+/**
+ * Gets the index of a option with a specific alternative name
+ * 
+ * @param   name  The option's alternative name
+ * @return        The option's index, negative if not found
+ */
+extern long args_optmap_get_index(char* name);
+
+/**
+ * Checks whether an options with a specific alternative name exists
+ * 
+ * @param   name  One of the names of the option
+ * @return        Whether the option exists
+ */
+extern long args_optmap_contains(char* name);
+
+/**
+ * Gets the type of a option with a specific alternative name
+ * 
+ * @param   name  The option's alternative name
+ * @return        The option's type
+ */
+extern long args_optmap_get_type(char* name);
+
+/**
+ * Gets the standard option name for a option with a specific alternative name
+ * 
+ * @param   name  The option's alternative name
+ * @return        The option's standard option name
+ */
+extern char* args_optmap_get_standard(char* name);
+
+
+/**
+ * Adds an option
+ * 
+ * @param  option  The option
+ * @param  help    Help text, multi-line, `null` if hidden
+ */
+extern void args_add_option(args_Option option, char* help);
+
+/**
+ * Gets the name of the parent process
+ * 
+ * @param   levels  The number of parents to walk, 0 for self, and 1 for direct parent
+ * @return          The name of the parent process, `null` if not found
+ */
+extern char* args_parent_name(long levels);
+
+/**
+ * Checks the correctness of the number of used non-option arguments
+ * 
+ * @param   min  The minimum number of files
+ * @return       Whether the usage was correct
+ */
+extern long args_test_files_min(long min);
+
+/**
+ * Checks the correctness of the number of used non-option arguments
+ * 
+ * @param   max  The maximum number of files
+ * @return       Whether the usage was correct
+ */
+extern long args_test_files_max(long max);
+
+/**
+ * Checks the correctness of the number of used non-option arguments
+ * 
+ * @param   min  The minimum number of files
+ * @param   max  The maximum number of files
+ * @return       Whether the usage was correct
+ */
+extern long args_test_files(long min, long max);
+
+/**
+ * Checks for out of context option usage
+ * 
+ * @param   allowed        Allowed options, will be sorted
+ * @param   allowed_count  The number of elements in `allowed`
+ * @return                 Whether only allowed options was used
+ */
+extern long args_test_allowed(char** allowed, long allowed_count);
+
+/**
+ * Checks for option conflicts
+ * 
+ * @param   exclusives        Exclusive options, will be sorted
+ * @param   exclusives_count  The number of elements in `exclusives`
+ * @return                    Whether at most one exclusive option was used
+ */
+extern long args_test_exclusiveness(char** exclusives, long exclusives_count);
+
+/**
+ * Maps up options that are alternatives to the first alternative for each option
+ */
+extern void args_support_alternatives();
+
+/**
+ * Prints a colourful help message
+ */
+extern void args_help();
+
+/**
+ * Parse arguments
+ * 
+ * @param   argc  The number of elements in `argv`
+ * @param   argv  The command line arguments, it should include the execute file at index 0
+ * @return        Whether no unrecognised option is used
+ */
+extern long args_parse(int argc, char** argv);
+