Replaced "chat" and "chatf" with "vtalk" and "vtalkf".

Author: aks

README.md

@@ -208,16 +208,16 @@ handy functions for writing bash-based scripts
 
 Copyright 2006-2013 Alan K. Stebbens <[email protected]>
 
-    chat MSG ..
-    chatf FMT ARGS ..
-
-If `$norun` or `$verbose` is set, print (or printf) all args on `STDERR`.
-
     talk MSG ..
     talkf FMT ARGS ..
 
 Print (or printf) all arguments on `STDERR`.
 
+    vtalk MSG ..
+    vtalkf FMT ARGS ..
+
+If `$norun` or `$verbose` is set, print (or printf) all args on `STDERR`.
+
     nvtalk MSG 
     nvtalkf FMT ARGS ..
 

date-utils.sh

@@ -1,7 +1,12 @@
 # bash 
-# date-utils.sh
+# date-utils.sh  -- date management utility for bash
+#
 # Copyright 2009-2013 Alan K. Stebbens <[email protected]>
-# 
+
+[[ -z "$DATE_UTILS_SH" ]] || return 
+
+DATE_UTILS_SH="${BASH_SOURCE[0]}"
+
 # functions for date management
 #
 # date_arg YYYY-MM-DD 
@@ -250,3 +255,5 @@ get_date_last_quarter_end() {
   print_date $year $month 1
 }
 
+# end of date-utils.sh
+# vim: set ai sw=2

sh-utils.sh

@@ -14,13 +14,13 @@ sh_utils_help() {
     cat 1>&2 <<EOF
 Shell utility functions:
 
-talk MSG ..         Print all arguments on STDERR.
-chat MSG ..         If $norun or $verbose is set, print all args on STDERR.
+  talk MSG ..       Print all arguments on STDERR.
+ vtalk MSG ..       If $norun or $verbose is set, print all args on STDERR.
 nvtalk MSG          Print all arguments on STDERR only if $verbose is not set.
 error [CODE] "MSG"  Print MSG on STDERR, then exit with code CODE (or 2)
 
-talkf FMT ARGS ..           printf FMT ARGS on STDERR
-chatf FMT ARGS ..           printf FMT ARGS on STDERR if $norun or $verbose set
+  talkf FMT ARGS ..         printf FMT ARGS on STDERR
+ vtalkf FMT ARGS ..         printf FMT ARGS on STDERR if $norun or $verbose set
 nvtalkf FMT ARGS ..         printf FMT ARGS on STDERR unless $verbose set
 errorf [CODE] FMT ARGS ..   printf FMT ARGS on STDERR, then exit $CODE [2]
 
@@ -36,14 +36,13 @@ EOF
 }
 help_sh_utils() { sh_utils_help ; }
 
-# chat MSG        - show MSG on STDERR if $norun or $verbose
-# talk MSG        - show MSG on STDERR
-# warn MSG        - show MSG on STDERR
+#   talk MSG      - show MSG on STDERR
+#  vtalk MSG      - show MSG on STDERR if $norun or $verbose
 # nvtalk MSG      - show MSG on STDERR unless $verbose is set
 
 talk()        { echo 1>&2 "$@" ; }
 warn()        { talk "$@" ; }
-chat()	{ [[ -n "$norun$verbose" ]] && talk "$@" ; }
+vtalk()	      { [[ -n "$norun$verbose" ]] && talk "$@" ; }
 nvtalk()      { [[ -z "$verbose" ]] && talk "$@" ; }
 
 # error [CODE] MSG - show MSG on STDERR then exit with error CODE [default 2]
@@ -55,14 +54,14 @@ error()       {
   exit $code
 }
 
-# chatf FMT ARGS..    printf FMT ARGS on STDERR if $norun or $verbose are set
-# talkf FMT ARGS...   printf FMT ARGS on STDERR
-# warnf FMT ARGS...   alias for talkf
-# nvtalkf FMT ARGS..  printf FMT ARGS on STDERR unless $verbose set
+#   talkf FMT ARGS...   printf FMT ARGS on STDERR
+#   warnf FMT ARGS...   alias for talkf
+#  vtalkf FMT ARGS..    printf FMT ARGS on STDERR if $norun or $verbose are set
+# nvtalkf FMT ARGS..    printf FMT ARGS on STDERR unless $verbose set
 
 talkf()       { printf 1>&2 "$@" ; }
 warnf()       { talkf "$@" ; }
-chatf()       { [[ -n "$norun$verbose" ]] && talkf "$@" ; }
+vtalkf()      { [[ -n "$norun$verbose" ]] && talkf "$@" ; }
 nvtalkf()     { [[ -z "$verbose" ]] && talkf "$@" ; }
 
 # errorf [CODE] FMT ARGS .. print FMT ARGS on STDERR, then exit with CODE[2]

sync-files.sh

@@ -103,10 +103,10 @@ build_files() {
     file="$( eval echo \"${FILENAME_BUILDER:?'FILENAME_BUILDER not defined!'}\" )"
     if [[ -e "$file" ]]; then               # already exists?
       if [[ -z "$force" ]]; then            # force build it?
-        chat "Not building $file; already exists."
+        vtalk "Not building $file; already exists."
         continue                            # no, skip it
       else
-        chat "Rebuilding $file.."
+        vtalk "Rebuilding $file.."
       fi
     fi
     run "$( eval echo \"$FILE_GENERATOR\" )"

t1.sh

@@ -0,0 +1,18 @@
+#/bin/sh
+# Copyright 2006-2013, Alan K. Stebbens <[email protected]>
+# 
+# Test module for list-utils.sh
+#
+
+export PATH=.:$HOME/lib:$PATH
+
+source list-utils.sh
+source test-utils.sh
+
+  tlist1=( now is the time for all good men to come to the aid of their country )
+
+  items=( `grep_list tlist1 the` )
+
+  echo "$?"
+  echo `join_list items`
+  exit

t2.sh

@@ -0,0 +1,24 @@
+#/bin/sh
+  echo "\
+           s/ /%20/g   ; s/\\\$/%24/g ; s/\>/%3E/g  ;
+           s/#/%23/g   ; s/\%/%25/g  ;  s/\[/%5B/g  ;
+           s/'/%27/g   ; s/\&/%26/g  ;  s/\]/%5D/g  ;
+           s/,/%2C/g   ; s/\(/%28/g  ;  s/\^/%5E/g  ;
+           s/-/%2D/g   ; s/\)/%29/g  ;  s/\`/%60/g  ;
+           s/=/%3D/g   ; s/\*/%2A/g  ;  s/\{/%7B/g  ;
+           s/[\]/%5C/g ; s/\+/%2B/g  ;  s/\|/%7C/g  ;
+           s/\!/%21/g  ; s/\//%2F/g  ;  s/\}/%7D/g  ;
+           s/\"/%22/g  ; s/\</%3C/g  ;  s/\~/%7E/g"
+
+echo ''
+
+  echo "\
+           s/\%20/ /g  ;  s/\%29/)/g   ;   s/\%5B/[/g   ;
+           s/\%21/\!/g ;  s/\%2A/*/g   ;   s/\%5C/\\\\/g  ;
+           s/\%22/\"/g ;  s/\%2B/+/g   ;   s/\%5D/]/g   ;
+           s/\%23/\#/g ;  s/\%2C/,/g   ;   s/\%5E/^/g   ;
+           s/\%24/\$/g ;  s/\%2D/-/g   ;   s/\%60/\`/g  ;
+           s/\%25/\%/g ;  s/\%2F/\//g  ;   s/\%7B/{/g   ;
+           s/\%26/\&/g ;  s/\%3C/</g   ;   s/\%7C/|/g   ;
+           s/\%27/'/g  ;  s/\%3D/=/g   ;   s/\%7D/}/g   ;
+           s/\%28/(/g  ;  s/\%3E/>/g   ;   s/\%7E/~/g"

test-sh-utils.sh

@@ -20,8 +20,8 @@ talk "one two three"
 
 for norun in '' 1 ; do
   for verbose in '' 1 ; do
-    echo -n 1>&2 "norun=$norun verbose=$verbose : chat says: "
-    chat "this is a test"
+    echo -n 1>&2 "norun=$norun verbose=$verbose : vtalk says: "
+    vtalk "this is a test"
     echo 1>&2
   done
 done
@@ -37,9 +37,9 @@ while [[ $x -lt ${#wordlist[*]} ]]; do
   x=$((x + 1))
 done
 
-echo $'\nTesting chatf ..'
+echo $'\nTesting vtalkf ..'
 
 verobse= norun=
 for verbose in '' 1 ; do
-  chatf "Verbose = %s\n" $verbose
+  vtalkf "Verbose = %s\n" $verbose
 done

text-utils.sh

@@ -5,6 +5,8 @@
 
 [[ -z "$TEXT_UTILS_SH" ]] || return
 
+export TEXT_UTILS_SH="${BASH_SOURCE[0]}"
+
 help_test_utils() {
   cat 1>&2 <<EOF
 lowercase STRING              # return the lowercase string
@@ -106,8 +108,5 @@ html_decode() {
 }
 
 
-# define TEXT_UTILS_SH as the source file that brought us in
-export TEXT_UTILS_SH="${BASH_SOURCE[0]}"
-
 # end text-utils.sh
 # vim: set sw=2 ai