feat(files): add _randomLineFromFile_

.typos.toml

@@ -1,2 +1,9 @@
-[default.extend-words]
+[default]
-    nd = "nd" # Used in the context of '2nd'
+    default.locale = "en_us"
+
+    [default.extend-words]
+        curren = "curren" # Used in the context of '¤100'
+        nd     = "nd"     # Used in the context of '2nd'
+
+[files]
+    extend-exclude = ["test/test_helper"]

README.md

@@ -20,28 +20,28 @@ To create a new script, copy one of the script templates to a new file and make
 
 There are two templates located at the root level of this repository.
 
-- **`template.sh`** - A lean template which attempts to source all the utility functions from this repository. You will need to update the path to the utilities folder sent to `_sourceUtilities_` at the bottom of the script. This template will not function correctly if the utilities are not found.
+-   **`template.sh`** - A lean template which attempts to source all the utility functions from this repository. You will need to update the path to the utilities folder sent to `_sourceUtilities_` at the bottom of the script. This template will not function correctly if the utilities are not found.
-- **`template_standalone.sh`** - For portability, the standalone template does not assume that this repository is available. Copy and paste the individual utility functions under the `### Custom utility functions` line.
+-   **`template_standalone.sh`** - For portability, the standalone template does not assume that this repository is available. Copy and paste the individual utility functions under the `### Custom utility functions` line.
 
 ### Code Organization
 
 The script templates are roughly split into three sections:
 
-- TOP: Write the main logic of your script within the `_mainScript_` function. It is placed at the top of the file for easy access and editing. However, it is invoked at the end of the script after options are parsed and functions are sourced.
+-   TOP: Write the main logic of your script within the `_mainScript_` function. It is placed at the top of the file for easy access and editing. However, it is invoked at the end of the script after options are parsed and functions are sourced.
-- MIDDLE: Functions and default variable settings are located just below `_mainScript_`.
+-   MIDDLE: Functions and default variable settings are located just below `_mainScript_`.
-- BOTTOM: Script initialization (BASH options, traps, call to `_mainScript_`, etc.) is at the bottom of the template
+-   BOTTOM: Script initialization (BASH options, traps, call to `_mainScript_`, etc.) is at the bottom of the template
 
 ### Default Options
 
 These default options and global variables are included in the templates and used throughout the utility functions. CLI flags to set/unset them are:
 
-- **`-h, --help`**: Prints the contents of the `_usage_` function. Edit the text in that function to provide help
+-   **`-h, --help`**: Prints the contents of the `_usage_` function. Edit the text in that function to provide help
-- **`--logfile [FILE]`** Full PATH to logfile. (Default is `${HOME}/logs/$(basename "$0").log`)
+-   **`--logfile [FILE]`** Full PATH to logfile. (Default is `${HOME}/logs/$(basename "$0").log`)
-- **`loglevel [LEVEL]`**: Log level of the script. One of: `FATAL`, `ERROR`, `WARN`, `INFO`, `DEBUG`, `ALL`, `OFF` (Default is '`ERROR`')
+-   **`loglevel [LEVEL]`**: Log level of the script. One of: `FATAL`, `ERROR`, `WARN`, `INFO`, `DEBUG`, `ALL`, `OFF` (Default is '`ERROR`')
-- **`-n, --dryrun`**: Dryrun, sets `$DRYRUN` to `true` allowing you to write functions that will work non-destructively using the `_execute_` function
+-   **`-n, --dryrun`**: Dryrun, sets `$DRYRUN` to `true` allowing you to write functions that will work non-destructively using the `_execute_` function
-- **`-q, --quiet`**: Runs in quiet mode, suppressing all output to stdout. Will still write to log files
+-   **`-q, --quiet`**: Runs in quiet mode, suppressing all output to stdout. Will still write to log files
-- **`-v, --verbose`**: Sets `$VERBOSE` to `true` and prints all debug messages to stdout
+-   **`-v, --verbose`**: Sets `$VERBOSE` to `true` and prints all debug messages to stdout
-- **`--force`**: If using the `_seekConfirmation_` utility function, this skips all user interaction. Implied `Yes` to all confirmations.
+-   **`--force`**: If using the `_seekConfirmation_` utility function, this skips all user interaction. Implied `Yes` to all confirmations.
 
 You can add custom script options and flags to the `_parseOptions_` function.
 
@@ -125,11 +125,11 @@ You can copy any complete function from the Utilities and place it into your scr
 
 ## alerts.bash
 
-- **`_columns_`** Prints a two column output from a key/value pair
+-   **`_columns_`** Prints a two column output from a key/value pair
-- -**`_printFuncStack_`** Prints the function stack in use. Used for debugging, and error reporting
+-   -**`_printFuncStack_`** Prints the function stack in use. Used for debugging, and error reporting
-- **`_alert_`** Performs alerting functions including writing to a log file and printing to screen
+-   **`_alert_`** Performs alerting functions including writing to a log file and printing to screen
-- **`_centerOutput_`** Prints text in the center of the terminal window
+-   **`_centerOutput_`** Prints text in the center of the terminal window
-- **`_setColors_`** Sets color constants for alerting (**Note:** Colors default to a dark theme.)
+-   **`_setColors_`** Sets color constants for alerting (**Note:** Colors default to a dark theme.)
 
 Basic alerting, logging, and setting color functions (included in `scriptTemplate.sh` by default). Print messages to stdout and to a user specified logfile using the following functions.
 
@@ -147,175 +147,176 @@ dryrun "some text"    # Prints commands that would be run if not in dry run (-n)
 
 The following global variables must be set for the alert functions to work
 
-- **`$DEBUG`** - If `true`, prints `debug` level alerts to stdout. (Default: `false`)
+-   **`$DEBUG`** - If `true`, prints `debug` level alerts to stdout. (Default: `false`)
-- **`$DRYRUN`** - If `true` does not eval commands passed to `_execute_` function. (Default: `false`)
+-   **`$DRYRUN`** - If `true` does not eval commands passed to `_execute_` function. (Default: `false`)
-- **`$LOGFILE`** - Path to a log file
+-   **`$LOGFILE`** - Path to a log file
-- **`$LOGLEVEL`** - One of: FATAL, ERROR, WARN, INFO, DEBUG, ALL, OFF (Default: `ERROR`)
+-   **`$LOGLEVEL`** - One of: FATAL, ERROR, WARN, INFO, DEBUG, ALL, OFF (Default: `ERROR`)
-- **`$QUIET`** - If `true`, prints to log file but not stdout. (Default: `false`)
+-   **`$QUIET`** - If `true`, prints to log file but not stdout. (Default: `false`)
 
 ## arrays.bash
 
 Utility functions for working with arrays.
 
-- **`_dedupeArray_`** Removes duplicate array elements
+-   **`_dedupeArray_`** Removes duplicate array elements
-- **`_forEachDo_`** Iterates over elements and passes each to a function
+-   **`_forEachDo_`** Iterates over elements and passes each to a function
-- **`_forEachFilter_`** Iterates over elements, returning only those that are validated by a function
+-   **`_forEachFilter_`** Iterates over elements, returning only those that are validated by a function
-- **`_forEachFind_`** Iterates over elements, returning the first value that is validated by a function
+-   **`_forEachFind_`** Iterates over elements, returning the first value that is validated by a function
-- **`_forEachReject_`** Iterates over elements, returning only those that are NOT validated by a function
+-   **`_forEachReject_`** Iterates over elements, returning only those that are NOT validated by a function
-- **`_forEachValidate_`** Iterates over elements and passes each to a function for validation
+-   **`_forEachValidate_`** Iterates over elements and passes each to a function for validation
-- **`_inArray_`** Determine if a value is in an array
+-   **`_inArray_`** Determine if a value is in an array
-- **`_isEmptyArray_`** Checks if an array is empty
+-   **`_isEmptyArray_`** Checks if an array is empty
-- **`_joinArray_`** Joins items together with a user specified separator
+-   **`_joinArray_`** Joins items together with a user specified separator
-- **`_mergeArrays_`** Merges the values of two arrays together
+-   **`_mergeArrays_`** Merges the values of two arrays together
-- **`_randomArrayElement_`** Selects a random item from an array
+-   **`_randomArrayElement_`** Selects a random item from an array
-- **`_reverseSortArray_`** Sorts an array from highest to lowest
+-   **`_reverseSortArray_`** Sorts an array from highest to lowest
-- **`_setdiff_`** Return items that exist in ARRAY1 that are do not exist in ARRAY2
+-   **`_setdiff_`** Return items that exist in ARRAY1 that are do not exist in ARRAY2
-- **`_sortArray_`** Sorts an array from lowest to highest
+-   **`_sortArray_`** Sorts an array from lowest to highest
 
 ## checks.bash
 
 Functions for validating common use-cases
 
-- **`_commandExists_`** Check if a command or binary exists in the PATH
+-   **`_commandExists_`** Check if a command or binary exists in the PATH
-- **`_functionExists_`** Tests if a function is available in current scope
+-   **`_functionExists_`** Tests if a function is available in current scope
-- **`_isInternetAvailable_`** Checks if Internet connections are possible
+-   **`_isInternetAvailable_`** Checks if Internet connections are possible
-- **`_isAlpha_`** Validate that a given variable contains only alphabetic characters
+-   **`_isAlpha_`** Validate that a given variable contains only alphabetic characters
-- **`_isAlphaDash_`** Validate that a given variable contains only alpha-numeric characters, as well as dashes and underscores
+-   **`_isAlphaDash_`** Validate that a given variable contains only alpha-numeric characters, as well as dashes and underscores
-- **`_isAlphaNum_`** Validate that a given variable contains only alpha-numeric characters
+-   **`_isAlphaNum_`** Validate that a given variable contains only alpha-numeric characters
-- **`_isDir_`** Validate that a given input points to a valid directory
+-   **`_isDir_`** Validate that a given input points to a valid directory
-- **`_isEmail_`** Validates that an input is a valid email address
+-   **`_isEmail_`** Validates that an input is a valid email address
-- **`_isFQDN_`** Determines if a given input is a fully qualified domain name
+-   **`_isFQDN_`** Determines if a given input is a fully qualified domain name
-- **`_isFile_`** Validate that a given input points to a valid file
+-   **`_isFile_`** Validate that a given input points to a valid file
-- **`_isIPv4_`** Validates that an input is a valid IPv4 address
+-   **`_isIPv4_`** Validates that an input is a valid IPv4 address
-- **`_isIPv6_`** Validates that an input is a valid IPv6 address
+-   **`_isIPv6_`** Validates that an input is a valid IPv6 address
-- **`_isNum_`** Validate that a given variable contains only numeric characters
+-   **`_isNum_`** Validate that a given variable contains only numeric characters
-- **`_isTerminal_`** Checks if script is run in an interactive terminal
+-   **`_isTerminal_`** Checks if script is run in an interactive terminal
-- **`_rootAvailable_`** Validate we have superuser access as root (via sudo if requested)
+-   **`_rootAvailable_`** Validate we have superuser access as root (via sudo if requested)
-- **`_varIsEmpty_`** Checks if a given variable is empty or null
+-   **`_varIsEmpty_`** Checks if a given variable is empty or null
-- **`_varIsFalse_`** Checks if a given variable is false
+-   **`_varIsFalse_`** Checks if a given variable is false
-- **`_varIsTrue_`** Checks if a given variable is true
+-   **`_varIsTrue_`** Checks if a given variable is true
 
 ## dates.bash
 
 Functions for working with dates and time.
 
-- **`_convertToUnixTimestamp_`** Converts a date to unix timestamp
+-   **`_convertToUnixTimestamp_`** Converts a date to unix timestamp
-- **`_countdown_`** Sleep for a specified amount of time
+-   **`_countdown_`** Sleep for a specified amount of time
-- **`_dateUnixTimestamp_`** Current time in unix timestamp
+-   **`_dateUnixTimestamp_`** Current time in unix timestamp
-- **`_formatDate_`** Reformats dates into user specified formats
+-   **`_formatDate_`** Reformats dates into user specified formats
-- **`_fromSeconds_`** Convert seconds to HH:MM:SS
+-   **`_fromSeconds_`** Convert seconds to HH:MM:SS
-- **`_monthToNumber_`** Convert a month name to a number
+-   **`_monthToNumber_`** Convert a month name to a number
-- **`_numberToMonth_`** Convert a month number to its name
+-   **`_numberToMonth_`** Convert a month number to its name
-- **`_parseDate_`** Takes a string as input and attempts to find a date within it to parse into component parts (day, month, year)
+-   **`_parseDate_`** Takes a string as input and attempts to find a date within it to parse into component parts (day, month, year)
-- **`_readableUnixTimestamp_`** Format unix timestamp to human readable format
+-   **`_readableUnixTimestamp_`** Format unix timestamp to human readable format
-- **`_toSeconds_`** Converts HH:MM:SS to seconds
+-   **`_toSeconds_`** Converts HH:MM:SS to seconds
 
 ## debug.bash
 
 Functions to aid in debugging BASH scripts
 
-- **`_pauseScript_`** Pause a script at any point and continue after user input
+-   **`_pauseScript_`** Pause a script at any point and continue after user input
-- **`_printAnsi_`** Helps debug ansi escape sequence in text by displaying the escape codes
+-   **`_printAnsi_`** Helps debug ansi escape sequence in text by displaying the escape codes
-- **`_printArray_`** Prints the content of array as key value pairs for easier debugging
+-   **`_printArray_`** Prints the content of array as key value pairs for easier debugging
 
 ## files.bash
 
 Functions for working with files.
 
-- **`_backupFile_`** Creates a backup of a specified file with .bak extension or optionally to a specified directory.
+-   **`_backupFile_`** Creates a backup of a specified file with .bak extension or optionally to a specified directory.
-- **`_decryptFile_`** Decrypts a file with `openssl`
+-   **`_decryptFile_`** Decrypts a file with `openssl`
-- **`_encryptFile_`** Encrypts a file with `openssl`
+-   **`_encryptFile_`** Encrypts a file with `openssl`
-- **`_extractArchive_`** Extract a compressed file
+-   **`_extractArchive_`** Extract a compressed file
-- **`_fileBasename_`** Gets the basename of a file from a file name
+-   **`_fileBasename_`** Gets the basename of a file from a file name
-- **`_fileContains_`** Tests whether a file contains a given pattern
+-   **`_fileContains_`** Tests whether a file contains a given pattern
-- **`_filePath_`** Gets the absolute path to a file
+-   **`_filePath_`** Gets the absolute path to a file
-- **`_fileExtension_`** Gets the extension of a file
+-   **`_fileExtension_`** Gets the extension of a file
-- **`_fileName_`** Prints a filename from a path
+-   **`_fileName_`** Prints a filename from a path
-- **`_json2yaml_`** Convert JSON to YAML uses python
+-   **`_json2yaml_`** Convert JSON to YAML uses python
-- **`_listFiles_`** Find files in a directory. Use either glob or regex.
+-   **`_listFiles_`** Find files in a directory. Use either glob or regex.
-- **`_makeSymlink_`** Creates a symlink and backs up a file which may be overwritten by the new symlink. If the exact same symlink already exists, nothing is done.
+-   **`_makeSymlink_`** Creates a symlink and backs up a file which may be overwritten by the new symlink. If the exact same symlink already exists, nothing is done.
-- **`_parseYAML_`** Convert a YAML file into BASH variables for use in a shell script
+-   **`_parseYAML_`** Convert a YAML file into BASH variables for use in a shell script
-- **`_printFileBetween_`** Prints block of text in a file between two regex patterns
+-   **`_printFileBetween_`** Prints block of text in a file between two regex patterns
-- **`_readFile_`** Prints each line of a file
+-   **`_randomLineFromFile_`** Prints a random line from a file
-- **`_sourceFile_`** Source a file into a script
+-   **`_readFile_`** Prints each line of a file
-- **`_createUniqueFilename_`** Ensure a file to be created has a unique filename to avoid overwriting other files
+-   **`_sourceFile_`** Source a file into a script
-- **`_yaml2json_`** Convert a YAML file to JSON with python
+-   **`_createUniqueFilename_`** Ensure a file to be created has a unique filename to avoid overwriting other files
+-   **`_yaml2json_`** Convert a YAML file to JSON with python
 
 ## macOS.bash
 
 Functions useful when writing scripts to be run on macOS
 
-- **`_guiInput_`** Ask for user input using a Mac dialog box
+-   **`_guiInput_`** Ask for user input using a Mac dialog box
-- **`_haveScriptableFinder_`** Determine whether we can script the Finder or not
+-   **`_haveScriptableFinder_`** Determine whether we can script the Finder or not
-- **`_homebrewPath_`** Adds Homebrew bin directory to PATH
+-   **`_homebrewPath_`** Adds Homebrew bin directory to PATH
-- **`_useGNUUtils_`** Add GNU utilities to PATH to allow consistent use of sed/grep/tar/etc. on MacOS
+-   **`_useGNUUtils_`** Add GNU utilities to PATH to allow consistent use of sed/grep/tar/etc. on MacOS
 
 ## misc.bash
 
 Miscellaneous functions
 
-- **`_acquireScriptLock_`** Acquire script lock to prevent running the same script a second time before the first instance exits
+-   **`_acquireScriptLock_`** Acquire script lock to prevent running the same script a second time before the first instance exits
-- **`_detectLinuxDistro_`** Detects the host computer's distribution of Linux
+-   **`_detectLinuxDistro_`** Detects the host computer's distribution of Linux
-- **`_detectMacOSVersion_`** Detects the host computer's version of macOS
+-   **`_detectMacOSVersion_`** Detects the host computer's version of macOS
-- **`_detectOS_`** Detect the the host computer's operating system
+-   **`_detectOS_`** Detect the the host computer's operating system
-- **`_endspin_`** Clears output from the _spinner_
+-   **`_endspin_`** Clears output from the _spinner_
-- **`_execute_`** Executes commands with safety and logging options. Respects `DRYRUN` and `VERBOSE` flags.
+-   **`_execute_`** Executes commands with safety and logging options. Respects `DRYRUN` and `VERBOSE` flags.
-- **`_findBaseDir_`** Locates the real directory of the script being run. Similar to GNU readlink -n
+-   **`_findBaseDir_`** Locates the real directory of the script being run. Similar to GNU readlink -n
-- **`_generateUUID_`** Generates a unique UUID
+-   **`_generateUUID_`** Generates a unique UUID
-- **`_progressBar_`** Prints a progress bar within a for/while loop
+-   **`_progressBar_`** Prints a progress bar within a for/while loop
-- **`_runAsRoot_`** Run the requested command as root (via sudo if requested)
+-   **`_runAsRoot_`** Run the requested command as root (via sudo if requested)
-- **`_seekConfirmation_`** Seek user input for yes/no question
+-   **`_seekConfirmation_`** Seek user input for yes/no question
-- **`_spinner_`** Creates a spinner within a for/while loop.
+-   **`_spinner_`** Creates a spinner within a for/while loop.
-- **`_trapCleanup_`** Cleans up after a trapped error.
+-   **`_trapCleanup_`** Cleans up after a trapped error.
 
 ## services.bash
 
 Functions to work with external services
 
-- **`_haveInternet_`** Tests to see if there is an active Internet connection
+-   **`_haveInternet_`** Tests to see if there is an active Internet connection
-- **`_httpStatus_`** Report the HTTP status of a specified URL
+-   **`_httpStatus_`** Report the HTTP status of a specified URL
-- **`_pushover_`** Sends a notification via Pushover (Requires API keys)
+-   **`_pushover_`** Sends a notification via Pushover (Requires API keys)
 
 ## strings.bash
 
 Functions for string manipulation
 
-- **`_cleanString_`** Cleans a string of text
+-   **`_cleanString_`** Cleans a string of text
-- **`_decodeHTML_`** Decode HTML characters with sed. (Requires sed file)
+-   **`_decodeHTML_`** Decode HTML characters with sed. (Requires sed file)
-- **`_decodeURL_`** Decode a URL encoded string
+-   **`_decodeURL_`** Decode a URL encoded string
-- **`_encodeHTML_`** Encode HTML characters with sed (Requires sed file)
+-   **`_encodeHTML_`** Encode HTML characters with sed (Requires sed file)
-- **`_encodeURL_`** URL encode a string
+-   **`_encodeURL_`** URL encode a string
-- **`_escapeString_`** Escapes a string by adding `\` before special chars
+-   **`_escapeString_`** Escapes a string by adding `\` before special chars
-- **`_lower_`** Convert a string to lowercase
+-   **`_lower_`** Convert a string to lowercase
-- **`_ltrim_`** Removes all leading whitespace (from the left)
+-   **`_ltrim_`** Removes all leading whitespace (from the left)
-- **`_regexCapture_`** Use regex to validate and parse strings
+-   **`_regexCapture_`** Use regex to validate and parse strings
-- **`_rtrim_`** Removes all leading whitespace (from the right)
+-   **`_rtrim_`** Removes all leading whitespace (from the right)
-- **`_splitString_`** Split a string based on a given delimiter
+-   **`_splitString_`** Split a string based on a given delimiter
-- **`_stringContains_`** Tests whether a string matches a substring
+-   **`_stringContains_`** Tests whether a string matches a substring
-- **`_stringRegex_`** Tests whether a string matches a regex pattern
+-   **`_stringRegex_`** Tests whether a string matches a regex pattern
-- **`_stripANSI_`** Strips ANSI escape sequences from text
+-   **`_stripANSI_`** Strips ANSI escape sequences from text
-- **`_stripStopwords_`** Removes common stopwords from a string using a list of sed replacements located in an external file.
+-   **`_stripStopwords_`** Removes common stopwords from a string using a list of sed replacements located in an external file.
-- **`_trim_`** Removes all leading/trailing whitespace
+-   **`_trim_`** Removes all leading/trailing whitespace
-- **`_upper_`** Convert a string to uppercase
+-   **`_upper_`** Convert a string to uppercase
 
 ## template_utils.bash
 
 Functions required to allow the script template and alert functions to be used
 
-- **`_makeTempDir_`** Creates a temp directory to house temporary files
+-   **`_makeTempDir_`** Creates a temp directory to house temporary files
-- **`_safeExit_`** Cleans up temporary files before exiting a script
+-   **`_safeExit_`** Cleans up temporary files before exiting a script
-- **`_setPATH_`** Add directories to $PATH so script can find executables
+-   **`_setPATH_`** Add directories to $PATH so script can find executables
 
 # Coding conventions
 
-- Function names use camel case surrounded by underscores: `_nameOfFunction_`
+-   Function names use camel case surrounded by underscores: `_nameOfFunction_`
-- Local variable names use camel case with a starting underscore: `_localVariable`
+-   Local variable names use camel case with a starting underscore: `_localVariable`
-- Global variables are in ALL_CAPS with underscores separating words
+-   Global variables are in ALL_CAPS with underscores separating words
-- Exceptions to the variable an function naming rules are made for alerting functions and colors to ease my speed of programming. (Breaking years of habits is hard...) I.e. `notice "Some log item: ${blue}blue text${reset}` Where `notice` is a function and `$blue` and `$reset` are global variables but are lowercase.
+-   Exceptions to the variable an function naming rules are made for alerting functions and colors to ease my speed of programming. (Breaking years of habits is hard...) I.e. `notice "Some log item: ${blue}blue text${reset}` Where `notice` is a function and `$blue` and `$reset` are global variables but are lowercase.
-- Variables are always surrounded by quotes and brackets `"${1}"` (Overly verbose true, but a safe practice)
+-   Variables are always surrounded by quotes and brackets `"${1}"` (Overly verbose true, but a safe practice)
-- Formatting is provided by [shfmt](https://github.com/mvdan/sh) using 4 spaces for indentation
+-   Formatting is provided by [shfmt](https://github.com/mvdan/sh) using 4 spaces for indentation
-- All scripts and functions are fully [Shellcheck](https://github.com/koalaman/shellcheck) compliant
+-   All scripts and functions are fully [Shellcheck](https://github.com/koalaman/shellcheck) compliant
-- Where possible, I follow [defensive BASH programming](https://kfirlavi.herokuapp.com/blog/2012/11/14/defensive-bash-programming/) principles.
+-   Where possible, I follow [defensive BASH programming](https://kfirlavi.herokuapp.com/blog/2012/11/14/defensive-bash-programming/) principles.
 
 ## A Note on Code Reuse and Prior Art
 

test/files.bats

@@ -301,6 +301,13 @@ _testParseYAML_() {
   assert_line --index 2 'line 3'
 }
 
+@test "_randomLineFromFile_" {
+  echo -e "line 1\nline 2\nline 3" > testfile.txt
+
+  run _randomLineFromFile_ "testfile.txt"
+  assert_output --regexp "^line [123]$"
+}
+
 @test "_sourceFile_ failure" {
   run _sourceFile_ "someNonExistentFile"
 

utilities/files.bash

@@ -749,6 +749,31 @@ _printFileBetween_() (
     fi
 )
 
+_randomLineFromFile_() {
+    # DESC:
+    #         Returns a random line from a file
+    # ARGS:
+    #         $1 (Required) - Input file
+    # OUTS:
+    #         Returns random line from file
+    # USAGE:
+    #         _randomLineFromFile_ "file.txt"
+
+    [[ $# == 0 ]] && fatal "Missing required argument to ${FUNCNAME[0]}"
+
+    local _fileToRead="$1"
+    local _rnd
+
+    [ ! -f "${_fileToRead}" ] \
+        && {
+            error "'${_fileToRead}' not found"
+            return 1
+        }
+
+    _rnd=$((1 + RANDOM % $(wc -l <"${_fileToRead}")))
+    sed -n "${_rnd}p" "${_fileToRead}"
+}
+
 _readFile_() {
     # DESC:
     #         Prints each line of a file