Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
tests	[ DIR ]	drwxr-xr-x	2026-05-18 06:31
access.aug	3.58 KB	-rw-r--r--	2026-05-06 08:42
activemq_conf.aug	1.47 KB	-rw-r--r--	2026-05-06 08:42
activemq_xml.aug	864 B	-rw-r--r--	2026-05-06 08:42
afs_cellalias.aug	1.56 KB	-rw-r--r--	2026-05-06 08:42
aliases.aug	2.18 KB	-rw-r--r--	2026-05-06 08:42
anaconda.aug	775 B	-rw-r--r--	2026-05-06 08:42
anacron.aug	2.49 KB	-rw-r--r--	2026-05-06 08:42
approx.aug	1.26 KB	-rw-r--r--	2026-05-06 08:42
apt_update_manager.aug	1.11 KB	-rw-r--r--	2026-05-06 08:42
aptcacherngsecurity.aug	726 B	-rw-r--r--	2026-05-06 08:42
aptconf.aug	3.9 KB	-rw-r--r--	2026-05-06 08:42
aptpreferences.aug	1.79 KB	-rw-r--r--	2026-05-06 08:42
aptsources.aug	1.98 KB	-rw-r--r--	2026-05-06 08:42
authinfo2.aug	1.44 KB	-rw-r--r--	2026-05-06 08:42
authorized_keys.aug	1.84 KB	-rw-r--r--	2026-05-06 08:42
authselectpam.aug	3.7 KB	-rw-r--r--	2026-05-06 08:42
automaster.aug	3.31 KB	-rw-r--r--	2026-05-06 08:42
automounter.aug	4.05 KB	-rw-r--r--	2026-05-06 08:42
avahi.aug	1.38 KB	-rw-r--r--	2026-05-06 08:42
backuppchosts.aug	1014 B	-rw-r--r--	2026-05-06 08:42
bbhosts.aug	4.24 KB	-rw-r--r--	2026-05-06 08:42
bootconf.aug	3.65 KB	-rw-r--r--	2026-05-06 08:42
build.aug	16.65 KB	-rw-r--r--	2026-05-06 08:42
cachefilesd.aug	2 KB	-rw-r--r--	2026-05-06 08:42
carbon.aug	1.54 KB	-rw-r--r--	2026-05-06 08:42
ceph.aug	719 B	-rw-r--r--	2026-05-06 08:42
cgconfig.aug	3.37 KB	-rw-r--r--	2026-05-06 08:42
cgrules.aug	2.38 KB	-rw-r--r--	2026-05-06 08:42
channels.aug	3.84 KB	-rw-r--r--	2026-05-06 08:42
chrony.aug	13.79 KB	-rw-r--r--	2026-05-06 08:42
clamav.aug	1.72 KB	-rw-r--r--	2026-05-06 08:42
cmdline.aug	500 B	-rw-r--r--	2026-05-06 08:42
cobblermodules.aug	398 B	-rw-r--r--	2026-05-06 08:42
cobblersettings.aug	2.24 KB	-rw-r--r--	2026-05-06 08:42
cockpit.aug	1.96 KB	-rw-r--r--	2026-05-06 08:42
collectd.aug	869 B	-rw-r--r--	2026-05-06 08:42
cpanel.aug	824 B	-rw-r--r--	2026-05-06 08:42
cron.aug	4.05 KB	-rw-r--r--	2026-05-06 08:42
cron_user.aug	1.26 KB	-rw-r--r--	2026-05-06 08:42
crypttab.aug	3.08 KB	-rw-r--r--	2026-05-06 08:42
csv.aug	1.18 KB	-rw-r--r--	2026-05-06 08:42
cups.aug	459 B	-rw-r--r--	2026-05-06 08:42
cyrus_imapd.aug	1.51 KB	-rw-r--r--	2026-05-06 08:42
darkice.aug	773 B	-rw-r--r--	2026-05-06 08:42
debctrl.aug	3.61 KB	-rw-r--r--	2026-05-06 08:42
desktop.aug	1.39 KB	-rw-r--r--	2026-05-06 08:42
devfsrules.aug	619 B	-rw-r--r--	2026-05-06 08:42
device_map.aug	620 B	-rw-r--r--	2026-05-06 08:42
dhclient.aug	6.69 KB	-rw-r--r--	2026-05-06 08:42
dhcpd.aug	20.88 KB	-rw-r--r--	2026-05-06 08:42
dns_zone.aug	2.89 KB	-rw-r--r--	2026-05-06 08:42
dnsmasq.aug	2.16 KB	-rw-r--r--	2026-05-06 08:42
dovecot.aug	3.98 KB	-rw-r--r--	2026-05-06 08:42
dpkg.aug	2.78 KB	-rw-r--r--	2026-05-06 08:42
dput.aug	2.16 KB	-rw-r--r--	2026-05-06 08:42
erlang.aug	4.33 KB	-rw-r--r--	2026-05-06 08:42
ethers.aug	663 B	-rw-r--r--	2026-05-06 08:42
exports.aug	2.37 KB	-rw-r--r--	2026-05-06 08:42
fai_diskconfig.aug	9.28 KB	-rw-r--r--	2026-05-06 08:42
fail2ban.aug	1.79 KB	-rw-r--r--	2026-05-06 08:42
fonts.aug	819 B	-rw-r--r--	2026-05-06 08:42
fstab.aug	1.23 KB	-rw-r--r--	2026-05-06 08:42
fuse.aug	871 B	-rw-r--r--	2026-05-06 08:42
gdm.aug	1.8 KB	-rw-r--r--	2026-05-06 08:42
getcap.aug	1.57 KB	-rw-r--r--	2026-05-06 08:42
group.aug	1.66 KB	-rw-r--r--	2026-05-06 08:42
grub.aug	11.05 KB	-rw-r--r--	2026-05-06 08:42
grubenv.aug	508 B	-rw-r--r--	2026-05-06 08:42
gshadow.aug	2.19 KB	-rw-r--r--	2026-05-06 08:42
gtkbookmarks.aug	855 B	-rw-r--r--	2026-05-06 08:42
host_conf.aug	1.9 KB	-rw-r--r--	2026-05-06 08:42
hostname.aug	435 B	-rw-r--r--	2026-05-06 08:42
hosts.aug	485 B	-rw-r--r--	2026-05-06 08:42
hosts_access.aug	4.32 KB	-rw-r--r--	2026-05-06 08:42
htpasswd.aug	1.02 KB	-rw-r--r--	2026-05-06 08:42
httpd.aug	7.35 KB	-rw-r--r--	2026-05-06 08:42
inetd.aug	6.22 KB	-rw-r--r--	2026-05-06 08:42
inifile.aug	15.49 KB	-rw-r--r--	2026-05-06 08:42
inittab.aug	780 B	-rw-r--r--	2026-05-06 08:42
inputrc.aug	1.62 KB	-rw-r--r--	2026-05-06 08:42
interfaces.aug	4.62 KB	-rw-r--r--	2026-05-06 08:42
iproute2.aug	323 B	-rw-r--r--	2026-05-06 08:42
iptables.aug	2.64 KB	-rw-r--r--	2026-05-06 08:42
iscsid.aug	684 B	-rw-r--r--	2026-05-06 08:42
jaas.aug	1.57 KB	-rw-r--r--	2026-05-06 08:42
jettyrealm.aug	1.52 KB	-rw-r--r--	2026-05-06 08:42
jmxaccess.aug	1.35 KB	-rw-r--r--	2026-05-06 08:42
jmxpassword.aug	1.34 KB	-rw-r--r--	2026-05-06 08:42
json.aug	2.15 KB	-rw-r--r--	2026-05-06 08:42
kdump.aug	3.06 KB	-rw-r--r--	2026-05-06 08:42
keepalived.aug	10.73 KB	-rw-r--r--	2026-05-06 08:42
known_hosts.aug	1.93 KB	-rw-r--r--	2026-05-06 08:42
koji.aug	898 B	-rw-r--r--	2026-05-06 08:42
krb5.aug	6.98 KB	-rw-r--r--	2026-05-06 08:42
ldif.aug	7.65 KB	-rw-r--r--	2026-05-06 08:42
ldso.aug	1.06 KB	-rw-r--r--	2026-05-06 08:42
lightdm.aug	1.75 KB	-rw-r--r--	2026-05-06 08:42
limits.aug	2.02 KB	-rw-r--r--	2026-05-06 08:42
login_defs.aug	615 B	-rw-r--r--	2026-05-06 08:42
logrotate.aug	4.23 KB	-rw-r--r--	2026-05-06 08:42
logwatch.aug	1.44 KB	-rw-r--r--	2026-05-06 08:42
lokkit.aug	2.16 KB	-rw-r--r--	2026-05-06 08:42
lvm.aug	2.03 KB	-rw-r--r--	2026-05-06 08:42
mailscanner.aug	1.66 KB	-rw-r--r--	2026-05-06 08:42
mailscanner_rules.aug	2.84 KB	-rw-r--r--	2026-05-06 08:42
masterpasswd.aug	4.36 KB	-rw-r--r--	2026-05-06 08:42
mcollective.aug	1.09 KB	-rw-r--r--	2026-05-06 08:42
mdadm_conf.aug	10.05 KB	-rw-r--r--	2026-05-06 08:42
memcached.aug	1.24 KB	-rw-r--r--	2026-05-06 08:42
mke2fs.aug	6.29 KB	-rw-r--r--	2026-05-06 08:42
modprobe.aug	3.34 KB	-rw-r--r--	2026-05-06 08:42
modules.aug	741 B	-rw-r--r--	2026-05-06 08:42
modules_conf.aug	1.04 KB	-rw-r--r--	2026-05-06 08:42
mongodbserver.aug	1.17 KB	-rw-r--r--	2026-05-06 08:42
monit.aug	2.13 KB	-rw-r--r--	2026-05-06 08:42
multipath.aug	4.21 KB	-rw-r--r--	2026-05-06 08:42
mysql.aug	1.95 KB	-rw-r--r--	2026-05-06 08:42
nagioscfg.aug	2.09 KB	-rw-r--r--	2026-05-06 08:42
nagiosobjects.aug	1.57 KB	-rw-r--r--	2026-05-06 08:42
netmasks.aug	1.69 KB	-rw-r--r--	2026-05-06 08:42
networkmanager.aug	2.18 KB	-rw-r--r--	2026-05-06 08:42
networks.aug	1.09 KB	-rw-r--r--	2026-05-06 08:42
nginx.aug	3.65 KB	-rw-r--r--	2026-05-06 08:42
nrpe.aug	1.78 KB	-rw-r--r--	2026-05-06 08:42
nslcd.aug	9.87 KB	-rw-r--r--	2026-05-06 08:42
nsswitch.aug	2.33 KB	-rw-r--r--	2026-05-06 08:42
ntp.aug	5.29 KB	-rw-r--r--	2026-05-06 08:42
ntpd.aug	4.75 KB	-rw-r--r--	2026-05-06 08:42
odbc.aug	1.42 KB	-rw-r--r--	2026-05-06 08:42
opendkim.aug	3.1 KB	-rw-r--r--	2026-05-06 08:42
openshift_config.aug	2.46 KB	-rw-r--r--	2026-05-06 08:42
openshift_http.aug	1.03 KB	-rw-r--r--	2026-05-06 08:42
openshift_quickstarts.aug	1.02 KB	-rw-r--r--	2026-05-06 08:42
openvpn.aug	22.28 KB	-rw-r--r--	2026-05-06 08:42
oz.aug	1.35 KB	-rw-r--r--	2026-05-06 08:42
pagekite.aug	2.6 KB	-rw-r--r--	2026-05-06 08:42
pam.aug	2.58 KB	-rw-r--r--	2026-05-06 08:42
pamconf.aug	1.23 KB	-rw-r--r--	2026-05-06 08:42
passwd.aug	3.52 KB	-rw-r--r--	2026-05-06 08:42
pbuilder.aug	638 B	-rw-r--r--	2026-05-06 08:42
pg_hba.aug	2.97 KB	-rw-r--r--	2026-05-06 08:42
pgbouncer.aug	1.43 KB	-rw-r--r--	2026-05-06 08:42
php.aug	2.34 KB	-rw-r--r--	2026-05-06 08:42
phpvars.aug	3.85 KB	-rw-r--r--	2026-05-06 08:42
postfix_access.aug	771 B	-rw-r--r--	2026-05-06 08:42
postfix_main.aug	1.52 KB	-rw-r--r--	2026-05-06 08:42
postfix_master.aug	1.9 KB	-rw-r--r--	2026-05-06 08:42
postfix_passwordmap.aug	1.28 KB	-rw-r--r--	2026-05-06 08:42
postfix_sasl_smtpd.aug	697 B	-rw-r--r--	2026-05-06 08:42
postfix_transport.aug	1.48 KB	-rw-r--r--	2026-05-06 08:42
postfix_virtual.aug	1.32 KB	-rw-r--r--	2026-05-06 08:42
postgresql.aug	2.1 KB	-rw-r--r--	2026-05-06 08:42
properties.aug	2.3 KB	-rw-r--r--	2026-05-06 08:42
protocols.aug	1.05 KB	-rw-r--r--	2026-05-06 08:42
puppet.aug	1.52 KB	-rw-r--r--	2026-05-06 08:42
puppet_auth.aug	1.95 KB	-rw-r--r--	2026-05-06 08:42
puppetfile.aug	2.27 KB	-rw-r--r--	2026-05-06 08:42
puppetfileserver.aug	3.12 KB	-rw-r--r--	2026-05-06 08:42
pylonspaste.aug	2.3 KB	-rw-r--r--	2026-05-06 08:42
pythonpaste.aug	1.99 KB	-rw-r--r--	2026-05-06 08:42
qpid.aug	670 B	-rw-r--r--	2026-05-06 08:42
quote.aug	6.71 KB	-rw-r--r--	2026-05-06 08:42
rabbitmq.aug	4.69 KB	-rw-r--r--	2026-05-06 08:42
radicale.aug	1.48 KB	-rw-r--r--	2026-05-06 08:42
rancid.aug	927 B	-rw-r--r--	2026-05-06 08:42
redis.aug	6.5 KB	-rw-r--r--	2026-05-06 08:42
reprepro_uploaders.aug	5.47 KB	-rw-r--r--	2026-05-06 08:42
resolv.aug	4.03 KB	-rw-r--r--	2026-05-06 08:42
rhsm.aug	1.1 KB	-rw-r--r--	2026-05-06 08:42
rmt.aug	788 B	-rw-r--r--	2026-05-06 08:42
rsyncd.aug	1.97 KB	-rw-r--r--	2026-05-06 08:42
rsyslog.aug	3.27 KB	-rw-r--r--	2026-05-06 08:42
rtadvd.aug	854 B	-rw-r--r--	2026-05-06 08:42
rx.aug	4.2 KB	-rw-r--r--	2026-05-06 08:42
samba.aug	1.71 KB	-rw-r--r--	2026-05-06 08:42
schroot.aug	1.79 KB	-rw-r--r--	2026-05-06 08:42
securetty.aug	450 B	-rw-r--r--	2026-05-06 08:42
semanage.aug	1.02 KB	-rw-r--r--	2026-05-06 08:42
sep.aug	1.28 KB	-rw-r--r--	2026-05-06 08:42
services.aug	2.82 KB	-rw-r--r--	2026-05-06 08:42
shadow.aug	2.35 KB	-rw-r--r--	2026-05-06 08:42
shells.aug	745 B	-rw-r--r--	2026-05-06 08:42
shellvars.aug	12.02 KB	-rw-r--r--	2026-05-06 08:42
shellvars_list.aug	1.74 KB	-rw-r--r--	2026-05-06 08:42
simplelines.aug	1.13 KB	-rw-r--r--	2026-05-06 08:42
simplevars.aug	1.4 KB	-rw-r--r--	2026-05-06 08:42
sip_conf.aug	1.61 KB	-rw-r--r--	2026-05-06 08:42
slapd.aug	5.2 KB	-rw-r--r--	2026-05-06 08:42
smbusers.aug	781 B	-rw-r--r--	2026-05-06 08:42
solaris_system.aug	3.15 KB	-rw-r--r--	2026-05-06 08:42
soma.aug	1.14 KB	-rw-r--r--	2026-05-06 08:42
sos.aug	807 B	-rw-r--r--	2026-05-06 08:42
spacevars.aug	1.42 KB	-rw-r--r--	2026-05-06 08:42
splunk.aug	1.64 KB	-rw-r--r--	2026-05-06 08:42
squid.aug	15.95 KB	-rw-r--r--	2026-05-06 08:42
ssh.aug	4.39 KB	-rw-r--r--	2026-05-06 08:42
sshd.aug	4.6 KB	-rw-r--r--	2026-05-06 08:42
sssd.aug	861 B	-rw-r--r--	2026-05-06 08:42
star.aug	941 B	-rw-r--r--	2026-05-06 08:42
strongswan.aug	1.63 KB	-rw-r--r--	2026-05-06 08:42
stunnel.aug	2.21 KB	-rw-r--r--	2026-05-06 08:42
subversion.aug	2.75 KB	-rw-r--r--	2026-05-06 08:42
sudoers.aug	20.08 KB	-rw-r--r--	2026-05-06 08:42
sysconfig.aug	2.49 KB	-rw-r--r--	2026-05-06 08:42
sysconfig_route.aug	2.55 KB	-rw-r--r--	2026-05-06 08:42
sysctl.aug	1.36 KB	-rw-r--r--	2026-05-06 08:42
syslog.aug	7.33 KB	-rw-r--r--	2026-05-06 08:42
systemd.aug	6 KB	-rw-r--r--	2026-05-06 08:42
termcap.aug	1.03 KB	-rw-r--r--	2026-05-06 08:42
thttpd.aug	1.31 KB	-rw-r--r--	2026-05-06 08:42
tinc.aug	1.08 KB	-rw-r--r--	2026-05-06 08:42
tmpfiles.aug	3.08 KB	-rw-r--r--	2026-05-06 08:42
toml.aug	4.21 KB	-rw-r--r--	2026-05-06 08:42
trapperkeeper.aug	4.01 KB	-rw-r--r--	2026-05-06 08:42
tuned.aug	387 B	-rw-r--r--	2026-05-06 08:42
up2date.aug	2.21 KB	-rw-r--r--	2026-05-06 08:42
updatedb.aug	1.13 KB	-rw-r--r--	2026-05-06 08:42
util.aug	4.85 KB	-rw-r--r--	2026-05-06 08:42
vfstab.aug	1.71 KB	-rw-r--r--	2026-05-06 08:42
vmware_config.aug	702 B	-rw-r--r--	2026-05-06 08:42
vsftpd.aug	2.72 KB	-rw-r--r--	2026-05-06 08:42
webmin.aug	1.23 KB	-rw-r--r--	2026-05-06 08:42
wine.aug	1.92 KB	-rw-r--r--	2026-05-06 08:42
xendconfsxp.aug	1.07 KB	-rw-r--r--	2026-05-06 08:42
xinetd.aug	4.02 KB	-rw-r--r--	2026-05-06 08:42
xml.aug	6.33 KB	-rw-r--r--	2026-05-06 08:42
xorg.aug	10.43 KB	-rw-r--r--	2026-05-06 08:42
xymon.aug	2.26 KB	-rw-r--r--	2026-05-06 08:42
xymon_alerting.aug	6.11 KB	-rw-r--r--	2026-05-06 08:42
yaml.aug	1.54 KB	-rw-r--r--	2026-05-06 08:42
yum.aug	2.19 KB	-rw-r--r--	2026-05-06 08:42

Rename

(*
Module: Build
   Generic functions to build lenses

Author: Raphael Pinson <raphink@gmail.com>

About: License
  This file is licensed under the LGPL v2+, like the rest of Augeas.

About: Reference
  This file provides generic functions to build Augeas lenses
*)

module Build =

let eol = Util.eol

(************************************************************************
 * Group:               GENERIC CONSTRUCTIONS
 ************************************************************************)

(************************************************************************
 * View: brackets
 *   Put a lens inside brackets
 *
 *   Parameters:
 *     l:lens   - the left bracket lens
 *     r: lens  - the right bracket lens
 *     lns:lens - the lens to put inside brackets
 ************************************************************************)
let brackets (l:lens) (r:lens) (lns:lens) = l . lns . r

(************************************************************************
 * Group:             LIST CONSTRUCTIONS
 ************************************************************************)

(************************************************************************
 * View: list
 *   Build a list of identical lenses separated with a given separator
 *   (at least 2 elements)
 *
 *   Parameters:
 *     lns:lens - the lens to repeat in the list
 *     sep:lens - the separator lens, which can be taken from the <Sep> module
 ************************************************************************)
let list (lns:lens) (sep:lens) = lns . ( sep . lns )+

(************************************************************************
 * View: opt_list
 *   Same as <list>, but there might be only one element in the list
 *
 *   Parameters:
 *     lns:lens - the lens to repeat in the list
 *     sep:lens - the separator lens, which can be taken from the <Sep> module
 ************************************************************************)
let opt_list (lns:lens) (sep:lens) = lns . ( sep . lns )*

(************************************************************************
 * Group:                   LABEL OPERATIONS
 ************************************************************************)

(************************************************************************
 * View: xchg
 *   Replace a pattern with a different label in the tree,
 *   thus emulating a key but allowing to replace the keyword
 *   with a different value than matched
 *
 *   Parameters:
 *     m:regexp - the pattern to match
 *     d:string - the default value when a node in created
 *     l:string - the label to apply for such nodes
 ************************************************************************)
let xchg (m:regexp) (d:string) (l:string) = del m d . label l

(************************************************************************
 * View: xchgs
 *   Same as <xchg>, but the pattern is the default string
 *
 *   Parameters:
 *     m:string - the string to replace, also used as default
 *     l:string - the label to apply for such nodes
 ************************************************************************)
let xchgs (m:string) (l:string) = xchg m m l

(************************************************************************
 * Group:                   SUBNODE CONSTRUCTIONS
 ************************************************************************)

(************************************************************************
 * View: key_value_line
 *   A subnode with a keyword, a separator and a storing lens,
 *   and an end of line
 *
 *   Parameters:
 *     kw:regexp - the pattern to match as key
 *     sep:lens  - the separator lens, which can be taken from the <Sep> module
 *     sto:lens  - the storing lens
 ************************************************************************)
let key_value_line (kw:regexp) (sep:lens) (sto:lens) =
                                   [ key kw . sep . sto . eol ]

(************************************************************************
 * View: key_value_line_comment
 *   Same as <key_value_line>, but allows to have a comment in the end of a line
 *   and an end of line
 *
 *   Parameters:
 *     kw:regexp    - the pattern to match as key
 *     sep:lens     - the separator lens, which can be taken from the <Sep> module
 *     sto:lens     - the storing lens
 *     comment:lens - the comment lens, which can be taken from <Util>
 ************************************************************************)
let key_value_line_comment (kw:regexp) (sep:lens) (sto:lens) (comment:lens) =
                                   [ key kw . sep . sto . (eol|comment) ]

(************************************************************************
 * View: key_value
 *   Same as <key_value_line>, but does not end with an end of line
 *
 *   Parameters:
 *     kw:regexp - the pattern to match as key
 *     sep:lens  - the separator lens, which can be taken from the <Sep> module
 *     sto:lens  - the storing lens
 ************************************************************************)
let key_value (kw: regexp) (sep:lens) (sto:lens) =
                                   [ key kw . sep . sto ]

(************************************************************************
 * View: key_ws_value
 *
 *   Store a key/value pair where key and value are separated by whitespace
 *   and the value goes to the end of the line. Leading and trailing
 *   whitespace is stripped from the value. The end of line is consumed by
 *   this lens
 *
 *   Parameters:
 *     kw:regexp - the pattern to match as key
 ************************************************************************)
let key_ws_value (kw:regexp) =
  key_value_line kw Util.del_ws_spc (store Rx.space_in)

(************************************************************************
 * View: flag
 *   A simple flag subnode, consisting of a single key
 *
 *   Parameters:
 *     kw:regexp - the pattern to match as key
 ************************************************************************)
let flag (kw:regexp) = [ key kw ]

(************************************************************************
 * View: flag_line
 *   A simple flag line, consisting of a single key
 *
 *   Parameters:
 *     kw:regexp - the pattern to match as key
 ************************************************************************)
let flag_line (kw:regexp) = [ key kw . eol ]

(************************************************************************
 * Group:                   BLOCK CONSTRUCTIONS
 ************************************************************************)

(************************************************************************
 * View: block_generic
 *   A block enclosed in brackets
 *
 *   Parameters:
 *     entry:lens                - the entry to be stored inside the block.
 *                                 This entry should include <Util.empty>
 *                                 or its equivalent if necessary.
 *     entry_noindent:lens       - the entry to be stored inside the block,
 *                                 without indentation.
 *                                 This entry should not include <Util.empty>
 *     entry_noeol:lens          - the entry to be stored inside the block,
 *                                 without eol.
 *                                 This entry should not include <Util.empty>
 *     entry_noindent_noeol:lens - the entry to be stored inside the block,
 *                                 without indentation or eol.
 *                                 This entry should not include <Util.empty>
 *     comment:lens              - the comment lens used in the block
 *     comment_noindent:lens     - the comment lens used in the block,
 *                                 without indentation.
 *     ldelim_re:regexp          - regexp for the left delimiter
 *     rdelim_re:regexp          - regexp for the right delimiter
 *     ldelim_default:string     - default value for the left delimiter
 *     rdelim_default:string     - default value for the right delimiter
 ************************************************************************)
let block_generic
     (entry:lens) (entry_noindent:lens)
     (entry_noeol:lens) (entry_noindent_noeol:lens)
     (comment:lens) (comment_noindent:lens)
     (ldelim_re:regexp) (rdelim_re:regexp)
     (ldelim_default:string) (rdelim_default:string) =
     let block_single = entry_noindent_noeol | comment_noindent
  in let block_start  = entry_noindent | comment_noindent
  in let block_middle = (entry | comment)*
  in let block_end    = entry_noeol | comment
  in del ldelim_re ldelim_default
     . ( ( block_start . block_middle . block_end )
       | block_single )
     . del rdelim_re rdelim_default

(************************************************************************
 * View: block_setdefault
 *   A block enclosed in brackets
 *
 *   Parameters:
 *     entry:lens - the entry to be stored inside the block.
 *                  This entry should not include <Util.empty>,
 *                  <Util.comment> or <Util.comment_noindent>,
 *                  should not be indented or finish with an eol.
 *     ldelim_re:regexp      - regexp for the left delimiter
 *     rdelim_re:regexp      - regexp for the left delimiter
 *     ldelim_default:string - default value for the left delimiter
 *     rdelim_default:string - default value for the right delimiter
 ************************************************************************)
let block_setdelim (entry:lens)
                     (ldelim_re:regexp)
                     (rdelim_re:regexp)
                     (ldelim_default:string)
                     (rdelim_default:string) =
    block_generic (Util.empty | Util.indent . entry . eol)
                  (entry . eol) (Util.indent . entry) entry
                  Util.comment Util.comment_noindent
                  ldelim_re rdelim_re
                  ldelim_default rdelim_default

(* Variable: block_ldelim_re *)
let block_ldelim_re = /[ \t\n]+\{[ \t\n]*/

(* Variable: block_rdelim_re *)
let block_rdelim_re = /[ \t\n]*\}/

(* Variable: block_ldelim_default *)
let block_ldelim_default = " {\n"

(* Variable: block_rdelim_default *)
let block_rdelim_default = "}"

(************************************************************************
 * View: block
 *   A block enclosed in brackets
 *
 *   Parameters:
 *     entry:lens - the entry to be stored inside the block.
 *                  This entry should not include <Util.empty>,
 *                  <Util.comment> or <Util.comment_noindent>,
 *                  should not be indented or finish with an eol.
 ************************************************************************)
let block (entry:lens) = block_setdelim entry
                         block_ldelim_re block_rdelim_re
                         block_ldelim_default block_rdelim_default

(* Variable: block_ldelim_newlines_re *)
let block_ldelim_newlines_re = /[ \t\n]*\{([ \t\n]*\n)?/

(* Variable: block_rdelim_newlines_re *)
let block_rdelim_newlines_re = /[ \t]*\}/

(* Variable: block_ldelim_newlines_default *)
let block_ldelim_newlines_default = "\n{\n"

(* Variable: block_rdelim_newlines_default *)
let block_rdelim_newlines_default = "}"

(************************************************************************
 * View: block_newline
 *   A block enclosed in brackets, with newlines forced
 *   and indentation defaulting to a tab.
 *
 *   Parameters:
 *     entry:lens - the entry to be stored inside the block.
 *                  This entry should not include <Util.empty>,
 *                  <Util.comment> or <Util.comment_noindent>,
 *                  should be indented and finish with an eol.
 ************************************************************************)
let block_newlines (entry:lens) (comment:lens) =
   del block_ldelim_newlines_re block_ldelim_newlines_default
 . ((entry | comment) . (Util.empty | entry | comment)*)?
 . del block_rdelim_newlines_re block_rdelim_newlines_default

(************************************************************************
 * View: block_newlines_spc
 *   A block enclosed in brackets, with newlines forced
 *   and indentation defaulting to a tab. The opening brace
 *   must be preceded by whitespace
 *
 *   Parameters:
 *     entry:lens - the entry to be stored inside the block.
 *                  This entry should not include <Util.empty>,
 *                  <Util.comment> or <Util.comment_noindent>,
 *                  should be indented and finish with an eol.
 ************************************************************************)
let block_newlines_spc (entry:lens) (comment:lens) =
   del (/[ \t\n]/ . block_ldelim_newlines_re) block_ldelim_newlines_default
 . ((entry | comment) . (Util.empty | entry | comment)*)?
 . del block_rdelim_newlines_re block_rdelim_newlines_default

(************************************************************************
 * View: named_block
 *   A named <block> enclosed in brackets
 *
 *   Parameters:
 *     kw:regexp  - the regexp for the block name
 *     entry:lens - the entry to be stored inside the block
 *                   this entry should not include <Util.empty>
 ************************************************************************)
let named_block (kw:regexp) (entry:lens) = [ key kw . block entry . eol ]

(************************************************************************
 * Group:               COMBINATORICS
 ************************************************************************)

(************************************************************************
 * View: combine_two_ord
 *   Combine two lenses, ensuring first lens is first
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 ************************************************************************)
let combine_two_ord (a:lens) (b:lens) = a . b

(************************************************************************
 * View: combine_two
 *   Combine two lenses
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 ************************************************************************)
let combine_two (a:lens) (b:lens) =
  combine_two_ord a b | combine_two_ord b a

(************************************************************************
 * View: combine_two_opt_ord
 *   Combine two lenses optionally, ensuring first lens is first
 *   (a, and optionally b)
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 ************************************************************************)
let combine_two_opt_ord (a:lens) (b:lens) = a . b?

(************************************************************************
 * View: combine_two_opt
 *   Combine two lenses optionally
 *   (either a, b, or both, in any order)
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 ************************************************************************)
let combine_two_opt (a:lens) (b:lens) =
  combine_two_opt_ord a b | combine_two_opt_ord b a

(************************************************************************
 * View: combine_three_ord
 *   Combine three lenses, ensuring first lens is first
 *   (a followed by either b, c, in any order)
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 *     c:lens - the third lens
 ************************************************************************)
let combine_three_ord (a:lens) (b:lens) (c:lens) =
  combine_two_ord a (combine_two b c)

(************************************************************************
 * View: combine_three
 *   Combine three lenses
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 *     c:lens - the third lens
 ************************************************************************)
let combine_three (a:lens) (b:lens) (c:lens) =
    combine_three_ord a b c
  | combine_three_ord b a c
  | combine_three_ord c b a

(************************************************************************
 * View: combine_three_opt_ord
 *   Combine three lenses optionally, ensuring first lens is first
 *   (a followed by either b, c, or any of them, in any order)
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 *     c:lens - the third lens
 ************************************************************************)
let combine_three_opt_ord (a:lens) (b:lens) (c:lens) =
  combine_two_opt_ord a (combine_two_opt b c)

(************************************************************************
 * View: combine_three_opt
 *   Combine three lenses optionally
 *   (either a, b, c, or any of them, in any order)
 *
 *   Parameters:
 *     a:lens - the first lens
 *     b:lens - the second lens
 *     c:lens - the third lens
 ************************************************************************)
let combine_three_opt (a:lens) (b:lens) (c:lens) =
    combine_three_opt_ord a b c
  | combine_three_opt_ord b a c
  | combine_three_opt_ord c b a