v0.46.2 - OBL_ vars

Author: attogram

README.md

@@ -143,33 +143,33 @@ $ ollama_app_turbo on
 Enter Ollama API Key (input hidden):
 ```
 
-This will set and export `OLLAMA_LIB_API` and `OLLAMA_HOST` to `https://ollama.com`,
-and set `OLLAMA_LIB_TURBO_KEY` to your key.
+This will set and export `OBL_API` and `OLLAMA_HOST` to `https://ollama.com`,
+and set `OBL_TURBO_KEY` to your key.
 
-Note: `OLLAMA_LIB_TURBO_KEY` is never exported.
+Note: `OBL_TURBO_KEY` is never exported.
 You must decide yourself if you want to export it into your environment.
 ```
-export OLLAMA_LIB_KEY=my.super.secret.key
+export OBL_KEY=my.super.secret.key
 ```
 
 If the key is set, then `ollama_app_turbo on` will not prompt you again for the key.
 
 To turn **off** Turbo Mode, simply use `ollama_app_turbo off`.
-This will unset `OLLAMA_LIB_TURBO_KEY`
-and reset `OLLAMA_LIB_API` and `OLLAMA_HOST` to `http://localhost:11434`
+This will unset `OBL_TURBO_KEY`
+and reset `OBL_API` and `OLLAMA_HOST` to `http://localhost:11434`
 
 Use `ollama_lib_about` to view your current settings.
 
 ### Howto debug
 
-The `OLLAMA_LIB_DEBUG` variable controls if debug messages are sent to `stderr`
+The `OBL_DEBUG` variable controls if debug messages are sent to `stderr`
 
-Set `OLLAMA_LIB_DEBUG=1` to turn on debugging. 
-Set `OLLAMA_LIB_DEBUG=0` to turn off debugging.
+Set `OBL_DEBUG=1` to turn on debugging. 
+Set `OBL_DEBUG=0` to turn off debugging.
 
 Examples:
 ```
-OLLAMA_LIB_DEBUG=1 ollama_generate gpt-oss:20b "Three words about debugging"
+OBL_DEBUG=1 ollama_generate gpt-oss:20b "Three words about debugging"
 ```
 
 ## Demos
@@ -276,7 +276,7 @@ To run all demos and save output to Markdown files: [demos/run.demos.sh](demos/r
 | Function                     | About                                   | Usage                                 | Output                     | Return                                          |
 |------------------------------|-----------------------------------------|---------------------------------------|----------------------------|-------------------------------------------------|
 | `_is_valid_json`             | Is a string valid JSON?                 | `_is_valid_json "string"`             | none                       | `0` if valid json<br />`1` or higher if invalid |
-| `_debug`                     | Debug message (if `OLLAMA_LIB_DEBUG=1`) | `_debug "message"`                    | message to `stderr`        | `0`/`1`                                         |
+| `_debug`                     | Debug message (if `OBL_DEBUG=1`) | `_debug "message"`                    | message to `stderr`        | `0`/`1`                                         |
 | `_error`                     | Error message                           | `_error "message"`                    | message to `stderr`        | `0`/`1`                                         |
 
 ## Requirements

apps/interactive.chat.sh

@@ -7,7 +7,7 @@ startup() {
   source "$ollama_bash_lib"
   if ! ollama_app_installed; then echo 'ERROR: Ollama Not Installed'; fi;
   if ! ollama_api_ping; then echo 'ERROR: Ollama API not reachable'; fi
-  echo; echo "A [demo](../README.md#demos) of [$OLLAMA_LIB_NAME]($OLLAMA_LIB_URL) v$OLLAMA_LIB_VERSION"
+  echo; echo "A [demo](../README.md#demos) of [$OBL_NAME]($OBL_URL) v$OBL_VERSION"
 }
 
 shutdown() {

apps/interactive.generate.sh

@@ -9,7 +9,7 @@ startup() {
   source "$ollama_bash_lib"
   if ! ollama_app_installed; then echo 'ERROR: Ollama Not Installed'; fi;
   if ! ollama_api_ping; then echo 'ERROR: Ollama API not reachable'; fi
-  echo; echo "A [demo](../README.md#demos) of [$OLLAMA_LIB_NAME]($OLLAMA_LIB_URL) v$OLLAMA_LIB_VERSION"
+  echo; echo "A [demo](../README.md#demos) of [$OBL_NAME]($OBL_URL) v$OBL_VERSION"
 }
 
 shutdown() {

demos/_is_valid_json.sh

@@ -9,7 +9,7 @@ startup() {
   source "$ollama_bash_lib"
   #if ! ollama_app_installed; then echo "ERROR: Ollama Not Installed"; fi;
   #if ! ollama_api_ping; then echo "ERROR: Ollama API not reachable"; fi
-  echo; echo "A [demo](../README.md#demos) of [$OLLAMA_LIB_NAME]($OLLAMA_LIB_URL) v$OLLAMA_LIB_VERSION"
+  echo; echo "A [demo](../README.md#demos) of [$OBL_NAME]($OBL_URL) v$OBL_VERSION"
 }
 
 startup

demos/_is_valid_model.sh

@@ -9,7 +9,7 @@ startup() {
   source "$ollama_bash_lib"
   #if ! ollama_app_installed; then echo "ERROR: Ollama Not Installed"; fi;
   #if ! ollama_api_ping; then echo "ERROR: Ollama API not reachable"; fi
-  echo; echo "A [demo](../README.md#demos) of [$OLLAMA_LIB_NAME]($OLLAMA_LIB_URL) v$OLLAMA_LIB_VERSION"
+  echo; echo "A [demo](../README.md#demos) of [$OBL_NAME]($OBL_URL) v$OBL_VERSION"
 }
 
 startup

demos/about.md

@@ -15,19 +15,19 @@ ollama_lib_about
 ```
 A Bash Library to interact with Ollama
 
-OLLAMA_LIB_NAME      : Ollama Bash Lib
-OLLAMA_LIB_VERSION   : 0.46.1
-OLLAMA_LIB_URL       : https://github.com/attogram/ollama-bash-lib
-OLLAMA_LIB_DISCORD   : https://discord.gg/BGQJCbYVBa
-OLLAMA_LIB_LICENSE   : MIT
-OLLAMA_LIB_COPYRIGHT : Copyright (c) 2025 Ollama Bash Lib, Attogram Project <https://github.com/attogram>
-OLLAMA_LIB_API       : https://ollama.com
-OLLAMA_LIB_DEBUG     : 0
-OLLAMA_LIB_STREAM    : 0
-OLLAMA_LIB_THINKING  : off
-OLLAMA_LIB_MESSAGES  : 0 messages
-OLLAMA_LIB_TURBO_KEY : YES [REDACTED]
-OLLAMA_LIB_TIMEOUT   : 300 seconds
+OBL_NAME      : Ollama Bash Lib
+OBL_VERSION   : 0.46.1
+OBL_URL       : https://github.com/attogram/ollama-bash-lib
+OBL_DISCORD   : https://discord.gg/BGQJCbYVBa
+OBL_LICENSE   : MIT
+OBL_COPYRIGHT : Copyright (c) 2025 Ollama Bash Lib, Attogram Project <https://github.com/attogram>
+OBL_API       : https://ollama.com
+OBL_DEBUG     : 0
+OBL_STREAM    : 0
+OBL_THINKING  : off
+OBL_MESSAGES  : 0 messages
+OBL_TURBO_KEY : YES [REDACTED]
+OBL_TIMEOUT   : 300 seconds
 
 Functions:
 

demos/about.sh

@@ -9,7 +9,7 @@ startup() {
   source "$ollama_bash_lib"
   #if ! ollama_app_installed; then echo "ERROR: Ollama Not Installed"; fi;
   #if ! ollama_api_ping; then echo "ERROR: Ollama API not reachable"; fi
-  echo; echo "A [demo](../README.md#demos) of [$OLLAMA_LIB_NAME]($OLLAMA_LIB_URL) v$OLLAMA_LIB_VERSION"
+  echo; echo "A [demo](../README.md#demos) of [$OBL_NAME]($OBL_URL) v$OBL_VERSION"
 }
 
 startup

demos/deprecated.txt

@@ -47,7 +47,7 @@ _redact() {
   local msg="${1:-}"
   local out="$msg"
 
-  local explicit_vars=( OLLAMA_LIB_TURBO_KEY )
+  local explicit_vars=( OBL_TURBO_KEY )
   local var val
   for var in "${explicit_vars[@]}"; do
     val=${!var}
@@ -207,7 +207,7 @@ raw_nano() {
 # Requires: none
 # Returns: 0
 _DEPRECATED_escape_control_characters() {
-  if (( OLLAMA_LIB_SAFE_MODE != 1 )); then # If Safe Mode is OFF, do not escape control characters
+  if (( OBL_SAFE_MODE != 1 )); then # If Safe Mode is OFF, do not escape control characters
     printf '%s' "$1"
     return 0
   fi
@@ -248,7 +248,7 @@ _DEPRECATED_escape_control_characters() {
 #
 #   _escape_control_characters "some string"
 #
-# If OLLAMA_LIB_SAFE_MODE is 1, bytes 0‑31 and 127 are turned into JSON‑legal
+# If OBL_SAFE_MODE is 1, bytes 0‑31 and 127 are turned into JSON‑legal
 # escapes:
 #   * \b, \t, \n, \f, \r for the five most common controls
 #   * \u00XX for any other control character
@@ -258,7 +258,7 @@ _escape_control_characters() {
   # 1️⃣  Safe‑mode shortcut – when safe‑mode is OFF we simply echo the
   #      original argument unchanged.
   # --------------------------------------------------------------
-  if (( OLLAMA_LIB_SAFE_MODE != 1 )); then   # safe‑mode OFF → no escaping
+  if (( OBL_SAFE_MODE != 1 )); then   # safe‑mode OFF → no escaping
     printf '%s' "$1"
     return 0
   fi

demos/help.md

@@ -101,7 +101,7 @@ Generate a completion from a model as JSON.
   -v          Show version information and exit.
 
 This function sends a prompt to a specified model and returns the model's response as a raw JSON object.
-If streaming is enabled via the global 'OLLAMA_LIB_STREAM' variable, it will return a stream of JSON objects.
+If streaming is enabled via the global 'OBL_STREAM' variable, it will return a stream of JSON objects.
 This is a foundational function for 'ollama_generate' and 'ollama_generate_stream', which process this JSON output into plain text.
 ```
 
@@ -117,7 +117,7 @@ Generate a completion from a model as JSON.
   -v          Show version information and exit.
 
 This function sends a prompt to a specified model and returns the model's response as a raw JSON object.
-If streaming is enabled via the global 'OLLAMA_LIB_STREAM' variable, it will return a stream of JSON objects.
+If streaming is enabled via the global 'OBL_STREAM' variable, it will return a stream of JSON objects.
 This is a foundational function for 'ollama_generate' and 'ollama_generate_stream', which process this JSON output into plain text.
 ```
 
@@ -162,7 +162,7 @@ Generate a completion from a model as a stream of JSON objects.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function sets the global 'OLLAMA_LIB_STREAM' variable to 1 and then calls 'ollama_generate_json'.
+This function sets the global 'OBL_STREAM' variable to 1 and then calls 'ollama_generate_json'.
 It is the basis for 'ollama_generate_stream', which further processes the output into a continuous stream of text.
 ```
 
@@ -177,7 +177,7 @@ Generate a completion from a model as a stream of JSON objects.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function sets the global 'OLLAMA_LIB_STREAM' variable to 1 and then calls 'ollama_generate_json'.
+This function sets the global 'OBL_STREAM' variable to 1 and then calls 'ollama_generate_json'.
 It is the basis for 'ollama_generate_stream', which further processes the output into a continuous stream of text.
 ```
 
@@ -248,7 +248,7 @@ Add a message to the current session's message history.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function appends a new message object to the \'OLLAMA_LIB_MESSAGES\' array.
+This function appends a new message object to the \'OBL_MESSAGES\' array.
 This history is then used by \'ollama_chat\' and related functions to maintain a conversation with the model.
 ```
 
@@ -263,7 +263,7 @@ Add a message to the current session's message history.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function appends a new message object to the \'OLLAMA_LIB_MESSAGES\' array.
+This function appends a new message object to the \'OBL_MESSAGES\' array.
 This history is then used by \'ollama_chat\' and related functions to maintain a conversation with the model.
 ```
 
@@ -276,7 +276,7 @@ Clear all messages from the current session.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function resets the \'OLLAMA_LIB_MESSAGES\' array, effectively deleting the entire conversation history for the current session.
+This function resets the \'OBL_MESSAGES\' array, effectively deleting the entire conversation history for the current session.
 This is useful for starting a new conversation without restarting the script.
 ```
 
@@ -289,7 +289,7 @@ Clear all messages from the current session.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function resets the \'OLLAMA_LIB_MESSAGES\' array, effectively deleting the entire conversation history for the current session.
+This function resets the \'OBL_MESSAGES\' array, effectively deleting the entire conversation history for the current session.
 This is useful for starting a new conversation without restarting the script.
 ```
 
@@ -302,7 +302,7 @@ Get the number of messages in the current session.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function returns the current number of messages stored in the 'OLLAMA_LIB_MESSAGES' array.
+This function returns the current number of messages stored in the 'OBL_MESSAGES' array.
 It can be used to check if a conversation has started or to monitor the length of the conversation history.
 ```
 
@@ -315,7 +315,7 @@ Get the number of messages in the current session.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function returns the current number of messages stored in the 'OLLAMA_LIB_MESSAGES' array.
+This function returns the current number of messages stored in the 'OBL_MESSAGES' array.
 It can be used to check if a conversation has started or to monitor the length of the conversation history.
 ```
 
@@ -895,7 +895,7 @@ Configure the 'thinking' mode for model responses.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function sets the \'OLLAMA_LIB_THINKING\' environment variable, which controls whether the model\'s \'thinking\' process is displayed.
+This function sets the \'OBL_THINKING\' environment variable, which controls whether the model\'s \'thinking\' process is displayed.
 Modes:
 - on: Show thinking output.
 - off: Hide thinking output.
@@ -912,7 +912,7 @@ Configure the 'thinking' mode for model responses.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function sets the \'OLLAMA_LIB_THINKING\' environment variable, which controls whether the model\'s \'thinking\' process is displayed.
+This function sets the \'OBL_THINKING\' environment variable, which controls whether the model\'s \'thinking\' process is displayed.
 Modes:
 - on: Show thinking output.
 - off: Hide thinking output.
@@ -954,7 +954,7 @@ Get the version of the Ollama Bash Lib.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function returns the current version number of the library as defined in the 'OLLAMA_LIB_VERSION' variable.
+This function returns the current version number of the library as defined in the 'OBL_VERSION' variable.
 It is useful for checking the library version for compatibility or debugging purposes.
 ```
 
@@ -967,6 +967,6 @@ Get the version of the Ollama Bash Lib.
   -h          Show this help and exit.
   -v          Show version information and exit.
 
-This function returns the current version number of the library as defined in the 'OLLAMA_LIB_VERSION' variable.
+This function returns the current version number of the library as defined in the 'OBL_VERSION' variable.
 It is useful for checking the library version for compatibility or debugging purposes.
 ```

demos/help.sh

@@ -9,7 +9,7 @@ startup() {
   source "$ollama_bash_lib"
   #if ! ollama_app_installed; then echo "ERROR: Ollama Not Installed"; fi;
   #if ! ollama_api_ping; then echo "ERROR: Ollama API not reachable"; fi
-  echo; echo "A [demo](../README.md#demos) of [$OLLAMA_LIB_NAME]($OLLAMA_LIB_URL) v$OLLAMA_LIB_VERSION"
+  echo; echo "A [demo](../README.md#demos) of [$OBL_NAME]($OBL_URL) v$OBL_VERSION"
 }
 
 startup