crudini (1) - Linux Manuals

crudini: manipulate ini files

NAME

crudini - manipulate ini files

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 specifed 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)