v3.0.0 "The Great Overhaul"

=====================================================================

Notice the major version change which comes with breaking changes to
2.x! Reconstructs "library" functions for both python and zsh scwrypts,
with changes to virtualenv naming conventions (you'll need to refresh
all virtualenv with the appropriate scwrypt).

--- Changes ------------------------------

- changed a naming convention across zsh scripts, particularly
  removing underscores where there is no need to avoid naming clash
  (e.g. 'zsh/lib/utils/io.zsh' renames '__STATUS' to 'STATUS')

- moved clients reliant on py.lib.http to the py.lib.http module

- python scripts now rely on py.lib.scwrypts.execute

- updated package.json in zx scripts to include `type = module`

- 'scwrypts --list' commandline argument now includes additional
  relevant data for each scwrypt

- environment variables no longer add themselves to be staged in the
  '.env.template'

--- New Features -------------------------

- new 'use' syntax for disjoint import within zsh scripts; took me
  a very long time to convince myself this would be necessary

- introduced scwrypt "groups" to allow portable module creation;
  (i.e. ability add your own scripts from another repo!)

- py.lib.scwrypts.io provides a combined IO stream for quick, hybrid
  use of input/output files and stdin/stdout

- py.lib.fzf provides a wrapper to provide similar functionality to
  zsh/utils/io.zsh including fzf_(head|tail)

- improved efficiency of various scwrypts; notably reducing runtime
  of scwrypts/environment sync

- improved scwrypts CLI by adding new options for exact scwrypt
  matching, better filtering, and prettier/more-detailed interfaces

--- New Scripts --------------------------

- py/twilio )
    basic SMS integration with twilio
     - send-sms

- py/directus )
    interactive directus GET query
     - get-items

- py/discord )
    post message to discord channel or webhook
     - post-message

zsh/cloud/aws/README.md

@@ -0,0 +1,5 @@
+# Amazon Web Services
+[![Generic Badge](https://img.shields.io/badge/barnybug-cli53-informational.svg)](https://github.com/barnybug/cli53)
+<br>
+
+- relies on AWS-CLI 2.x

zsh/cloud/aws/ecr/login

@@ -0,0 +1,10 @@
+#!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
+use cloud/aws/ecr
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+ECR_LOGIN $@

zsh/cloud/aws/efs/mount

@@ -0,0 +1,69 @@
+#!/bin/zsh
+DEPENDENCIES+=(jq)
+REQUIRED_ENV+=(AWS__EFS__LOCAL_MOUNT_POINT)
+
+use cloud/aws/cli
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+EFS_CONNECT() {
+	GETSUDO || exit 1
+	[ ! -d $AWS__EFS__LOCAL_MOUNT_POINT ] && {
+		sudo mkdir $AWS__EFS__LOCAL_MOUNT_POINT \
+			&& STATUS "created local mount point '$AWS__EFS__LOCAL_MOUNT_POINT'"
+	}
+
+	local FS_ID=$(\
+		AWS efs describe-file-systems \
+		| jq -r '.[] | .[] | .FileSystemId' \
+		| FZF 'select a filesystem to mount' \
+	)
+	[ ! $FS_ID ] && ABORT
+
+	local MOUNT_POINT="$AWS__EFS__LOCAL_MOUNT_POINT/$FS_ID"
+	[ -d "$MOUNT_POINT" ] && sudo rmdir "$MOUNT_POINT" >/dev/null 2>&1
+	[ -d "$MOUNT_POINT" ] && {
+		STATUS "$FS_ID is already mounted"
+		exit 0
+	}
+
+	local MOUNT_TARGETS=$(AWS efs describe-mount-targets --file-system-id $FS_ID)
+	local ZONE=$(\
+		echo $MOUNT_TARGETS \
+		| jq -r '.[] | .[] | .AvailabilityZoneName' \
+		| sort -u | FZF 'select availability zone'\
+	)
+	[ ! $ZONE ] && ABORT
+
+	local MOUNT_IP=$(\
+		echo $MOUNT_TARGETS \
+		| jq -r ".[] | .[] | select (.AvailabilityZoneName == \"$ZONE\") | .IpAddress" \
+		| head -n1 \
+	)
+
+	SUCCESS 'ready to mount!'
+	REMINDER 'for private file-systems, you must be connected to the appropriate VPN'
+
+	STATUS "file system id    : $FS_ID"
+	STATUS "availability zone : $ZONE"
+	STATUS "file system ip    : $MOUNT_IP"
+	STATUS "local mount point : $MOUNT_POINT"
+
+	Yn 'proceed?' || ABORT
+
+	sudo mkdir $MOUNT_POINT \
+		&& sudo mount \
+			-t nfs4 \
+			-o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport \
+			$MOUNT_IP:/ \
+			"$MOUNT_POINT" \
+		&& SUCCESS "mounted at '$MOUNT_POINT'" \
+		|| {
+		sudo rmdir $MOUNT_POINT >/dev/null 2>&1
+		FAIL 2 "unable to mount '$FS_ID'"
+	}
+}
+
+#####################################################################
+EFS_CONNECT $@

zsh/cloud/aws/efs/unmount

@@ -0,0 +1,37 @@
+#!/bin/zsh
+DEPENDENCIES+=(jq)
+REQUIRED_ENV+=(AWS__EFS__LOCAL_MOUNT_POINT)
+
+use cloud/aws/cli
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+EFS_DISCONNECT() {
+	[ ! -d "$AWS__EFS__LOCAL_MOUNT_POINT" ] && {
+		STATUS 'no efs currently mounted'
+		exit 0
+	}
+
+	local MOUNTED=$(ls "$AWS__EFS__LOCAL_MOUNT_POINT")
+	[ ! $MOUNTED ] && {
+		STATUS 'no efs currently mounted'
+		exit 0
+	}
+
+	GETSUDO || exit 1
+
+
+	local SELECTED=$(echo $MOUNTED | FZF 'select a file system to unmount')
+	[ ! $SELECTED ] && ABORT
+
+	local EFS="$AWS__EFS__LOCAL_MOUNT_POINT/$SELECTED"
+	STATUS "unmounting '$SELECTED'"
+	sudo umount $EFS >/dev/null 2>&1
+	sudo rmdir $EFS \
+		&& SUCCESS "done" \
+		|| FAIL 2 "failed to unmount '$EFS'"
+}
+
+#####################################################################
+EFS_DISCONNECT $@

zsh/cloud/aws/eks/login

@@ -0,0 +1,10 @@
+#!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
+use cloud/aws/eks
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+EKS_CLUSTER_LOGIN $@

zsh/cloud/aws/rds/create-backup

@@ -0,0 +1,25 @@
+#!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
+use cloud/aws/rds
+use db/postgres
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+CREATE_BACKUP() {
+	local DB_HOST DB_PORT DB_NAME DB_USER DB_PASS
+	RDS__GET_DATABASE_CREDENTIALS $@ || return 1
+
+	PG_DUMP \
+		--host $DB_HOST \
+		--port $DB_PORT \
+		--name $DB_NAME \
+		--user $DB_USER \
+		--pass $DB_PASS \
+		;
+}
+
+#####################################################################
+CREATE_BACKUP $@

zsh/cloud/aws/rds/interactive-login

@@ -0,0 +1,26 @@
+#!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
+use cloud/aws/rds
+use db/postgres
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+RDS_INTERACTIVE_LOGIN() {
+	local DB_HOST DB_PORT DB_NAME DB_USER DB_PASS
+	RDS__GET_DATABASE_CREDENTIALS $@ || return 1
+
+	POSTGRES__LOGIN_INTERACTIVE \
+		--host $DB_HOST \
+		--port $DB_PORT \
+		--name $DB_NAME \
+		--user $DB_USER \
+		--pass $DB_PASS \
+		;
+}
+
+
+#####################################################################
+RDS_INTERACTIVE_LOGIN $@

zsh/cloud/aws/rds/load-backup

@@ -0,0 +1,26 @@
+#!/bin/zsh
+DEPENDENCIES+=()
+REQUIRED_ENV+=()
+
+use cloud/aws/rds
+use db/postgres
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+LOAD_BACKUP() {
+	local DB_HOST DB_PORT DB_NAME DB_USER DB_PASS
+	RDS__GET_DATABASE_CREDENTIALS $@ || return 1
+
+	PG_RESTORE \
+		--host $DB_HOST \
+		--port $DB_PORT \
+		--name $DB_NAME \
+		--user $DB_USER \
+		--pass $DB_PASS \
+		;
+}
+
+
+#####################################################################
+LOAD_BACKUP $@

zsh/cloud/aws/route53/backup

@@ -0,0 +1,36 @@
+#!/bin/zsh
+DEPENDENCIES+=(cli53)
+REQUIRED_ENV+=(AWS_PROFILE)
+
+CHECK_ENVIRONMENT
+#####################################################################
+
+ROUTE53_BACKUP() {
+	local BACKUP_PATH="$SCWRYPTS_OUTPUT_PATH/$ENV_NAME/aws-dns-backup/$(date '+%Y-%m-%d')"
+	mkdir -p $BACKUP_PATH >/dev/null 2>&1
+
+	local DOMAIN
+	local JOBS=()
+	for DOMAIN in $(ROUTE53_GET_DOMAINS)
+	do
+		( STATUS "creating '$BACKUP_PATH/$DOMAIN.txt'" \
+			&& cli53 export --profile $AWS_PROFILE $DOMAIN > "$BACKUP_PATH/$DOMAIN.txt" \
+			&& SUCCESS "backed up '$DOMAIN'" \
+			|| ERROR "failed to back up '$DOMAIN'" \
+		) &
+		JOBS+=$!
+	done
+
+	local P
+	for P in ${JOBS[@]}; do wait $P >/dev/null 2>&1; done
+}
+
+ROUTE53_GET_DOMAINS() {
+	cli53 list --profile $AWS_PROFILE \
+		| awk '{print $2;}' \
+		| sed '1d; s/\.$//'\
+		;
+}
+
+#####################################################################
+ROUTE53_BACKUP