scwrypts/zsh/lib/utils
yage f3e70c61cb v3.9.0
=====================================================================

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

- scwrypts runner has new arguments
  -q/--quiet   allows quiet-mode operation while still logging to logfiles
  -v/--verbose forces verbose mode
    --version  longform required (-v is now for "verbose" mode)

- scwrypts runner now auto-detects certain CLI usage, running in quiet,
  logged mode if pattern match successfully identifies a single scwrypt
  (or when using --name); use --verbose to override this behavior

- 'k exec' no longer requires double '--' if a '--' comes after
  - old : k exec -it my-pod-0 -- -- /bin/sh
  + new : k exec -it my-pod-0 -- /bin/sh
  + still works : k -- exec -it my-pod-0 -- /bin/sh

--- Bug Fixes ----------------------------

- fixed various plugins/kubectl auto-completion settings; arguments
  after '--' or profile number (e.g. 'k 1 get deployments') will now
  appropriately autocomplete in the indicated profile

- helm template functions now work on related .tpl files as well
  (renders from chart root)

- fixed some goofy UTF-8 icons in zsh/lib/utils/io

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

- (experimental) scwrypts zsh plugin for interactive command selection
  (like CTRL+SPACE), but allows you to build command arguments,
  providing help dialogue for the selected command

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

- zsh/misc/tally ) helps keep tally-counts of things; helpful when
                   running long scripts "what iteration am I on"
2023-12-11 18:19:37 -07:00
..
colors.zsh v3.0.0 "The Great Overhaul" 2023-06-21 20:04:30 -06:00
credits.zsh v3.0.0 "The Great Overhaul" 2023-06-21 20:04:30 -06:00
dependencies.zsh v3.8.0 2023-11-22 15:54:16 -07:00
environment.zsh v3.5.0 2023-08-24 17:11:34 -06:00
io.zsh v3.9.0 2023-12-11 18:19:37 -07:00
os.zsh v3.0.0 "The Great Overhaul" 2023-06-21 20:04:30 -06:00
README.md v3.0.0 "The Great Overhaul" 2023-06-21 20:04:30 -06:00
utils.module.zsh v3.7.0 2023-11-10 16:32:05 -07:00

ZSH Utilities

A shell-scripting utilities module made for ZSH. This module is definitely a major component of Scwrypts, but is also standalone and can be sourced by any ZSH script to utilize (almost) all of the features.

Usage

Import utils.module.zsh to activate all of the features. Doing so will also check for path dependencies and required environment variables (see Dependencies and Environment below).

#!/bin/zsh
source ./path/to/utils.plugin.zsh
SUCCESS 'ZSH utilities online!'

Checkout io and os for available simple functions.

Dependencies

Ensures dependent programs are available for execution. Specify a simple name to check the current PATH, or give a fully-qualified path for arbitrary dependency inclusion.

Include a dependency by adding to the DEPENDENCIES array. Always using += makes your dependencies extensible to other scripts :)

If any dependencies are missing, source utils.module.zsh will return an error code and count the number of missing dependencies in the variable DEP_ERROR_COUNT.

#!/bin/zsh
DEPENDENCIES+=(
	path-executable-1
	path-executable-2
	/path/to/arbitrary/program
)
source ./path/to/utils.plugin.zsh
echo "missing $DEP_ERROR required dependencies"

Environment

Similar to Dependencies, environment.zsh ensures a list of environment variables are set to non-empty values.

Include an environment variable by adding to the REQUIRED_ENV array. Something something use += here too ;)

If any environment variables are missing, source utils.module.zsh will return an error code and count the number of missing variables in ENV_ERROR_COUNT.

Missing environment variables will be added to the environment template (exclusive to Scwrypts).

#!/bin/zsh
REQUIRED_ENV+=(
	AWS_PROFILE
	AWS_REGION
)
source ./path/to/utils.plugin.zsh
echo "missing $ENV_ERROR_COUNT required environment variables"