An integration test suite

This test suite uses cram to run integration tests through `/bin/sh`.
The tests are all high-level acceptance tests; they should work
regardless of the implemention code.

To run them, you must first install cram:

    sudo pip install cram

Then the `check` target will run them:

    make check

Failure output should be printed clearly to stdout, but in general: full
test output is in `test/test-suite.log` and output specific to a test
named `foo.t` is in `foo.t.log`.

Tests are now encouraged in `CONTRIBUTING.md` as part of the normal pull
request process.

This is a TAP-enabled test suite.

19 files changed, 303 insertions, 0 deletions

diff --git a/test/Makefile.am b/test/Makefile.am
new file mode 100644
index 0000000..9cbc6b2
--- /dev/null
+++ b/test/Makefile.am
@@ -0,0 +1,20 @@
+TESTS = \
+  lsrc-dotfiles-dirs.t \
+  lsrc-excludes.t \
+  lsrc-hostname.t \
+  lsrc-sigils.t \
+  lsrc.t \
+  lsrc-tags.t \
+  lsrc-usage.t \
+  mkrc-alternate-dotfiles-dir.t \
+  mkrc-copy-file.t \
+  mkrc-host-file.t \
+  mkrc-simple-output.t \
+  mkrc-tagged-file.t \
+  mkrc-usage.t \
+  rcrc-custom.t \
+  rcrc.t \
+  rcup-link-files.t \
+  rcup-usage.t
+
+LOG_COMPILER = cram
diff --git a/test/helper.sh b/test/helper.sh
new file mode 100644
index 0000000..539e270
--- /dev/null
+++ b/test/helper.sh
@@ -0,0 +1,34 @@
+for bin in lsrc mkrc rcup rcdn; do
+  chmod +x "$TESTDIR/../bin"/$bin
+done
+
+export HOME="$PWD"
+export PATH="$TESTDIR/../bin:$PATH"
+export RCRC="$HOME/.rcrc"
+export RCM_LIB="$TESTDIR/../share"
+
+mkdir .dotfiles
+
+assert() {
+  local msg="$1"; shift
+
+  test "$@" || echo "Failed assertion: $msg"
+
+  return 0
+}
+
+refute() {
+  local msg="$1"; shift
+
+  test "$@" && echo "Failed assertion: $msg"
+
+  return 0
+}
+
+assert_linked() {
+  local from="$1" to="$2"
+  local resolved="$(readlink -f "$from")"
+
+  assert "$from should be a symlink" -h "$from"
+  assert "$from should resolve to $to, resolved to $resolved" "$resolved" = "$to"
+}
diff --git a/test/lsrc-dotfiles-dirs.t b/test/lsrc-dotfiles-dirs.t
new file mode 100644
index 0000000..e7769c0
--- /dev/null
+++ b/test/lsrc-dotfiles-dirs.t
@@ -0,0 +1,13 @@
+  $ . "$TESTDIR/helper.sh"
+
+Should include all the dotfiles
+
+  $ touch .dotfiles/example
+  > mkdir .second-dotfiles/
+  > touch .second-dotfiles/s-example
+  > mkdir .third-dotfiles/
+  > touch .third-dotfiles/t-example
+
+  $ lsrc -d .second-dotfiles -d .third-dotfiles
+  /*/.s-example:/*/.second-dotfiles/s-example (glob)
+  /*/.t-example:/*/.third-dotfiles/t-example (glob)
diff --git a/test/lsrc-excludes.t b/test/lsrc-excludes.t
new file mode 100644
index 0000000..de63840
--- /dev/null
+++ b/test/lsrc-excludes.t
@@ -0,0 +1,20 @@
+  $ . "$TESTDIR/helper.sh"
+
+Should exclude items with -x
+
+  $ touch .dotfiles/example
+  > touch .dotfiles/excluded
+
+  $ lsrc -x excluded
+  /*/.example:/*/.dotfiles/example (glob)
+
+Should accept directory:file syntax
+
+  $ mkdir .other-dotfiles
+  > touch .other-dotfiles/included
+  > touch .other-dotfiles/excluded
+
+  $ lsrc -d .dotfiles -d .other-dotfiles -x other-dotfiles:excluded
+  /*/.example:/*/.dotfiles/example (glob)
+  /*/.excluded:/*/.dotfiles/excluded (glob)
+  /*/.included:/*/.other-dotfiles/included (glob)
diff --git a/test/lsrc-hostname.t b/test/lsrc-hostname.t
new file mode 100644
index 0000000..9170c74
--- /dev/null
+++ b/test/lsrc-hostname.t
@@ -0,0 +1,13 @@
+  $ . "$TESTDIR/helper.sh"
+
+Should include entries that match hostname
+
+  $ touch .dotfiles/example
+  > mkdir .dotfiles/host-$(hostname)
+  > touch .dotfiles/host-$(hostname)/h-example
+  > mkdir .dotfiles/host-not-hostname
+  > touch .dotfiles/host-not-hostname/nh-example
+
+  $ lsrc
+  /*/.example:/*/.dotfiles/example (glob)
+  /*/.h-example:/*/.dotfiles/host-*/h-example (glob)
diff --git a/test/lsrc-sigils.t b/test/lsrc-sigils.t
new file mode 100644
index 0000000..98573b2
--- /dev/null
+++ b/test/lsrc-sigils.t
@@ -0,0 +1,16 @@
+  $ . "$TESTDIR/helper.sh"
+
+Should print @ for links
+
+  $ touch .dotfiles/example
+
+  $ lsrc -F
+  /*/.example:/*/.dotfiles/example:@ (glob)
+
+Should print X for files in COPY_ALWAYS
+
+  $ touch .dotfiles/copy
+
+  $ COPY_ALWAYS=copy lsrc -F
+  /*/.copy:/*/.dotfiles/copy:X (glob)
+  /*/.example:/*/.dotfiles/example:@ (glob)
diff --git a/test/lsrc-tags.t b/test/lsrc-tags.t
new file mode 100644
index 0000000..97f77db
--- /dev/null
+++ b/test/lsrc-tags.t
@@ -0,0 +1,14 @@
+  $ . "$TESTDIR/helper.sh"
+
+Should include entries that match passed tags
+
+  $ touch .dotfiles/example
+  > mkdir .dotfiles/tag-foo
+  > touch .dotfiles/tag-foo/f-example
+  > mkdir .dotfiles/tag-bar
+  > touch .dotfiles/tag-bar/b-example
+
+  $ lsrc -t foo -t bar
+  /*/.example:/*/.dotfiles/example (glob)
+  /*/.f-example:/*/.dotfiles/tag-foo/f-example (glob)
+  /*/.b-example:/*/.dotfiles/tag-bar/b-example (glob)
diff --git a/test/lsrc-usage.t b/test/lsrc-usage.t
new file mode 100644
index 0000000..70a3bd8
--- /dev/null
+++ b/test/lsrc-usage.t
@@ -0,0 +1,7 @@
+  $ . "$TESTDIR/helper.sh"
+
+-h should output usage information and exit 0
+
+  $ lsrc -h
+  Usage: lsrc [-FVqvh] [-I EXCL_PAT] [-x EXCL_PAT] [-N EXCL_PAT ] [-t TAG] [-d DOT_DIR]
+  see lsrc(1) and rcm(5) for more details
diff --git a/test/lsrc.t b/test/lsrc.t
new file mode 100644
index 0000000..e28a3a8
--- /dev/null
+++ b/test/lsrc.t
@@ -0,0 +1,14 @@
+  $ . "$TESTDIR/helper.sh"
+
+Should list the contents of ~/.dotfiles
+
+  $ touch .dotfiles/example
+  > mkdir .dotfiles/nested
+  > touch .dotfiles/nested/example
+  > mkdir .dotfiles/nested/deeply
+  > touch .dotfiles/nested/deeply/example
+
+  $ lsrc
+  /*/.example:/*/.dotfiles/example (glob)
+  /*/.nested/deeply/example:/*/.dotfiles/nested/deeply/example (glob)
+  /*/.nested/example:/*/.dotfiles/nested/example (glob)
diff --git a/test/mkrc-alternate-dotfiles-dir.t b/test/mkrc-alternate-dotfiles-dir.t
new file mode 100644
index 0000000..8346214
--- /dev/null
+++ b/test/mkrc-alternate-dotfiles-dir.t
@@ -0,0 +1,10 @@
+  $ . "$TESTDIR/helper.sh"
+  > mkdir .other-dotfiles
+
+Passing -d should specify alternate dotfiles location
+
+  $ touch .example
+
+  $ mkrc -d .other-dotfiles .example  >/dev/null
+
+  $ assert_linked "$HOME/.example" "$HOME/.other-dotfiles/example"
diff --git a/test/mkrc-copy-file.t b/test/mkrc-copy-file.t
new file mode 100644
index 0000000..45e63d3
--- /dev/null
+++ b/test/mkrc-copy-file.t
@@ -0,0 +1,15 @@
+  $ . "$TESTDIR/helper.sh"
+
+Passing -C should copy the file
+
+  $ echo 'Content' > .example
+
+  $ mkrc -C .example >/dev/null
+
+  $ refute "should not be a symlink" -h $HOME/.example
+
+  $ cat $HOME/.example
+  Content
+
+  $ cat $HOME/.dotfiles/example
+  Content
diff --git a/test/mkrc-host-file.t b/test/mkrc-host-file.t
new file mode 100644
index 0000000..3f13c6c
--- /dev/null
+++ b/test/mkrc-host-file.t
@@ -0,0 +1,9 @@
+  $ . "$TESTDIR/helper.sh"
+
+Passing -o should put it in a host
+
+  $ touch .example
+
+  $ mkrc -o .example >/dev/null
+
+  $ assert_linked "$HOME/.example" "$HOME/.dotfiles/host-$(hostname)/example"
diff --git a/test/mkrc-simple-output.t b/test/mkrc-simple-output.t
new file mode 100644
index 0000000..884da01
--- /dev/null
+++ b/test/mkrc-simple-output.t
@@ -0,0 +1,41 @@
+  $ . "$TESTDIR/helper.sh"
+
+Making an rc file should move it into dotfiles and create a symlink
+
+  $ touch .example
+
+  $ mkrc -v .example
+  Moving...
+  '.example' -> '*/.dotfiles/example' (glob)
+  Linking...
+  '*/.dotfiles/example' -> '*/.example' (glob)
+
+  $ assert_linked "$HOME/.example" "$HOME/.dotfiles/example"
+
+Making an rc file in a sub-directory should create the directories then
+create a symlink
+
+  $ mkdir .nested
+  > touch .nested/example
+
+  $ mkrc -v .nested/example
+  Moving...
+  '.nested/example' -> '*/.dotfiles/nested/example' (glob)
+  Linking...
+  '*/.dotfiles/nested/example' -> '*/.nested/example' (glob)
+
+  $ assert_linked "$HOME/.nested/example" "$HOME/.dotfiles/nested/example"
+
+Making an rc file in a deeply nested sub-directory should create all of
+the required directories then create a symlink
+
+  $ mkdir .nested/deeply
+  > touch .nested/deeply/example
+
+  $ mkrc -v .nested/deeply/example
+  Moving...
+  '.nested/deeply/example' -> '*/.dotfiles/nested/deeply/example' (glob)
+  Linking...
+  '*/.dotfiles/nested/deeply/example' -> '*/.nested/deeply/example' (glob)
+
+  $ assert_linked "$HOME/.nested/deeply/example" "$HOME/.dotfiles/nested/deeply/example"
diff --git a/test/mkrc-tagged-file.t b/test/mkrc-tagged-file.t
new file mode 100644
index 0000000..2f8e710
--- /dev/null
+++ b/test/mkrc-tagged-file.t
@@ -0,0 +1,9 @@
+  $ . "$TESTDIR/helper.sh"
+
+Passing -t should put it in a tag
+
+  $ touch .example
+
+  $ mkrc -t foo .example >/dev/null
+
+  $ assert_linked "$HOME/.example" "$HOME/.dotfiles/tag-foo/example"
diff --git a/test/mkrc-usage.t b/test/mkrc-usage.t
new file mode 100644
index 0000000..c9ede8d
--- /dev/null
+++ b/test/mkrc-usage.t
@@ -0,0 +1,14 @@
+  $ . "$TESTDIR/helper.sh"
+
+no arguments should output usage information and exit 1
+
+  $ mkrc
+  Usage: mkrc [-hvqo] [-t TAG] [-d DIR] FILES ...
+  see mkrc(1) and rcm(5) for more details
+  [1]
+
+-h should output usage information and exit 0
+
+  $ mkrc -h
+  Usage: mkrc [-hvqo] [-t TAG] [-d DIR] FILES ...
+  see mkrc(1) and rcm(5) for more details
diff --git a/test/rcrc-custom.t b/test/rcrc-custom.t
new file mode 100644
index 0000000..ef9b8fa
--- /dev/null
+++ b/test/rcrc-custom.t
@@ -0,0 +1,16 @@
+  $ . "$TESTDIR/helper.sh"
+
+mkrc should accept -r for a custom rcrc
+
+  $ touch .example
+  > mkdir .other-dotfiles
+
+  $ echo 'DOTFILES_DIRS="$HOME/.other-dotfiles"' > alt-rcrc
+
+  $ RCRC=./alt-rcrc mkrc -v .example
+  Moving...
+  '.example' -> '*/.other-dotfiles/example' (glob)
+  Linking...
+  '*/.other-dotfiles/example' -> '*/.example' (glob)
+
+  $ assert_linked "$HOME/.example" "$HOME/.other-dotfiles/example"
diff --git a/test/rcrc.t b/test/rcrc.t
new file mode 100644
index 0000000..54fc022
--- /dev/null
+++ b/test/rcrc.t
@@ -0,0 +1,16 @@
+  $ . "$TESTDIR/helper.sh"
+
+Information should be read from ~/.rcrc by default
+
+  $ touch .example
+  > mkdir .other-dotfiles
+
+  $ echo 'DOTFILES_DIRS="$HOME/.other-dotfiles"' > $HOME/.rcrc
+
+  $ mkrc -v .example
+  Moving...
+  '.example' -> '*/.other-dotfiles/example' (glob)
+  Linking...
+  '*/.other-dotfiles/example' -> '*/.example' (glob)
+
+  $ assert_linked "$HOME/.example" "$HOME/.other-dotfiles/example"
diff --git a/test/rcup-link-files.t b/test/rcup-link-files.t
new file mode 100644
index 0000000..9a3e273
--- /dev/null
+++ b/test/rcup-link-files.t
@@ -0,0 +1,15 @@
+  $ . "$TESTDIR/helper.sh"
+
+Should create symlinks for files and directories
+
+  $ touch .dotfiles/example
+  > mkdir .dotfiles/nested/
+  > touch .dotfiles/nested/example
+  > mkdir .dotfiles/nested/deeply
+  > touch .dotfiles/nested/deeply/example
+
+  $ rcup >/dev/null
+
+  $ assert_linked "$HOME/.example" "$HOME/.dotfiles/example"
+  $ assert_linked "$HOME/.nested/example" "$HOME/.dotfiles/nested/example"
+  $ assert_linked "$HOME/.nested/deeply/example" "$HOME/.dotfiles/nested/deeply/example"
diff --git a/test/rcup-usage.t b/test/rcup-usage.t
new file mode 100644
index 0000000..c5b798f
--- /dev/null
+++ b/test/rcup-usage.t
@@ -0,0 +1,7 @@
+  $ . "$TESTDIR/helper.sh"
+
+-h should output usage information and exit 0
+
+  $ rcup -h
+  Usage: rcup [-CVqvfhikK] [-I EXCL_PAT] [-x EXCL_PAT] [-t TAG] [-d DOT_DIR]
+  see rcup(1) and rcm(5) for more details