Projects/bash-ini-parser
1
0
Fork 0
Code Releases Wiki Activity

Update help text and version number.

Browse source
This commit is contained in:
Darren 'Tadgy' Austin 2019-08-12 01:02:20 +01:00
commit cecae2a90a
1 changed files with 14 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

25
parse-ini
View file

@ -143,7 +143,7 @@ parser_getopts() {
parser_help() { parser_help() {
#........1.........2.........3.........4.........5.........6.........7.........8 #........1.........2.........3.........4.........5.........6.........7.........8
cat <<-EOF cat <<-EOF
Usage: ${0##*/} [options] <INI file> Usage: ${0##*/} [options] <INI file|->
Parse an INI-style file into array assignments which can be 'eval'ed into Bash. Parse an INI-style file into array assignments which can be 'eval'ed into Bash.
Example usage in bash script: eval "\$(${0##*/} example.ini)" Example usage in bash script: eval "\$(${0##*/} example.ini)"
@ -159,11 +159,11 @@ parser_help() {
-d <char(s)>, --delim <char(s)> -d <char(s)>, --delim <char(s)>
The character(s) (which may be an empty value) to use as a delimiter The character(s) (which may be an empty value) to use as a delimiter
between the prefix and section name when declaring the arrays. The between the prefix and section name when declaring the arrays. The
default is "_", except when '--prefix' is set to an empty value, in which default is "_", except when '-p' is set to an empty value, in which case
case the default is also empty. Only alphanumerics and _ may be used with the default is also empty. Only alphanumerics and _ may be used with
this option, and it may not begin with a number if '--prefix' is empty. this option, and it may not begin with a number if '-p' is empty. The
The delimiter may be converted to upper or lower case depending upon the delimiter may be converted to upper or lower case depending upon the use
use of '--uppercase' or '--lowercase'. of '--uppercase' or '--lowercase'.
-e, --export -e, --export
When declaring the arrays, export them to the environment. When declaring the arrays, export them to the environment.
-h, -?, --help -h, -?, --help
@ -176,7 +176,9 @@ parser_help() {
default is "INI". An empty prefix (denoted by "") implies '-d ""', but default is "INI". An empty prefix (denoted by "") implies '-d ""', but
this can be overridden by explicitly specifying a delimiter with '-d'. this can be overridden by explicitly specifying a delimiter with '-d'.
Only alphanumerics and "_" may be used with this option, and it may not be Only alphanumerics and "_" may be used with this option, and it may not be
empty when delim ('-d') begins with a number. empty when delim ('-d') begins with a number. The prefix may be converted
to upper or lower case depending upon the use of '--uppercase' or
'--lowercase'.
-v, --version -v, --version
Show version and copyright information. Show version and copyright information.
@ -192,11 +194,12 @@ parser_help() {
The name of the 'global' section used when declaring the arrays. Only The name of the 'global' section used when declaring the arrays. Only
alphanumerics and "_" may be used with this option, which cannot be empty. alphanumerics and "_" may be used with this option, which cannot be empty.
The name may not begin with a number, and may be converted to upper or The name may not begin with a number, and may be converted to upper or
lower case depending upon the use of '--uppercase' or '--lowercase'. lower case depending upon the use of '--uppercase' or '--lowercase'. The
default is "global".
--lowercase --lowercase
When declaring the arrays, the case of the prefix ('--prefix') name, When declaring the arrays, the case of the prefix ('--prefix') name,
delimiter and section name is kept as per the INI file. With this option delimiter and section name is kept as per the INI file. With this option
all items are converted to lower case. The case of the propertie's all items are converted to lower case. The case of the properties'
keys/values is not affected. keys/values is not affected.
--no-booleans --no-booleans
Normally, the parser interprites the presence of a key without an Normally, the parser interprites the presence of a key without an
@ -220,7 +223,7 @@ parser_help() {
--uppercase --uppercase
When declaring the arrays, the case of the prefix ('--prefix') name, When declaring the arrays, the case of the prefix ('--prefix') name,
delimiter and section name is kept as per the INI file. With this option delimiter and section name is kept as per the INI file. With this option
all items are converted to upper case. The case of the propertie's all items are converted to upper case. The case of the properties'
keys/values is not affected. keys/values is not affected.
Option processing ceases with the first non-option argument, or "--". Option processing ceases with the first non-option argument, or "--".
EOF EOF
@ -230,7 +233,7 @@ parser_help() {
parser_version() { parser_version() {
#........1.........2.........3.........4.........5.........6.........7.........8 #........1.........2.........3.........4.........5.........6.........7.........8
cat <<-EOF cat <<-EOF
Bash INI file parser v0.1.0. Bash INI file parser v0.1.1.
Copyright (C) 2019 Darren 'Tadgy' Austin <darren (at) afterdark.org.uk>. Copyright (C) 2019 Darren 'Tadgy' Austin <darren (at) afterdark.org.uk>.
Licensed under the terms of the GNU General Public Licence version 3. Licensed under the terms of the GNU General Public Licence version 3.