bashly 1.0.7 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a333ce419f5ba64e38000497f245fc5baf822243cd2765c1805ebdf6de2e3b46
-  data.tar.gz: 0c9ab24cc2cecd88cbd20a06ab11028740ce3000aec75080ca9a12c6769110c1
+  metadata.gz: b82e5ead650cc1774cf3870af91b9046b1e5f69f05484d833f72dd4090eab091
+  data.tar.gz: 26626b09b79382d2d4530241b5517ed04d3e4a27c004130adadad3b27421f100
 SHA512:
-  metadata.gz: ff95fd919a29a16d610d8f3c069f2de17b9984a41251de56e484a5dc49e86dd4114934c47ccb2274521f7f8bd5078287a54ef10478c5e18b6c8a93f462f1c503
-  data.tar.gz: 65a1be57601cc7a560a19ef48dc75b09647244fe477327f23ae52a37f8114afca4ee3871a1f72e1b046589e252a57701956a93e9015907bf76fd24455da341ff
+  metadata.gz: 9e3b78d5975c92954347be94d567f28d240d628e080fb3d136382cc4f8fa1ae81827057ad3b61ac144b5ab930c3f5353128f9d6068b983d0e2e77ac996d4ab0d
+  data.tar.gz: 2595428ca74b3ada25619fc7839f99993f98bcda169b47fcda84c82b279ebcaa1882864d2d842c67f05ca1ca946f2f64867d6905892f2ff5f5f5107f32f49037

data/lib/bashly/commands/completions.rb

@@ -4,7 +4,7 @@ module Bashly
       summary 'Install bash completions for bashly itself'
       help 'Display the bash completions script or install it directly to your bash completions directory'
 
-      usage 'bashly completions [--install --uninstall]'
+      usage 'bashly completions [--install|--uninstall]'
       usage 'bashly completions (-h|--help)'
 
       option '-i --install', 'Install the completions script to your bash completions directory'

data/lib/bashly/libraries/config/config.sh

@@ -1,128 +1,108 @@
-## Config functions [@bashly-upgrade config]
+## Config (INI) functions [@bashly-upgrade config]
 ## This file is a part of Bashly standard library
 ##
 ## Usage:
-## - In your script, set the CONFIG_FILE variable. For rxample:
-##   CONFIG_FILE=settings.ini.
-##   If it is unset, it will default to 'config.ini'.
-## - Use any of the functions below to access the config file.
 ##
-## Create a new config file.
-## There is normally no need to use this function, it is used by other
-## functions as needed.
+## - Set the global variable CONFIG_FILE to the path of your INI file somewhere
+##   in your script (for example, in src/initialize.sh).
+## - Use any of the following functions to access and manipulate the values.
+## - INI sections are optional (i.e., sectionless key=value pairs are allowed).
 ##
-config_init() {
-  CONFIG_FILE=${CONFIG_FILE:=config.ini}
-  [[ -f "$CONFIG_FILE" ]] || touch "$CONFIG_FILE"
+
+## Show all the key=value pairs from your config file
+config_show() {
+  config_load
+  ini_show
 }
 
-## Get a value from the config.
-## Usage: result=$(config_get hello)
+## Get a single value from the config file:
+##
+##   config_get login.email
+##
+## Get the value or a default one if it is not set:
+##
+##   config_get login.user guest
+##
+## Assign the result to a variable:
+##
+##   theme="$(config_get interface.theme)"
+##
 config_get() {
-  local key=$1
-  local regex="^$key *= *(.+)$"
-  local value=""
-
-  config_init
+  local key="$1"
+  local default_value="$2"
 
-  while IFS= read -r line || [ -n "$line" ]; do
-    if [[ $line =~ $regex ]]; then
-      value="${BASH_REMATCH[1]}"
-      break
-    fi
-  done <"$CONFIG_FILE"
-
-  echo "$value"
+  config_load
+  echo "${ini["$key"]:-$default_value}"
 }
 
-## Add or update a key=value pair in the config.
-## Usage: config_set key value
+## Create/update a key=value pair:
+##
+##   config_set cloud.provider aws
+##
 config_set() {
-  local key=$1
+  local key="$1"
   shift
   local value="$*"
 
-  config_init
-
-  local regex="^($key) *= *.+$"
-  local output=""
-  local found_key=""
-  local newline
-
-  while IFS= read -r line || [ -n "$line" ]; do
-    newline=$line
-    if [[ $line =~ $regex ]]; then
-      found_key="${BASH_REMATCH[1]}"
-      newline="$key = $value"
-      output="$output$newline\n"
-    elif [[ $line ]]; then
-      output="$output$line\n"
-    fi
-  done <"$CONFIG_FILE"
-
-  if [[ -z $found_key ]]; then
-    output="$output$key = $value\n"
-  fi
-
-  printf "%b\n" "$output" >"$CONFIG_FILE"
+  config_load
+  ini["$key"]="$value"
+  config_save
 }
 
-## Delete a key from the config.
-## Usage: config_del key
+## Delete a key=value pair:
+##
+##   config_del login.email
+##
 config_del() {
-  local key=$1
+  local key="$1"
 
-  local regex="^($key) *="
-  local output=""
-
-  config_init
-
-  while IFS= read -r line || [ -n "$line" ]; do
-    if [[ $line ]] && [[ ! $line =~ $regex ]]; then
-      output="$output$line\n"
-    fi
-  done <"$CONFIG_FILE"
-
-  printf "%b\n" "$output" >"$CONFIG_FILE"
-}
-
-## Show the config file
-config_show() {
-  config_init
-  cat "$CONFIG_FILE"
+  config_load
+  unset "ini[$key]"
+  config_save
 }
 
-## Return an array of the keys in the config file.
-## Usage:
+## Get an array of all keys:
 ##
-##   for k in $(config_keys); do
-##     echo "- $k = $(config_get "$k")";
+##   for key in $(config_keys); do
+##     echo "- $key = $(config_get "$key")";
 ##   done
 ##
 config_keys() {
-  local regex="^([a-zA-Z0-9_\-\/\.]+) *="
-
-  config_init
-
-  local keys=()
-  local key
-
-  while IFS= read -r line || [ -n "$line" ]; do
-    if [[ $line =~ $regex ]]; then
-      key="${BASH_REMATCH[1]}"
-      keys+=("$key")
-    fi
-  done <"$CONFIG_FILE"
-  echo "${keys[@]}"
+  config_load
+  ini_keys
 }
 
-## Returns true if the specified key exists in the config file.
-## Usage:
+## Check if a key exists:
 ##
-##   if config_has_key "key"; then
+##   if config_has_key login.password; then
 ##     echo "key exists"
 ##   fi
 ##
 config_has_key() {
   [[ $(config_get "$1") ]]
 }
+
+## Force-load from file
+## This should normally not be called, unless you suspect that the INI file
+## was modified by external means during the run of your script.
+config_reload() {
+  declare -g config_loaded=false
+  config_load
+}
+
+## Load an INI file (unless loaded) and populate the associative array
+## NOTE: Normally there is no need to call this function, it is called as needed
+config_load() {
+  [[ "$config_loaded" == "true" ]] && return
+
+  declare -g CONFIG_FILE=${CONFIG_FILE:=config.ini}
+  declare -g config_loaded=true
+  [[ -f "$CONFIG_FILE" ]] || touch "$CONFIG_FILE"
+  ini_load "$CONFIG_FILE"
+}
+
+## Save the associative array back to a file
+## NOTE: Normally there is no need to call this function, it is called as needed
+config_save() {
+  ini_save "$CONFIG_FILE"
+}

data/lib/bashly/libraries/ini/ini.sh

@@ -0,0 +1,110 @@
+## INI functions [@bashly-upgrade ini]
+## This file is a part of Bashly standard library
+##
+## Usage:
+##
+## - In your script, call `ini_load path/to/config.ini`.
+## - A global associative array named `ini` will become available to you,
+## - When updating any of the associative array's values, call
+##   `ini_save path/to/config.ini` to save the data.
+## - INI sections are optional.
+##
+## Get a value:
+##
+##   ${ini[section1.key1]}  # for keys under a [section]
+##   ${ini[key1]}           # for keys not under a [section]
+##   ${ini[key1]:-default}  # get a default value if the INI key is unset
+##
+## Update/create a value:
+##
+##   ini[section1.key1]="value"
+##   ini_save path/to/config.ini
+##
+## Delete a value
+##
+##   unset ini[section1.key1]
+##   ini_save path/to/config.ini
+##
+
+## Load an INI file and populate the associative array `ini`.
+ini_load() {
+  declare -gA ini
+
+  local ini_file="$1"
+
+  local section=""
+  local key=""
+  local value=""
+  local section_regex="^\[(.+)\]"
+  local key_regex="^([^ =]+) *= *(.*) *$"
+  local comment_regex="^;"
+
+  while IFS= read -r line; do
+    if [[ $line =~ $comment_regex ]]; then
+      continue
+    elif [[ $line =~ $section_regex ]]; then
+      section="${BASH_REMATCH[1]}."
+    elif [[ $line =~ $key_regex ]]; then
+      key="${BASH_REMATCH[1]}"
+      value="${BASH_REMATCH[2]}"
+      ini["${section}${key}"]="$value"
+    fi
+  done <"$ini_file"
+}
+
+## Save the associative array `ini` back to a file
+ini_save() {
+  declare -gA ini
+
+  local ini_file="$1"
+
+  local current_section=""
+  local has_free_keys=false
+
+  rm -f "$ini_file"
+
+  for key in $(ini_keys); do
+    [[ $key == *.* ]] && continue
+    has_free_keys=true
+    value="${ini[$key]}"
+    echo "$key = $value" >>"$ini_file"
+  done
+
+  [[ "${has_free_keys}" == "true" ]] && echo >>"$ini_file"
+
+  for key in $(ini_keys); do
+    [[ $key == *.* ]] || continue
+    value="${ini[$key]}"
+    IFS="." read -r section_name key_name <<<"$key"
+
+    if [[ "$current_section" != "$section_name" ]]; then
+      [[ $current_section ]] && echo >>"$ini_file"
+      echo "[$section_name]" >>"$ini_file"
+      current_section="$section_name"
+    fi
+    
+    echo "$key_name = $value" >>"$ini_file"
+  done
+}
+
+## Show all loaded key-value pairs
+ini_show() {
+  declare -gA ini
+
+  for key in $(ini_keys); do
+    echo "$key = ${ini[$key]}"
+  done
+}
+
+## Get an array of all keys:
+##
+##   for key in $(ini_keys); do
+##     echo "- $key = ${ini[$key]}";
+##   done
+##
+ini_keys() {
+  declare -gA ini
+
+  local keys=("${!ini[@]}")
+  for a in "${keys[@]}"; do echo "$a"; done | sort
+}

data/lib/bashly/libraries/libraries.yml

@@ -20,10 +20,12 @@ completions_yaml:
   handler: Bashly::Libraries::CompletionsYAML
 
 config:
-  help: Add standard functions for handling INI files to the lib directory.
+  help: Add functions for handling INI configuration files to the lib directory.
   files:
     - source: "config/config.sh"
       target: "%{user_lib_dir}/config.%{user_ext}"
+    - source: "ini/ini.sh"
+      target: "%{user_lib_dir}/ini.%{user_ext}"
 
 help:
   help: Add a help command, in addition to the standard --help flag.
@@ -39,6 +41,12 @@ hooks:
     - source: "hooks/after.sh"
       target: "%{user_source_dir}/after.%{user_ext}"
 
+ini:
+  help: Add low level functions for reading/writing INI files to the lib directory.
+  files:
+    - source: "ini/ini.sh"
+      target: "%{user_lib_dir}/ini.%{user_ext}"
+
 lib:
   help: |-
     Create the lib directory for any additional user scripts.

data/lib/bashly/version.rb

@@ -1,3 +1,3 @@
 module Bashly
-  VERSION = '1.0.7'
+  VERSION = '1.0.8'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bashly
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.0.8
 platform: ruby
 authors:
 - Danny Ben Shitrit
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-07-07 00:00:00.000000000 Z
+date: 2023-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colsole
@@ -114,6 +114,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: psych
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
 description: Generate bash command line tools using YAML configuration
 email: db@dannyben.com
 executables:
@@ -164,6 +184,7 @@ files:
 - lib/bashly/libraries/hooks/after.sh
 - lib/bashly/libraries/hooks/before.sh
 - lib/bashly/libraries/hooks/initialize.sh
+- lib/bashly/libraries/ini/ini.sh
 - lib/bashly/libraries/lib/sample_function.sh
 - lib/bashly/libraries/libraries.yml
 - lib/bashly/libraries/settings/settings.yml
@@ -253,7 +274,7 @@ metadata:
   homepage_uri: https://bashly.dannyb.co/
   source_code_uri: https://github.com/DannyBen/bashly
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -268,8 +289,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key: 
+rubygems_version: 3.4.18
+signing_key:
 specification_version: 4
 summary: Bash Command Line Tool Generator
 test_files: []