Man pages sections > man1 > crudini

crudini - manipulate ini files

CRUDINI(1) User Commands CRUDINI(1)

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 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)
July 2015 crudini 0.7