SYNOPSIS

crudini ,--set /[,OPTION/]... ,config_file section /[,param/] [,value/]
crudini ,--get /[,OPTION/]... ,config_file /[,section/] [,param/]
crudini ,--del /[,OPTION/]... ,config_file section /[,param/] [,list value/]
crudini ,--merge /[,OPTION/]... ,config_file /[,section/]

DESCRIPTION

crudini - A utility for manipulating ini files

OPTIONS

--existing[=,WHAT/]

For --set, --del and --merge, fail if item is missing, where WHAT is 'file', 'section', or 'param', or if not specified; all specified items.

--format=,FMT/

For --get, select the output FMT. Formats are sh,ini,lines

--inplace

Lock and write files in place. This is not atomic but has less restrictions than the default replacement method.

--list

For --set and --del, update a list (set) of values

--list-sep=,STR/

Delimit list values with "STR" instead of " ,"

--output=,FILE/

Write output to FILE instead. '-' means stdout

--verbose

Indicate on stderr if changes were made

EXAMPLES

# Add/Update a var

crudini --set config_file section parameter value

# Update an existing var

crudini --set --existing config_file section parameter value

# Delete a var

crudini --del config_file section parameter

# Delete a section

crudini --del config_file section

# output a value

crudini --get config_file section parameter

# output a global value not in a section

crudini --get config_file '' parameter

# output a section

crudini --get config_file section

# output a section, parseable by shell

eval $(crudini --get --format=sh config_file section)

# update an ini file from shell variable(s)

echo name="$name" | crudini --merge config_file section

# merge an ini file from another ini

crudini --merge config_file < another.ini

# compare two ini files using standard UNIX text processing

diff <(crudini --get --format=lines file1.ini|sort) \

<(crudini --get --format=lines file2.ini|sort)