Gecko [ goons4good.org ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2022-10-11 05:09
inspectlib	[ DIR ]	drwxr-xr-x	2022-10-11 05:09
__init__.py	35 B	-rw-r--r--	2022-05-16 09:16
acme.py	12.74 KB	-rw-r--r--	2022-05-16 09:16
aix_group.py	4.11 KB	-rw-r--r--	2022-05-16 09:16
aix_shadow.py	1.93 KB	-rw-r--r--	2022-05-16 09:16
aixpkg.py	10.91 KB	-rw-r--r--	2022-05-16 09:16
aliases.py	5.07 KB	-rw-r--r--	2022-05-16 09:16
alternatives.py	5.1 KB	-rw-r--r--	2022-05-16 09:16
ansiblegate.py	11.38 KB	-rw-r--r--	2022-05-16 09:16
apache.py	12.47 KB	-rw-r--r--	2022-05-16 09:16
apcups.py	2.21 KB	-rw-r--r--	2022-05-16 09:16
apf.py	3.09 KB	-rw-r--r--	2022-05-16 09:16
apkpkg.py	16 KB	-rw-r--r--	2022-05-16 09:16
aptly.py	15.28 KB	-rw-r--r--	2022-05-16 09:16
aptpkg.py	102.35 KB	-rw-r--r--	2022-05-16 09:16
archive.py	46.97 KB	-rw-r--r--	2022-05-16 09:16
arista_pyeapi.py	22.06 KB	-rw-r--r--	2022-05-16 09:16
artifactory.py	24.78 KB	-rw-r--r--	2022-05-16 09:16
at.py	10.65 KB	-rw-r--r--	2022-05-16 09:16
at_solaris.py	8.56 KB	-rw-r--r--	2022-05-16 09:16
augeas_cfg.py	13.93 KB	-rw-r--r--	2022-05-16 09:16
aws_sqs.py	6.55 KB	-rw-r--r--	2022-05-16 09:16
azurearm_compute.py	19.55 KB	-rw-r--r--	2022-05-16 09:16
azurearm_dns.py	14.7 KB	-rw-r--r--	2022-05-16 09:16
azurearm_network.py	80.8 KB	-rw-r--r--	2022-05-16 09:16
azurearm_resource.py	34.27 KB	-rw-r--r--	2022-05-16 09:16
bamboohr.py	7.36 KB	-rw-r--r--	2022-05-16 09:16
baredoc.py	11.13 KB	-rw-r--r--	2022-05-16 09:16
bcache.py	28.97 KB	-rw-r--r--	2022-05-16 09:16
beacons.py	27.89 KB	-rw-r--r--	2022-05-16 09:16
bigip.py	69.11 KB	-rw-r--r--	2022-05-16 09:16
bluez_bluetooth.py	6.76 KB	-rw-r--r--	2022-05-16 09:16
boto3_elasticache.py	37.34 KB	-rw-r--r--	2022-05-16 09:16
boto3_elasticsearch.py	53.17 KB	-rw-r--r--	2022-05-16 09:16
boto3_route53.py	39.75 KB	-rw-r--r--	2022-05-16 09:16
boto3_sns.py	12.93 KB	-rw-r--r--	2022-05-16 09:16
boto_apigateway.py	61.86 KB	-rw-r--r--	2022-05-16 09:16
boto_asg.py	35.7 KB	-rw-r--r--	2022-05-16 09:16
boto_cfn.py	7.95 KB	-rw-r--r--	2022-05-16 09:16
boto_cloudfront.py	12.75 KB	-rw-r--r--	2022-05-16 09:16
boto_cloudtrail.py	14.45 KB	-rw-r--r--	2022-05-16 09:16
boto_cloudwatch.py	10.99 KB	-rw-r--r--	2022-05-16 09:16
boto_cloudwatch_event.py	9.48 KB	-rw-r--r--	2022-05-16 09:16
boto_cognitoidentity.py	14.63 KB	-rw-r--r--	2022-05-16 09:16
boto_datapipeline.py	6.94 KB	-rw-r--r--	2022-05-16 09:16
boto_dynamodb.py	10.54 KB	-rw-r--r--	2022-05-16 09:16
boto_ec2.py	79.29 KB	-rw-r--r--	2022-05-16 09:16
boto_efs.py	14.05 KB	-rw-r--r--	2022-05-16 09:16
boto_elasticache.py	23.69 KB	-rw-r--r--	2022-05-16 09:16
boto_elasticsearch_domain.py	15.85 KB	-rw-r--r--	2022-05-16 09:16
boto_elb.py	35.4 KB	-rw-r--r--	2022-05-16 09:16
boto_elbv2.py	10.81 KB	-rw-r--r--	2022-05-16 09:16
boto_iam.py	75.62 KB	-rw-r--r--	2022-05-16 09:16
boto_iot.py	26.2 KB	-rw-r--r--	2022-05-16 09:16
boto_kinesis.py	19.63 KB	-rw-r--r--	2022-05-16 09:16
boto_kms.py	17.29 KB	-rw-r--r--	2022-05-16 09:16
boto_lambda.py	35.05 KB	-rw-r--r--	2022-05-16 09:16
boto_rds.py	34.92 KB	-rw-r--r--	2022-05-16 09:16
boto_route53.py	32.55 KB	-rw-r--r--	2022-05-16 09:16
boto_s3.py	4.24 KB	-rw-r--r--	2022-05-16 09:16
boto_s3_bucket.py	31.8 KB	-rw-r--r--	2022-05-16 09:16
boto_secgroup.py	25.22 KB	-rw-r--r--	2022-05-16 09:16
boto_sns.py	7.22 KB	-rw-r--r--	2022-05-16 09:16
boto_sqs.py	6.43 KB	-rw-r--r--	2022-05-16 09:16
boto_ssm.py	3.65 KB	-rw-r--r--	2022-05-16 09:16
boto_vpc.py	112.81 KB	-rw-r--r--	2022-05-16 09:16
bower.py	5.89 KB	-rw-r--r--	2022-05-16 09:16
bridge.py	10.86 KB	-rw-r--r--	2022-05-16 09:16
bsd_shadow.py	6.92 KB	-rw-r--r--	2022-05-16 09:16
btrfs.py	33.64 KB	-rw-r--r--	2022-05-16 09:16
cabal.py	3.79 KB	-rw-r--r--	2022-05-16 09:16
capirca_acl.py	40.04 KB	-rw-r--r--	2022-05-16 09:16
cassandra_cql.py	39 KB	-rw-r--r--	2022-05-16 09:16
cassandra_mod.py	3.97 KB	-rw-r--r--	2022-05-16 09:16
celery.py	3.33 KB	-rw-r--r--	2022-05-16 09:16
ceph.py	15.82 KB	-rw-r--r--	2022-05-16 09:16
chassis.py	1.52 KB	-rw-r--r--	2022-05-16 09:16
chef.py	4.66 KB	-rw-r--r--	2022-05-16 09:16
chocolatey.py	39.34 KB	-rw-r--r--	2022-05-16 09:16
chronos.py	2.89 KB	-rw-r--r--	2022-05-16 09:16
chroot.py	11.51 KB	-rw-r--r--	2022-05-16 09:16
cimc.py	23.02 KB	-rw-r--r--	2022-05-16 09:16
ciscoconfparse_mod.py	14.79 KB	-rw-r--r--	2022-05-16 09:16
cisconso.py	3.83 KB	-rw-r--r--	2022-05-16 09:16
cloud.py	9.39 KB	-rw-r--r--	2022-05-16 09:16
cmdmod.py	162.16 KB	-rw-r--r--	2022-05-16 09:16
composer.py	10.31 KB	-rw-r--r--	2022-05-16 09:16
config.py	16.85 KB	-rw-r--r--	2022-05-16 09:16
consul.py	68.93 KB	-rw-r--r--	2022-05-16 09:16
container_resource.py	13.36 KB	-rw-r--r--	2022-05-16 09:16
cp.py	27.98 KB	-rw-r--r--	2022-05-16 09:16
cpan.py	5.54 KB	-rw-r--r--	2022-05-16 09:16
cron.py	26.8 KB	-rw-r--r--	2022-05-16 09:16
cryptdev.py	10.08 KB	-rw-r--r--	2022-05-16 09:16
csf.py	16.04 KB	-rw-r--r--	2022-05-16 09:16
cyg.py	8.32 KB	-rw-r--r--	2022-05-16 09:16
daemontools.py	5.41 KB	-rw-r--r--	2022-05-16 09:16
data.py	3.83 KB	-rw-r--r--	2022-05-16 09:16
datadog_api.py	7.64 KB	-rw-r--r--	2022-05-16 09:16
ddns.py	7.04 KB	-rw-r--r--	2022-05-16 09:16
deb_apache.py	7.41 KB	-rw-r--r--	2022-05-16 09:16
deb_postgres.py	4.22 KB	-rw-r--r--	2022-05-16 09:16
debconfmod.py	4.06 KB	-rw-r--r--	2022-05-16 09:16
debian_ip.py	64.78 KB	-rw-r--r--	2022-05-16 09:16
debian_service.py	6.6 KB	-rw-r--r--	2022-05-16 09:16
debuild_pkgbuild.py	34.69 KB	-rw-r--r--	2022-05-16 09:16
defaults.py	5.42 KB	-rw-r--r--	2022-05-16 09:16
devinfo.py	9.05 KB	-rw-r--r--	2022-05-16 09:16
devmap.py	627 B	-rw-r--r--	2022-05-16 09:16
dig.py	7.45 KB	-rw-r--r--	2022-05-16 09:16
disk.py	30.44 KB	-rw-r--r--	2022-05-16 09:16
djangomod.py	7.53 KB	-rw-r--r--	2022-05-16 09:16
dnsmasq.py	5.71 KB	-rw-r--r--	2022-05-16 09:16
dnsutil.py	11.51 KB	-rw-r--r--	2022-05-16 09:16
dockercompose.py	32.62 KB	-rw-r--r--	2022-05-16 09:16
dockermod.py	224.97 KB	-rw-r--r--	2022-05-16 09:16
dpkg_lowpkg.py	12.9 KB	-rw-r--r--	2022-05-16 09:16
drac.py	10.97 KB	-rw-r--r--	2022-05-16 09:16
dracr.py	38.53 KB	-rw-r--r--	2022-05-16 09:16
drbd.py	7.19 KB	-rw-r--r--	2022-05-16 09:16
dummyproxy_pkg.py	2.46 KB	-rw-r--r--	2022-05-16 09:16
dummyproxy_service.py	2.91 KB	-rw-r--r--	2022-05-16 09:16
ebuildpkg.py	38.74 KB	-rw-r--r--	2022-05-16 09:16
eix.py	1.58 KB	-rw-r--r--	2022-05-16 09:16
elasticsearch.py	51.44 KB	-rw-r--r--	2022-05-16 09:16
environ.py	8.96 KB	-rw-r--r--	2022-05-16 09:16
eselect.py	4.99 KB	-rw-r--r--	2022-05-16 09:16
esxcluster.py	502 B	-rw-r--r--	2022-05-16 09:16
esxdatacenter.py	514 B	-rw-r--r--	2022-05-16 09:16
esxi.py	1.64 KB	-rw-r--r--	2022-05-16 09:16
esxvm.py	481 B	-rw-r--r--	2022-05-16 09:16
etcd_mod.py	7.02 KB	-rw-r--r--	2022-05-16 09:16
ethtool.py	7.65 KB	-rw-r--r--	2022-05-16 09:16
event.py	8.23 KB	-rw-r--r--	2022-05-16 09:16
extfs.py	8.78 KB	-rw-r--r--	2022-05-16 09:16
file.py	224.74 KB	-rw-r--r--	2022-05-16 09:16
firewalld.py	20.51 KB	-rw-r--r--	2022-05-16 09:16
freebsd_sysctl.py	4.76 KB	-rw-r--r--	2022-05-16 09:16
freebsd_update.py	6.19 KB	-rw-r--r--	2022-05-16 09:16
freebsdjail.py	7.16 KB	-rw-r--r--	2022-05-16 09:16
freebsdkmod.py	6.17 KB	-rw-r--r--	2022-05-16 09:16
freebsdpkg.py	17.04 KB	-rw-r--r--	2022-05-16 09:16
freebsdports.py	13.13 KB	-rw-r--r--	2022-05-16 09:16
freebsdservice.py	12.53 KB	-rw-r--r--	2022-05-16 09:16
freezer.py	8.91 KB	-rw-r--r--	2022-05-16 09:16
gcp_addon.py	4.07 KB	-rw-r--r--	2022-05-16 09:16
gem.py	10.6 KB	-rw-r--r--	2022-05-16 09:16
genesis.py	21.75 KB	-rw-r--r--	2022-05-16 09:16
gentoo_service.py	9.18 KB	-rw-r--r--	2022-05-16 09:16
gentoolkitmod.py	8.33 KB	-rw-r--r--	2022-05-16 09:16
git.py	171.44 KB	-rw-r--r--	2022-05-16 09:16
github.py	53.19 KB	-rw-r--r--	2022-05-16 09:16
glanceng.py	4.69 KB	-rw-r--r--	2022-05-16 09:16
glassfish.py	19.49 KB	-rw-r--r--	2022-05-16 09:16
glusterfs.py	19.55 KB	-rw-r--r--	2022-05-16 09:16
gnomedesktop.py	6.85 KB	-rw-r--r--	2022-05-16 09:16
google_chat.py	1.52 KB	-rw-r--r--	2022-05-16 09:16
gpg.py	39.99 KB	-rw-r--r--	2022-05-16 09:16
grafana4.py	30.27 KB	-rw-r--r--	2022-05-16 09:16
grains.py	23.67 KB	-rw-r--r--	2022-05-16 09:16
groupadd.py	10.85 KB	-rw-r--r--	2022-05-16 09:16
grub_legacy.py	3.08 KB	-rw-r--r--	2022-05-16 09:16
guestfs.py	2.32 KB	-rw-r--r--	2022-05-16 09:16
hadoop.py	3.76 KB	-rw-r--r--	2022-05-16 09:16
haproxyconn.py	10.17 KB	-rw-r--r--	2022-05-16 09:16
hashutil.py	6.77 KB	-rw-r--r--	2022-05-16 09:16
heat.py	25.26 KB	-rw-r--r--	2022-05-16 09:16
helm.py	39.27 KB	-rw-r--r--	2022-05-16 09:16
hg.py	7.16 KB	-rw-r--r--	2022-05-16 09:16
highstate_doc.py	22.76 KB	-rw-r--r--	2022-05-16 09:16
hosts.py	10.47 KB	-rw-r--r--	2022-05-16 09:16
http.py	3.75 KB	-rw-r--r--	2022-05-16 09:16
icinga2.py	4.46 KB	-rw-r--r--	2022-05-16 09:16
idem.py	1.75 KB	-rw-r--r--	2022-05-16 09:16
ifttt.py	2.28 KB	-rw-r--r--	2022-05-16 09:16
ilo.py	15.98 KB	-rw-r--r--	2022-05-16 09:16
incron.py	7.68 KB	-rw-r--r--	2022-05-16 09:16
influxdb08mod.py	15.07 KB	-rw-r--r--	2022-05-16 09:16
influxdbmod.py	16.13 KB	-rw-r--r--	2022-05-16 09:16
infoblox.py	17.53 KB	-rw-r--r--	2022-05-16 09:16
ini_manage.py	14.63 KB	-rw-r--r--	2022-05-16 09:16
inspector.py	8.19 KB	-rw-r--r--	2022-05-16 09:16
introspect.py	4.02 KB	-rw-r--r--	2022-05-16 09:16
iosconfig.py	14.78 KB	-rw-r--r--	2022-05-16 09:16
ipmi.py	25.45 KB	-rw-r--r--	2022-05-16 09:16
ipset.py	17.97 KB	-rw-r--r--	2022-05-16 09:16
iptables.py	57.33 KB	-rw-r--r--	2022-05-16 09:16
iwtools.py	3.99 KB	-rw-r--r--	2022-05-16 09:16
jboss7.py	20.51 KB	-rw-r--r--	2022-05-16 09:16
jboss7_cli.py	15.23 KB	-rw-r--r--	2022-05-16 09:16
jenkinsmod.py	11.9 KB	-rw-r--r--	2022-05-16 09:16
jinja.py	2.66 KB	-rw-r--r--	2022-05-16 09:16
jira_mod.py	7.07 KB	-rw-r--r--	2022-05-16 09:16
junos.py	73.9 KB	-rw-r--r--	2022-05-16 09:16
k8s.py	24.87 KB	-rw-r--r--	2022-05-16 09:16
kapacitor.py	5.37 KB	-rw-r--r--	2022-05-16 09:16
kerberos.py	5.42 KB	-rw-r--r--	2022-05-16 09:16
kernelpkg_linux_apt.py	6.91 KB	-rw-r--r--	2022-05-16 09:16
kernelpkg_linux_yum.py	7.46 KB	-rw-r--r--	2022-05-16 09:16
key.py	1007 B	-rw-r--r--	2022-05-16 09:16
keyboard.py	2.64 KB	-rw-r--r--	2022-05-16 09:16
keystone.py	43.16 KB	-rw-r--r--	2022-05-16 09:16
keystoneng.py	21.82 KB	-rw-r--r--	2022-05-16 09:16
keystore.py	6.69 KB	-rw-r--r--	2022-05-16 09:16
kmod.py	7.29 KB	-rw-r--r--	2022-05-16 09:16
kubeadm.py	34.01 KB	-rw-r--r--	2022-05-16 09:16
kubernetesmod.py	46.66 KB	-rw-r--r--	2022-05-16 09:16
launchctl_service.py	9.73 KB	-rw-r--r--	2022-05-16 09:16
layman.py	4.22 KB	-rw-r--r--	2022-05-16 09:16
ldap3.py	18.81 KB	-rw-r--r--	2022-05-16 09:16
ldapmod.py	5.9 KB	-rw-r--r--	2022-05-16 09:16
libcloud_compute.py	23.51 KB	-rw-r--r--	2022-05-16 09:16
libcloud_dns.py	9.76 KB	-rw-r--r--	2022-05-16 09:16
libcloud_loadbalancer.py	13.17 KB	-rw-r--r--	2022-05-16 09:16
libcloud_storage.py	12.19 KB	-rw-r--r--	2022-05-16 09:16
linux_acl.py	7.7 KB	-rw-r--r--	2022-05-16 09:16
linux_ip.py	5.44 KB	-rw-r--r--	2022-05-16 09:16
linux_lvm.py	17.86 KB	-rw-r--r--	2022-05-16 09:16
linux_service.py	4.64 KB	-rw-r--r--	2022-05-16 09:16
linux_shadow.py	13.37 KB	-rw-r--r--	2022-05-16 09:16
linux_sysctl.py	7.39 KB	-rw-r--r--	2022-05-16 09:16
localemod.py	11.84 KB	-rw-r--r--	2022-05-16 09:16
locate.py	2.58 KB	-rw-r--r--	2022-05-16 09:16
logadm.py	9.57 KB	-rw-r--r--	2022-05-16 09:16
logmod.py	1.24 KB	-rw-r--r--	2022-05-16 09:16
logrotate.py	7.72 KB	-rw-r--r--	2022-05-16 09:16
lvs.py	11.54 KB	-rw-r--r--	2022-05-16 09:16
lxc.py	148.61 KB	-rw-r--r--	2022-05-16 09:16
lxd.py	90.2 KB	-rw-r--r--	2022-05-16 09:16
mac_assistive.py	6.36 KB	-rw-r--r--	2022-05-16 09:16
mac_brew_pkg.py	19.82 KB	-rw-r--r--	2022-05-16 09:16
mac_desktop.py	2.77 KB	-rw-r--r--	2022-05-16 09:16
mac_group.py	6.34 KB	-rw-r--r--	2022-05-16 09:16
mac_keychain.py	6.68 KB	-rw-r--r--	2022-05-16 09:16
mac_pkgutil.py	2.84 KB	-rw-r--r--	2022-05-16 09:16
mac_portspkg.py	11.36 KB	-rw-r--r--	2022-05-16 09:16
mac_power.py	13.29 KB	-rw-r--r--	2022-05-16 09:16
mac_service.py	19.64 KB	-rw-r--r--	2022-05-16 09:16
mac_shadow.py	14.23 KB	-rw-r--r--	2022-05-16 09:16
mac_softwareupdate.py	14.52 KB	-rw-r--r--	2022-05-16 09:16
mac_sysctl.py	5.13 KB	-rw-r--r--	2022-05-16 09:16
mac_system.py	15.2 KB	-rw-r--r--	2022-05-16 09:16
mac_timezone.py	8.34 KB	-rw-r--r--	2022-05-16 09:16
mac_user.py	16.36 KB	-rw-r--r--	2022-05-16 09:16
mac_xattr.py	6.11 KB	-rw-r--r--	2022-05-16 09:16
macdefaults.py	2.33 KB	-rw-r--r--	2022-05-16 09:16
macpackage.py	6.94 KB	-rw-r--r--	2022-05-16 09:16
makeconf.py	17.31 KB	-rw-r--r--	2022-05-16 09:16
mandrill.py	6.31 KB	-rw-r--r--	2022-05-16 09:16
marathon.py	5.36 KB	-rw-r--r--	2022-05-16 09:16
match.py	10.28 KB	-rw-r--r--	2022-05-16 09:16
mattermost.py	3.4 KB	-rw-r--r--	2022-05-16 09:16
mdadm_raid.py	9.86 KB	-rw-r--r--	2022-05-16 09:16
mdata.py	3.44 KB	-rw-r--r--	2022-05-16 09:16
memcached.py	6.13 KB	-rw-r--r--	2022-05-16 09:16
mine.py	18.79 KB	-rw-r--r--	2022-05-16 09:16
minion.py	7.68 KB	-rw-r--r--	2022-05-16 09:16
mod_random.py	6.72 KB	-rw-r--r--	2022-05-16 09:16
modjk.py	12.48 KB	-rw-r--r--	2022-05-16 09:16
mongodb.py	17.3 KB	-rw-r--r--	2022-05-16 09:16
monit.py	5.51 KB	-rw-r--r--	2022-05-16 09:16
moosefs.py	3.87 KB	-rw-r--r--	2022-05-16 09:16
mount.py	56.18 KB	-rw-r--r--	2022-05-16 09:16
mssql.py	14.64 KB	-rw-r--r--	2022-05-16 09:16
msteams.py	2 KB	-rw-r--r--	2022-05-16 09:16
munin.py	2.4 KB	-rw-r--r--	2022-05-16 09:16
mysql.py	87.85 KB	-rw-r--r--	2022-05-16 09:16
nacl.py	9.73 KB	-rw-r--r--	2022-05-16 09:16
nagios.py	6.53 KB	-rw-r--r--	2022-05-16 09:16
nagios_rpc.py	5.09 KB	-rw-r--r--	2022-05-16 09:16
namecheap_domains.py	12.84 KB	-rw-r--r--	2022-05-16 09:16
namecheap_domains_dns.py	5.93 KB	-rw-r--r--	2022-05-16 09:16
namecheap_domains_ns.py	4.51 KB	-rw-r--r--	2022-05-16 09:16
namecheap_ssl.py	25.72 KB	-rw-r--r--	2022-05-16 09:16
namecheap_users.py	2.4 KB	-rw-r--r--	2022-05-16 09:16
napalm_bgp.py	9.72 KB	-rw-r--r--	2022-05-16 09:16
napalm_formula.py	11.33 KB	-rw-r--r--	2022-05-16 09:16
napalm_mod.py	59.3 KB	-rw-r--r--	2022-05-16 09:16
napalm_netacl.py	28.59 KB	-rw-r--r--	2022-05-16 09:16
napalm_network.py	93.24 KB	-rw-r--r--	2022-05-16 09:16
napalm_ntp.py	10.22 KB	-rw-r--r--	2022-05-16 09:16
napalm_probes.py	13.25 KB	-rw-r--r--	2022-05-16 09:16
napalm_route.py	5.09 KB	-rw-r--r--	2022-05-16 09:16
napalm_snmp.py	7.05 KB	-rw-r--r--	2022-05-16 09:16
napalm_users.py	6.49 KB	-rw-r--r--	2022-05-16 09:16
napalm_yang_mod.py	20.28 KB	-rw-r--r--	2022-05-16 09:16
netaddress.py	1.6 KB	-rw-r--r--	2022-05-16 09:16
netbox.py	32.22 KB	-rw-r--r--	2022-05-16 09:16
netbsd_sysctl.py	3.97 KB	-rw-r--r--	2022-05-16 09:16
netbsdservice.py	6.49 KB	-rw-r--r--	2022-05-16 09:16
netmiko_mod.py	19.63 KB	-rw-r--r--	2022-05-16 09:16
netscaler.py	27.02 KB	-rw-r--r--	2022-05-16 09:16
network.py	62.75 KB	-rw-r--r--	2022-05-16 09:16
neutron.py	44.93 KB	-rw-r--r--	2022-05-16 09:16
neutronng.py	15.02 KB	-rw-r--r--	2022-05-16 09:16
nexus.py	22.95 KB	-rw-r--r--	2022-05-16 09:16
nfs3.py	3.9 KB	-rw-r--r--	2022-05-16 09:16
nftables.py	33.58 KB	-rw-r--r--	2022-05-16 09:16
nginx.py	3.83 KB	-rw-r--r--	2022-05-16 09:16
nilrt_ip.py	36.18 KB	-rw-r--r--	2022-05-16 09:16
nix.py	8.03 KB	-rw-r--r--	2022-05-16 09:16
nova.py	19.61 KB	-rw-r--r--	2022-05-16 09:16
npm.py	10.35 KB	-rw-r--r--	2022-05-16 09:16
nspawn.py	41.35 KB	-rw-r--r--	2022-05-16 09:16
nxos.py	24.67 KB	-rw-r--r--	2022-05-16 09:16
nxos_api.py	14.66 KB	-rw-r--r--	2022-05-16 09:16
nxos_upgrade.py	14.74 KB	-rw-r--r--	2022-05-16 09:16
omapi.py	3.6 KB	-rw-r--r--	2022-05-16 09:16
openbsd_sysctl.py	3.74 KB	-rw-r--r--	2022-05-16 09:16
openbsdpkg.py	11 KB	-rw-r--r--	2022-05-16 09:16
openbsdrcctl_service.py	6.25 KB	-rw-r--r--	2022-05-16 09:16
openbsdservice.py	8.31 KB	-rw-r--r--	2022-05-16 09:16
openscap.py	2.81 KB	-rw-r--r--	2022-05-16 09:16
openstack_config.py	3.5 KB	-rw-r--r--	2022-05-16 09:16
openstack_mng.py	2.71 KB	-rw-r--r--	2022-05-16 09:16
openvswitch.py	11.75 KB	-rw-r--r--	2022-05-16 09:16
opkg.py	49.72 KB	-rw-r--r--	2022-05-16 09:16
opsgenie.py	3.29 KB	-rw-r--r--	2022-05-16 09:16
oracle.py	5.83 KB	-rw-r--r--	2022-05-16 09:16
osquery.py	24.93 KB	-rw-r--r--	2022-05-16 09:16
out.py	2.53 KB	-rw-r--r--	2022-05-16 09:16
pacmanpkg.py	31.99 KB	-rw-r--r--	2022-05-16 09:16
pagerduty.py	4.7 KB	-rw-r--r--	2022-05-16 09:16
pagerduty_util.py	13.49 KB	-rw-r--r--	2022-05-16 09:16
pam.py	2.01 KB	-rw-r--r--	2022-05-16 09:16
panos.py	61.05 KB	-rw-r--r--	2022-05-16 09:16
parallels.py	19.85 KB	-rw-r--r--	2022-05-16 09:16
parted_partition.py	21.53 KB	-rw-r--r--	2022-05-16 09:16
pcs.py	14.11 KB	-rw-r--r--	2022-05-16 09:16
pdbedit.py	10.72 KB	-rw-r--r--	2022-05-16 09:16
pecl.py	3.79 KB	-rw-r--r--	2022-05-16 09:16
peeringdb.py	8.39 KB	-rw-r--r--	2022-05-16 09:16
pf.py	9.51 KB	-rw-r--r--	2022-05-16 09:16
philips_hue.py	1.55 KB	-rw-r--r--	2022-05-16 09:16
pillar.py	21.29 KB	-rw-r--r--	2022-05-16 09:16
pip.py	51.76 KB	-rw-r--r--	2022-05-16 09:16
pkg_resource.py	11.89 KB	-rw-r--r--	2022-05-16 09:16
pkgin.py	17.35 KB	-rw-r--r--	2022-05-16 09:16
pkgng.py	61.1 KB	-rw-r--r--	2022-05-16 09:16
pkgutil.py	9.88 KB	-rw-r--r--	2022-05-16 09:16
portage_config.py	22.77 KB	-rw-r--r--	2022-05-16 09:16
postfix.py	16.24 KB	-rw-r--r--	2022-05-16 09:16
postgres.py	88.3 KB	-rw-r--r--	2022-05-16 09:16
poudriere.py	7.85 KB	-rw-r--r--	2022-05-16 09:16
powerpath.py	2.57 KB	-rw-r--r--	2022-05-16 09:16
proxy.py	11.49 KB	-rw-r--r--	2022-05-16 09:16
ps.py	19.45 KB	-rw-r--r--	2022-05-16 09:16
publish.py	10.22 KB	-rw-r--r--	2022-05-16 09:16
puppet.py	11.69 KB	-rw-r--r--	2022-05-16 09:16
purefa.py	33.03 KB	-rw-r--r--	2022-05-16 09:16
purefb.py	13.65 KB	-rw-r--r--	2022-05-16 09:16
pushbullet.py	1.88 KB	-rw-r--r--	2022-05-16 09:16
pushover_notify.py	3.48 KB	-rw-r--r--	2022-05-16 09:16
pw_group.py	4.4 KB	-rw-r--r--	2022-05-16 09:16
pw_user.py	12.47 KB	-rw-r--r--	2022-05-16 09:16
pyenv.py	6.93 KB	-rw-r--r--	2022-05-16 09:16
qemu_img.py	1.53 KB	-rw-r--r--	2022-05-16 09:16
qemu_nbd.py	3.28 KB	-rw-r--r--	2022-05-16 09:16
quota.py	6.43 KB	-rw-r--r--	2022-05-16 09:16
rabbitmq.py	38.44 KB	-rw-r--r--	2022-05-16 09:16
rallydev.py	6.09 KB	-rw-r--r--	2022-05-16 09:16
random_org.py	23.76 KB	-rw-r--r--	2022-05-16 09:16
rbac_solaris.py	16.15 KB	-rw-r--r--	2022-05-16 09:16
rbenv.py	10.75 KB	-rw-r--r--	2022-05-16 09:16
rdp.py	6.08 KB	-rw-r--r--	2022-05-16 09:16
rebootmgr.py	7.66 KB	-rw-r--r--	2022-05-16 09:16
redismod.py	16.36 KB	-rw-r--r--	2022-05-16 09:16
reg.py	16.36 KB	-rw-r--r--	2022-05-16 09:16
rest_pkg.py	2.26 KB	-rw-r--r--	2022-05-16 09:16
rest_sample_utils.py	558 B	-rw-r--r--	2022-05-16 09:16
rest_service.py	3.63 KB	-rw-r--r--	2022-05-16 09:16
restartcheck.py	24.1 KB	-rw-r--r--	2022-05-16 09:16
ret.py	1.27 KB	-rw-r--r--	2022-05-16 09:16
rh_ip.py	38.01 KB	-rw-r--r--	2022-05-16 09:16
rh_service.py	16.61 KB	-rw-r--r--	2022-05-16 09:16
riak.py	5.19 KB	-rw-r--r--	2022-05-16 09:16
rpm_lowpkg.py	27.61 KB	-rw-r--r--	2022-05-16 09:16
rpmbuild_pkgbuild.py	24.53 KB	-rw-r--r--	2022-05-16 09:16
rsync.py	8.04 KB	-rw-r--r--	2022-05-16 09:16
runit.py	17.14 KB	-rw-r--r--	2022-05-16 09:16
rvm.py	11.1 KB	-rw-r--r--	2022-05-16 09:16
s3.py	9.93 KB	-rw-r--r--	2022-05-16 09:16
s6.py	3.62 KB	-rw-r--r--	2022-05-16 09:16
salt_proxy.py	4.48 KB	-rw-r--r--	2022-05-16 09:16
salt_version.py	4.29 KB	-rw-r--r--	2022-05-16 09:16
saltcheck.py	46.11 KB	-rw-r--r--	2022-05-16 09:16
saltcloudmod.py	954 B	-rw-r--r--	2022-05-16 09:16
saltutil.py	56.5 KB	-rw-r--r--	2022-05-16 09:16
schedule.py	43.35 KB	-rw-r--r--	2022-05-16 09:16
scp_mod.py	6.22 KB	-rw-r--r--	2022-05-16 09:16
scsi.py	2.66 KB	-rw-r--r--	2022-05-16 09:16
sdb.py	2.45 KB	-rw-r--r--	2022-05-16 09:16
seed.py	8.87 KB	-rw-r--r--	2022-05-16 09:16
selinux.py	23.83 KB	-rw-r--r--	2022-05-16 09:16
sensehat.py	7.79 KB	-rw-r--r--	2022-05-16 09:16
sensors.py	1.3 KB	-rw-r--r--	2022-05-16 09:16
serverdensity_device.py	8.1 KB	-rw-r--r--	2022-05-16 09:16
servicenow.py	4.38 KB	-rw-r--r--	2022-05-16 09:16
slack_notify.py	7.83 KB	-rw-r--r--	2022-05-16 09:16
slackware_service.py	6.89 KB	-rw-r--r--	2022-05-16 09:16
slsutil.py	19.05 KB	-rw-r--r--	2022-05-16 09:16
smartos_imgadm.py	12.09 KB	-rw-r--r--	2022-05-16 09:16
smartos_nictagadm.py	6.51 KB	-rw-r--r--	2022-05-16 09:16
smartos_virt.py	5.21 KB	-rw-r--r--	2022-05-16 09:16
smartos_vmadm.py	26.37 KB	-rw-r--r--	2022-05-16 09:16
smbios.py	10.06 KB	-rw-r--r--	2022-05-16 09:16
smf_service.py	8.52 KB	-rw-r--r--	2022-05-16 09:16
smtp.py	5.41 KB	-rw-r--r--	2022-05-16 09:16
snapper.py	27.14 KB	-rw-r--r--	2022-05-16 09:16
solaris_fmadm.py	11.27 KB	-rw-r--r--	2022-05-16 09:16
solaris_group.py	2.8 KB	-rw-r--r--	2022-05-16 09:16
solaris_shadow.py	7.98 KB	-rw-r--r--	2022-05-16 09:16
solaris_system.py	3.72 KB	-rw-r--r--	2022-05-16 09:16
solaris_user.py	11.06 KB	-rw-r--r--	2022-05-16 09:16
solarisipspkg.py	18.7 KB	-rw-r--r--	2022-05-16 09:16
solarispkg.py	15.42 KB	-rw-r--r--	2022-05-16 09:16
solr.py	45.54 KB	-rw-r--r--	2022-05-16 09:16
solrcloud.py	14.63 KB	-rw-r--r--	2022-05-16 09:16
splunk.py	8.15 KB	-rw-r--r--	2022-05-16 09:16
splunk_search.py	8.76 KB	-rw-r--r--	2022-05-16 09:16
sqlite3.py	2.54 KB	-rw-r--r--	2022-05-16 09:16
ssh.py	43.15 KB	-rw-r--r--	2022-05-16 09:16
ssh_pkg.py	1.08 KB	-rw-r--r--	2022-05-16 09:16
ssh_service.py	3.39 KB	-rw-r--r--	2022-05-16 09:16
state.py	78.55 KB	-rw-r--r--	2022-05-16 09:16
status.py	57.34 KB	-rw-r--r--	2022-05-16 09:16
statuspage.py	14.67 KB	-rw-r--r--	2022-05-16 09:16
supervisord.py	11.15 KB	-rw-r--r--	2022-05-16 09:16
suse_apache.py	2.45 KB	-rw-r--r--	2022-05-16 09:16
svn.py	10.75 KB	-rw-r--r--	2022-05-16 09:16
swarm.py	13.5 KB	-rw-r--r--	2022-05-16 09:16
swift.py	5.55 KB	-rw-r--r--	2022-05-16 09:16
sysbench.py	6.62 KB	-rw-r--r--	2022-05-16 09:16
sysfs.py	6.61 KB	-rw-r--r--	2022-05-16 09:16
syslog_ng.py	31.55 KB	-rw-r--r--	2022-05-16 09:16
sysmod.py	22.59 KB	-rw-r--r--	2022-05-16 09:16
sysrc.py	3.38 KB	-rw-r--r--	2022-05-16 09:16
system.py	19.28 KB	-rw-r--r--	2022-05-16 09:16
system_profiler.py	3.54 KB	-rw-r--r--	2022-05-16 09:16
systemd_service.py	46.19 KB	-rw-r--r--	2022-05-16 09:16
telegram.py	3.28 KB	-rw-r--r--	2022-05-16 09:16
telemetry.py	12.9 KB	-rw-r--r--	2022-05-16 09:16
temp.py	831 B	-rw-r--r--	2022-05-16 09:16
test.py	14.71 KB	-rw-r--r--	2022-05-16 09:16
test_virtual.py	194 B	-rw-r--r--	2022-05-16 09:16
testinframod.py	9.92 KB	-rw-r--r--	2022-05-16 09:16
textfsm_mod.py	16.22 KB	-rw-r--r--	2022-05-16 09:16
timezone.py	19.89 KB	-rw-r--r--	2022-05-16 09:16
tls.py	58.67 KB	-rw-r--r--	2022-05-16 09:16
tomcat.py	18.59 KB	-rw-r--r--	2022-05-16 09:16
trafficserver.py	10.44 KB	-rw-r--r--	2022-05-16 09:16
transactional_update.py	42 KB	-rw-r--r--	2022-05-16 09:16
travisci.py	2.08 KB	-rw-r--r--	2022-05-16 09:16
tuned.py	2.34 KB	-rw-r--r--	2022-05-16 09:16
twilio_notify.py	2.95 KB	-rw-r--r--	2022-05-16 09:16
udev.py	3.72 KB	-rw-r--r--	2022-05-16 09:16
upstart_service.py	16.92 KB	-rw-r--r--	2022-05-16 09:16
uptime.py	3.23 KB	-rw-r--r--	2022-05-16 09:16
useradd.py	22.3 KB	-rw-r--r--	2022-05-16 09:16
uwsgi.py	996 B	-rw-r--r--	2022-05-16 09:16
vagrant.py	20.4 KB	-rw-r--r--	2022-05-16 09:16
varnish.py	3.08 KB	-rw-r--r--	2022-05-16 09:16
vault.py	13.48 KB	-rw-r--r--	2022-05-16 09:16
vbox_guest.py	10.55 KB	-rw-r--r--	2022-05-16 09:16
vboxmanage.py	14.72 KB	-rw-r--r--	2022-05-16 09:16
vcenter.py	455 B	-rw-r--r--	2022-05-16 09:16
victorops.py	6.54 KB	-rw-r--r--	2022-05-16 09:16
virt.py	290.11 KB	-rw-r--r--	2022-05-16 09:16
virtualenv_mod.py	15.08 KB	-rw-r--r--	2022-05-16 09:16
vmctl.py	9.6 KB	-rw-r--r--	2022-05-16 09:16
vsphere.py	376.7 KB	-rw-r--r--	2022-05-16 09:16
webutil.py	3.66 KB	-rw-r--r--	2022-05-16 09:16
win_auditpol.py	4.74 KB	-rw-r--r--	2022-05-16 09:16
win_autoruns.py	2.29 KB	-rw-r--r--	2022-05-16 09:16
win_certutil.py	3.27 KB	-rw-r--r--	2022-05-16 09:16
win_dacl.py	32.27 KB	-rw-r--r--	2022-05-16 09:16
win_disk.py	1.8 KB	-rw-r--r--	2022-05-16 09:16
win_dism.py	18.26 KB	-rw-r--r--	2022-05-16 09:16
win_dns_client.py	4.19 KB	-rw-r--r--	2022-05-16 09:16
win_dsc.py	26.56 KB	-rw-r--r--	2022-05-16 09:16
win_file.py	59.46 KB	-rw-r--r--	2022-05-16 09:16
win_firewall.py	20.15 KB	-rw-r--r--	2022-05-16 09:16
win_groupadd.py	11.27 KB	-rw-r--r--	2022-05-16 09:16
win_iis.py	68.76 KB	-rw-r--r--	2022-05-16 09:16
win_ip.py	11.43 KB	-rw-r--r--	2022-05-16 09:16
win_lgpo.py	491.78 KB	-rw-r--r--	2022-05-16 09:16
win_license.py	2.72 KB	-rw-r--r--	2022-05-16 09:16
win_network.py	14.02 KB	-rw-r--r--	2022-05-16 09:16
win_ntp.py	1.8 KB	-rw-r--r--	2022-05-16 09:16
win_path.py	11.12 KB	-rw-r--r--	2022-05-16 09:16
win_pkg.py	84.64 KB	-rw-r--r--	2022-05-16 09:16
win_pki.py	15.8 KB	-rw-r--r--	2022-05-16 09:16
win_powercfg.py	9.85 KB	-rw-r--r--	2022-05-16 09:16
win_psget.py	8.97 KB	-rw-r--r--	2022-05-16 09:16
win_servermanager.py	14.33 KB	-rw-r--r--	2022-05-16 09:16
win_service.py	32.7 KB	-rw-r--r--	2022-05-16 09:16
win_shadow.py	3.03 KB	-rw-r--r--	2022-05-16 09:16
win_smtp_server.py	17.67 KB	-rw-r--r--	2022-05-16 09:16
win_snmp.py	13.38 KB	-rw-r--r--	2022-05-16 09:16
win_status.py	17.04 KB	-rw-r--r--	2022-05-16 09:16
win_system.py	40.62 KB	-rw-r--r--	2022-05-16 09:16
win_task.py	78.46 KB	-rw-r--r--	2022-05-16 09:16
win_timezone.py	13.27 KB	-rw-r--r--	2022-05-16 09:16
win_useradd.py	27.53 KB	-rw-r--r--	2022-05-16 09:16
win_wua.py	38.29 KB	-rw-r--r--	2022-05-16 09:16
win_wusa.py	5.88 KB	-rw-r--r--	2022-05-16 09:16
winrepo.py	6.3 KB	-rw-r--r--	2022-05-16 09:16
wordpress.py	4.71 KB	-rw-r--r--	2022-05-16 09:16
x509.py	62.22 KB	-rw-r--r--	2022-05-16 09:16
xapi_virt.py	24.08 KB	-rw-r--r--	2022-05-16 09:16
xbpspkg.py	15.89 KB	-rw-r--r--	2022-05-16 09:16
xfs.py	15.33 KB	-rw-r--r--	2022-05-16 09:16
xml.py	2.14 KB	-rw-r--r--	2022-05-16 09:16
xmpp.py	5.28 KB	-rw-r--r--	2022-05-16 09:16
yumpkg.py	112.71 KB	-rw-r--r--	2022-05-16 09:16
zabbix.py	94.11 KB	-rw-r--r--	2022-05-16 09:16
zcbuildout.py	28.19 KB	-rw-r--r--	2022-05-16 09:16
zenoss.py	5.64 KB	-rw-r--r--	2022-05-16 09:16
zfs.py	34.49 KB	-rw-r--r--	2022-05-16 09:16
zk_concurrency.py	11.19 KB	-rw-r--r--	2022-05-16 09:16
znc.py	2.26 KB	-rw-r--r--	2022-05-16 09:16
zoneadm.py	15.11 KB	-rw-r--r--	2022-05-16 09:16
zonecfg.py	21.91 KB	-rw-r--r--	2022-05-16 09:16
zookeeper.py	14.72 KB	-rw-r--r--	2022-05-16 09:16
zpool.py	44.02 KB	-rw-r--r--	2022-05-16 09:16
zypperpkg.py	90.34 KB	-rw-r--r--	2022-05-16 09:16

Rename

# pylint: disable=W1401
'''
This module renders highstate configuration into a more human readable format.

How it works:

`highstate or lowstate` data is parsed with a `processor` this defaults to `highstate_doc.processor_markdown`.
The processed data is passed to a `jinja` template that builds up the document content.

configuration: Pillar

.. code-block:: none

# the following defaults can be overridden
    highstate_doc.config:

# list of regex of state names to ignore in `highstate_doc.process_lowstates`
        filter_id_regex:
            - '.*!doc_skip$'

# list of regex of state functions to ignore in `highstate_doc.process_lowstates`
        filter_state_function_regex:
            - 'file.accumulated'

# dict of regex to replace text after `highstate_doc.render`. (remove passwords)
        text_replace_regex:
            'password:.*^': '[PASSWORD]'

# limit size of files that can be included in doc (10000 bytes)
        max_render_file_size: 10000

# advanced option to set a custom lowstate processor
        processor: highstate_doc.processor_markdown

State example

.. code-block:: yaml

{{sls}} note:
        highstate_doc.note:
            - name: example
            - order: 0
            - contents: |
                example `highstate_doc.note`
                ------------------
                This state does not do anything to the system! It is only used by a `processor`
                you can use `requisites` and `order` to move your docs around the rendered file.

{{sls}} a file we don't want in the doc !doc_skip:
        file.managed:
            - name: /root/passwords
            - contents: 'password: sadefgq34y45h56q'
            # also could use `highstate_doc.config: text_replace_regex` to replace
            # password string. `password:.*^': '[PASSWORD]`

To create the help document build a State that uses `highstate_doc.render`.
For performance it's advised to not included this state in your `top.sls` file.

.. code-block:: yaml

# example `salt://makereadme.sls`
    make helpfile:
        file.managed:
            - name: /root/README.md
            - contents: {{salt.highstate_doc.render()|json}}
            - show_diff: {{opts['test']}}
            - mode: '0640'
            - order: last

Run our `makereadme.sls` state to create `/root/README.md`.

.. code-block:: bash

# first ensure `highstate` return without errors or changes
    salt-call state.highstate
    salt-call state.apply makereadme
    # or if you don't want the extra `make helpfile` state
    salt-call --out=newline_values_only salt.highstate_doc.render > /root/README.md ; chmod 0600 /root/README.md

Creating a document collection
------------------------------

From the master we can run the following script to
creates a collection of all your minion documents.

.. code-block:: bash

salt '*' state.apply makereadme

.. code-block:: python

#!/bin/python
    import os
    import salt.client
    s = salt.client.LocalClient()
    # NOTE: because of issues with `cp.push` use `highstate_doc.read_file`
    o = s.cmd('*', 'highstate_doc.read_file', ['/root/README.md'])
    for m in o:
        d = o.get(m)
        if d and not d.endswith('is not available.'):
            # mkdir m
            #directory = os.path.dirname(file_path)
            if not os.path.exists(m):
                os.makedirs(m)
            with open(m + '/README.md','wb') as f:
                f.write(d)
            print('ADDED: ' + m + '/README.md')

Once the master has a collection of all the README files.
You can use pandoc to create HTML versions of the markdown.

.. code-block:: bash

# process all the readme.md files to readme.html
    if which pandoc; then echo "Found pandoc"; else echo "** Missing pandoc"; exit 1; fi
    if which gs; then echo "Found gs"; else echo "** Missing gs(ghostscript)"; exit 1; fi
    readme_files=$(find $dest -type f -path "*/README.md" -print)
    for f in $readme_files ; do
        ff=${f#$dest/}
        minion=${ff%%/*}
        echo "process: $dest/${minion}/$(basename $f)"
        cat $dest/${minion}/$(basename $f) | \
            pandoc --standalone --from markdown_github --to html \
            --include-in-header $dest/style.html \
            > $dest/${minion}/$(basename $f).html
    done

It is also nice to put the help files in source control.

# git init
    git add -A
    git commit -am 'updated docs'
    git push -f

Other hints
-----------

If you wish to customize the document format:

.. code-block:: none

# you could also create a new `processor` for perhaps reStructuredText
    # highstate_doc.config:
    #     processor: doc_custom.processor_rst

# example `salt://makereadme.jinja`
    """
    {{opts['id']}}
    ==========================================

{# lowstates is set from highstate_doc.render() #}
    {# if lowstates is missing use salt.highstate_doc.process_lowstates() #}
    {% for s in lowstates %}
    {{s.id}}
    -----------------------------------------------------------------
    {{s.function}}

{%- endfor %}
    """

# example `salt://makereadme.sls`
    {% import_text "makereadme.jinja" as makereadme %}
    {{sls}} or:
        file.managed:
            - name: /root/README_other.md
            - contents: {{salt.highstate_doc.render(jinja_template_text=makereadme)|json}}
            - mode: '0640'

Some `replace_text_regex` values that might be helpful::

CERTS
    -----

``'-----BEGIN RSA PRIVATE KEY-----[\\r\\n\\t\\f\\S]{0,2200}': 'XXXXXXX'``
    ``'-----BEGIN CERTIFICATE-----[\\r\\n\\t\\f\\S]{0,2200}': 'XXXXXXX'``
    ``'-----BEGIN DH PARAMETERS-----[\\r\\n\\t\\f\\S]{0,2200}': 'XXXXXXX'``
    ``'-----BEGIN PRIVATE KEY-----[\\r\\n\\t\\f\\S]{0,2200}': 'XXXXXXX'``
    ``'-----BEGIN OPENSSH PRIVATE KEY-----[\\r\\n\\t\\f\\S]{0,2200}': 'XXXXXXX'``
    ``'ssh-rsa .* ': 'ssh-rsa XXXXXXX '``
    ``'ssh-dss .* ': 'ssh-dss XXXXXXX '``

DB
    --

``'DB_PASS.*': 'DB_PASS = XXXXXXX'``
    ``'5432:*:*:.*': '5432:*:XXXXXXX'``
    ``"'PASSWORD': .*": "'PASSWORD': 'XXXXXXX',"``
    ``" PASSWORD '.*'": " PASSWORD 'XXXXXXX'"``
    ``'PGPASSWORD=.* ': 'PGPASSWORD=XXXXXXX'``
    ``"_replication password '.*'":  "_replication password 'XXXXXXX'"``

OTHER
    -----

``'EMAIL_HOST_PASSWORD =.*': 'EMAIL_HOST_PASSWORD =XXXXXXX'``
    ``"net ads join -U '.*@MFCFADS.MATH.EXAMPLE.CA.* ": "net ads join -U '.*@MFCFADS.MATH.EXAMPLE.CA%XXXXXXX "``
    ``"net ads join -U '.*@NEXUS.EXAMPLE.CA.* ": "net ads join -U '.*@NEXUS.EXAMPLE.CA%XXXXXXX "``
    ``'install-uptrack .* --autoinstall': 'install-uptrack XXXXXXX --autoinstall'``
    ``'accesskey = .*': 'accesskey = XXXXXXX'``
    ``'auth_pass .*': 'auth_pass XXXXXXX'``
    ``'PSK "0x.*': 'PSK "0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'``
    ``'SECRET_KEY.*': 'SECRET_KEY = XXXXXXX'``
    ``"password=.*": "password=XXXXXXX"``
    ``'<password>.*</password>': '<password>XXXXXXX</password>'``
    ``'<salt>.*</salt>': '<salt>XXXXXXX</salt>'``
    ``'application.secret = ".*"': 'application.secret = "XXXXXXX"'``
    ``'url = "postgres://.*"': 'url = "postgres://XXXXXXX"'``
    ``'PASS_.*_PASS': 'PASS_XXXXXXX_PASS'``

HTACCESS
    --------

``':{PLAIN}.*': ':{PLAIN}XXXXXXX'``

'''

import logging
import re

import salt.utils.files
import salt.utils.stringutils
import salt.utils.templates as tpl
import salt.utils.yaml

__virtualname__ = "highstate_doc"

log = logging.getLogger(__name__)

markdown_basic_jinja_template_txt = """
{% for s in lowstates %}
`{{s.id_full}}`
-----------------------------------------------------------------
 * state: {{s.state_function}}
 * name: `{{s.name}}`

{%- endfor %}
"""

markdown_default_jinja_template_txt = (
    """
Configuration Managment
===============================================================================

```
####################################################
fqdn: {{grains.get('fqdn')}}
os: {{grains.get('os')}}
osfinger: {{grains.get('osfinger')}}
mem_total: {{grains.get('mem_total')}}MB
num_cpus: {{grains.get('num_cpus')}}
ipv4: {{grains.get('ipv4')}}
master: {{opts.get('master')}}
####################################################
```

This system is fully or partly managed using Salt.

The following sections are a rendered view of what the configuration management system
controlled on this system. Each item is handled in order from top to bottom unless some
requisites like `require` force other ordering.

"""
    + markdown_basic_jinja_template_txt
)

markdown_advanced_jinja_template_txt = (
    markdown_default_jinja_template_txt
    + r"""

{% if vars.get('doc_other', True) -%}
Other information
=====================================================================================

```

salt grain: ip_interfaces
-----------------------------------------------------------------
{{grains['ip_interfaces']|dictsort}}

salt grain: hwaddr_interfaces
-----------------------------------------------------------------
{{grains['hwaddr_interfaces']|dictsort}}

{% if not grains['os'] == 'Windows' %}

{% if salt['cmd.has_exec']('ip') -%}
# ip address show
-----------------------------------------------------------------
{{salt['cmd.run']('ip address show | sed "/valid_lft/d"')}}

# ip route list table all
-----------------------------------------------------------------
{{salt['cmd.run']('ip route list table all')}}
{% endif %}

{% if salt['cmd.has_exec']('iptables') %}
{%- if salt['cmd.has_exec']('iptables-save') -%}
# iptables-save
-----------------------------------------------------------------
{{salt['cmd.run']("iptables --list > /dev/null; iptables-save | \grep -v -F '#' | sed '/^:/s@\[[0-9]\{1,\}:[0-9]\{1,\}\]@[0:0]@g'")}}

# ip6tables-save
-----------------------------------------------------------------
{{salt['cmd.run']("ip6tables --list > /dev/null; ip6tables-save | \grep -v -F '#' | sed '/^:/s@\[[0-9]\{1,\}:[0-9]\{1,\}\]@[0:0]@g'")}}
{%- else -%}
# iptables --list-rules
-----------------------------------------------------------------
{{salt['cmd.run']('iptables --list-rules')}}

# ip6tables --list-rules
-----------------------------------------------------------------
{{salt['cmd.run']('ip6tables --list-rules')}}
{% endif %}
{% endif %}

{% if salt['cmd.has_exec']('firewall-cmd') -%}
# firewall-cmd --list-all
-----------------------------------------------------------------
{{salt['cmd.run']('firewall-cmd --list-all')}}
{% endif %}

# mount
-----------------------------------------------------------------
{{salt['cmd.run']('mount')}}

{% endif %}
"""
)

def markdown_basic_jinja_template(**kwargs):
    """
    Return text for a simple markdown jinja template

This function can be used from the `highstate_doc.render` modules `jinja_template_function` option.
    """
    return markdown_basic_jinja_template_txt

def markdown_default_jinja_template(**kwargs):
    """
    Return text for a markdown jinja template that included a header

This function can be used from the `highstate_doc.render` modules `jinja_template_function` option.
    """
    return markdown_default_jinja_template_txt

def markdown_full_jinja_template(**kwargs):
    """
    Return text for an advanced markdown jinja template

This function can be used from the `highstate_doc.render` modules `jinja_template_function` option.
    """
    return markdown_advanced_jinja_template_txt

def _get_config(**kwargs):
    """
    Return configuration
    """
    config = {
        "filter_id_regex": [".*!doc_skip"],
        "filter_function_regex": [],
        "replace_text_regex": {},
        "processor": "highstate_doc.processor_markdown",
        "max_render_file_size": 10000,
        "note": None,
    }
    if "__salt__" in globals():
        config_key = "{}.config".format(__virtualname__)
        config.update(__salt__["config.get"](config_key, {}))
    # pylint: disable=C0201
    for k in set(config.keys()) & set(kwargs.keys()):
        config[k] = kwargs[k]
    return config

def read_file(name):
    """
    output the contents of a file:

this is a workaround if the cp.push module does not work.
    https://github.com/saltstack/salt/issues/37133

help the master output the contents of a document
    that might be saved on the minions filesystem.

.. code-block:: python

#!/bin/python
        import os
        import salt.client
        s = salt.client.LocalClient()
        o = s.cmd('*', 'highstate_doc.read_file', ['/root/README.md'])
        for m in o:
            d = o.get(m)
            if d and not d.endswith('is not available.'):
                # mkdir m
                #directory = os.path.dirname(file_path)
                if not os.path.exists(m):
                    os.makedirs(m)
                with open(m + '/README.md','wb') as fin:
                    fin.write(d)
                print('ADDED: ' + m + '/README.md')
    """
    out = ""
    try:
        with salt.utils.files.fopen(name, "r") as f:
            out = salt.utils.stringutils.to_unicode(f.read())
    except Exception as ex:  # pylint: disable=broad-except
        log.error(ex)
        return None
    return out

def render(
    jinja_template_text=None,
    jinja_template_function="highstate_doc.markdown_default_jinja_template",
    **kwargs
):
    """
    Render highstate to a text format (default Markdown)

if `jinja_template_text` is not set, `jinja_template_function` is used.

jinja_template_text: jinja text that the render uses to create the document.
    jinja_template_function: a salt module call that returns template text.

:options:
        highstate_doc.markdown_basic_jinja_template
        highstate_doc.markdown_default_jinja_template
        highstate_doc.markdown_full_jinja_template

"""
    config = _get_config(**kwargs)
    lowstates = process_lowstates(**kwargs)
    # TODO: __env__,
    context = {
        "saltenv": None,
        "config": config,
        "lowstates": lowstates,
        "salt": __salt__,
        "pillar": __pillar__,
        "grains": __grains__,
        "opts": __opts__,
        "kwargs": kwargs,
    }
    template_text = jinja_template_text
    if template_text is None and jinja_template_function:
        template_text = __salt__[jinja_template_function](**kwargs)
    if template_text is None:
        raise Exception("No jinja template text")

txt = tpl.render_jinja_tmpl(template_text, context, tmplpath=None)
    # after processing the template replace passwords or other data.
    rt = config.get("replace_text_regex")
    for r in rt:
        txt = re.sub(r, rt[r], txt)
    return txt

def _blacklist_filter(s, config):
    ss = s["state"]
    sf = s["fun"]
    state_function = "{}.{}".format(s["state"], s["fun"])
    for b in config["filter_function_regex"]:
        if re.match(b, state_function):
            return True
    for b in config["filter_id_regex"]:
        if re.match(b, s["__id__"]):
            return True
    return False

def process_lowstates(**kwargs):
    """
    return processed lowstate data that was not blacklisted

render_module_function is used to provide your own.
    defaults to from_lowstate
    """
    states = []
    config = _get_config(**kwargs)
    processor = config.get("processor")
    ls = __salt__["state.show_lowstate"]()

if not isinstance(ls, list):
        raise Exception(
            "ERROR: to see details run: [salt-call state.show_lowstate]"
            " <-----***-SEE-***"
        )
    else:
        if ls:
            if not isinstance(ls[0], dict):
                raise Exception(
                    "ERROR: to see details run: [salt-call state.show_lowstate]"
                    " <-----***-SEE-***"
                )

for s in ls:
        if _blacklist_filter(s, config):
            continue
        doc = __salt__[processor](s, config, **kwargs)
        states.append(doc)
    return states

def _state_data_to_yaml_string(data, whitelist=None, blacklist=None):
    """
    return a data dict in yaml string format.
    """
    y = {}
    if blacklist is None:
        # TODO: use salt defined STATE_REQUISITE_IN_KEYWORDS  STATE_RUNTIME_KEYWORDS  STATE_INTERNAL_KEYWORDS
        blacklist = [
            "__env__",
            "__id__",
            "__sls__",
            "fun",
            "name",
            "context",
            "order",
            "state",
            "require",
            "require_in",
            "watch",
            "watch_in",
        ]
    kset = set(data.keys())
    if blacklist:
        kset -= set(blacklist)
    if whitelist:
        kset &= set(whitelist)
    for k in kset:
        y[k] = data[k]
    if not y:
        return None
    return salt.utils.yaml.safe_dump(y, default_flow_style=False)

def _md_fix(text):
    """
    sanitize text data that is to be displayed in a markdown code block
    """
    return text.replace("```", "``[`][markdown parse fix]")

def _format_markdown_system_file(filename, config):
    ret = ""
    file_stats = __salt__["file.stats"](filename)
    y = _state_data_to_yaml_string(
        file_stats, whitelist=["user", "group", "mode", "uid", "gid", "size"]
    )
    if y:
        ret += "file stat {1}\n```\n{0}```\n".format(y, filename)
    file_size = file_stats.get("size")
    if file_size <= config.get("max_render_file_size"):
        is_binary = True
        try:
            # TODO: this is linux only should find somthing portable
            file_type = __salt__["cmd.shell"]("\\file -i '{}'".format(filename))
            if "charset=binary" not in file_type:
                is_binary = False
        except Exception as ex:  # pylint: disable=broad-except
            # likely on a windows system, set as not binary for now.
            is_binary = False
        if is_binary:
            file_data = "[[skipped binary data]]"
        else:
            with salt.utils.files.fopen(filename, "r") as f:
                file_data = salt.utils.stringutils.to_unicode(f.read())
        file_data = _md_fix(file_data)
        ret += "file data {1}\n```\n{0}\n```\n".format(file_data, filename)
    else:
        ret += "```\n{}\n```\n".format(
            "SKIPPED LARGE FILE!\nSet {}:max_render_file_size > {} to render.".format(
                "{}.config".format(__virtualname__), file_size
            )
        )
    return ret

def _format_markdown_link(name):
    link = name
    symbals = "~`!@#$%^&*()+={}[]:;\"<>,.?/|'\\"
    for s in symbals:
        link = link.replace(s, "")
    link = link.replace(" ", "-")
    return link

def _format_markdown_requisite(state, stateid, makelink=True):
    """
    format requisite as a link users can click
    """
    fmt_id = "{}: {}".format(state, stateid)
    if makelink:
        return " * [{}](#{})\n".format(fmt_id, _format_markdown_link(fmt_id))
    else:
        return " * `{}`\n".format(fmt_id)

def processor_markdown(lowstate_item, config, **kwargs):
    """
    Takes low state data and returns a dict of processed data
    that is by default used in a jinja template when rendering a markdown highstate_doc.

This `lowstate_item_markdown` given a lowstate item, returns a dict like:

.. code-block:: none

vars:       # the raw lowstate_item that was processed
        id:         # the 'id' of the state.
        id_full:    # combo of the state type and id "state: id"
        state:      # name of the salt state module
        function:   # name of the state function
        name:       # value of 'name:' passed to the salt state module
        state_function:    # the state name and function name
        markdown:          # text data to describe a state
            requisites:    # requisite like [watch_in, require_in]
            details:       # state name, parameters and other details like file contents

"""
    # TODO: switch or ... ext call.
    s = lowstate_item
    state_function = "{}.{}".format(s["state"], s["fun"])
    id_full = "{}: {}".format(s["state"], s["__id__"])

# TODO: use salt defined STATE_REQUISITE_IN_KEYWORDS
    requisites = ""
    for comment, key in (
        ("run or update after changes in:\n", "watch"),
        ("after changes, run or update:\n", "watch_in"),
        ("require:\n", "require"),
        ("required in:\n", "require_in"),
    ):
        reqs = s.get(key, [])
        if reqs:
            requisites += comment
            for w in reqs:
                requisites += _format_markdown_requisite(*next(iter(w.items())))

details = ""

if state_function == "highstate_doc.note":
        if "contents" in s:
            details += "\n{}\n".format(s["contents"])
        if "source" in s:
            text = __salt__["cp.get_file_str"](s["source"])
            if text:
                details += "\n{}\n".format(text)
            else:
                details += "\n{}\n".format("ERROR: opening {}".format(s["source"]))

if state_function == "pkg.installed":
        pkgs = s.get("pkgs", s.get("name"))
        details += "\n```\ninstall: {}\n```\n".format(pkgs)

if state_function == "file.recurse":
        details += """recurse copy of files\n"""
        y = _state_data_to_yaml_string(s)
        if y:
            details += "```\n{}\n```\n".format(y)
        if "!doc_recurse" in id_full:
            findfiles = __salt__["file.find"](path=s.get("name"), type="f")
            if len(findfiles) < 10 or "!doc_recurse_force" in id_full:
                for f in findfiles:
                    details += _format_markdown_system_file(f, config)
            else:
                details += """ > Skipping because more than 10 files to display.\n"""
                details += (
                    """ > HINT: to force include !doc_recurse_force in state id.\n"""
                )
        else:
            details += """ > For more details review logs and Salt state files.\n\n"""
            details += """ > HINT: for improved docs use multiple file.managed states or file.archive, git.latest. etc.\n"""
            details += """ > HINT: to force doc to show all files in path add !doc_recurse .\n"""

if state_function == "file.blockreplace":
        if s.get("content"):
            details += "ensure block of content is in file\n```\n{}\n```\n".format(
                _md_fix(s["content"])
            )
        if s.get("source"):
            text = "** source: " + s.get("source")
            details += "ensure block of content is in file\n```\n{}\n```\n".format(
                _md_fix(text)
            )

if state_function == "file.managed":
        details += _format_markdown_system_file(s["name"], config)

# if no state doc is created use default state as yaml
    if not details:
        y = _state_data_to_yaml_string(s)
        if y:
            details += "```\n{}```\n".format(y)

r = {
        "vars": lowstate_item,
        "state": s["state"],
        "name": s["name"],
        "function": s["fun"],
        "id": s["__id__"],
        "id_full": id_full,
        "state_function": state_function,
        "markdown": {
            "requisites": requisites.decode("utf-8"),
            "details": details.decode("utf-8"),
        },
    }
    return r