restructuring and refactoring of implementation with breaking syntax changes

Signed-off-by: Rob Frawley 2nd <rmf@src.run>

Author: robfrawley

.gitattributes

@@ -0,0 +1,6 @@
+*               text=auto eol=lf whitespace=tabwidth=4
+*.bash          diff=bash
+/test           export-ignore
+/.gitmodules    export-ignore
+/.gitattributes export-ignore
+/.travis.yml    export-ignore

.gitignore

@@ -1,18 +1,27 @@
 ---
 
+##
+## This file is part of the `src-run/bash-bright-library` package.
+##
+## (c) Rob Frawley 2nd <rmf@src.run>
+##
+## For the full copyright and license information, view the LICENSE.md
+## file distributed with this source code.
+##
+
 language: bash
 
 addons:
-  apt:
-    packages:
-      - realpath
+    apt:
+        packages:
+            - realpath
 
 env:
   - SHUNIT_COLOR=always
 
 matrix:
-  include:
-    - script:
-        - bash test/test_bright-apis.bash
-    - script:
-        - shellcheck -x bright.bash
+    include:
+        - script:
+            - bash test/bright-test.bash
+        - script:
+            - shellcheck -s bash -x bright.bash test/bright-test.bash

.travis.yml

@@ -1,9 +1,9 @@
-# [src-run] bright-library
+# [src-run] bash-bright-library
 
 ## Overview
 
 [Welcome](https://src.run/go/readme_welcome)!
-The `bright-library` provides a light weight collection of bash functions to enable
+The `bash-bright-library` provides a light weight collection of bash functions to enable
 basic console output styling.
 
 ### JTT
@@ -12,8 +12,8 @@ This package represents a single project within a
 [large collection](https://src.run/go/explore) of open-source code released
 under the *Scribe* namespace, comprised of framework-agnostic libraries,
 and a number of Symfony bundles. These projects are authored and maintained
-by [Rob Frawley 2nd](https://src.run/rmf) and 
-[collaborators](https://src.run/bright-library/github_collaborators),
+by [Rob Frawley 2nd](https://src.run/rmf) and
+[collaborators](https://src.run/bash-bright-library/github_collaborators),
 often with the support of [Scribe Inc](https://src.run/go/scribe-home).
 
 ## Contributing
@@ -28,8 +28,8 @@ be joined using the following link
 ### Issues
 
 To report issues or request a new feature use
-[GitHub](https://src.run/bright-library/github_issues)
-or [GitLab](https://src.run/bright-library/gitlab_issues)
+[GitHub](https://src.run/bash-bright-library/github_issues)
+or [GitLab](https://src.run/bash-bright-library/gitlab_issues)
 to start a discussion. Include as much information as possible to aid in
 a quick resolution. Feel free to "ping" the topic if you don't get a
 response within a few days.
@@ -39,7 +39,7 @@ response within a few days.
 You created additional functionality during the use of this package? Send
 it back upstream! *Don't hesitate to submit a pull request!* Beyond the
 brief requirements outlined in the
-[contibuting guide](https://src.run/bright-library/contributing),
+[contibuting guide](https://src.run/bash-bright-library/contributing),
 your [imagination](https://src.run/go/readme_imagination)
 represents the only limitation.
 
@@ -50,5 +50,5 @@ This project is licensed under the
 [FSF](https://src.run/go/fsf)-/[OSI](https://src.run/go/osi)-approved
 and [GPL](https://src.run/go/gpl)-compatible, permissive free software
 license. Review the
-[LICENSE](https://src.run/bright-library/license)
+[LICENSE](https://src.run/bash-bright-library/license)
 file distributed with this source code for additional information.

README.md

@@ -1,7 +1,7 @@
 #!/bin/bash
 
 ##
-## This file is part of the `src-run/bright-library` package.
+## This file is part of the `src-run/bash-bright-library` package.
 ##
 ## (c) Rob Frawley 2nd <rmf@src.run>
 ##
@@ -11,31 +11,28 @@
 
 
 #
-# create output control string with custom formatting
+# write raw string with custom formatting visible
 #
-# @param string $1 controls to apply
+# @param string ...$1 any of: message, replacements, styles, colors, and controls
 #
 # @return int
 #
 
-function _cmd() {
-    _builder_return "${@}" \
-        && _auto_nl \
+function _get() {
+    _builder '@ctl:no-nl' '@ctl:no-reset' '@ctl:no-interpret' "${@}" \
         || return ${?}
 }
 
 
 #
-# output string with custom formatting
+# write string with custom formatting parsed
 #
-# @param string $1 message to output
-# @param string $2 command(s) to apply
+# @param string ...$1 any of: message, replacements, styles, colors, and controls
 #
 # @return int
 #
 
 function _out() {
-    _builder_output "${@}" \
-        && _auto_nl \
+    _builder '@ctl:auto-nl' '@ctl:auto-reset' '@ctl:interpret' "${@}" \
         || return ${?}
 }