Gecko [ www.foryou-vip.com ]

Name	Size	Permission	Date
tests	[ DIR ]	drwxrwxrwx	2020-08-25 15:28
access.aug	3.58 KB	-rwxrwxrwx	2017-08-18 07:56
activemq_conf.aug	1.47 KB	-rwxrwxrwx	2017-08-18 07:56
activemq_xml.aug	864 B	-rwxrwxrwx	2017-08-18 07:56
afs_cellalias.aug	1.56 KB	-rwxrwxrwx	2017-08-18 07:56
aliases.aug	2.18 KB	-rwxrwxrwx	2017-08-18 07:56
anacron.aug	2.49 KB	-rwxrwxrwx	2017-08-18 07:56
approx.aug	1.26 KB	-rwxrwxrwx	2017-08-18 07:56
apt_update_manager.aug	1.11 KB	-rwxrwxrwx	2017-08-18 07:56
aptcacherngsecurity.aug	726 B	-rwxrwxrwx	2017-08-18 07:56
aptconf.aug	3.89 KB	-rwxrwxrwx	2017-08-18 07:56
aptpreferences.aug	1.79 KB	-rwxrwxrwx	2017-08-18 07:56
aptsources.aug	1.98 KB	-rwxrwxrwx	2017-08-18 07:56
authorized_keys.aug	1.84 KB	-rwxrwxrwx	2017-08-18 07:56
automaster.aug	3.31 KB	-rwxrwxrwx	2017-08-18 07:56
automounter.aug	4.05 KB	-rwxrwxrwx	2017-08-18 07:56
avahi.aug	1.38 KB	-rwxrwxrwx	2017-08-18 07:56
backuppchosts.aug	1014 B	-rwxrwxrwx	2017-08-18 07:56
bbhosts.aug	4.24 KB	-rwxrwxrwx	2017-08-18 07:56
bootconf.aug	3.65 KB	-rwxrwxrwx	2017-08-18 07:56
build.aug	16.65 KB	-rwxrwxrwx	2017-08-18 07:56
cachefilesd.aug	2 KB	-rwxrwxrwx	2017-08-18 07:56
carbon.aug	1.54 KB	-rwxrwxrwx	2017-08-18 07:56
cgconfig.aug	3.35 KB	-rwxrwxrwx	2017-08-18 07:56
cgrules.aug	2.38 KB	-rwxrwxrwx	2017-08-18 07:56
channels.aug	3.84 KB	-rwxrwxrwx	2017-08-18 07:56
chrony.aug	12.7 KB	-rwxrwxrwx	2017-08-18 07:56
clamav.aug	1.53 KB	-rwxrwxrwx	2017-08-18 07:56
cobblermodules.aug	398 B	-rwxrwxrwx	2017-08-18 07:56
cobblersettings.aug	2.24 KB	-rwxrwxrwx	2017-08-18 07:56
collectd.aug	869 B	-rwxrwxrwx	2017-08-18 07:56
cpanel.aug	824 B	-rwxrwxrwx	2017-08-18 07:56
cron.aug	4.05 KB	-rwxrwxrwx	2017-08-18 07:56
cron_user.aug	1.26 KB	-rwxrwxrwx	2017-08-18 07:56
crypttab.aug	3.01 KB	-rwxrwxrwx	2017-08-18 07:56
csv.aug	1.18 KB	-rwxrwxrwx	2017-08-18 07:56
cups.aug	459 B	-rwxrwxrwx	2017-08-18 07:56
cyrus_imapd.aug	1.51 KB	-rwxrwxrwx	2017-08-18 07:56
darkice.aug	773 B	-rwxrwxrwx	2017-08-18 07:56
debctrl.aug	3.61 KB	-rwxrwxrwx	2017-08-18 07:56
desktop.aug	1.39 KB	-rwxrwxrwx	2017-08-18 07:56
device_map.aug	620 B	-rwxrwxrwx	2017-08-18 07:56
dhclient.aug	6.61 KB	-rwxrwxrwx	2017-08-18 07:56
dhcpd.aug	20.88 KB	-rwxrwxrwx	2017-08-18 07:56
dns_zone.aug	2.89 KB	-rwxrwxrwx	2017-08-18 07:56
dnsmasq.aug	2.16 KB	-rwxrwxrwx	2017-08-18 07:56
dovecot.aug	3.86 KB	-rwxrwxrwx	2017-08-18 07:56
dpkg.aug	2.79 KB	-rwxrwxrwx	2017-08-18 07:56
dput.aug	2.16 KB	-rwxrwxrwx	2017-08-18 07:56
erlang.aug	4.33 KB	-rwxrwxrwx	2017-08-18 07:56
ethers.aug	663 B	-rwxrwxrwx	2017-08-18 07:56
exports.aug	2.37 KB	-rwxrwxrwx	2017-08-18 07:56
fai_diskconfig.aug	9.28 KB	-rwxrwxrwx	2017-08-18 07:56
fonts.aug	819 B	-rwxrwxrwx	2017-08-18 07:56
fstab.aug	1.2 KB	-rwxrwxrwx	2017-08-18 07:56
fuse.aug	871 B	-rwxrwxrwx	2017-08-18 07:56
gdm.aug	1.8 KB	-rwxrwxrwx	2017-08-18 07:56
group.aug	1.66 KB	-rwxrwxrwx	2017-08-18 07:56
grub.aug	9.53 KB	-rwxrwxrwx	2017-08-18 07:56
gshadow.aug	2.19 KB	-rwxrwxrwx	2017-08-18 07:56
gtkbookmarks.aug	855 B	-rwxrwxrwx	2017-08-18 07:56
host_conf.aug	1.9 KB	-rwxrwxrwx	2017-08-18 07:56
hostname.aug	422 B	-rwxrwxrwx	2017-08-18 07:56
hosts.aug	485 B	-rwxrwxrwx	2017-08-18 07:56
hosts_access.aug	4.32 KB	-rwxrwxrwx	2017-08-18 07:56
htpasswd.aug	1.02 KB	-rwxrwxrwx	2017-08-18 07:56
httpd.aug	5.12 KB	-rwxrwxrwx	2017-08-18 07:56
inetd.aug	6.22 KB	-rwxrwxrwx	2017-08-18 07:56
inifile.aug	15.49 KB	-rwxrwxrwx	2017-08-18 07:56
inittab.aug	780 B	-rwxrwxrwx	2017-08-18 07:56
inputrc.aug	1.62 KB	-rwxrwxrwx	2017-08-18 07:56
interfaces.aug	4.62 KB	-rwxrwxrwx	2017-08-18 07:56
iproute2.aug	323 B	-rwxrwxrwx	2017-08-18 07:56
iptables.aug	2.64 KB	-rwxrwxrwx	2017-08-18 07:56
iscsid.aug	684 B	-rwxrwxrwx	2017-08-18 07:56
jaas.aug	1.57 KB	-rwxrwxrwx	2017-08-18 07:56
jettyrealm.aug	1.52 KB	-rwxrwxrwx	2017-08-18 07:56
jmxaccess.aug	1.35 KB	-rwxrwxrwx	2017-08-18 07:56
jmxpassword.aug	1.34 KB	-rwxrwxrwx	2017-08-18 07:56
json.aug	2.01 KB	-rwxrwxrwx	2017-08-18 07:56
kdump.aug	2.91 KB	-rwxrwxrwx	2017-08-18 07:56
keepalived.aug	10.7 KB	-rwxrwxrwx	2017-08-18 07:56
known_hosts.aug	1.93 KB	-rwxrwxrwx	2017-08-18 07:56
koji.aug	898 B	-rwxrwxrwx	2017-08-18 07:56
krb5.aug	6.13 KB	-rwxrwxrwx	2017-08-18 07:56
ldif.aug	7.65 KB	-rwxrwxrwx	2017-08-18 07:56
ldso.aug	1.06 KB	-rwxrwxrwx	2017-08-18 07:56
lightdm.aug	1.75 KB	-rwxrwxrwx	2017-08-18 07:56
limits.aug	2.02 KB	-rwxrwxrwx	2017-08-18 07:56
login_defs.aug	615 B	-rwxrwxrwx	2017-08-18 07:56
logrotate.aug	4.2 KB	-rwxrwxrwx	2017-08-18 07:56
logwatch.aug	1.44 KB	-rwxrwxrwx	2017-08-18 07:56
lokkit.aug	2.16 KB	-rwxrwxrwx	2017-08-18 07:56
lvm.aug	2.03 KB	-rwxrwxrwx	2017-08-18 07:56
mailscanner.aug	1.66 KB	-rwxrwxrwx	2017-08-18 07:56
mailscanner_rules.aug	2.84 KB	-rwxrwxrwx	2017-08-18 07:56
masterpasswd.aug	4.36 KB	-rwxrwxrwx	2017-08-18 07:56
mcollective.aug	1.09 KB	-rwxrwxrwx	2017-08-18 07:56
mdadm_conf.aug	10.05 KB	-rwxrwxrwx	2017-08-18 07:56
memcached.aug	1.24 KB	-rwxrwxrwx	2017-08-18 07:56
mke2fs.aug	4.67 KB	-rwxrwxrwx	2017-08-18 07:56
modprobe.aug	3.34 KB	-rwxrwxrwx	2017-08-18 07:56
modules.aug	741 B	-rwxrwxrwx	2017-08-18 07:56
modules_conf.aug	1.04 KB	-rwxrwxrwx	2017-08-18 07:56
mongodbserver.aug	1.17 KB	-rwxrwxrwx	2017-08-18 07:56
monit.aug	2.13 KB	-rwxrwxrwx	2017-08-18 07:56
multipath.aug	4.09 KB	-rwxrwxrwx	2017-08-18 07:56
mysql.aug	1.95 KB	-rwxrwxrwx	2017-08-18 07:56
nagioscfg.aug	2.09 KB	-rwxrwxrwx	2017-08-18 07:56
nagiosobjects.aug	1.57 KB	-rwxrwxrwx	2017-08-18 07:56
netmasks.aug	1.69 KB	-rwxrwxrwx	2017-08-18 07:56
networkmanager.aug	2 KB	-rwxrwxrwx	2017-08-18 07:56
networks.aug	1.09 KB	-rwxrwxrwx	2017-08-18 07:56
nginx.aug	3.37 KB	-rwxrwxrwx	2017-08-18 07:56
nrpe.aug	1.78 KB	-rwxrwxrwx	2017-08-18 07:56
nsswitch.aug	2.27 KB	-rwxrwxrwx	2017-08-18 07:56
ntp.aug	5.25 KB	-rwxrwxrwx	2017-08-18 07:56
ntpd.aug	4.75 KB	-rwxrwxrwx	2017-08-18 07:56
odbc.aug	1.42 KB	-rwxrwxrwx	2017-08-18 07:56
opendkim.aug	3.08 KB	-rwxrwxrwx	2017-08-18 07:56
openshift_config.aug	2.46 KB	-rwxrwxrwx	2017-08-18 07:56
openshift_http.aug	1.03 KB	-rwxrwxrwx	2017-08-18 07:56
openshift_quickstarts.aug	1.02 KB	-rwxrwxrwx	2017-08-18 07:56
openvpn.aug	22.28 KB	-rwxrwxrwx	2017-08-18 07:56
pagekite.aug	2.6 KB	-rwxrwxrwx	2017-08-18 07:56
pam.aug	2.24 KB	-rwxrwxrwx	2017-08-18 07:56
pamconf.aug	1.23 KB	-rwxrwxrwx	2017-08-18 07:56
passwd.aug	3.52 KB	-rwxrwxrwx	2017-08-18 07:56
pbuilder.aug	638 B	-rwxrwxrwx	2017-08-18 07:56
pg_hba.aug	2.97 KB	-rwxrwxrwx	2017-08-18 07:56
pgbouncer.aug	1.43 KB	-rwxrwxrwx	2017-08-18 07:56
php.aug	2.34 KB	-rwxrwxrwx	2017-08-18 07:56
phpvars.aug	3.85 KB	-rwxrwxrwx	2017-08-18 07:56
postfix_access.aug	732 B	-rwxrwxrwx	2017-08-18 07:56
postfix_main.aug	1.46 KB	-rwxrwxrwx	2017-08-18 07:56
postfix_master.aug	1.84 KB	-rwxrwxrwx	2017-08-18 07:56
postfix_passwordmap.aug	1.23 KB	-rwxrwxrwx	2017-08-18 07:56
postfix_sasl_smtpd.aug	636 B	-rwxrwxrwx	2017-08-18 07:56
postfix_transport.aug	1.43 KB	-rwxrwxrwx	2017-08-18 07:56
postfix_virtual.aug	1.27 KB	-rwxrwxrwx	2017-08-18 07:56
postgresql.aug	2.1 KB	-rwxrwxrwx	2017-08-18 07:56
properties.aug	2.25 KB	-rwxrwxrwx	2017-08-18 07:56
protocols.aug	1.05 KB	-rwxrwxrwx	2017-08-18 07:56
puppet.aug	1.52 KB	-rwxrwxrwx	2017-08-18 07:56
puppet_auth.aug	1.95 KB	-rwxrwxrwx	2017-08-18 07:56
puppetfile.aug	1.66 KB	-rwxrwxrwx	2017-08-18 07:56
puppetfileserver.aug	3.12 KB	-rwxrwxrwx	2017-08-18 07:56
pylonspaste.aug	2.3 KB	-rwxrwxrwx	2017-08-18 07:56
pythonpaste.aug	1.99 KB	-rwxrwxrwx	2017-08-18 07:56
qpid.aug	670 B	-rwxrwxrwx	2017-08-18 07:56
quote.aug	6.71 KB	-rwxrwxrwx	2017-08-18 07:56
rabbitmq.aug	4.69 KB	-rwxrwxrwx	2017-08-18 07:56
radicale.aug	1.48 KB	-rwxrwxrwx	2017-08-18 07:56
redis.aug	4.6 KB	-rwxrwxrwx	2017-08-18 07:56
reprepro_uploaders.aug	5.47 KB	-rwxrwxrwx	2017-08-18 07:56
resolv.aug	3.85 KB	-rwxrwxrwx	2017-08-18 07:56
rhsm.aug	1.1 KB	-rwxrwxrwx	2017-08-18 07:56
rmt.aug	788 B	-rwxrwxrwx	2017-08-18 07:56
rsyncd.aug	1.97 KB	-rwxrwxrwx	2017-08-18 07:56
rsyslog.aug	2.46 KB	-rwxrwxrwx	2017-08-18 07:56
rx.aug	4.06 KB	-rwxrwxrwx	2017-08-18 07:56
samba.aug	1.71 KB	-rwxrwxrwx	2017-08-18 07:56
schroot.aug	1.79 KB	-rwxrwxrwx	2017-08-18 07:56
securetty.aug	450 B	-rwxrwxrwx	2017-08-18 07:56
sep.aug	1.28 KB	-rwxrwxrwx	2017-08-18 07:56
services.aug	2.82 KB	-rwxrwxrwx	2017-08-18 07:56
shadow.aug	2.35 KB	-rwxrwxrwx	2017-08-18 07:56
shells.aug	745 B	-rwxrwxrwx	2017-08-18 07:56
shellvars.aug	11.63 KB	-rwxrwxrwx	2017-08-18 07:56
shellvars_list.aug	1.74 KB	-rwxrwxrwx	2017-08-18 07:56
simplelines.aug	1.13 KB	-rwxrwxrwx	2017-08-18 07:56
simplevars.aug	1.39 KB	-rwxrwxrwx	2017-08-18 07:56
sip_conf.aug	1.61 KB	-rwxrwxrwx	2017-08-18 07:56
slapd.aug	5.2 KB	-rwxrwxrwx	2017-08-18 07:56
smbusers.aug	781 B	-rwxrwxrwx	2017-08-18 07:56
solaris_system.aug	3.15 KB	-rwxrwxrwx	2017-08-18 07:56
soma.aug	1.14 KB	-rwxrwxrwx	2017-08-18 07:56
spacevars.aug	1.42 KB	-rwxrwxrwx	2017-08-18 07:56
splunk.aug	1.64 KB	-rwxrwxrwx	2017-08-18 07:56
squid.aug	15.95 KB	-rwxrwxrwx	2017-08-18 07:56
ssh.aug	3.57 KB	-rwxrwxrwx	2017-08-18 07:56
sshd.aug	3.76 KB	-rwxrwxrwx	2017-08-18 07:56
sssd.aug	861 B	-rwxrwxrwx	2017-08-18 07:56
star.aug	941 B	-rwxrwxrwx	2017-08-18 07:56
stunnel.aug	2.21 KB	-rwxrwxrwx	2017-08-18 07:56
subversion.aug	2.75 KB	-rwxrwxrwx	2017-08-18 07:56
sudoers.aug	19.96 KB	-rwxrwxrwx	2017-08-18 07:56
sysconfig.aug	2.49 KB	-rwxrwxrwx	2017-08-18 07:56
sysconfig_route.aug	2.55 KB	-rwxrwxrwx	2017-08-18 07:56
sysctl.aug	923 B	-rwxrwxrwx	2017-08-18 07:56
syslog.aug	7.22 KB	-rwxrwxrwx	2017-08-18 07:56
systemd.aug	5.65 KB	-rwxrwxrwx	2017-08-18 07:56
thttpd.aug	1.31 KB	-rwxrwxrwx	2017-08-18 07:56
tmpfiles.aug	3.03 KB	-rwxrwxrwx	2017-08-18 07:56
trapperkeeper.aug	4.01 KB	-rwxrwxrwx	2017-08-18 07:56
tuned.aug	387 B	-rwxrwxrwx	2017-08-18 07:56
up2date.aug	2.21 KB	-rwxrwxrwx	2017-08-18 07:56
updatedb.aug	1.13 KB	-rwxrwxrwx	2017-08-18 07:56
util.aug	4.85 KB	-rwxrwxrwx	2017-08-18 07:56
vfstab.aug	1.71 KB	-rwxrwxrwx	2017-08-18 07:56
vmware_config.aug	702 B	-rwxrwxrwx	2017-08-18 07:56
vsftpd.aug	2.7 KB	-rwxrwxrwx	2017-08-18 07:56
webmin.aug	1.23 KB	-rwxrwxrwx	2017-08-18 07:56
wine.aug	1.92 KB	-rwxrwxrwx	2017-08-18 07:56
xendconfsxp.aug	1.07 KB	-rwxrwxrwx	2017-08-18 07:56
xinetd.aug	4.02 KB	-rwxrwxrwx	2017-08-18 07:56
xml.aug	6.33 KB	-rwxrwxrwx	2017-08-18 07:56
xorg.aug	10.12 KB	-rwxrwxrwx	2017-08-18 07:56
xymon.aug	2.18 KB	-rwxrwxrwx	2017-08-18 07:56
xymon_alerting.aug	6.11 KB	-rwxrwxrwx	2017-08-18 07:56
yaml.aug	1.4 KB	-rwxrwxrwx	2017-08-18 07:56
yum.aug	2.19 KB	-rwxrwxrwx	2017-08-18 07:56

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