Overview

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.

How it works

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.

Example ini file

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.|

Simple config file

``` [section1] value1=abcd value2=1234

[section2] value1=1234 value2=5678

[section3] value1=abcd value2=1234 value3=a1b2 value_4=c3d4 ```

Example usage

There is a complete working example available, parse-example.sh, but a 'snippet' example is given below, to show a simple single value extraction.

```shell

!/usr/bin/env bash

Load in the ini file parser

source ini-file-parser.sh

Load and process the ini/config file

processinifile '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_value1 ```

Processing rules

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.

Subroutines

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.

Global overrides

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 |

Example override usage

```shell

!/usr/bin/env bash

Turn off config warnings

showconfigwarnings=false

Make Section names case-insensitive

casesensitivesections=false

Load in the ini file parser

source ini-file-parser.sh

Load and process the ini/config file

processinifile '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 ```