here (and probably also in :py:mod:`cnfvar`) work with conf vars represented as
dictionaries and lists thereof. Conf var dicts have keys `number`, `varname`,
`instance`, `data`, `comment` and possibly `parent` and/or `children`.
-`varname` is a regular upper-case string, `data` is a (utf8) string, `comment`
+`varname` is a regular lower-case string, `data` is a (utf8) string, `comment`
is usually None, `number`, `parent` and `instance` are int. If a conf var has
children, then this is a list of conf var dicts. `parent` is only present if a
conf-var is a child. Several conf vars, if not wrapped in a
Will only check on top level, is not recursive.
- :param str varname: name of conf var; will be converted to upper-case
+ :param str varname: name of conf var; will be converted to lower-case
:returns: instance number for which there is no other conf var of same
name (0 if there is not other conf var with that name)
:rtype: int
"""
Add a cnf var to config on top level.
- :param str varname: name of conf var; only required arg; upper-case
+ :param str varname: name of conf var; only required arg; case ignored
:param str data: conf var's value
:param int number: line number of that conf var; if given as None
(default) the function looks through config to find
users.append_guest_vars(varname='user')
:param item: line number or value to specify a cnf subset;
- if string value, will be converted to upper case
+ if string value, will be converted to lower case
:type item: int or str
:returns: another simple cnf that contains a subset of this simple cnf
:rtype: :py:class:`SimpleCnf`
cnf.get(line=1121)
:param str name: conf var name (key) or None to not use this criterion;
- will be converted to upper case
+ will be converted to lower case
:param str value: value of conf var or None to not use this criterion
:param int instance: instance number of value in a list (e.g. USERS)
or None to not use this criterion