From 193c6888e9a50d4aae967b693664c7e3fa41901a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Wed, 3 Mar 2021 01:42:28 +0100
Subject: [PATCH 01/13] split argsparse source code into multiple files for
 better maintenance

---
 argsparse.sh                | 1656 -----------------------------------
 src/00_head                 |  312 +++++++
 src/10_utils                |   92 ++
 src/15_misc                 |   33 +
 src/19_option-property      |  141 +++
 src/20_declaration          |  121 +++
 src/30_types                |   91 ++
 src/40_usage                |  227 +++++
 src/60_option-value-setting |  160 ++++
 src/65_params               |   71 ++
 src/70_parsing              |  366 ++++++++
 src/80_post-parsing         |   62 ++
 src/95_help-option          |   28 +
 src/99_main                 |   11 +
 14 files changed, 1715 insertions(+), 1656 deletions(-)
 delete mode 100644 argsparse.sh
 create mode 100644 src/00_head
 create mode 100644 src/10_utils
 create mode 100644 src/15_misc
 create mode 100644 src/19_option-property
 create mode 100644 src/20_declaration
 create mode 100644 src/30_types
 create mode 100644 src/40_usage
 create mode 100644 src/60_option-value-setting
 create mode 100644 src/65_params
 create mode 100644 src/70_parsing
 create mode 100644 src/80_post-parsing
 create mode 100644 src/95_help-option
 create mode 100644 src/99_main

diff --git a/argsparse.sh b/argsparse.sh
deleted file mode 100644
index 9f4e9d2..0000000
--- a/argsparse.sh
+++ /dev/null
@@ -1,1656 +0,0 @@
-#!/usr/bin/env bash
-# -*- tab-width: 4; encoding: utf-8; -*-
-#
-#########
-# License:
-#
-#             DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
-#                    Version 2, December 2004
-#
-# Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
-#
-# Everyone is permitted to copy and distribute verbatim or modified
-# copies of this license document, and changing it is allowed as long
-# as the name is changed.
-#
-#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
-#   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-#
-#  0. You just DO WHAT THE FUCK YOU WANT TO.
-#
-#########
-#
-## @file
-## @author Damien Nadé <bash-argsparse@livna.org>
-## @copyright WTFPLv2
-## @version 1.8
-## @brief Bash Argsparse Library
-## @details
-## @par URL
-## https://github.com/Anvil/bash-argsparse @n
-##
-## @par Purpose
-##
-## To replace the option-parsing and usage-describing functions
-## commonly rewritten in all scripts.
-##
-## @note
-## This library is implemented for bash version 4. Prior versions of
-## bash will fail at interpreting that code.
-## @note
-## The extglob shell option will be enabled and posix mode will be
-## disabled when loading the library. Changing those settings
-## afterwards will make the library execution fail.
-##
-## @par Usage
-## Use the argsparse_use_option() function to declare your options with
-## their single letter counterparts, along with their description.
-##
-## @par
-## The argsparse_use_option() syntax is:
-##
-## @code
-##     argsparse_use_option "optstring" "option description string" \
-##     [ "property" ... ] [ "optional default value" ]
-## @endcode
-##
-##
-## @par
-## An "optstring" is of the form "som=estring:". This would declare a
-## long option named somestring. The ending ":" is optional and, if
-## present, means the long option expects a value on the command
-## line. The "=" char is also optional and means the immediatly
-## following letter is the short single-letter equivalent option of
-## --something.
-##
-## @par
-## The "something" string must only contains ASCII
-## letters/numbers/dash/underscore characters.
-##
-## @note
-## What is referred later as "option" or "option name" (or even "long
-## option name") is the optstring without the ':' and '=' characters.
-##
-##
-##
-## @par Options may have properties.
-##
-## Properties are set either at option declarations through the
-## argsparse_use_option() function, or using the
-## argsparse_set_option_property() function
-##
-## The currently supported properties are:
-##
-## - "hidden" @n
-## 	 An hidden option will not be shown in usage.
-##
-## - "mandatory" @n
-## 	 An option marked as mandatory is required on the command line. If
-##   a mandatory option is omited by the user, usage() will be
-##   triggered by argsparse_parse_options().
-##
-## - "value" @n
-##   On the command line, the option will require a value.
-## 	 Same effect if you end your optstring with a ':' char.
-##
-## - "default:<defaultvalue>" @n
-## 	 The default value for the option.
-##
-## - "short:<char>" @n
-##   The short single-letter equivalent of the option.
-##
-## - "type:<typename>" @n
-##   Give a type to the option value. User input value will be checked
-## 	 against built-in type verifications _or_ the
-## 	 "check_type_<typename>" function. You cannot override a built-in
-## 	 type. Built-in types are:
-##   - file
-##   - directory
-##   - pipe
-##   - terminal
-##   - socket
-##   - link
-##   - char
-##   - unsignedint
-##   - uint
-##   - integer
-##   - int
-##   - hexa
-##   - ipv4
-##   - ipv6
-##   - ip
-##   - hostname
-##   - host
-##   - portnumber
-##   - port
-##   - username
-##   - group
-##   - date
-##   .
-##
-## - "exclude:<option> <option>" @n
-##   The exclude property value is a space-separated list of other
-##   options. User wont be able to provided two mutually exclusive
-##   options on the command line. @n
-##
-##   e.g: if you set exclude property for the --foo option this way:
-##   @code argsparse_set_option_property "exclude:opt1 opt2" foo @endcode
-##   Then --opt1 and --foo are not allowed on the same command line
-##   invokation. And same goes for --opt2 and --foo.
-##   This foo exclude property setting wouldnt make --opt1 and --opt2,
-##   mutually exclusive though.
-##
-## - "alias:<option> <option>" @n
-##   This property allows an option to set multiple other without-value
-##   options instead. Recursive aliases are permitted but no loop
-##   detection is made, so be careful. @n
-##   e.g: if you declare an option 'opt' like this:
-##   @code argsparse_use_option opt "my description" "alias:opt1 opt2" @endcode
-##   Then if the user is doing --opt on the command line, it will be as
-##   if he would have done --opt1 --opt2
-##
-## - cumulative @n
-##   Implies 'value'.
-##   Everytime a cumulative option "optionname" is passed on the
-##   command line, the value is stored at the end of an array named
-##   "cumulated_values_<optionname>". @n
-##
-##   e.g: for a script with an opt1 option declared this way:
-##   @code argsparse_use_option opt1 "some description" cumulative @endcode
-##   and invoked with:
-##   @code --opt1 value1 --opt1 value2 @endcode
-##   after argsparse_parse_options(), "${cumulated_values_opt1[0]}" will
-##   expand to value1, and ${cumulated_values_opt1[1]} will expand to
-##   value2.
-##
-## - cumulativeset @n
-##   Exactly like cumulative, except only uniq values are kept. @n
-##
-##   e.g: for a script with an opt1 option declared this way:
-##   @code argsparse_use_option opt1 "some description" cumulativeset @endcode
-##   and invoked with:
-##   @code --opt1 value1 --opt1 value2 --opt1 value1 @endcode
-##   after argsparse_parse_options(), "${cumulated_values_opt1[0]}" will
-##   expand to value1, and "${cumulated_values_opt1[1]}" will expand to
-##   value2. There would be no "${cumulated_values_opt1[2]}" value.
-##
-## - "require:<option> <option>" @n
-##   Creates a dependency between options. if you declare an option with:
-##   @code
-##   argsparse_use_option opt1 "something" require:"opt2 opt3"
-##   @endcode
-##   argsparse_parse_options() would return with an error if "--opt1"
-##   is given on the commande line without "--opt2" or without "--opt3".
-##
-## @par
-## You can test if an option has a property using the
-## argsparse_has_option_property() function.
-## @code argsparse_has_option_property <option> <property> @endcode
-##
-##
-## @par Parsing positionnal parameters
-## After the options are declared, invoke the function
-## argsparse_parse_options() with the all script parameters. This will
-## define:
-##
-## - program_params, an array, containing all non-option parameters.
-##
-## - program_options, an associative array. For each record of the
-##   array:
-##   - The key is the long option name.
-##   - And about values:
-##     - If option doesn't expect a value on the command line, the
-##       value represents how many times the option has been
-##       found on the command line
-##
-##     - If option does require a value, the array record value is the
-##       value of the last occurence of the option found on the command
-##       line.
-##     .
-##   - If option is cumulative (or cumulativeset), the array record
-##     value is the number of values passed by the user.
-##   .
-##
-## After argsparse_parse_options() invokation, you can check if an
-## option have was on the command line (or not) using the
-## argsparse_is_option_set() function. @n
-##
-## e.g:
-## @code argsparse_is_option_set "long-option-name" @endcode
-##
-##
-## @par The "usage()" function
-## If a 'usage' function is defined, and shall
-## argsparse_parse_options() return with non-zero status, 'usage' will
-## be automatically called.
-##
-## @note
-## This library automatically defines a default 'usage' function,
-## which may be removed or overridden by the sourcing program
-## afterwards.
-##
-## @par Value setting internal logic
-## During option parsing, for every option of the form '--optionname'
-## expecting a value:
-##
-## - If there exists an array named "option_<optionname>_values" and
-##   the user-given value doesn't belong to that array, then the
-##   argsparse_parse_options() function immediately returns with
-##   non-zero status, triggering 'usage'.
-##
-## - If the "option_<optionname>_values" array does not exist, but if
-##   the option has a type property field, then the value format will
-##   be checked against that type.
-##
-## - If a function named "check_value_of_<optionname>" has been
-##   defined, it will be called with the user-given value as its first
-##   positionnal parameter. If check_value_of_<optionname> returns
-##   with non-zero status, then parse_option immediately returns with
-##   non-zero status, triggering the 'usage' function.
-##
-## @par
-## Also, still during option parsing and for @b every option of the form
-## "--optionname":
-##
-## - After value-checking, if a function named
-##   "set_option_<optionname>" exists, then, instead of directly
-##   modifying the "program_options" associative array, this function
-##   is automatically called with 'optionname' as its first
-##   positionnal parameter, and, if 'optionname' expected a value, the
-##   value is given as the function second positionnal parameter.
-##
-## @par About functions return values...
-##
-## All argsparse functions will return with an error (usually a return
-## code of 1) if called with a wrong number of parameters, and return
-## with 0 if everything went fine.
-##
-## @defgroup ArgsparseUsage Calling program usage description message.
-## @defgroup ArgsparseOptionSetter Setting options values.
-## @defgroup ArgsparseProperty Options properties handling.
-## @defgroup ArgsparseParameter Non-optional positionnal parameters.
-
-# We're not compatible with older bash versions.
-if [[ "$BASH_VERSINFO" -lt 4 ]]
-then
-	printf >&2 "This requires bash >= 4 to run.\n"
-	return 1 2>/dev/null
-	exit 1
-fi
-
-if ! command -v getopt >/dev/null 2>&1
-then
-	printf >&2 "Cannot find the getopt command.\n"
-	return 1 2>/dev/null
-	exit 1
-fi
-
-if declare -rp ARGSPARSE_VERSION >/dev/null 2>&1
-then
-	# argsparse is already loaded.
-	return 0 2>/dev/null
-fi
-
-## @var ARGSPARSE_VERSION
-## @brief argsparse version number
-## @showinitializer
-declare -r ARGSPARSE_VERSION=1.8
-
-# Enable required features
-shopt -s extglob
-set +o posix
-
-# This is an associative array. It should contains records of the form
-# "something" -> "Some usage description string".
-# The "something" string is referred as the "option name" later in
-# source code and comments.
-## @var AssociativeArray __argsparse_options_descriptions
-## @private
-## @brief Internal use only.
-declare -A __argsparse_options_descriptions=()
-
-## @brief The name of the program currently using argsparse.
-## @details Automatically set by argsparse at load time, it contains
-## the basename (path-less but with extension, if any) of the main
-## script. Used internally to print error messages and by
-## usage-related functions, but can be used by the loading script.
-## @hideinitializer
-declare -r argsparse_pgm=${0##*/}
-
-## @brief Internal use only.
-## @details The default minimum parameters requirement for command line.
-## @ingroup ArgsparseParameter
-declare -i __argsparse_minimum_parameters=0
-
-## @brief Internal use only.
-## @details An associative array where options default values are
-## stored as soon as the 'default:' property is set.
-## @ingroup ArgsparseProperty
-declare -A __argsparse_options_default_values=()
-
-## @fn argsparse_minimum_parameters()
-## @brief Set the minimum number of non-option parameters expected on
-## the command line.
-## @param unsigned_int a positive number.
-## @retval 0 if there is an unsigned integer is provided and is the
-## single parameter of this function.
-## @retval 1 in other cases.
-## @ingroup ArgsparseParameter
-argsparse_minimum_parameters() {
-	[[ $# -eq 1 ]] || return 1
-	local min=$1
-	[[ "$min" = +([0-9]) ]] || return 1
-	__argsparse_minimum_parameters=$min
-}
-
-## @brief Internal use only.
-## @details The default maximum parameters requirement for command
-## line. "Should be enough for everyone".
-## @ingroup ArgsparseParameter
-declare -i __argsparse_maximum_parameters=1000000
-
-## @fn argsparse_maximum_parameters()
-## @brief Set the maximum number of non-option parameters expected on
-## the command line.
-## @param unsigned_int a positive number.
-## @retval 0 if there is an unsigned integer is provided and is the
-## single parameter of this function.
-## @retval 1 in other cases.
-## @ingroup ArgsparseParameter
-argsparse_maximum_parameters() {
-	[[ $# -eq 1 ]] || return 1
-	local max=$1
-	[[ "$max" = +([0-9]) ]] || return 1
-	__argsparse_maximum_parameters=$max
-}
-
-
-# 2 generic functions
-
-# @fn __argsparse_index_of()
-# @param value a value
-# @param values... array values
-# @brief Tells if a value is found in a set of other values.
-# @details Look for @a value and print its position in the @a values
-# set. Return false if it can not be found.
-# @retval 0 if @a value is amongst @a values
-# @retval 1 if @a value is not found.
-__argsparse_index_of() {
-	[[ $# -ge 2 ]] || return 1
-	local key=$1 ; shift
-	local index=0
-	local elem
-	for elem in "$@"
-	do
-		if [[ "$key" = "$elem" ]]
-		then
-			printf %s "$index"
-			return 0
-		fi
-		: $((index++))
-	done
-	return 1
-}
-
-# @fn __argsparse_join_array()
-# @param c a single char
-# @param strings... strings to join
-# @brief join multiple strings by a char.
-# @details Like the 'str.join' string method in python, join multiple
-# strings by a char. Only work with a single char, though.
-# @retval 1 if first parameter is invalid.
-# @retval 0 else.
-__argsparse_join_array() {
-	[[ $# -ge 1 && $1 = ? ]] || return 1
-	local IFS="$1$IFS"
-	shift
-	printf %s "$*"
-}
-
-## @fn argsparse_option_to_identifier()
-## @brief Give the identifier name associated to an option.
-## @details Transforms and prints an option name into a string which
-## suitable to be part of a function or a variable name.
-## @param option an option name.
-argsparse_option_to_identifier() {
-	[[ $# -eq 1 ]] || return 1
-	local option=$1
-	printf %s "${option//-/_}"
-}
-
-# Following functions define the default option-setting hook and its
-# with/without value counter-parts. They can be referered in external
-# source code, though they should only be in user-defined
-# option-setting hooks.
-
-# All user-defined option-setting hook should be defined like
-# argsparse_set_option
-
-## @fn argsparse_set_option_without_value()
-## @brief The option-setting hook for options not accepting values.
-## @param option an option name.
-## @retval 0
-## @ingroup ArgsparseOptionSetter
-argsparse_set_option_without_value() {
-	[[ $# -eq 1 ]] || return 1
-	local option=$1
-	: $((program_options["$option"]++))
-}
-
-## @fn argsparse_set_option_with_value()
-## @brief "value" property specific option-setting hook.
-## @param option an option name.
-## @param value the value put on command line for given option.
-## @ingroup ArgsparseOptionSetter
-argsparse_set_option_with_value() {
-	[[ $# -eq 2 ]] || return 1
-	local option=$1
-	local value=$2
-	program_options["$option"]=$value
-}
-
-## @fn argsparse_get_cumulative_array_name()
-## @param option an option name.
-## @brief Print the name of the array used for "cumulative" and
-## "cumulativeset" options.
-## @details For "option-name" usually prints
-## "cumulated_values_option_name".
-argsparse_get_cumulative_array_name() {
-	[[ $# -eq 1 ]] || return 1
-	local option=$1
-	local ident=$(argsparse_option_to_identifier "$option")
-	printf "cumulated_values_%s" "$ident"
-}
-
-## @fn argsparse_set_cumulative_option()
-## @brief "cumulative" property specific option-setting hook.
-## @details Default action to take for cumulative options. Store @a
-## value into an array whose name is generated using
-## argsparse_get_cumulative_array_name().
-## @param option an option name.
-## @param value the value put on command line for given option.
-## @ingroup ArgsparseOptionSetter
-argsparse_set_cumulative_option() {
-	[[ $# -eq 2 ]] || return 1
-	local option=$1
-	local value=$2
-	local array="$(argsparse_get_cumulative_array_name "$option")"
-	local size temp="$array[@]"
-	local -a copy
-	if __argsparse_has_array_item "$array" 0
-	then
-		copy=( "${!temp}" )
-		size=${#copy[@]}
-	else
-		size=0
-	fi
-	printf -v "$array[$size]" %s "$value"
-	argsparse_set_option_without_value "$option"
-}
-
-## @fn argsparse_set_cumulativeset_option()
-## @param option an option name.
-## @param value a new value for the option.
-## @brief "cumulativeset" property specific option-setting hook.
-## @details Default action to take for cumulativeset options. Act
-## exactly like argsparse_set_cumulative_option() except that values
-## are not duplicated in the cumulated values array.
-## @ingroup ArgsparseOptionSetter
-argsparse_set_cumulativeset_option() {
-	[[ $# -eq 2 ]] || return 1
-	local option=$1
-	local value=$2
-	local array_name="$(argsparse_get_cumulative_array_name "$option")"
-	local array="$array_name[@]"
-	if ! __argsparse_has_array_item "$array_name" || \
-		   ! __argsparse_index_of "$value" "${!array}" >/dev/null
-	then
-		# The value is not already in the array, so add it.
-		argsparse_set_cumulative_option "$option" "$value"
-	fi
-}
-
-## @fn argsparse_set_alias()
-## @param option an option name.
-## @brief "alias" property specific option-setting hook.
-## @details When an option is an alias for other option(s), then set
-## the aliases options.
-## @ingroup ArgsparseOptionSetter
-argsparse_set_alias() {
-	# This option will set all options aliased by another.
-	[[ $# -eq 1 ]] || return 1
-	local option=$1
-	local aliases
-	if ! aliases="$(argsparse_has_option_property "$option" alias)"
-	then
-		return 1
-	fi
-	while [[ "$aliases" =~ ^\ *([^\ ]+)(\ (.+))?\ *$ ]]
-	do
-		# At this point, BASH_REMATCH[1] is the first alias, and
-		# BASH_REMATCH[3] is the maybe-empty list of other aliases.
-		# __argsparse_set_option will alter BASH_REMATCH, so modify
-		# aliases first.
-		aliases=${BASH_REMATCH[3]}
-		__argsparse_set_option "${BASH_REMATCH[1]}"
-	done
-}
-
-## @fn argsparse_set_option()
-## @brief Default option-setting hook.
-## @param option The option being set.
-## @param value the value of the option (optional).
-## @details This function will be called by argsparse_parse_options()
-## whenever a given option is being set and no custom setting hook is
-## defined for said option. Depending of the properties of the option,
-## a more specific setting hook will be called.
-## @ingroup ArgsparseOptionSetter
-argsparse_set_option() {
-	[[ $# -eq 2 || $# -eq 1 ]] || return 1
-	local option=$1
-	if [[ $# -eq 2 ]]
-	then
-		local value=$2
-	fi
-	local property
-	local -A setters=(
-		[cumulative]=argsparse_set_cumulative_option
-		[cumulativeset]=argsparse_set_cumulativeset_option
-		[value]=argsparse_set_option_with_value
-	)
-
-	if ! argsparse_set_alias "$option"
-	then
-		# We dont use ${!setters[@]} here, because order matters.
-		for property in cumulative cumulativeset value
-		do
-			if argsparse_has_option_property "$option" "$property"
-			then
-				"${setters[$property]}" "$option" "$value"
-				return
-			fi
-		done
-		argsparse_set_option_without_value "$option"
-	fi
-}
-
-
-# The usage-related functions.
-
-__argsparse_usage_short_line_management() {
-	[[ $# -eq 1 ]] || return 1
-	local next_token=$1
-	local max_length=78
-	local bigger_line
-	bigger_line="$current_line $next_token"
-	if [[ "${#bigger_line}" -gt "$max_length" ]]
-	then
-		printf -- '%s \\\n' "$current_line"
-		printf -v current_line "\t%s" "$next_token"
-	else
-		current_line=$bigger_line
-	fi
-}
-
-## @fn argsparse_usage_short()
-## @brief Print a short description of the program syntax.
-## @details Generate and print the "short" description of the program
-## usage.
-## @ingroup ArgsparseUsage
-argsparse_usage_short() {
-	local option values current_line current_option param
-	local max_length=78
-	current_line=$argsparse_pgm
-	for option in "${!__argsparse_options_descriptions[@]}"
-	do
-		if argsparse_has_option_property "$option" hidden
-		then
-			continue
-		fi
-		current_option="--$option"
-		if argsparse_has_option_property "$option" value
-		then
-			if values=$(__argsparse_values_array_identifier "$option")
-			then
-				current_option="$current_option <$(
-					__argsparse_join_array '|' "${!values}")>"
-			else
-				current_option="$current_option ${option^^}"
-			fi
-		fi
-		if ! argsparse_has_option_property "$option" mandatory
-		then
-			current_option="[ $current_option ]"
-		fi
-		__argsparse_usage_short_line_management "$current_option"
-	done
-	if __argsparse_has_array_item __argsparse_parameters_description
-	then
-	   for param in "${__argsparse_parameters_description[@]}"
-	   do
-		   __argsparse_usage_short_line_management "$param"
-	   done
-	fi
-	printf -- "%s\n" "$current_line"
-}
-
-## @var Array __argsparse_parameters_description
-## @private
-## @brief Internal use only.
-## @ingroup ArgsparseUsage
-# @details Used by argsparse_describe_parameters() to store
-# non-option positionnal parameters short descriptions and by
-# argsparse_usage_short() to print them to end-users.
-declare -a __argsparse_parameters_description
-
-## @fn argsparse_describe_parameters()
-## @brief Describe non-option positionnal parameters.
-## @details This function has currently 2 purposes:
-## - enhance the "short" usage program description (see
-## argsparse_usage_short())
-## - compute the minimum and maximum numbers of non-option
-## positionnal parameters and will overwrite previous settings using
-## argsparse_minimum_parameters() and argsparse_maximum_parameters().
-##
-## @param param... a list of label describing positionnal
-## parameters. These labels can have special forms such as:
-## - "label?" a single optional non-repeatable parameter
-## - "label+" a non-empty list of parameters
-## - "label*" a potentially-empty list of parameters
-## - "label" a single non-optional non-repeatable parameter
-## @retval 0
-## @ingroup ArgsparseUsage
-argsparse_describe_parameters() {
-	[[ $# -eq 0 ]] && return
-	local param last name
-	local -i min=0 max=0
-	__argsparse_parameters_description=( "[--]" )
-	for param in "$@"
-	do
-		name=${param%?}
-		last=${param#$name}
-		case "$last" in
-			'?')
-				: maximum param $((++max))
-				__argsparse_parameters_description+=( "[ $name ]" )
-				;;
-			'*')
-				max=1000000
-				__argsparse_parameters_description+=( "[ $name ... ]" )
-				;;
-			+)
-				max=1000000
-				: minimum param $((++min))
-				__argsparse_parameters_description+=( "$name [ $name ... ]" )
-				;;
-			*)
-				: maximum param $((++max))
-				: minimum param $((++min))
-				__argsparse_parameters_description+=( "$param" )
-		esac
-	done
-	argsparse_minimum_parameters "$min"
-	argsparse_maximum_parameters "$max"
-}
-
-## @fn argsparse_usage_long()
-## @brief Fully describe the program syntax and options to the end-user.
-## @details This function generates and prints the "long" description
-## of the program usage. Print all options along with their
-## descriptions provided to argsparse_use_option().
-## @ingroup ArgsparseUsage
-argsparse_usage_long() {
-	local long short sep format array property propstring
-	local q=\' bol='\t\t  '
-	local -A long_to_short=()
-	local -a values
-	# Reverse the __argsparse_short_options array.
-	for short in "${!__argsparse_short_options[@]}"
-	do
-		long=${__argsparse_short_options["$short"]}
-		long_to_short["$long"]=$short
-	done
-	for long in "${!__argsparse_options_descriptions[@]}"
-	do
-		if argsparse_has_option_property "$long" hidden
-		then
-			continue
-		fi
-		# Pretty printer issue here. If the long option length is
-		# greater than 8, we just use next line to print the option
-		# description.
-		if [[ "${#long}" -le 9 ]]
-		then
-			sep=' '
-		else
-			sep="\n$bol"
-		fi
-		# Define format according to the presence of the short option.
-		if __argsparse_has_array_item long_to_short "$long"
-		then
-			short="${long_to_short[$long]}"
-			format=" -%s | %- 11s$sep%s\n"
-		else
-			short=""
-			format=" %s     %- 11s$sep%s\n"
-		fi
-		printf -- "$format" "$short" "--$long" \
-			"${__argsparse_options_descriptions["$long"]}"
-		if argsparse_has_option_property "$long" cumulative || \
-			argsparse_has_option_property "$long" cumulativeset
-		then
-			printf "${bol}Can be repeated.\n"
-		fi
-		if argsparse_has_option_property "$long" value
-		then
-			if array=$(__argsparse_values_array_identifier "$long")
-			then
-				values=( "${!array}" )
-				values=( "${values[@]/%/$q}" )
-				values=( "${values[@]/#/$q}" )
-				printf "${bol}Acceptable values: %s\n" \
-					"$(__argsparse_join_array " " "${values[@]}")"
-			fi
-			if __argsparse_index_of "$long" \
-				"${!__argsparse_options_default_values[@]}" >/dev/null
-			then
-				printf "${bol}Default: %s\n" \
-					"${__argsparse_options_default_values[$long]}"
-			fi
-		fi
-		local -A properties=([require]="Requires" [alias]="Same as")
-		for property in "${!properties[@]}"
-		do
-			if propstring=$(argsparse_has_option_property "$long" "$property")
-			then
-				read -a values <<<"$propstring"
-				values=( "${values[@]/#/--}" )
-				printf "${bol}%s: %s\n" \
-					"${properties[$property]}" "${values[*]}"
-			fi
-		done
-	done
-}
-
-## @var String argsparse_usage_description
-## @brief Usage description additionnal string.
-## @details The content of this variable will be appended to the
-## argsparse_usage() output.
-## @ingroup ArgsparseUsage
-declare argsparse_usage_description
-
-## @fn argsparse_usage()
-## @brief A generic help message generated from the options and their
-## descriptions.
-## @details Will print both a rather-short and a quite long
-## description of the program and its options. Just provided to be
-## wrapped in your own usage().
-## @ingroup ArgsparseUsage
-argsparse_usage() {
-	# There's still a lot of room for improvement here.
-	argsparse_usage_short
-	printf "\n"
-	# This will print option descriptions.
-	argsparse_usage_long
-	[[ -n "${argsparse_usage_description:-}" ]] && \
-		printf "\n%s\n" "$argsparse_usage_description" || :
-}
-
-## @fn usage()
-## @brief Default usage function.
-## @details The default usage function. By default, it will be called
-## by argsparse_parse_options() on error or if --help option provided by
-## user on the command line. It can easily be overwritten if it does not
-## suits your needs.
-## @return This function makes an @b exit with code 1
-## @ingroup ArgsparseUsage
-usage() {
-	argsparse_usage
-	exit 1
-}
-
-## @fn set_option_help()
-## @brief Default trigger for --help option.
-## @details Will actually only call usage().
-## @return Whatever usage() returns.
-## @ingroup ArgsparseUsage
-set_option_help() {
-	# This is the default hook for the --help option.
-	usage
-}
-
-## @fn __argsparse_values_array_identifier()
-## @private
-## @brief Prints the name of the array containing all user-declared
-## acceptable values for an option.
-## @details from "opt" or "opt-name" string, prints
-## "option_opt_values[@]" or "option_opt_name_values[@]", unless array
-## is not declared, in which case function will return an error.
-## @param option an option name.
-## @retval 1 if array has not been declared
-## @retval 0 else. Array name will be written to stdout.
-__argsparse_values_array_identifier() {
-	local option=$1
-	local array="option_$(argsparse_option_to_identifier "$option")_values"
-	__argsparse_is_array_declared "$array" || return 1
-	printf %s "$array[@]"
-}
-
-__argsparse_is_array_declared() {
-	# @param an array name.
-	# @retval 0 if an array has been already declared by the name of
-	# the parameter.
-	[[ $# -eq 1 ]] || return 1
-	local array_name=$1
-	[[ "$(declare -p "$array_name" 2>/dev/null)" = \
-		"declare -"[aA]" $array_name="* ]]
-}
-
-__argsparse_has_array_item() {
-	# @param an array name.
-	# @retval 0 if an array has been already declared by the name of
-	# the parameter.
-	[[ $# = [12] ]] || return 1
-	local array_name=$1
-	local index=${2:-@}
-	local var="$array_name[$index]"
-	(
-		set +o nounset
-		[[ ${!var+set} = set ]]
-	)
-}
-
-__argsparse_check_requires() {
-	# @return the number of missing option detected, but this function
-	# actually stops are the first failing *list* of dependencies.
-	local option
-	local requirestring require count=0
-	local -a requires
-	for option in "${!program_options[@]}"
-	do
-		if ! requirestring="$(argsparse_has_option_property "$option" require)"
-		then
-			# No requirement for this option.
-			continue
-		fi
-		read -a requires <<<"$requirestring"
-		for require in "${requires[@]}"
-		do
-			if ! argsparse_is_option_set "$require"
-			then
-				printf >&2 "%s: --%s: requires option --%s.\n" \
-					"$argsparse_pgm" "$option" "$require"
-				: $((count++))
-			fi
-		done
-		[[ "$count" -ne 0 ]] && return "$count"
-	done
-	return 0
-}
-
-__argsparse_check_missing_options() {
-	# @retval 0 if all mandatory options have a value in
-	# program_options associative array.
-	local option count=0
-	for option in "${!__argsparse_options_descriptions[@]}"
-	do
-		argsparse_has_option_property "$option" mandatory || continue
-		# If option has been given, just iterate.
-		argsparse_is_option_set "$option" && continue
-		printf >&2 "%s: --%s: option is mandatory.\n" \
-			"$argsparse_pgm" "$option"
-		: $((count++))
-	done
-	[[ "$count" -eq 0 ]]
-}
-
-## @fn argsparse_check_option_type()
-## @brief Check if a value matches a given type.
-## @details Return True if @a value is of type @a type.
-## @param type A case-insensitive type name.
-## @param value a value to check.
-## @retval 0 if the value matches the given type format.
-argsparse_check_option_type() {
-	[[ $# -eq 2 ]] || return 1
-	local option_type=${1,,}
-	local value=$2
-	local t
-	case "$option_type" in
-		file|directory|pipe|terminal)
-			# [[ wont accept the -$var as an operator.
-			[ -"${option_type:0:1}" "$value" ]
-			;;
-		socket|link)
-			t=${option_type:0:1}
-			[ -"${t^^}" "$value" ]
-			;;
-		char)
-			[[ "$value" = ? ]]
-			;;
-		unsignedint|uint)
-			[[ "$value" = +([0-9]) ]]
-			;;
-		integer|int)
-			[[ "$value" = ?(-)+([0-9]) ]]
-			;;
-		hexa)
-			[[ "$value" = ?(0x)+([a-fA-F0-9]) ]]
-			;;
-		ipv4)
-			# Regular expression for ipv4 and ipv6 have been found on
-			# http://www.d-sites.com/2008/10/09/regex-ipv4-et-ipv6/
-			[[ "$value" =~ ^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ ]]
-			;;
-		ipv6)
-			[[ "$value" =~ ^((([0-9A-Fa-f]{1,4}:){7}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){6}:[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){5}:([0-9A-Fa-f]{1,4}:)?[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){4}:([0-9A-Fa-f]{1,4}:){0,2}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){3}:([0-9A-Fa-f]{1,4}:){0,3}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){2}:([0-9A-Fa-f]{1,4}:){0,4}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){6}((b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b).){3}(b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b))|(([0-9A-Fa-f]{1,4}:){0,5}:((b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b).){3}(b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b))|(::([0-9A-Fa-f]{1,4}:){0,5}((b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b).){3}(b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b))|([0-9A-Fa-f]{1,4}::([0-9A-Fa-f]{1,4}:){0,5}[0-9A-Fa-f]{1,4})|(::([0-9A-Fa-f]{1,4}:){0,6}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){1,7}:))$ ]]
-			;;
-		ip)
-			# Generic IP address.
-			argsparse_check_option_type ipv4 "$value" || \
-				argsparse_check_option_type ipv6 "$value"
-			;;
-		hostname)
-			# check if value resolv as an IPv4 or IPv6 address.
-			host -t a "$value" >/dev/null 2>&1 || \
-				host -t aaaa "$value" >/dev/null 2>&1
-			;;
-		host)
-			# An hostname or an IP address.
-			argsparse_check_option_type hostname "$value" || \
-				argsparse_check_option_type ipv4 "$value" || \
-				argsparse_check_option_type ipv6 "$value"
-			;;
-		portnumber)
-			argsparse_check_option_type uint "$value" && \
-				[[ "$value" -gt 0 && "$value" -le 65536 ]]
-			;;
-		port)
-			# Port number or service.
-			argsparse_check_option_type portnumber "$value" || \
-				getent services "$value" >/dev/null 2>&1
-			;;
-		username)
-			getent passwd "$value" >/dev/null 2>&1
-			;;
-		group)
-			getent group "$value" >/dev/null 2>&1
-			;;
-		date)
-			date --date "$value"  >/dev/null 2>&1
-			;;
-		*)
-			# Invoke user-defined type-checking function if available.
-			if ! declare -f "check_option_type_$option_type" >/dev/null
-			then
-				printf >&2 \
-					"%s: %s: type has no validation function. This is a bug.\n" \
-					"$argsparse_pgm" "$option_type"
-				return 2
-			fi
-			"check_option_type_$option_type" "$value"
-			;;
-	esac
-}
-
-## @fn __argsparse_parse_options_valuecheck()
-## @private
-## @brief Check a value given to an option.
-## @details If an enumeration has been defined for the option, check
-## against that. If there's no enumeration, but option has a type
-## property, then check against the type. In the end, check against
-## check_value_of_<option> function, if it's been defined.
-## @param option an option name.
-## @param value anything.
-## @retval 0 if value is correct for given option.
-__argsparse_parse_options_valuecheck() {
-	[[ $# -eq 2 ]] || return 1
-	local option=$1
-	local value=$2
-	local identifier possible_values option_type
-	identifier="$(argsparse_option_to_identifier "$option")"
-	if possible_values=$(__argsparse_values_array_identifier "$option")
-	then
-		__argsparse_index_of "$value" "${!possible_values}" >/dev/null || \
-			return 1
-	elif option_type=$(argsparse_has_option_property "$option" type)
-	then
-		argsparse_check_option_type "$option_type" "$value" || return 1
-	fi
-	if declare -f "check_value_of_$identifier" >/dev/null 2>&1
-	then
-		"check_value_of_$identifier" "$value" || return 1
-	fi
-	return 0
-}
-
-# Default behaviour is not to accept empty command lines.
-__argsparse_allow_no_argument=no
-
-## @fn argsparse_allow_no_argument()
-## @brief Allow empty command lines to run.
-## @details Change argsparse behaviour for empty command
-## lines. Default says "no argument triggers usage".
-## @param string if (case-insensitive) "yes", "true" or "1", the value
-## is considered as affirmative. Anything else is a negative value.
-## @retval 0 unless there's more than one parameter (or none).
-argsparse_allow_no_argument() {
-	[[ $# -eq 1 ]] || return 1
-	local param=$1
-	case "${param,,}" in
-		yes|true|1)
-			__argsparse_allow_no_argument=yes
-			;;
-		*)
-			__argsparse_allow_no_argument=no
-			;;
-	esac
-}
-
-if [[ ${ARGSPARSE_COMPLETION_MODE-} ]]
-then
-	shopt progcomp expand_aliases >/dev/null || exit 1
-	alias argsparse_parse_options='return 0 2>/dev/null || :'
-else
-## @fn argsparse_parse_options()
-## @brief Parse program options.
-## @details This function will make option parsing happen, and if an error
-## is detected, the usage() function will be invoked, if it has been
-## defined. If it's not defined, the function will return 1.
-## Parse options, and return if everything went fine.
-## @param parameters... should be the program arguments.
-## @retval 0 if the whole option parsing process went fine.
-## @retval 1 if an error is encoutered and usage does not perform an exit.
-	argsparse_parse_options() {
-		unset __argsparse_tmp_identifiers || :
-		__argsparse_parse_options_no_usage "$@" && return
-		# Something went wrong, invoke usage function, if defined.
-		declare -f usage >/dev/null 2>&1 && usage
-		return 1
-	}
-fi
-
-__argsparse_parse_options_prepare_exclude() {
-	# Check for all "exclude" properties, and fill "exclusions"
-	# associative array, which should have been declared in
-	# __argsparse_parse_options_no_usage.
-	local option exclude excludestring
-	local -a excludes
-	for option in "${!__argsparse_options_descriptions[@]}"
-	do
-		excludestring=$(argsparse_has_option_property "$option" exclude) || \
-			continue
-		exclusions["$option"]+="${exclusions["$option"]:+ }$excludestring"
-		# Re-split the string. (without involving anything else)
-		read -a excludes <<<"$excludestring"
-		for exclude in "${excludes[@]}"
-		do
-			exclusions["$exclude"]+="${exclusions["$exclude"]:+ }$option"
-		done
-	done
-}
-
-__argsparse_parse_options_check_exclusions() {
-	# Check if two options presents on the command line are mutually
-	# exclusive. Prints the "other" option if it's the case.
-	# @param an option
-	# @return 0 if the given option has actually excluded by annother
-	# already-given option.
-	[[ $# -eq 1 ]] || return 1
-	local new_option=$1
-	local option
-
-	for option in "${!program_options[@]}"
-	do
-		if [[ "${exclusions["$option"]-}" =~ ^(.* )?"$new_option"( .*)?$ ]]
-		then
-			printf %s "$option"
-			return 0
-		fi
-	done
-	return 1
-}
-
-## @fn argsparse_short_to_long()
-## @brief
-## @param char a short option letter
-## @return if found, the long option name matching given short option
-## letter.
-argsparse_short_to_long() {
-	[[ $# -eq 1 ]] || return 1
-	local char=$1
-	local long=${__argsparse_short_options[$char]}
-	[[ -n "$long" ]] && printf %s "$long"
-}
-
-## @fn __argsparse_set_option()
-## @private
-## @brief Resolv option-specific setter function and invoke it.
-## @details Check if a user-defined option setting function
-## (set_option_<optionname>) has been defined or if the generic
-## argsparse_set_option() function is to be used. Then invoke the that
-## function with the option name as first parameter. If a value for
-## the option is involved, it is passed as a second parameter.
-## @param option an option name.
-## @return the setter function return code
-## @ingroup ArgsparseOptionSetter
-__argsparse_set_option() {
-	[[ $# -eq 1 || $# -eq 2 ]] || return 1
-	local option=$1
-	local set_hook identifier
-	[[ $# -ne 2 ]] || local value=$2
-	# The "identifier string" matching next_param, suitable for
-	# variable or function names.
-	identifier="$(argsparse_option_to_identifier "$option")"
-	# If user has defined a specific setting hook for given the
-	# option, then use it, else use default standard
-	# option-setting function.
-	if declare -f "set_option_$identifier" >/dev/null 2>&1
-	then
-		set_hook="set_option_$identifier"
-	else
-		set_hook=argsparse_set_option
-	fi
-	# Invoke setting hook, and if it returns some non-zero status,
-	# send the user back to usage, if declared, and return with error.
-	# The specific $value substitution, here, is to distinguish an
-	# empty value from a no-value.
-	"$set_hook" "$option" ${value+"$value"}
-}
-
-__argsparse_parse_options_no_usage() {
-	# This function re-set program_params array values. This function
-	# will also modify the program_options associative array.
-	# If any error happens, this function will return 1.
-
-	# Be careful, the function is (too) big.
-
-	local long short getopt_temp next_param set_hook option_type
-	local next_param_identifier exclude value char
-	local -a longs_array
-	local -A exclusions
-	# The getopt parameters.
-	local longs shorts option
-
-	# No argument sends back to usage, if defined.
-	if [[ $# -eq 0 && "$__argsparse_allow_no_argument" != yes ]]
-	then
-		return 1
-	fi
-
-	# 1. Analyze declared options to create getopt valid arguments.
-	for long in "${!__argsparse_options_descriptions[@]}"
-	do
-		if argsparse_has_option_property "$long" value
-		then
-			longs_array+=( "$long:" )
-		else
-			longs_array+=( "$long" )
-		fi
-	done
-
-	# 2. Create the long options string.
-	longs="$(__argsparse_join_array , "${longs_array[@]}")"
-
-	# 3. Create the short option string.
-	for short in "${!__argsparse_short_options[@]}"
-	do
-		if argsparse_has_option_property \
-			"${__argsparse_short_options[$short]}" value
-		then
-			shorts+="$short:"
-		else
-			shorts+=$short
-		fi
-	done
-
-	# 4. Invoke getopt and replace arguments.
-	if ! getopt_temp=$(getopt -s bash -n "$argsparse_pgm" \
-		--longoptions="$longs" "$shorts" "$@")
-	then
-		# Syntax error on the command implies returning with error.
-		return 1
-	fi
-	eval set -- "$getopt_temp"
-
-	# 5. Prepare exclusions stuff.
-	__argsparse_parse_options_prepare_exclude
-
-	# 6. Arguments parsing is really made here.
-	while [[ $# -ge 1 ]]
-	do
-		next_param=$1
-		shift
-		# The regular exit case.
-		if [[ "$next_param" = -- ]]
-		then
-			# Check how many parameters we have and if it's at least
-			# what we expects.
-			if [[ $# -lt "$__argsparse_minimum_parameters" ]]
-			then
-				printf >&2 \
-					"%s: not enough parameters (at least %d expected, %d provided)\n" \
-					"$argsparse_pgm" "$__argsparse_minimum_parameters" $#
-				return 1
-			elif [[ $# -gt "$__argsparse_maximum_parameters" ]]
-			then
-				printf >&2 \
-					"%s: too many parameters (maximum allowed is %d, %d provided)\n" \
-					"$argsparse_pgm" "$__argsparse_maximum_parameters" $#
-				return 1
-			fi
-			# Save program parameters in array
-			program_params=( "$@" )
-
-			# Apply default values here
-			for option in "${!__argsparse_options_default_values[@]}"
-			do
-				if ! argsparse_is_option_set "$option"
-				then
-					argsparse_set_option "$option" \
-						"${__argsparse_options_default_values[$option]}"
-				fi
-			done
-
-			# If some mandatory option have been omited by the user, then
-			# print some error, and invoke usage.
-			# Also checks requires chains.
-			__argsparse_check_missing_options && __argsparse_check_requires
-			return
-		fi
-		# If a short option was given, then we first convert it to its
-		# matching long name.
-		if [[ "$next_param" = -[!-] ]]
-		then
-			char=${next_param#-}
-			if ! next_param=$(argsparse_short_to_long "$char")
-			then
-				# Short option without equivalent long. According to
-				# current implementation, this should be considered as
-				# a bug.
-				printf >&2 \
-					"%s: -%s: option doesnt have any matching long option." \
-					"$argsparse_pgm" "$char"
-				return 1
-			fi
-		else
-			# Wasnt a short option. Just strip the leading dash.
-			next_param=${next_param#--}
-		fi
-		if exclude=$(__argsparse_parse_options_check_exclusions "$next_param")
-		then
-			printf >&2 \
-				"%s: %s: option excluded by other option (%s).\n" \
-				"$argsparse_pgm" "$next_param" "$exclude"
-			return 1
-		fi
-		# Set option value, if there should be one.
-		if argsparse_has_option_property "$next_param" value
-		then
-			value=$1
-			shift
-			if ! __argsparse_parse_options_valuecheck "$next_param" "$value"
-			then
-				printf >&2 "%s: %s: Invalid value for option %s.\n" \
-					"$argsparse_pgm" "$value" "$next_param"
-				return 1
-			fi
-		fi
-		# Invoke setting hook, and if it returns returns some non-zero
-		# status, send the user back to usage, if declared, and return
-		# with error.
-		# The specific $value substitution, here, is to distinguish an
-		# empty value from a no-value.
-		if ! __argsparse_set_option "$next_param" ${value+"$value"}
-		then
-			printf >&2 "%s: %s: Invalid value for %s option.\n" \
-				"$argsparse_pgm" "$value" "$next_param"
-			return 1
-		fi
-		unset value
-	done
-	return 0
-}
-
-## @var AssociativeArray program_options
-## @brief Options values.
-## @details
-## After argsparse_parse_options(), it will contain (if no hook is set
-## for "optionname")
-## - "optionname" -> "value", if "optionname" accepts a value.
-## - "optionname" -> "how many times the option has been detected on
-## .
-## the command line", else.
-declare -A program_options=()
-
-## @var Array program_params
-## @brief Positionnal parameters of the script
-## @details
-## After argsparse_parse_options(), it will contain all non-option
-## parameters. (Typically, everything found after the '--')
-declare -a program_params=()
-
-## @var AssociativeArray __argsparse_options_properties
-## @private
-## @brief Internal use only.
-## @ingroup ArgsparseProperty
-declare -A __argsparse_options_properties=()
-
-## @fn argsparse_set_option_property()
-## @brief Enable a property to a list of options.
-## @param property a property name.
-## @param option... option names.
-## @return non-zero if property is not supported.
-## @ingroup ArgsparseProperty
-argsparse_set_option_property() {
-	[[ $# -ge 2 ]] || return 1
-	local property=$1
-	shift
-	local option p short
-	for option in "$@"
-	do
-		case "$property" in
-			cumulative|cumulativeset)
-				argsparse_set_option_property value "$option"
-				;;&
-			type:*|exclude:*|alias:*|require:*)
-				if [[ "$property" =~ ^.*:(.+)$ ]]
-				then
-					# If property has a value, check its format, we
-					# dont want any funny chars.
-					if [[ "${BASH_REMATCH[1]}" = *[*?!,]* ]]
-					then
-						printf >&2 "%s: %s: invalid property value.\n" \
-							"$argsparse_pgm" "${BASH_REMATCH[1]}"
-						return 1
-					fi
-				fi
-				;&
-			mandatory|hidden|value|cumulative|cumulativeset)
-				# We use the comma as the property character separator
-				# in the __argsparse_options_properties array.
-				p=${__argsparse_options_properties["$option"]:-}
-				__argsparse_options_properties["$option"]="${p:+$p,}$property"
-				;;
-			short:?)
-				short=${property#short:}
-				if __argsparse_has_array_item \
-					__argsparse_short_options "$short"
-				then
-					printf >&2 \
-						"%s: %s: short option for %s conflicts with already-configured short option for %s.\n" \
-						"$argsparse_pgm" "$short" "$option" \
-						"${__argsparse_short_options[$short]}"
-					return 1
-				fi
-				__argsparse_short_options["$short"]=$option
-				;;
-			default:*)
-				# The default value
-				__argsparse_options_default_values["$option"]=${property#default:}
-				;;
-			*)
-				return 1
-				;;
-		esac
-	done
-}
-
-## @fn argsparse_has_option_property()
-## @brief Determine if an option has a property.
-## @details Return True if property has been set for given option, and
-## print the property value, if available.
-## @param option an option name.
-## @param property a property name.
-## @retval 0 if option has given property.
-## @ingroup ArgsparseProperty
-argsparse_has_option_property() {
-	[[ $# -eq 2 ]] || return 1
-	local option=$1
-	local property=$2
-	local p=${__argsparse_options_properties["$option"]:-""}
-
-	if [[ "$p" =~ (^|.+,)"$property"(:([^,]+))?($|,.+) ]]
-	then
-		printf %s "${BASH_REMATCH[3]}"
-	elif [[ $property = default && \
-		"${__argsparse_options_default_values[$option]+yes}" = yes ]]
-	then
-			print %s "${__argsparse_options_default_values[$option]}"
-	else
-		return 1
-	fi
-}
-
-# Association short option -> long option.
-## @var AssociativeArray __argsparse_short_options
-## @private
-## @brief Internal use only.
-declare -A __argsparse_short_options=()
-
-# @fn __argsparse_optstring_has_short()
-# @brief Internal use only.
-# @details Prints the short option string suitable for getopt command
-# line.
-# @param optstring an optstring
-# @return non-zero if given optstring doesnt have any short option
-# equivalent.
-__argsparse_optstring_has_short() {
-	[[ $# -eq 1 ]] || return 1
-	local optstring=$1
-	if [[ "$optstring" =~ .*=(.).* ]]
-	then
-		printf %c "${BASH_REMATCH[1]}"
-		return 0
-	fi
-	return 1
-}
-
-
-## @var AssociativeArray __argsparse_tmp_identifiers
-## @private
-## @brief Internal use
-declare -A __argsparse_tmp_identifiers=()
-# Used to verify declared options do not conflict. Is unset after
-# argsparse_parse_options().
-
-
-# @fn __argsparse_check_declaration_conflict()
-# @brief Internal use.
-# @details Check if an option conflicts with another and, if it does,
-# prints the conflicted option.
-# @param option an option name
-# @return True if option *does* conflict with a previously declared
-# option.
-__argsparse_check_declaration_conflict() {
-	[[ $# -eq 1 ]] || return 1
-	local option=$1
-	local identifier=$(argsparse_option_to_identifier "$option")
-	local -a identifiers=("${!__argsparse_tmp_identifiers[@]}")
-	local conflict
-	if __argsparse_has_array_item identifiers && \
-		   conflict=$(__argsparse_index_of "$identifier" "${identifiers[@]}")
-	then
-		printf %s "${__argsparse_tmp_identifiers[${identifiers[$conflict]}]}"
-		return 0
-	fi
-	__argsparse_tmp_identifiers["$identifier"]=$option
-	return 1
-}
-
-## @fn argsparse_use_option()
-## @brief Define a @b new option.
-## @param optstring an optstring.
-## @param description the option description, for the usage() function.
-## @param property... an non-ordered list of keywords. Recognized
-## property keywords are:
-##   - mandatory: missing option will trigger usage. If a default
-##     value is given, the option is considered as if provided on
-##     the command line.
-##   - hidden: option wont show in default usage function.
-##   - value: option expects a following value.
-##   - short:c: option has a single-lettered (c) equivalent.
-##   - exclude:"option1 [ option2 ... ]" option is not
-##   compatible with other options option1, option2...
-##   - cumulative
-##   - cumulativeset
-##   - type:sometype
-##   - The @b last non-keyword parameter will be considered as the
-##     default value for the option. All other parameters and
-##     values will be ignored. - might be broken / obsolete and broken
-## @retval 0 if no error is encountered.
-## @retval 2 if option name is bad (a message will be printed)
-## @retval 3 if option name conflicts with another option (a message
-## will be printed)
-## @retval 4 if a wrong property name is provided. (a message will be
-## printed)
-argsparse_use_option() {
-	[[ $# -ge 2 ]] || return 1
-	local optstring=$1
-	local description=$2
-	shift 2
-	local long short conflict
-	# configure short option.
-	if short=$(__argsparse_optstring_has_short "$optstring")
-	then
-		set -- "short:$short" "$@"
-		optstring=${optstring/=/}
-	fi
-	# --$optstring expect an argument.
-	if [[ "$optstring" = *: ]]
-	then
-		set -- value "$@"
-		long=${optstring%:}
-	else
-		long=$optstring
-	fi
-
-	if [[ "$long" = *[!-0-9a-zA-Z_]* ]]
-	then
-		printf >&2 "%s: %s: bad option name.\n" "$argsparse_pgm" "$long"
-		return 2
-	fi
-
-	if conflict=$(__argsparse_check_declaration_conflict "$long")
-	then
-		printf >&2 "%s: %s: option conflicts with already-declared %s.\n" \
-			"$argsparse_pgm" "$long" "$conflict"
-		return 3
-	fi
-
-	__argsparse_options_descriptions["$long"]=$description
-
-	# Any other parameter to this function should be a property.
-	while [[ $# -ne 0 ]]
-	do
-		if ! argsparse_set_option_property "$1" "$long"
-		then
-			printf >&2 '%s: %s: unknown property.\n' "$argsparse_pgm" "$1"
-			return 4
-		fi
-		shift
-	done
-}
-
-## @fn argsparse_option_description()
-## @brief Prints to stdout the description of given option.
-## @param option an option name.
-## @retval 0 if given option has been previously declared.
-argsparse_option_description() {
-	[[ $# -eq 1 ]] || return 1
-	local option=$1
-	[[ -n "${__argsparse_options_descriptions[$option]+yes}" ]] && \
-		printf %s "${__argsparse_options_descriptions[$option]}"
-}
-
-## @fn argsparse_is_option_set()
-## @brief Return True if an option has been set on the command line.
-## @param option an option name.
-## @retval 0 if given option has been set on the command line.
-argsparse_is_option_set() {
-	[[ $# -eq 1 ]] || return 1
-	local option=$1
-	[[ -n "${program_options[$option]+yes}" ]]
-}
-
-
-# @private
-# @fn __argsparse_max_length()
-# @details Prints the length of the longest argument _or_ 50.
-# @brief Internal use.
-# @param string... a list of strings
-# @return 0
-__argsparse_max_length() {
-	local max=50
-	shift
-	local max_length=0 str
-	for str in "$@"
-	do
-		max_length=$((max_length>${#str}?max_length:${#str}))
-	done
-	printf %d "$((max_length>max?max:max_length))"
-}
-
-## @fn argsparse_report()
-## @brief Prints a basic report of all passed options
-## @details Kinda useful for a --debug, or a --verbose option,
-## this function will print options and their values.
-## @param option... A list of option name. If omitted all options
-## will be displayed.
-## @retval 0
-argsparse_report() {
-	local option array_name value
-	local length=$(__argsparse_max_length "${!__argsparse_options_descriptions[@]}")
-	local -a array options
-
-	if __argsparse_is_array_declared __argsparse_tmp_identifiers
-	then
-		# The test is a bit hacky, but it avoids implementing another
-		# mechanism.
-		printf "argsparse_parse_option was not ran yet.\n"
-	fi
-
-	if [[ $# -eq 0 ]]
-	then
-		options=( "${!__argsparse_options_descriptions[@]}" )
-	else
-		options=( "$@" )
-	fi
-	for option in "${options[@]}"
-	do
-		argsparse_has_option_property "$option" hidden && continue
-		printf "%- ${length}s\t: " "$option"
-		if argsparse_is_option_set "$option"
-		then
-			printf "yes (%s" "${program_options[$option]}"
-			if argsparse_has_option_property "$option" cumulative || \
-				argsparse_has_option_property "$option" cumulativeset
-			then
-				array_name="$(argsparse_get_cumulative_array_name "$option")[@]"
-				array=( "${!array_name}" )
-				printf ' time(s):'
-				for value in "${array[@]}"
-				do
-					printf ' %q' "$value"
-				done
-			fi
-			printf ')\n'
-		else
-			printf 'no\n'
-		fi
-	done
-}
-
-# "Main" stuff.
-
-
-# We do define a default --help option.
-argsparse_use_option "=help" "Show this help message"
-
-return 0 >/dev/null 2>&1 ||:
-
-printf "The %s file is not a standalone program. It's a shell library.\n" \
-	"$argsparse_pgm"
-printf "%s\n" \
-	"To use it, you have to load it in your own bash" \
-	"shell scripts using the following line:"
-printf "\n. %q\n\n" "$0"
diff --git a/src/00_head b/src/00_head
new file mode 100644
index 0000000..12b8c93
--- /dev/null
+++ b/src/00_head
@@ -0,0 +1,312 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+#
+#########
+# License:
+#
+#             DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#                    Version 2, December 2004
+#
+# Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+#
+# Everyone is permitted to copy and distribute verbatim or modified
+# copies of this license document, and changing it is allowed as long
+# as the name is changed.
+#
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+#
+#  0. You just DO WHAT THE FUCK YOU WANT TO.
+#
+#########
+#
+## @file
+## @author Damien Nadé <bash-argsparse@livna.org>
+## @copyright WTFPLv2
+## @version 1.8
+## @brief Bash Argsparse Library
+## @details
+## @par URL
+## https://github.com/Anvil/bash-argsparse @n
+##
+## @par Purpose
+##
+## To replace the option-parsing and usage-describing functions
+## commonly rewritten in all scripts.
+##
+## @note
+## This library is implemented for bash version 4. Prior versions of
+## bash will fail at interpreting that code.
+## @note
+## The extglob shell option will be enabled and posix mode will be
+## disabled when loading the library. Changing those settings
+## afterwards will make the library execution fail.
+##
+## @par Usage
+## Use the argsparse_use_option() function to declare your options with
+## their single letter counterparts, along with their description.
+##
+## @par
+## The argsparse_use_option() syntax is:
+##
+## @code
+##     argsparse_use_option "optstring" "option description string" \
+##     [ "property" ... ] [ "optional default value" ]
+## @endcode
+##
+##
+## @par
+## An "optstring" is of the form "som=estring:". This would declare a
+## long option named somestring. The ending ":" is optional and, if
+## present, means the long option expects a value on the command
+## line. The "=" char is also optional and means the immediatly
+## following letter is the short single-letter equivalent option of
+## --something.
+##
+## @par
+## The "something" string must only contains ASCII
+## letters/numbers/dash/underscore characters.
+##
+## @note
+## What is referred later as "option" or "option name" (or even "long
+## option name") is the optstring without the ':' and '=' characters.
+##
+##
+##
+## @par Options may have properties.
+##
+## Properties are set either at option declarations through the
+## argsparse_use_option() function, or using the
+## argsparse_set_option_property() function
+##
+## The currently supported properties are:
+##
+## - "hidden" @n
+## 	 An hidden option will not be shown in usage.
+##
+## - "mandatory" @n
+## 	 An option marked as mandatory is required on the command line. If
+##   a mandatory option is omited by the user, usage() will be
+##   triggered by argsparse_parse_options().
+##
+## - "value" @n
+##   On the command line, the option will require a value.
+## 	 Same effect if you end your optstring with a ':' char.
+##
+## - "default:<defaultvalue>" @n
+## 	 The default value for the option.
+##
+## - "short:<char>" @n
+##   The short single-letter equivalent of the option.
+##
+## - "type:<typename>" @n
+##   Give a type to the option value. User input value will be checked
+## 	 against built-in type verifications _or_ the
+## 	 "check_type_<typename>" function. You cannot override a built-in
+## 	 type. Built-in types are:
+##   - file
+##   - directory
+##   - pipe
+##   - terminal
+##   - socket
+##   - link
+##   - char
+##   - unsignedint
+##   - uint
+##   - integer
+##   - int
+##   - hexa
+##   - ipv4
+##   - ipv6
+##   - ip
+##   - hostname
+##   - host
+##   - portnumber
+##   - port
+##   - username
+##   - group
+##   - date
+##   .
+##
+## - "exclude:<option> <option>" @n
+##   The exclude property value is a space-separated list of other
+##   options. User wont be able to provided two mutually exclusive
+##   options on the command line. @n
+##
+##   e.g: if you set exclude property for the --foo option this way:
+##   @code argsparse_set_option_property "exclude:opt1 opt2" foo @endcode
+##   Then --opt1 and --foo are not allowed on the same command line
+##   invokation. And same goes for --opt2 and --foo.
+##   This foo exclude property setting wouldnt make --opt1 and --opt2,
+##   mutually exclusive though.
+##
+## - "alias:<option> <option>" @n
+##   This property allows an option to set multiple other without-value
+##   options instead. Recursive aliases are permitted but no loop
+##   detection is made, so be careful. @n
+##   e.g: if you declare an option 'opt' like this:
+##   @code argsparse_use_option opt "my description" "alias:opt1 opt2" @endcode
+##   Then if the user is doing --opt on the command line, it will be as
+##   if he would have done --opt1 --opt2
+##
+## - cumulative @n
+##   Implies 'value'.
+##   Everytime a cumulative option "optionname" is passed on the
+##   command line, the value is stored at the end of an array named
+##   "cumulated_values_<optionname>". @n
+##
+##   e.g: for a script with an opt1 option declared this way:
+##   @code argsparse_use_option opt1 "some description" cumulative @endcode
+##   and invoked with:
+##   @code --opt1 value1 --opt1 value2 @endcode
+##   after argsparse_parse_options(), "${cumulated_values_opt1[0]}" will
+##   expand to value1, and ${cumulated_values_opt1[1]} will expand to
+##   value2.
+##
+## - cumulativeset @n
+##   Exactly like cumulative, except only uniq values are kept. @n
+##
+##   e.g: for a script with an opt1 option declared this way:
+##   @code argsparse_use_option opt1 "some description" cumulativeset @endcode
+##   and invoked with:
+##   @code --opt1 value1 --opt1 value2 --opt1 value1 @endcode
+##   after argsparse_parse_options(), "${cumulated_values_opt1[0]}" will
+##   expand to value1, and "${cumulated_values_opt1[1]}" will expand to
+##   value2. There would be no "${cumulated_values_opt1[2]}" value.
+##
+## - "require:<option> <option>" @n
+##   Creates a dependency between options. if you declare an option with:
+##   @code
+##   argsparse_use_option opt1 "something" require:"opt2 opt3"
+##   @endcode
+##   argsparse_parse_options() would return with an error if "--opt1"
+##   is given on the commande line without "--opt2" or without "--opt3".
+##
+## @par
+## You can test if an option has a property using the
+## argsparse_has_option_property() function.
+## @code argsparse_has_option_property <option> <property> @endcode
+##
+##
+## @par Parsing positionnal parameters
+## After the options are declared, invoke the function
+## argsparse_parse_options() with the all script parameters. This will
+## define:
+##
+## - program_params, an array, containing all non-option parameters.
+##
+## - program_options, an associative array. For each record of the
+##   array:
+##   - The key is the long option name.
+##   - And about values:
+##     - If option doesn't expect a value on the command line, the
+##       value represents how many times the option has been
+##       found on the command line
+##
+##     - If option does require a value, the array record value is the
+##       value of the last occurence of the option found on the command
+##       line.
+##     .
+##   - If option is cumulative (or cumulativeset), the array record
+##     value is the number of values passed by the user.
+##   .
+##
+## After argsparse_parse_options() invokation, you can check if an
+## option have was on the command line (or not) using the
+## argsparse_is_option_set() function. @n
+##
+## e.g:
+## @code argsparse_is_option_set "long-option-name" @endcode
+##
+##
+## @par The "usage()" function
+## If a 'usage' function is defined, and shall
+## argsparse_parse_options() return with non-zero status, 'usage' will
+## be automatically called.
+##
+## @note
+## This library automatically defines a default 'usage' function,
+## which may be removed or overridden by the sourcing program
+## afterwards.
+##
+## @par Value setting internal logic
+## During option parsing, for every option of the form '--optionname'
+## expecting a value:
+##
+## - If there exists an array named "option_<optionname>_values" and
+##   the user-given value doesn't belong to that array, then the
+##   argsparse_parse_options() function immediately returns with
+##   non-zero status, triggering 'usage'.
+##
+## - If the "option_<optionname>_values" array does not exist, but if
+##   the option has a type property field, then the value format will
+##   be checked against that type.
+##
+## - If a function named "check_value_of_<optionname>" has been
+##   defined, it will be called with the user-given value as its first
+##   positionnal parameter. If check_value_of_<optionname> returns
+##   with non-zero status, then parse_option immediately returns with
+##   non-zero status, triggering the 'usage' function.
+##
+## @par
+## Also, still during option parsing and for @b every option of the form
+## "--optionname":
+##
+## - After value-checking, if a function named
+##   "set_option_<optionname>" exists, then, instead of directly
+##   modifying the "program_options" associative array, this function
+##   is automatically called with 'optionname' as its first
+##   positionnal parameter, and, if 'optionname' expected a value, the
+##   value is given as the function second positionnal parameter.
+##
+## @par About functions return values...
+##
+## All argsparse functions will return with an error (usually a return
+## code of 1) if called with a wrong number of parameters, and return
+## with 0 if everything went fine.
+##
+## @defgroup ArgsparseUsage Calling program usage description message.
+## @defgroup ArgsparseOptionSetter Setting options values.
+## @defgroup ArgsparseCLIParsing ...
+## @defgroup ArgsparseProperty Options properties handling.
+## @defgroup ArgsparseParameter Non-optional positionnal parameters.
+## @defgroup ArgsparseUtils Misc Functions.
+## @defgroup ArgsparseOptionTyping ...
+
+# We're not compatible with older bash versions.
+if [[ "$BASH_VERSINFO" -lt 4 ]]
+then
+	printf >&2 "This requires bash >= 4 to run.\n"
+	return 1 2>/dev/null
+	exit 1
+fi
+
+if ! command -v getopt >/dev/null 2>&1
+then
+	printf >&2 "Cannot find the getopt command.\n"
+	return 1 2>/dev/null
+	exit 1
+fi
+
+if declare -rp ARGSPARSE_VERSION >/dev/null 2>&1
+then
+	# argsparse is already loaded.
+	return 0 2>/dev/null
+fi
+
+## @var ARGSPARSE_VERSION
+## @brief argsparse version number
+## @showinitializer
+declare -r ARGSPARSE_VERSION=1.8
+
+# Enable required features
+shopt -s extglob
+set +o posix
+
+## @brief The name of the program currently using argsparse.
+## @details Automatically set by argsparse at load time, it contains
+## the basename (path-less but with extension, if any) of the main
+## script. Used internally to print error messages and by
+## usage-related functions, but can be used by the loading script.
+## @hideinitializer
+declare -r argsparse_pgm=${0##*/}
diff --git a/src/10_utils b/src/10_utils
new file mode 100644
index 0000000..0218f50
--- /dev/null
+++ b/src/10_utils
@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @fn __argsparse_index_of()
+## @param value a value
+## @param values... array values
+## @brief Tells if a value is found in a set of other values.
+## @details Look for @a value and print its position in the @a values
+## set. Return false if it can not be found.
+## @retval 0 if @a value is amongst @a values
+## @retval 1 if @a value is not found.
+## @ingroup ArgsparseUtils
+__argsparse_index_of() {
+	[[ $# -ge 2 ]] || return 1
+	local key=$1 ; shift
+	local index=0
+	local elem
+	for elem in "$@"
+	do
+		if [[ "$key" = "$elem" ]]
+		then
+			printf %s "$index"
+			return 0
+		fi
+		: $((index++))
+	done
+	return 1
+}
+
+## @fn __argsparse_join_array()
+## @param c a single char
+## @param strings... strings to join
+## @brief join multiple strings by a char.
+## @details Like the 'str.join' string method in python, join multiple
+## strings by a char. Only work with a single char, though.
+## @retval 1 if first parameter is invalid.
+## @retval 0 else.
+## @ingroup ArgsparseUtils
+__argsparse_join_array() {
+	[[ $# -ge 1 && $1 = ? ]] || return 1
+	local IFS="$1$IFS"
+	shift
+	printf %s "$*"
+}
+
+
+# @private
+# @fn __argsparse_max_length()
+# @details Prints the length of the longest argument _or_ 50.
+# @brief Internal use.
+# @param string... a list of strings
+# @return 0
+__argsparse_max_length() {
+	local max=50
+	shift
+	local max_length=0 str
+	for str in "$@"
+	do
+		max_length=$((max_length>${#str}?max_length:${#str}))
+	done
+	printf %d "$((max_length>max?max:max_length))"
+}
+
+
+## @fn __argsparse_is_array_declared()
+## @param name A potential array name
+## @retval 0 if an array named after the parameter does exist
+## @ingroup ArgsparseUtils
+__argsparse_is_array_declared() {
+	[[ $# -eq 1 ]] || return 1
+	local array_name=$1
+	[[ "$(declare -p "$array_name" 2>/dev/null)" = \
+		"declare -"[aA]" $array_name="* ]]
+}
+
+
+## @fn __argsparse_has_array_item()
+## @param array_name an array name.
+## @param item an item key.
+## @retval 0 if an array has been already declared by the name of
+## the parameter AND if said array holds given key.
+## @ingroup ArgsparseUtils
+__argsparse_has_array_item() {
+	[[ $# = [12] ]] || return 1
+	local array_name=$1
+	local index=${2:-@}
+	local var="$array_name[$index]"
+	(
+		set +o nounset
+		[[ ${!var+set} = set ]]
+	)
+}
diff --git a/src/15_misc b/src/15_misc
new file mode 100644
index 0000000..488f817
--- /dev/null
+++ b/src/15_misc
@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @fn argsparse_option_to_identifier()
+## @brief Give the identifier name associated to an option.
+## @details Transforms and prints an option name into a string which
+## suitable to be part of a function or a variable name.
+## @param option an option name.
+## @ingroup ArgsparseUtils
+argsparse_option_to_identifier() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	printf %s "${option//-/_}"
+}
+
+
+## @fn __argsparse_values_array_identifier()
+## @private
+## @brief Prints the name of the array containing all user-declared
+## acceptable values for an option.
+## @details from "opt" or "opt-name" string, prints
+## "option_opt_values[@]" or "option_opt_name_values[@]", unless array
+## is not declared, in which case function will return an error.
+## @param option an option name.
+## @retval 1 if array has not been declared
+## @retval 0 else. Array name will be written to stdout.
+## @ingroup ArgsparseUtils
+__argsparse_values_array_identifier() {
+	local option=$1
+	local array="option_$(argsparse_option_to_identifier "$option")_values"
+	__argsparse_is_array_declared "$array" || return 1
+	printf %s'[@]' "$array"
+}
diff --git a/src/19_option-property b/src/19_option-property
new file mode 100644
index 0000000..e7ca784
--- /dev/null
+++ b/src/19_option-property
@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @brief Internal use only.
+## @details An associative array where options default values are
+## stored as soon as the 'default:' property is set.
+## @ingroup ArgsparseProperty
+declare -A __argsparse_options_default_values=()
+
+
+## @var AssociativeArray __argsparse_options_properties
+## @private
+## @brief Internal use only.
+## @ingroup ArgsparseProperty
+declare -A __argsparse_options_properties=()
+
+
+# Association short option -> long option.
+## @var AssociativeArray __argsparse_short_options
+## @private
+## @brief Internal use only.
+declare -A __argsparse_short_options=()
+
+
+# @fn __argsparse_optstring_has_short()
+# @brief Internal use only.
+# @details Prints the short option string suitable for getopt command
+# line.
+# @param optstring an optstring
+# @return non-zero if given optstring doesnt have any short option
+# equivalent.
+__argsparse_optstring_has_short() {
+	[[ $# -eq 1 ]] || return 1
+	local optstring=$1
+	if [[ "$optstring" =~ .*=(.).* ]]
+	then
+		printf %c "${BASH_REMATCH[1]}"
+		return 0
+	fi
+	return 1
+}
+
+
+## @fn argsparse_set_option_property()
+## @brief Enable a property to a list of options.
+## @param property a property name.
+## @param option... option names.
+## @return non-zero if property is not supported.
+## @ingroup ArgsparseProperty
+argsparse_set_option_property() {
+	[[ $# -ge 2 ]] || return 1
+	local property=$1
+	shift
+	local option p short
+	for option in "$@"
+	do
+		case "$property" in
+			cumulative|cumulativeset)
+				argsparse_set_option_property value "$option"
+				;;&
+			type:*|exclude:*|alias:*|require:*)
+				if [[ "$property" =~ ^.*:(.+)$ ]]
+				then
+					# If property has a value, check its format, we
+					# dont want any funny chars.
+					if [[ "${BASH_REMATCH[1]}" = *[*?!,]* ]]
+					then
+						printf >&2 "%s: %s: invalid property value.\n" \
+							"$argsparse_pgm" "${BASH_REMATCH[1]}"
+						return 1
+					fi
+				fi
+				;&
+			mandatory|hidden|value|cumulative|cumulativeset)
+				# We use the comma as the property character separator
+				# in the __argsparse_options_properties array.
+				p=${__argsparse_options_properties["$option"]:-}
+				__argsparse_options_properties["$option"]="${p:+$p,}$property"
+				;;
+			short:?)
+				short=${property#short:}
+				if __argsparse_has_array_item \
+					__argsparse_short_options "$short"
+				then
+					printf >&2 \
+						"%s: %s: short option for %s conflicts with already-configured short option for %s.\n" \
+						"$argsparse_pgm" "$short" "$option" \
+						"${__argsparse_short_options[$short]}"
+					return 1
+				fi
+				__argsparse_short_options["$short"]=$option
+				;;
+			default:*)
+				# The default value
+				__argsparse_options_default_values["$option"]=${property#default:}
+				;;
+			*)
+				return 1
+				;;
+		esac
+	done
+}
+
+## @fn argsparse_has_option_property()
+## @brief Determine if an option has a property.
+## @details Return True if property has been set for given option, and
+## print the property value, if available.
+## @param option an option name.
+## @param property a property name.
+## @retval 0 if option has given property.
+## @ingroup ArgsparseProperty
+argsparse_has_option_property() {
+	[[ $# -eq 2 ]] || return 1
+	local option=$1
+	local property=$2
+	local p=${__argsparse_options_properties["$option"]:-""}
+
+	if [[ "$p" =~ (^|.+,)"$property"(:([^,]+))?($|,.+) ]]
+	then
+		printf %s "${BASH_REMATCH[3]}"
+	elif [[ $property = default && \
+		"${__argsparse_options_default_values[$option]+yes}" = yes ]]
+	then
+			print %s "${__argsparse_options_default_values[$option]}"
+	else
+		return 1
+	fi
+}
+
+
+## @fn argsparse_short_to_long()
+## @brief
+## @param char a short option letter
+## @return if found, the long option name matching given short option
+## letter.
+argsparse_short_to_long() {
+	[[ $# -eq 1 ]] || return 1
+	local char=$1
+	local long=${__argsparse_short_options[$char]}
+	[[ -n "$long" ]] && printf %s "$long"
+}
diff --git a/src/20_declaration b/src/20_declaration
new file mode 100644
index 0000000..56a089b
--- /dev/null
+++ b/src/20_declaration
@@ -0,0 +1,121 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+# This is an associative array. It should contains records of the form
+# "something" -> "Some usage description string".
+# The "something" string is referred as the "option name" later in
+# source code and comments.
+## @var AssociativeArray __argsparse_options_descriptions
+## @private
+## @brief Internal use only.
+declare -A __argsparse_options_descriptions=()
+
+
+# @fn __argsparse_check_declaration_conflict()
+# @brief Internal use.
+# @details Check if an option conflicts with another and, if it does,
+# prints the conflicted option.
+# @param option an option name
+# @return True if option *does* conflict with a previously declared
+# option.
+__argsparse_check_declaration_conflict() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	local identifier=$(argsparse_option_to_identifier "$option")
+	local -a identifiers=("${!__argsparse_tmp_identifiers[@]}")
+	local conflict
+	if __argsparse_has_array_item identifiers @ && \
+		   conflict=$(__argsparse_index_of "$identifier" "${identifiers[@]}")
+	then
+		printf %s "${__argsparse_tmp_identifiers[${identifiers[$conflict]}]}"
+		return 0
+	fi
+	__argsparse_tmp_identifiers["$identifier"]=$option
+	return 1
+}
+
+
+## @fn argsparse_use_option()
+## @brief Define a @b new option.
+## @param optstring an optstring.
+## @param description the option description, for the usage() function.
+## @param property... an non-ordered list of keywords. Recognized
+## property keywords are:
+##   - mandatory: missing option will trigger usage. If a default
+##     value is given, the option is considered as if provided on
+##     the command line.
+##   - hidden: option wont show in default usage function.
+##   - value: option expects a following value.
+##   - short:c: option has a single-lettered (c) equivalent.
+##   - exclude:"option1 [ option2 ... ]" option is not
+##   compatible with other options option1, option2...
+##   - cumulative
+##   - cumulativeset
+##   - type:sometype
+##   - The @b last non-keyword parameter will be considered as the
+##     default value for the option. All other parameters and
+##     values will be ignored. - might be broken / obsolete and broken
+## @retval 0 if no error is encountered.
+## @retval 2 if option name is bad (a message will be printed)
+## @retval 3 if option name conflicts with another option (a message
+## will be printed)
+## @retval 4 if a wrong property name is provided. (a message will be
+## printed)
+argsparse_use_option() {
+	[[ $# -ge 2 ]] || return 1
+	local optstring=$1
+	local description=$2
+	shift 2
+	local long short conflict
+	# configure short option.
+	if short=$(__argsparse_optstring_has_short "$optstring")
+	then
+		set -- "short:$short" "$@"
+		optstring=${optstring/=/}
+	fi
+	# --$optstring expect an argument.
+	if [[ "$optstring" = *: ]]
+	then
+		set -- value "$@"
+		long=${optstring%:}
+	else
+		long=$optstring
+	fi
+
+	if [[ "$long" = *[!-0-9a-zA-Z_]* ]]
+	then
+		printf >&2 "%s: %s: bad option name.\n" "$argsparse_pgm" "$long"
+		return 2
+	fi
+
+	if conflict=$(__argsparse_check_declaration_conflict "$long")
+	then
+		printf >&2 "%s: %s: option conflicts with already-declared %s.\n" \
+			"$argsparse_pgm" "$long" "$conflict"
+		return 3
+	fi
+
+	__argsparse_options_descriptions["$long"]=$description
+
+	# Any other parameter to this function should be a property.
+	while [[ $# -ne 0 ]]
+	do
+		if ! argsparse_set_option_property "$1" "$long"
+		then
+			printf >&2 '%s: %s: unknown property.\n' "$argsparse_pgm" "$1"
+			return 4
+		fi
+		shift
+	done
+}
+
+## @fn argsparse_option_description()
+## @brief Prints to stdout the description of given option.
+## @param option an option name.
+## @retval 0 if given option has been previously declared.
+argsparse_option_description() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	[[ -n "${__argsparse_options_descriptions[$option]+yes}" ]] && \
+		printf %s "${__argsparse_options_descriptions[$option]}"
+}
diff --git a/src/30_types b/src/30_types
new file mode 100644
index 0000000..2090e2b
--- /dev/null
+++ b/src/30_types
@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @fn argsparse_check_option_type()
+## @brief Check if a value matches a given type.
+## @details Return True if @a value is of type @a type.
+## @param type A case-insensitive type name.
+## @param value a value to check.
+## @retval 0 if the value matches the given type format.
+## @ingroup ArgsparseOptionTyping
+argsparse_check_option_type() {
+	[[ $# -eq 2 ]] || return 1
+	local option_type=${1,,}
+	local value=$2
+	local t
+	case "$option_type" in
+		file|directory|pipe|terminal)
+			# [[ wont accept the -$var as an operator.
+			[ -"${option_type:0:1}" "$value" ]
+			;;
+		socket|link)
+			t=${option_type:0:1}
+			[ -"${t^^}" "$value" ]
+			;;
+		char)
+			[[ "$value" = ? ]]
+			;;
+		unsignedint|uint)
+			[[ "$value" = +([0-9]) ]]
+			;;
+		integer|int)
+			[[ "$value" = ?(-)+([0-9]) ]]
+			;;
+		hexa)
+			[[ "$value" = ?(0x)+([a-fA-F0-9]) ]]
+			;;
+		ipv4)
+			# Regular expression for ipv4 and ipv6 have been found on
+			# http://www.d-sites.com/2008/10/09/regex-ipv4-et-ipv6/
+			[[ "$value" =~ ^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ ]]
+			;;
+		ipv6)
+			[[ "$value" =~ ^((([0-9A-Fa-f]{1,4}:){7}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){6}:[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){5}:([0-9A-Fa-f]{1,4}:)?[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){4}:([0-9A-Fa-f]{1,4}:){0,2}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){3}:([0-9A-Fa-f]{1,4}:){0,3}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){2}:([0-9A-Fa-f]{1,4}:){0,4}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){6}((b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b).){3}(b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b))|(([0-9A-Fa-f]{1,4}:){0,5}:((b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b).){3}(b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b))|(::([0-9A-Fa-f]{1,4}:){0,5}((b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b).){3}(b((25[0-5])|(1d{2})|(2[0-4]d)|(d{1,2}))b))|([0-9A-Fa-f]{1,4}::([0-9A-Fa-f]{1,4}:){0,5}[0-9A-Fa-f]{1,4})|(::([0-9A-Fa-f]{1,4}:){0,6}[0-9A-Fa-f]{1,4})|(([0-9A-Fa-f]{1,4}:){1,7}:))$ ]]
+			;;
+		ip)
+			# Generic IP address.
+			argsparse_check_option_type ipv4 "$value" || \
+				argsparse_check_option_type ipv6 "$value"
+			;;
+		hostname)
+			# check if value resolv as an IPv4 or IPv6 address.
+			host -t a "$value" >/dev/null 2>&1 || \
+				host -t aaaa "$value" >/dev/null 2>&1
+			;;
+		host)
+			# An hostname or an IP address.
+			argsparse_check_option_type hostname "$value" || \
+				argsparse_check_option_type ipv4 "$value" || \
+				argsparse_check_option_type ipv6 "$value"
+			;;
+		portnumber)
+			argsparse_check_option_type uint "$value" && \
+				[[ "$value" -gt 0 && "$value" -le 65536 ]]
+			;;
+		port)
+			# Port number or service.
+			argsparse_check_option_type portnumber "$value" || \
+				getent services "$value" >/dev/null 2>&1
+			;;
+		username)
+			getent passwd "$value" >/dev/null 2>&1
+			;;
+		group)
+			getent group "$value" >/dev/null 2>&1
+			;;
+		date)
+			date --date "$value"  >/dev/null 2>&1
+			;;
+		*)
+			# Invoke user-defined type-checking function if available.
+			if ! declare -f "check_option_type_$option_type" >/dev/null
+			then
+				printf >&2 \
+					"%s: %s: type has no validation function. This is a bug.\n" \
+					"$argsparse_pgm" "$option_type"
+				return 2
+			fi
+			"check_option_type_$option_type" "$value"
+			;;
+	esac
+}
diff --git a/src/40_usage b/src/40_usage
new file mode 100644
index 0000000..ef04888
--- /dev/null
+++ b/src/40_usage
@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+# The usage-related functions.
+
+## @var Array __argsparse_parameters_description
+## @private
+## @brief Internal use only.
+## @ingroup ArgsparseUsage
+# @details Used by argsparse_describe_parameters() to store
+# non-option positionnal parameters short descriptions and by
+# argsparse_usage_short() to print them to end-users.
+declare -a __argsparse_parameters_description
+
+
+__argsparse_usage_short_line_management() {
+	[[ $# -eq 1 ]] || return 1
+	local next_token=$1
+	local max_length=78
+	local bigger_line
+	bigger_line="$current_line $next_token"
+	if [[ "${#bigger_line}" -gt "$max_length" ]]
+	then
+		printf -- '%s \\\n' "$current_line"
+		printf -v current_line "\t%s" "$next_token"
+	else
+		current_line=$bigger_line
+	fi
+}
+
+
+## @fn argsparse_usage_short()
+## @brief Print a short description of the program syntax.
+## @details Generate and print the "short" description of the program
+## usage.
+## @ingroup ArgsparseUsage
+argsparse_usage_short() {
+	local option values current_line current_option param
+	local max_length=78
+	current_line=$argsparse_pgm
+	for option in "${!__argsparse_options_descriptions[@]}"
+	do
+		if argsparse_has_option_property "$option" hidden
+		then
+			continue
+		fi
+		current_option="--$option"
+		if argsparse_has_option_property "$option" value
+		then
+			if values=$(__argsparse_values_array_identifier "$option")
+			then
+				current_option="$current_option <$(
+					__argsparse_join_array '|' "${!values}")>"
+			else
+				current_option="$current_option ${option^^}"
+			fi
+		fi
+		if ! argsparse_has_option_property "$option" mandatory
+		then
+			current_option="[ $current_option ]"
+		fi
+		__argsparse_usage_short_line_management "$current_option"
+	done
+	if __argsparse_has_array_item __argsparse_parameters_description @
+	then
+	   for param in "${__argsparse_parameters_description[@]}"
+	   do
+		   __argsparse_usage_short_line_management "$param"
+	   done
+	fi
+	printf -- "%s\n" "$current_line"
+}
+
+
+## @fn argsparse_describe_parameters()
+## @brief Describe non-option positionnal parameters.
+## @details This function has currently 2 purposes:
+## - enhance the "short" usage program description (see
+## argsparse_usage_short())
+## - compute the minimum and maximum numbers of non-option
+## positionnal parameters and will overwrite previous settings using
+## argsparse_minimum_parameters() and argsparse_maximum_parameters().
+##
+## @param param... a list of label describing positionnal
+## parameters. These labels can have special forms such as:
+## - "label?" a single optional non-repeatable parameter
+## - "label+" a non-empty list of parameters
+## - "label*" a potentially-empty list of parameters
+## - "label" a single non-optional non-repeatable parameter
+## @retval 0
+## @ingroup ArgsparseUsage
+argsparse_describe_parameters() {
+	[[ $# -eq 0 ]] && return
+	local param last name
+	local -i min=0 max=0
+	__argsparse_parameters_description=( "[--]" )
+	for param in "$@"
+	do
+		name=${param%?}
+		last=${param#$name}
+		case "$last" in
+			'?')
+				: maximum param $((++max))
+				__argsparse_parameters_description+=( "[ $name ]" )
+				;;
+			'*')
+				max=1000000
+				__argsparse_parameters_description+=( "[ $name ... ]" )
+				;;
+			+)
+				max=1000000
+				: minimum param $((++min))
+				__argsparse_parameters_description+=( "$name [ $name ... ]" )
+				;;
+			*)
+				: maximum param $((++max))
+				: minimum param $((++min))
+				__argsparse_parameters_description+=( "$param" )
+		esac
+	done
+	argsparse_minimum_parameters "$min"
+	argsparse_maximum_parameters "$max"
+}
+
+
+## @fn argsparse_usage_long()
+## @brief Fully describe the program syntax and options to the end-user.
+## @details This function generates and prints the "long" description
+## of the program usage. Print all options along with their
+## descriptions provided to argsparse_use_option().
+## @ingroup ArgsparseUsage
+argsparse_usage_long() {
+	local long short sep format array property propstring
+	local q=\' bol='\t\t  '
+	local -A long_to_short=()
+	local -a values
+	# Reverse the __argsparse_short_options array.
+	for short in "${!__argsparse_short_options[@]}"
+	do
+		long=${__argsparse_short_options["$short"]}
+		long_to_short["$long"]=$short
+	done
+	for long in "${!__argsparse_options_descriptions[@]}"
+	do
+		if argsparse_has_option_property "$long" hidden
+		then
+			continue
+		fi
+		# Pretty printer issue here. If the long option length is
+		# greater than 8, we just use next line to print the option
+		# description.
+		if [[ "${#long}" -le 9 ]]
+		then
+			sep=' '
+		else
+			sep="\n$bol"
+		fi
+		# Define format according to the presence of the short option.
+		if __argsparse_has_array_item long_to_short "$long"
+		then
+			short="${long_to_short[$long]}"
+			format=" -%s | %- 11s$sep%s\n"
+		else
+			short=""
+			format=" %s     %- 11s$sep%s\n"
+		fi
+		printf -- "$format" "$short" "--$long" \
+			"${__argsparse_options_descriptions["$long"]}"
+		if argsparse_has_option_property "$long" cumulative || \
+			argsparse_has_option_property "$long" cumulativeset
+		then
+			printf "${bol}Can be repeated.\n"
+		fi
+		if argsparse_has_option_property "$long" value
+		then
+			if array=$(__argsparse_values_array_identifier "$long")
+			then
+				values=( "${!array}" )
+				values=( "${values[@]/%/$q}" )
+				values=( "${values[@]/#/$q}" )
+				printf "${bol}Acceptable values: %s\n" \
+					"$(__argsparse_join_array " " "${values[@]}")"
+			fi
+			if __argsparse_index_of "$long" \
+				"${!__argsparse_options_default_values[@]}" >/dev/null
+			then
+				printf "${bol}Default: %s\n" \
+					"${__argsparse_options_default_values[$long]}"
+			fi
+		fi
+		local -A properties=([require]="Requires" [alias]="Same as")
+		for property in "${!properties[@]}"
+		do
+			if propstring=$(argsparse_has_option_property "$long" "$property")
+			then
+				read -a values <<<"$propstring"
+				values=( "${values[@]/#/--}" )
+				printf "${bol}%s: %s\n" \
+					"${properties[$property]}" "${values[*]}"
+			fi
+		done
+	done
+}
+
+## @var String argsparse_usage_description
+## @brief Usage description additionnal string.
+## @details The content of this variable will be appended to the
+## argsparse_usage() output.
+## @ingroup ArgsparseUsage
+declare argsparse_usage_description
+
+## @fn argsparse_usage()
+## @brief A generic help message generated from the options and their
+## descriptions.
+## @details Will print both a rather-short and a quite long
+## description of the program and its options. Just provided to be
+## wrapped in your own usage().
+## @ingroup ArgsparseUsage
+argsparse_usage() {
+	# There's still a lot of room for improvement here.
+	argsparse_usage_short
+	printf "\n"
+	# This will print option descriptions.
+	argsparse_usage_long
+	[[ -n "${argsparse_usage_description:-}" ]] && \
+		printf "\n%s\n" "$argsparse_usage_description" || :
+}
diff --git a/src/60_option-value-setting b/src/60_option-value-setting
new file mode 100644
index 0000000..24d69a1
--- /dev/null
+++ b/src/60_option-value-setting
@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+# Following functions define the default option-setting hook and its
+# with/without value counter-parts. They can be referered in external
+# source code, though they should only be in user-defined
+# option-setting hooks.
+
+# All user-defined option-setting hook should be defined like
+# argsparse_set_option
+
+## @fn argsparse_set_option_without_value()
+## @brief The option-setting hook for options not accepting values.
+## @param option an option name.
+## @retval 0
+## @ingroup ArgsparseOptionSetter
+argsparse_set_option_without_value() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	: $((program_options["$option"]++))
+}
+
+## @fn argsparse_set_option_with_value()
+## @brief "value" property specific option-setting hook.
+## @param option an option name.
+## @param value the value put on command line for given option.
+## @ingroup ArgsparseOptionSetter
+argsparse_set_option_with_value() {
+	[[ $# -eq 2 ]] || return 1
+	local option=$1
+	local value=$2
+	program_options["$option"]=$value
+}
+
+## @fn argsparse_get_cumulative_array_name()
+## @param option an option name.
+## @brief Print the name of the array used for "cumulative" and
+## "cumulativeset" options.
+## @details For "option-name" usually prints
+## "cumulated_values_option_name".
+## @ingroup ArgsparseOptionSetter
+argsparse_get_cumulative_array_name() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	local ident=$(argsparse_option_to_identifier "$option")
+	printf "cumulated_values_%s" "$ident"
+}
+
+## @fn argsparse_set_cumulative_option()
+## @brief "cumulative" property specific option-setting hook.
+## @details Default action to take for cumulative options. Store @a
+## value into an array whose name is generated using
+## argsparse_get_cumulative_array_name().
+## @param option an option name.
+## @param value the value put on command line for given option.
+## @ingroup ArgsparseOptionSetter
+argsparse_set_cumulative_option() {
+	[[ $# -eq 2 ]] || return 1
+	local option=$1
+	local value=$2
+	local array="$(argsparse_get_cumulative_array_name "$option")"
+	local size temp="$array[@]"
+	local -a copy
+	if __argsparse_has_array_item "$array" 0
+	then
+		copy=( "${!temp}" )
+		size=${#copy[@]}
+	else
+		size=0
+	fi
+	printf -v "$array[$size]" %s "$value"
+	argsparse_set_option_without_value "$option"
+}
+
+## @fn argsparse_set_cumulativeset_option()
+## @param option an option name.
+## @param value a new value for the option.
+## @brief "cumulativeset" property specific option-setting hook.
+## @details Default action to take for cumulativeset options. Act
+## exactly like argsparse_set_cumulative_option() except that values
+## are not duplicated in the cumulated values array.
+## @ingroup ArgsparseOptionSetter
+argsparse_set_cumulativeset_option() {
+	[[ $# -eq 2 ]] || return 1
+	local option=$1
+	local value=$2
+	local array_name="$(argsparse_get_cumulative_array_name "$option")"
+	local array="$array_name[@]"
+	if ! __argsparse_has_array_item "$array_name" || \
+		   ! __argsparse_index_of "$value" "${!array}" >/dev/null
+	then
+		# The value is not already in the array, so add it.
+		argsparse_set_cumulative_option "$option" "$value"
+	fi
+}
+
+## @fn argsparse_set_alias()
+## @param option an option name.
+## @brief "alias" property specific option-setting hook.
+## @details When an option is an alias for other option(s), then set
+## the aliases options.
+## @ingroup ArgsparseOptionSetter
+argsparse_set_alias() {
+	# This option will set all options aliased by another.
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	local aliases
+	if ! aliases="$(argsparse_has_option_property "$option" alias)"
+	then
+		return 1
+	fi
+	while [[ "$aliases" =~ ^\ *([^\ ]+)(\ (.+))?\ *$ ]]
+	do
+		# At this point, BASH_REMATCH[1] is the first alias, and
+		# BASH_REMATCH[3] is the maybe-empty list of other aliases.
+		# __argsparse_set_option will alter BASH_REMATCH, so modify
+		# aliases first.
+		aliases=${BASH_REMATCH[3]}
+		__argsparse_set_option "${BASH_REMATCH[1]}"
+	done
+}
+
+
+## @fn argsparse_set_option()
+## @brief Default option-setting hook.
+## @param option The option being set.
+## @param value the value of the option (optional).
+## @details This function will be called by argsparse_parse_options()
+## whenever a given option is being set and no custom setting hook is
+## defined for said option. Depending of the properties of the option,
+## a more specific setting hook will be called.
+## @ingroup ArgsparseOptionSetter
+argsparse_set_option() {
+	[[ $# -eq 2 || $# -eq 1 ]] || return 1
+	local option=$1
+	if [[ $# -eq 2 ]]
+	then
+		local value=$2
+	fi
+	local property
+	local -A setters=(
+		[cumulative]=argsparse_set_cumulative_option
+		[cumulativeset]=argsparse_set_cumulativeset_option
+		[value]=argsparse_set_option_with_value
+	)
+
+	if ! argsparse_set_alias "$option"
+	then
+		# We dont use ${!setters[@]} here, because order matters.
+		for property in cumulative cumulativeset value
+		do
+			if argsparse_has_option_property "$option" "$property"
+			then
+				"${setters[$property]}" "$option" "$value"
+				return
+			fi
+		done
+		argsparse_set_option_without_value "$option"
+	fi
+}
diff --git a/src/65_params b/src/65_params
new file mode 100644
index 0000000..ab3a507
--- /dev/null
+++ b/src/65_params
@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+# Default behaviour is not to accept empty command lines.
+__argsparse_allow_no_argument=no
+
+
+## @fn argsparse_allow_no_argument()
+## @brief Allow empty command lines to run.
+## @details Change argsparse behaviour for empty command
+## lines. Default says "no argument triggers usage".
+## @param string if (case-insensitive) "yes", "true" or "1", the value
+## is considered as affirmative. Anything else is a negative value.
+## @retval 0 unless there's more than one parameter (or none).
+## @ingroup ArgsparseParameter
+argsparse_allow_no_argument() {
+	[[ $# -eq 1 ]] || return 1
+	local param=$1
+	case "${param,,}" in
+		yes|true|1)
+			__argsparse_allow_no_argument=yes
+			;;
+		*)
+			__argsparse_allow_no_argument=no
+			;;
+	esac
+}
+
+
+## @brief Internal use only.
+## @details The default minimum parameters requirement for command line.
+## @ingroup ArgsparseParameter
+declare -i __argsparse_minimum_parameters=0
+
+
+## @brief Internal use only.
+## @details The default maximum parameters requirement for command
+## line. "Should be enough for everyone".
+## @ingroup ArgsparseParameter
+declare -i __argsparse_maximum_parameters=1000000
+
+
+## @fn argsparse_minimum_parameters()
+## @brief Set the minimum number of non-option parameters expected on
+## the command line.
+## @param unsigned_int a positive number.
+## @retval 0 if there is an unsigned integer is provided and is the
+## single parameter of this function.
+## @retval 1 in other cases.
+## @ingroup ArgsparseParameter
+argsparse_minimum_parameters() {
+	[[ $# -eq 1 ]] || return 1
+	local min=$1
+	[[ "$min" = +([0-9]) ]] || return 1
+	__argsparse_minimum_parameters=$min
+}
+
+## @fn argsparse_maximum_parameters()
+## @brief Set the maximum number of non-option parameters expected on
+## the command line.
+## @param unsigned_int a positive number.
+## @retval 0 if there is an unsigned integer is provided and is the
+## single parameter of this function.
+## @retval 1 in other cases.
+## @ingroup ArgsparseParameter
+argsparse_maximum_parameters() {
+	[[ $# -eq 1 ]] || return 1
+	local max=$1
+	[[ "$max" = +([0-9]) ]] || return 1
+	__argsparse_maximum_parameters=$max
+}
diff --git a/src/70_parsing b/src/70_parsing
new file mode 100644
index 0000000..83318f8
--- /dev/null
+++ b/src/70_parsing
@@ -0,0 +1,366 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @var AssociativeArray program_options
+## @brief Options values.
+## @details
+## After argsparse_parse_options(), it will contain (if no hook is set
+## for "optionname")
+## - "optionname" -> "value", if "optionname" accepts a value.
+## - "optionname" -> "how many times the option has been detected on
+## .
+## the command line", else.
+declare -A program_options=()
+
+
+## @var Array program_params
+## @brief Positionnal parameters of the script
+## @details
+## After argsparse_parse_options(), it will contain all non-option
+## parameters. (Typically, everything found after the '--')
+declare -a program_params=()
+
+
+## @var AssociativeArray __argsparse_tmp_identifiers
+## @private
+## @brief Internal use
+## @details
+## Used to verify declared options do not conflict. Is unset after
+## argsparse_parse_options() being called.
+declare -A __argsparse_tmp_identifiers=()
+
+
+__argsparse_check_requires() {
+	# @return the number of missing option detected, but this function
+	# actually stops are the first failing *list* of dependencies.
+	local option
+	local requirestring require count=0
+	local -a requires
+	for option in "${!program_options[@]}"
+	do
+		if ! requirestring="$(argsparse_has_option_property "$option" require)"
+		then
+			# No requirement for this option.
+			continue
+		fi
+		read -a requires <<<"$requirestring"
+		for require in "${requires[@]}"
+		do
+			if ! argsparse_is_option_set "$require"
+			then
+				printf >&2 "%s: --%s: requires option --%s.\n" \
+					"$argsparse_pgm" "$option" "$require"
+				: $((count++))
+			fi
+		done
+		[[ "$count" -ne 0 ]] && return "$count"
+	done
+	return 0
+}
+
+__argsparse_check_missing_options() {
+	# @retval 0 if all mandatory options have a value in
+	# program_options associative array.
+	local option count=0
+	for option in "${!__argsparse_options_descriptions[@]}"
+	do
+		argsparse_has_option_property "$option" mandatory || continue
+		# If option has been given, just iterate.
+		argsparse_is_option_set "$option" && continue
+		printf >&2 "%s: --%s: option is mandatory.\n" \
+			"$argsparse_pgm" "$option"
+		: $((count++))
+	done
+	[[ "$count" -eq 0 ]]
+}
+
+
+__argsparse_parse_options_prepare_exclude() {
+	# Check for all "exclude" properties, and fill "exclusions"
+	# associative array, which should have been declared in
+	# __argsparse_parse_options_no_usage.
+	local option exclude excludestring
+	local -a excludes
+	for option in "${!__argsparse_options_descriptions[@]}"
+	do
+		excludestring=$(argsparse_has_option_property "$option" exclude) || \
+			continue
+		exclusions["$option"]+="${exclusions["$option"]:+ }$excludestring"
+		# Re-split the string. (without involving anything else)
+		read -a excludes <<<"$excludestring"
+		for exclude in "${excludes[@]}"
+		do
+			exclusions["$exclude"]+="${exclusions["$exclude"]:+ }$option"
+		done
+	done
+}
+
+
+__argsparse_parse_options_check_exclusions() {
+	# Check if two options presents on the command line are mutually
+	# exclusive. Prints the "other" option if it's the case.
+	# @param an option
+	# @return 0 if the given option has actually excluded by annother
+	# already-given option.
+	[[ $# -eq 1 ]] || return 1
+	local new_option=$1
+	local option
+
+	for option in "${!program_options[@]}"
+	do
+		if [[ "${exclusions["$option"]-}" =~ ^(.* )?"$new_option"( .*)?$ ]]
+		then
+			printf %s "$option"
+			return 0
+		fi
+	done
+	return 1
+}
+
+
+## @fn __argsparse_set_option()
+## @private
+## @brief Resolv option-specific setter function and invoke it.
+## @details Check if a user-defined option setting function
+## (set_option_<optionname>) has been defined or if the generic
+## argsparse_set_option() function is to be used. Then invoke the that
+## function with the option name as first parameter. If a value for
+## the option is involved, it is passed as a second parameter.
+## @param option an option name.
+## @return the setter function return code
+## @ingroup ArgsparseOptionSetter
+__argsparse_set_option() {
+	[[ $# -eq 1 || $# -eq 2 ]] || return 1
+	local option=$1
+	local set_hook identifier
+	[[ $# -ne 2 ]] || local value=$2
+	# The "identifier string" matching next_param, suitable for
+	# variable or function names.
+	identifier="$(argsparse_option_to_identifier "$option")"
+	# If user has defined a specific setting hook for given the
+	# option, then use it, else use default standard
+	# option-setting function.
+	if declare -f "set_option_$identifier" >/dev/null 2>&1
+	then
+		set_hook="set_option_$identifier"
+	else
+		set_hook=argsparse_set_option
+	fi
+	# Invoke setting hook, and if it returns some non-zero status,
+	# send the user back to usage, if declared, and return with error.
+	# The specific $value substitution, here, is to distinguish an
+	# empty value from a no-value.
+	"$set_hook" "$option" ${value+"$value"}
+}
+
+
+## @fn __argsparse_parse_options_valuecheck()
+## @private
+## @brief Check a value given to an option.
+## @details If an enumeration has been defined for the option, check
+## against that. If there's no enumeration, but option has a type
+## property, then check against the type. In the end, check against
+## check_value_of_<option> function, if it's been defined.
+## @param option an option name.
+## @param value anything.
+## @retval 0 if value is correct for given option.
+## @ingroup ArgsparseOptionTyping
+__argsparse_parse_options_valuecheck() {
+	[[ $# -eq 2 ]] || return 1
+	local option=$1
+	local value=$2
+	local identifier possible_values option_type
+	identifier="$(argsparse_option_to_identifier "$option")"
+	if possible_values=$(__argsparse_values_array_identifier "$option")
+	then
+		__argsparse_index_of "$value" "${!possible_values}" >/dev/null || \
+			return 1
+	elif option_type=$(argsparse_has_option_property "$option" type)
+	then
+		argsparse_check_option_type "$option_type" "$value" || return 1
+	fi
+	if declare -f "check_value_of_$identifier" >/dev/null 2>&1
+	then
+		"check_value_of_$identifier" "$value" || return 1
+	fi
+	return 0
+}
+
+## @fn __argsparse_parse_options_no_usage()
+## @brief Parse options without triggering usage
+__argsparse_parse_options_no_usage() {
+	# This function re-set program_params array values. This function
+	# will also modify the program_options associative array.
+	# If any error happens, this function will return 1.
+
+	# Be careful, the function is (too) big.
+
+	local long short getopt_temp next_param set_hook option_type
+	local next_param_identifier exclude value char
+	local -a longs_array
+	local -A exclusions
+	# The getopt parameters.
+	local longs shorts option
+
+	# No argument sends back to usage, if defined.
+	if [[ $# -eq 0 && "$__argsparse_allow_no_argument" != yes ]]
+	then
+		return 1
+	fi
+
+	# 1. Analyze declared options to create getopt valid arguments.
+	for long in "${!__argsparse_options_descriptions[@]}"
+	do
+		if argsparse_has_option_property "$long" value
+		then
+			longs_array+=( "$long:" )
+		else
+			longs_array+=( "$long" )
+		fi
+	done
+
+	# 2. Create the long options string.
+	longs="$(__argsparse_join_array , "${longs_array[@]}")"
+
+	# 3. Create the short option string.
+	for short in "${!__argsparse_short_options[@]}"
+	do
+		if argsparse_has_option_property \
+			"${__argsparse_short_options[$short]}" value
+		then
+			shorts+="$short:"
+		else
+			shorts+=$short
+		fi
+	done
+
+	# 4. Invoke getopt and replace arguments.
+	if ! getopt_temp=$(getopt -s bash -n "$argsparse_pgm" \
+		--longoptions="$longs" "$shorts" "$@")
+	then
+		# Syntax error on the command implies returning with error.
+		return 1
+	fi
+	eval set -- "$getopt_temp"
+
+	# 5. Prepare exclusions stuff.
+	__argsparse_parse_options_prepare_exclude
+
+	# 6. Arguments parsing is really made here.
+	while [[ $# -ge 1 ]]
+	do
+		next_param=$1
+		shift
+		# The regular exit case.
+		if [[ "$next_param" = -- ]]
+		then
+			# Check how many parameters we have and if it's at least
+			# what we expects.
+			if [[ $# -lt "$__argsparse_minimum_parameters" ]]
+			then
+				printf >&2 \
+					"%s: not enough parameters (at least %d expected, %d provided)\n" \
+					"$argsparse_pgm" "$__argsparse_minimum_parameters" $#
+				return 1
+			elif [[ $# -gt "$__argsparse_maximum_parameters" ]]
+			then
+				printf >&2 \
+					"%s: too many parameters (maximum allowed is %d, %d provided)\n" \
+					"$argsparse_pgm" "$__argsparse_maximum_parameters" $#
+				return 1
+			fi
+			# Save program parameters in array
+			program_params=( "$@" )
+
+			# Apply default values here
+			for option in "${!__argsparse_options_default_values[@]}"
+			do
+				if ! argsparse_is_option_set "$option"
+				then
+					argsparse_set_option "$option" \
+						"${__argsparse_options_default_values[$option]}"
+				fi
+			done
+
+			# If some mandatory option have been omited by the user, then
+			# print some error, and invoke usage.
+			# Also checks requires chains.
+			__argsparse_check_missing_options && __argsparse_check_requires
+			return
+		fi
+		# If a short option was given, then we first convert it to its
+		# matching long name.
+		if [[ "$next_param" = -[!-] ]]
+		then
+			char=${next_param#-}
+			if ! next_param=$(argsparse_short_to_long "$char")
+			then
+				# Short option without equivalent long. According to
+				# current implementation, this should be considered as
+				# a bug.
+				printf >&2 \
+					"%s: -%s: option doesnt have any matching long option." \
+					"$argsparse_pgm" "$char"
+				return 1
+			fi
+		else
+			# Wasnt a short option. Just strip the leading dash.
+			next_param=${next_param#--}
+		fi
+		if exclude=$(__argsparse_parse_options_check_exclusions "$next_param")
+		then
+			printf >&2 \
+				"%s: %s: option excluded by other option (%s).\n" \
+				"$argsparse_pgm" "$next_param" "$exclude"
+			return 1
+		fi
+		# Set option value, if there should be one.
+		if argsparse_has_option_property "$next_param" value
+		then
+			value=$1
+			shift
+			if ! __argsparse_parse_options_valuecheck "$next_param" "$value"
+			then
+				printf >&2 "%s: %s: Invalid value for option %s.\n" \
+					"$argsparse_pgm" "$value" "$next_param"
+				return 1
+			fi
+		fi
+		# Invoke setting hook, and if it returns returns some non-zero
+		# status, send the user back to usage, if declared, and return
+		# with error.
+		# The specific $value substitution, here, is to distinguish an
+		# empty value from a no-value.
+		if ! __argsparse_set_option "$next_param" ${value+"$value"}
+		then
+			printf >&2 "%s: %s: Invalid value for %s option.\n" \
+				"$argsparse_pgm" "$value" "$next_param"
+			return 1
+		fi
+		unset value
+	done
+	return 0
+}
+
+if [[ ${ARGSPARSE_COMPLETION_MODE-} ]]
+then
+	shopt progcomp expand_aliases >/dev/null || exit 1
+	alias argsparse_parse_options='return 0 2>/dev/null || :'
+else
+## @fn argsparse_parse_options()
+## @brief Parse program options.
+## @details This function will make option parsing happen, and if an error
+## is detected, the usage() function will be invoked, if it has been
+## defined. If it's not defined, the function will return 1.
+## Parse options, and return if everything went fine.
+## @param parameters... should be the program arguments.
+## @retval 0 if the whole option parsing process went fine.
+## @retval 1 if an error is encoutered and usage does not perform an exit.
+argsparse_parse_options() {
+		unset __argsparse_tmp_identifiers || :
+		__argsparse_parse_options_no_usage "$@" && return
+		# Something went wrong, invoke usage function, if defined.
+		declare -f usage >/dev/null 2>&1 && usage
+		return 1
+}
+fi
diff --git a/src/80_post-parsing b/src/80_post-parsing
new file mode 100644
index 0000000..b674830
--- /dev/null
+++ b/src/80_post-parsing
@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @fn argsparse_is_option_set()
+## @brief Return True if an option has been set on the command line.
+## @param option an option name.
+## @retval 0 if given option has been set on the command line.
+argsparse_is_option_set() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	[[ -n "${program_options[$option]+yes}" ]]
+}
+
+## @fn argsparse_report()
+## @brief Prints a basic report of all passed options
+## @details Kinda useful for a --debug, or a --verbose option,
+## this function will print options and their values.
+## @param option... A list of option name. If omitted all options
+## will be displayed.
+## @retval 0
+argsparse_report() {
+	local option array_name value
+	local length=$(__argsparse_max_length "${!__argsparse_options_descriptions[@]}")
+	local -a array options
+
+	if __argsparse_is_array_declared __argsparse_tmp_identifiers
+	then
+		# The test is a bit hacky, but it avoids implementing another
+		# mechanism.
+		printf "argsparse_parse_option was not ran yet.\n"
+	fi
+
+	if [[ $# -eq 0 ]]
+	then
+		options=( "${!__argsparse_options_descriptions[@]}" )
+	else
+		options=( "$@" )
+	fi
+	for option in "${options[@]}"
+	do
+		argsparse_has_option_property "$option" hidden && continue
+		printf "%- ${length}s\t: " "$option"
+		if argsparse_is_option_set "$option"
+		then
+			printf "yes (%s" "${program_options[$option]}"
+			if argsparse_has_option_property "$option" cumulative || \
+				argsparse_has_option_property "$option" cumulativeset
+			then
+				array_name="$(argsparse_get_cumulative_array_name "$option")[@]"
+				array=( "${!array_name}" )
+				printf ' time(s):'
+				for value in "${array[@]}"
+				do
+					printf ' %q' "$value"
+				done
+			fi
+			printf ')\n'
+		else
+			printf 'no\n'
+		fi
+	done
+}
diff --git a/src/95_help-option b/src/95_help-option
new file mode 100644
index 0000000..2631c09
--- /dev/null
+++ b/src/95_help-option
@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @fn usage()
+## @brief Default usage function.
+## @details The default usage function. By default, it will be called
+## by argsparse_parse_options() on error or if --help option provided by
+## user on the command line. It can easily be overwritten if it does not
+## suits your needs.
+## @return This function makes an @b exit with code 1
+## @ingroup ArgsparseUsage
+usage() {
+	argsparse_usage
+	exit 1
+}
+
+## @fn set_option_help()
+## @brief Default trigger for --help option.
+## @details Will actually only call usage().
+## @return Whatever usage() returns.
+## @ingroup ArgsparseUsage
+set_option_help() {
+	# This is the default hook for the --help option.
+	usage
+}
+
+# We do define a default --help option.
+argsparse_use_option "=help" "Show this help message"
diff --git a/src/99_main b/src/99_main
new file mode 100644
index 0000000..1d37355
--- /dev/null
+++ b/src/99_main
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+return 0 >/dev/null 2>&1 ||:
+
+printf "The %s file is not a standalone program. It's a shell library.\n" \
+	"$argsparse_pgm"
+printf "%s\n" \
+	"To use it, you have to load it in your own bash" \
+	"shell scripts using the following line:"
+printf "\n. %q\n\n" "$0"

From 70a66a9f1f62586e5a16b549953e698bd33a06e3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Wed, 3 Mar 2021 01:44:14 +0100
Subject: [PATCH 02/13] add make script to reglue split files

---
 make | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100755 make

diff --git a/make b/make
new file mode 100755
index 0000000..7e3469c
--- /dev/null
+++ b/make
@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+shopt -s extglob
+
+OUT_FILE=${OUT_FILE:-argsparse.sh}
+
+(
+	cat src/00_head
+	for file in src/!(00_head|*~)
+	do
+		printf '\n\n'
+		tail -n +4 < "$file"
+	done
+) > "$OUT_FILE"
+
+chmod +x "$OUT_FILE"

From d1c421a4d7292134225e045a9a1242ec1cff7919 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Wed, 3 Mar 2021 20:19:48 +0100
Subject: [PATCH 03/13] .travis.yml: call make script before attempting unit
 tests

---
 .travis.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.travis.yml b/.travis.yml
index 72ac2d3..8bb3b6d 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -10,4 +10,5 @@ matrix:
 language: bash
 
 script:
+  - ./make
   - ./unittest

From b2543a65d0c96729829c78aa70e159059d31dac7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Wed, 3 Mar 2021 20:24:18 +0100
Subject: [PATCH 04/13] .travis.yml: update list of tested distro

---
 .travis.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 8bb3b6d..b579734 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,11 +1,11 @@
 matrix:
   include:
     - os: linux
-      dist: precise
+      dist: xenial
     - os: linux
-      dist: trusty
+      dist: bionic
     - os: linux
-      dist: xenial
+      dist: focal
 
 language: bash
 

From 8eaaf13715010a63f7e9a513b5632147edfc2485 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Tue, 6 Apr 2021 18:12:33 +0200
Subject: [PATCH 05/13] .gitignore: ignore more emacs-styled temp files

---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gitignore b/.gitignore
index 22acb28..124097f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,3 +5,5 @@ debian/bash-argsparse*
 debian/files
 debian/debhelper-build-stamp
 unittest.log
+\#*
+.\#*

From 2f7642dfda894ef9e920f11cec2b823a8c6f1009 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Tue, 6 Apr 2021 18:13:01 +0200
Subject: [PATCH 06/13] .gitignore: ignore argsparse.sh file, which is now
 generated

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index 124097f..2c431ac 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,3 +7,4 @@ debian/debhelper-build-stamp
 unittest.log
 \#*
 .\#*
+argsparse.sh

From 48c2b01a34ef3786b47ac77ef368f7d02ae98c41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Tue, 6 Apr 2021 18:15:12 +0200
Subject: [PATCH 07/13] debian/rules: rely on ./make to build argsparse

---
 debian/rules | 1 +
 1 file changed, 1 insertion(+)

diff --git a/debian/rules b/debian/rules
index e1a7049..8314de1 100755
--- a/debian/rules
+++ b/debian/rules
@@ -11,6 +11,7 @@ override_dh_install:
 
 build:
 	dh build
+	./make
 	doxygen
 
 %:

From e2eb35e8c95708b2a3cc33346e5113f46192eecf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Tue, 6 Apr 2021 18:16:23 +0200
Subject: [PATCH 08/13] bash-argsparse.spec: rely on ./make to build
 argsparse.sh

---
 bash-argsparse.spec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bash-argsparse.spec b/bash-argsparse.spec
index c26329a..f3655d7 100644
--- a/bash-argsparse.spec
+++ b/bash-argsparse.spec
@@ -25,7 +25,7 @@ will fail at interpreting that code.
 %setup -q
 
 %build
-# Nothing to build, except the documentation.
+./make
 doxygen
 
 %install

From 1ba1aab86825eed4c070912d8b4eb52632379e98 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Wed, 3 Mar 2021 21:21:16 +0100
Subject: [PATCH 09/13] src/69_env-and-defaults: add functions for support for
 setting options from environment

---
 src/69_env-and-defaults | 141 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 141 insertions(+)
 create mode 100644 src/69_env-and-defaults

diff --git a/src/69_env-and-defaults b/src/69_env-and-defaults
new file mode 100644
index 0000000..bc55550
--- /dev/null
+++ b/src/69_env-and-defaults
@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# -*- tab-width: 4; encoding: utf-8; -*-
+
+## @var String __argsparse_environment_variable_prefix
+## @brief The prefix for option-setting environment variables
+## @private
+## @ingroup ArgsparseOptionSetter
+declare __argsparse_environment_variable_prefix
+
+
+## @fn argsparse_use_environment_variables()
+## @brief Enable option setting through environment variables.
+## @details
+## Once enabled, it cannot be disabled.
+## @param prefix an environment variable prefix
+## @ingroup ArgsparseOptionSetter
+argsparse_use_environment_variables() {
+	local prefix
+	case $# in
+		0)
+			prefix=$(argsparse_option_to_identifier "${argsparse_pgm%.sh}")
+			prefix=${prefix^^}
+			;;
+		1)
+			prefix=$1
+			;;
+		*)
+			return 1
+	esac
+	__argsparse_environment_variable_prefix=$prefix
+}
+
+
+## @fn argsparse_are_environment_variables_enabled()
+## @brief Tell if option setting through environment variables is
+## enabled or not.
+## @details
+## @retval 0 if argsparse_parse_options would also retrieve option
+## values from environment variables.
+## @ingroup @ArgsparseOptionSetter
+argsparse_are_environment_variables_enabled() {
+	[[ ${__argsparse_environment_variable_prefix:-} ]]
+}
+
+
+## @fn argsparse_option_environment_variable_name()
+## @brief Give the environment variable name linked to an option
+## @details
+## Return the name of the environment variable name that can be used
+## to set a given option. Works whether option setting through
+## environment variables is enabled or not.
+## @param option an option name
+## @return the environment variable name linked to the option
+argsparse_option_environment_variable_name() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	local identifier=$(argsparse_option_to_identifier "$option")
+	printf %s_%s "$__argsparse_environment_variable_prefix" "${identifier^^}"
+}
+
+
+## @fn argsparse_option_environment_variable()
+## @brief Give the content of the environment variable that can be
+## used to set a given option.
+## @details
+## Does not check if option setting through environment variable is
+## enabled or not.
+## @param option An option name
+## @return The content of the environment variable that matches the
+## given option.
+## @retval 0 if the variable that matches the given option actually
+## exists (even if its value is empty)
+argsparse_option_environment_variable() {
+	[[ $# -eq 1 ]] || return 1
+	local option=$1
+	local var=$(argsparse_option_environment_variable_name "$option")
+	if [[ -v $var ]]; then
+		printf %s "${!var}"
+		return 0
+	fi
+	return 1
+}
+
+
+## @fn argsparse_set_option_from_environment_value()
+## @brief Give a value to an option, from environment variable value.
+## @details
+## Options can be set from environment variables, and in some cases,
+## those values have special meanings:
+## - 0, "false", "no" and the empty string are explicit values to
+## disable a non-valued option
+## - (probably more to come)
+## .
+## @param option an option name
+## @param value the value, as found in the process environment, to set
+## the option to.
+argsparse_set_option_from_environment_value() {
+	[[ $# -eq 2 ]] || return 1
+	local option=$1
+	local value=$2
+	if ! argsparse_has_option_property "$option" value
+	then
+		if [[ $value != +(0|false|no|"") ]]
+		then
+			argsparse_set_option "$option"
+		fi
+	# There should be an elif statement here, if we want to consider
+	# cumulated options differently.
+	else
+		argsparse_set_option "$option" "$value"
+	fi
+}
+
+
+## @fn __argsparse_parse_options_env_and_defaults()
+## @brief set options from environment and from default values.
+## @details
+## For every option that have not been set from command line, look for
+## a matching environment variable (when
+## argsparse_are_environment_variables_enabled() is true) and apply
+## default values right after if still left unset.
+## @private
+__argsparse_parse_options_env_and_defaults() {
+	local option value
+	for option in "${!__argsparse_options_descriptions[@]}"
+	do
+		if ! argsparse_is_option_set "$option"
+		then
+			if argsparse_are_environment_variables_enabled &&
+					value=$(argsparse_option_environment_variable "$option")
+			then
+				argsparse_set_option_from_environment_value "$option" "$value"
+			elif __argsparse_has_array_item \
+					 __argsparse_options_default_values "$option"
+			then
+				 argsparse_set_option "$option" \
+					"${__argsparse_options_default_values[$option]}"
+			fi
+		fi
+	done
+}

From 00977e63e30a54b80a574a2200fa41af5357bb37 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Wed, 3 Mar 2021 21:22:35 +0100
Subject: [PATCH 10/13] src/70_parsing: insert setting-from-environment in the
 parsing process

---
 src/70_parsing | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/src/70_parsing b/src/70_parsing
index 83318f8..858212a 100644
--- a/src/70_parsing
+++ b/src/70_parsing
@@ -272,15 +272,8 @@ __argsparse_parse_options_no_usage() {
 			# Save program parameters in array
 			program_params=( "$@" )
 
-			# Apply default values here
-			for option in "${!__argsparse_options_default_values[@]}"
-			do
-				if ! argsparse_is_option_set "$option"
-				then
-					argsparse_set_option "$option" \
-						"${__argsparse_options_default_values[$option]}"
-				fi
-			done
+			# Retrieve values from environment and set matching options
+			__argsparse_parse_options_env_and_defaults
 
 			# If some mandatory option have been omited by the user, then
 			# print some error, and invoke usage.

From 4b745c51df29e099d45b6dfb89443017bee726a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Mon, 5 Apr 2021 22:06:42 +0200
Subject: [PATCH 11/13] src/40_usage: print environment variables related
 informations in usage

---
 src/40_usage | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/40_usage b/src/40_usage
index ef04888..731d4eb 100644
--- a/src/40_usage
+++ b/src/40_usage
@@ -199,6 +199,11 @@ argsparse_usage_long() {
 					"${properties[$property]}" "${values[*]}"
 			fi
 		done
+		if argsparse_are_environment_variables_enabled
+		then
+			printf "${bol}Environment variable: %s\n" \
+				"$(argsparse_option_environment_variable_name "$long")"
+		fi
 	done
 }
 

From 9b01408a4d4ab8abf90461636d20d6ec34e6e289 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Tue, 6 Apr 2021 17:58:10 +0200
Subject: [PATCH 12/13] tutorial/0-completion: load /etc/profile in order to
 ensure bash completion is loaded

---
 tutorial/0-completion | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tutorial/0-completion b/tutorial/0-completion
index 78e80c3..a6a3d37 100755
--- a/tutorial/0-completion
+++ b/tutorial/0-completion
@@ -6,6 +6,7 @@ tutorial_directory=${BASH_SOURCE[0]%/*}
 # just enable programmable completion for other tutorial scripts and
 # invoke an interactive shell
 read -N 4096 bashrc <<EOF
+. /etc/profile
 shopt -s progcomp sourcepath
 PATH="$PATH:$tutorial_directory"
 . "$tutorial_directory/../argsparse-completion.sh"

From df31fc49c9cf7d0293ec67b7a2609850c296c210 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Damien=20Nad=C3=A9?= <anvil.github@livna.org>
Date: Tue, 6 Apr 2021 18:09:11 +0200
Subject: [PATCH 13/13] tutorial/0-completion: mention the way to enable bash
 completion for argsparse scripts

---
 tutorial/0-completion | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tutorial/0-completion b/tutorial/0-completion
index a6a3d37..bd4fb86 100755
--- a/tutorial/0-completion
+++ b/tutorial/0-completion
@@ -22,3 +22,18 @@ printf "You are currently in %s directory and completion is enabled.\\\\n" \
 printf "Try:\\\n\\\\n./1-basics -<tab><tab>\\\\n\\\\n"
 EOF
 exec bash --rcfile <(printf %s "$bashrc") -i
+
+cat <<EOF
+
+As you can see, the Bash Argsparse Completion module can automatically
+enable the bash completion for the scripts you develop with the Bash
+Argsparse library.
+
+To enable completion for your own scripts, please ensure
+bash_completion is enabled, and then in your ~/.bashrc, add lines such
+as:
+
+    . argsparse-completion.sh
+    complete -F _argsparse_complete yourscript your_other_script
+
+EOF