Bash does not come with a way to process ini/config files, this script is an attempt at creating a generic easy to use solution to this problem and for no other reason than because I could.
The script works by reading in a normal ini file and creates 2 arrays per section. One for the keys and one for the values. The reason of this is that you cannot declare an associative array globally from within a loop which is within a function (in bash 4.3 at least) so this was the best work around that was available.
There are 2 config files provided as examples.
| Name | Description |
|---|---|
| simple example | Simple config file, demonstrating sections and key=value key pairs. |
| complete example | Complex config file, demonstrating all of the processing rules, warnings and error conditions. |
[section1]
value1=abcd
value2=1234
[section2]
value1=1234
value2=5678
[section3]
value1=abcd
value2=1234
value3=a1b2
value_4=c3d4
There is a complete working example available, parse-example.sh, but a 'snippet' example is given below, to show a simple single value extraction.
#!/usr/bin/env bash
# Load in the ini file parser
source ini-file-parser.sh
# Load and process the ini/config file
process_ini_file 'example.conf'
# Display a specific value from a specific section
echo $(get_value 'section1' 'value1')
# Display the same value as above but using the global variables created as part of the processing.
echo $section1_value1There are a number of rules / assumptions that have been coded in that might give you a result different to the one you might expect:
- Empty lines are ignored.
- Lines starting with comments (# or ;) are ignored.
- The 'default' section is called 'default' - This is for any name=value pair defined before the first section.
- Section names will only contains alpha-numeric characters and underscores - everything else is removed.
- Section names are case sensitive (by default).
- Key names have leading and trailing spaces removed.
- Key names replace all punctuation and blank characters (space, tab etc) with underscore and squish (remove multiple underscores).
- Value fields have in-line comments removed.
- Value fields have leading and trailing spaces removed.
- Value fields have leading and trailing quotes removed.
In addition to the data arrays that are created a set of variables are also created to allow for simple direction access to values, these are in the format: section_key=value.
It is worth noting that the global variables are created AFTER the processing rules have been applied, so the section name and the key name might differ from what you expect.
There are currently 4 subroutines that are exposed.
- process_ini_file - Load a names ini/config file and create the required arrays.
- get_value - Request a specific value (by key name) from a specific section.
- display_config - Display the processed (clean) ini/config in ini/config file format.
- display_config_by_section - As above but for a specific named section.
These variables allow us to override the parse script defaults, they can be used by the calling script, but they must be set BEFORE the ini/config file is processed.
| Name | Description | Default | Accepted Values |
|---|---|---|---|
| case_sensitive_sections | Should section names be case sensitive? | true | true / false |
| case_sensitive_keys | Should key names be case sensitive? | true | true / false |
| show_config_warnings | Should we show config warnings? | true | true / false |
| show_config_errors | Should we show config errors? | true | true / false |
#!/usr/bin/env bash
# Turn off config warnings
show_config_warnings=false
# Make Section names case-insensitive
case_sensitive_sections=false
# Load in the ini file parser
source ini-file-parser.sh
# Load and process the ini/config file
process_ini_file 'example.conf'
# Display a specific value from a specific section
echo $(get_value 'section1' 'value1')
# Display a value using the global variable created as part of the processing.
echo $section1_value1