feat: add bats tests, docs (#139)

* fix(test): ensure bats file list uses xargs

* docs(readme): use yarn for testing instructions

* fix(test): ensure pipelines fail properly

* docs(alias): fix table header

---------

Signed-off-by: Ismo Vuorinen <ismo@ivuorinen.net>

tests/dfm.bats

@@ -0,0 +1,11 @@
+#!/usr/bin/env bats
+
+setup() {
+  export DOTFILES="$PWD"
+}
+
+@test "dfm help shows usage" {
+  run bash local/bin/dfm help
+  [ "$status" -eq 0 ]
+  [[ "$output" == *"Usage: dfm"* ]]
+}

tests/x-gh-get-latest-version.bats

@@ -0,0 +1,7 @@
+#!/usr/bin/env bats
+
+@test "x-gh-get-latest-version help" {
+  run bash local/bin/x-gh-get-latest-version --help
+  [ "$status" -eq 1 ]
+  [[ "$output" == "Usage: x-gh-get-latest-version"* ]]
+}

tests/x-localip.bats

@@ -0,0 +1,7 @@
+#!/usr/bin/env bats
+
+@test "x-localip prints version" {
+  run bash local/bin/x-localip --version
+  [ "$status" -eq 0 ]
+  [[ "$output" == "x-localip version"* ]]
+}

tests/x-mkd.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+@test "x-mkd creates directory" {
+  dir="$BATS_TMPDIR/mkd-test"
+  run env VERBOSE=1 bash local/bin/x-mkd "$dir"
+  [ "$status" -eq 0 ]
+  [ -d "$dir" ]
+}

tests/x-path.bats

@@ -0,0 +1,22 @@
+#!/usr/bin/env bats
+
+@test "x-path-append adds directory" {
+  mkdir -p "$BATS_TMPDIR/dir"
+  PATH="/usr/bin"
+  VERBOSE=1 source local/bin/x-path-append "$BATS_TMPDIR/dir"
+  [ "$PATH" = "/usr/bin:$BATS_TMPDIR/dir" ]
+}
+
+@test "x-path-prepend adds directory to start" {
+  mkdir -p "$BATS_TMPDIR/dir"
+  PATH="/usr/bin:/bin"
+  VERBOSE=1 source local/bin/x-path-prepend "$BATS_TMPDIR/dir"
+  [ "$PATH" = "$BATS_TMPDIR/dir:/usr/bin:/bin" ]
+}
+
+@test "x-path-remove removes directory" {
+  mkdir -p "$BATS_TMPDIR/dir"
+  PATH="$BATS_TMPDIR/dir:/usr/bin"
+  VERBOSE=1 source local/bin/x-path-remove "$BATS_TMPDIR/dir"
+  [ "$PATH" = "/usr/bin" ]
+}