Repository files navigation

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.

[section1]value1=abcdvalue2=1234[section2]value1=1234value2=5678[section3]value1=abcdvalue2=1234value3=a1b2value_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 parsersource ini-file-parser.sh# Load and process the ini/config fileprocess_ini_file'example.conf'# Display a specific value from a specific sectionecho$(get_value'section1''value1')# Display the same value as above but using the global variables created as part of the processing.echo$section1_value1

There are a number of rules / assumptions that have been coded in that might give you a result different to the one you might expect:

1. Empty lines are ignored.
2. Lines starting with comments (# or ;) are ignored.
3. The 'default' section is called 'default' - This is for any name=value pair defined before the first section.
4. Section names will only contains alpha-numeric characters and underscores - everything else is removed.
5. Section names are case sensitive (by default).
6. Key names have leading and trailing spaces removed.
7. Key names replace all punctuation and blank characters (space, tab etc) with underscore and squish (remove multiple underscores).
8. Value fields have in-line comments removed.
9. Value fields have leading and trailing spaces removed.
10. 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 5 subroutines that are exposed.

1. process_ini_file - Load a names ini/config file and create the required arrays.
2. get_value - Request a specific value (by key name) from a specific section.
3. display_config - Display the processed (clean) ini/config in ini/config file format.
4. display_config_by_section - As above but for a specific named section.
5. global_reset - Reset the script and remove all previously loaded ini file data.

These variables allow us to override the parse script defaults, they can be used by the calling script, but they must be setBEFORE the ini/config file is processed.

#!/usr/bin/env bash# Turn off config warningsshow_config_warnings=false# Make Section names case-insensitivecase_sensitive_sections=false# Load in the ini file parsersource ini-file-parser.sh# Load and process the ini/config fileprocess_ini_file'example.conf'# Display a specific value from a specific sectionecho$(get_value'section1''value1')# Display a value using the global variable created as part of the processing.echo$section1_value1