tests: add test suite and GitHub action to run it with coverage

- [x] add test subdirectory with a suite of tests for sbang
- [x] add workflow for linux tests
- [x] add workflow for macos tests
- [x] add workflow for shellcheck
- [x] add codecov to macos tests

TODO: It seems like kcov doesn't work on linux tests for some reason.
Will need to debug later.

.codecov.yml

@@ -0,0 +1,13 @@
+coverage:
+  precision: 2
+  round: nearest
+  range: 60...90
+  status:
+    project:
+      default:
+        threshold: 0.2%
+
+ignore:
+  - test/.*
+
+comment: off

.github/workflows/linux-test.yaml

@@ -0,0 +1,19 @@
+name: linux
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+jobs:
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+    - name: run unit tests
+      run: |
+          make -C test test

.github/workflows/macos-tests.yaml

@@ -0,0 +1,27 @@
+name: macos
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+jobs:
+  unit-tests:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+    - name: Setup Homebrew packages
+      run: |
+        brew install kcov
+    - name: Run unit tests
+      env:
+        COVERAGE: true
+      run: make -C test test
+    - uses: codecov/codecov-action@v1
+      with:
+        directory: ./coverage
+        flags: unittests

.github/workflows/shellcheck.yaml

@@ -0,0 +1,22 @@
+name: shellcheck
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+jobs:
+  shellcheck:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+    - name: install shellcheck
+      run: |
+        sudo apt-get update
+        sudo apt-get install shellcheck
+    - name: run unit tests
+      run: make -C test shellcheck

.gitignore

@@ -0,0 +1 @@
+coverage

README.md

@@ -1,4 +1,8 @@
 # sbang
+![linux](https://github.com/spack/sbang/workflows/linux/badge.svg)
+![macos](https://github.com/spack/sbang/workflows/macos/badge.svg)
+![shellcheck](https://github.com/spack/sbang/workflows/shellcheck/badge.svg)
+[![codecov](https://codecov.io/gh/spack/sbang/branch/main/graph/badge.svg?token=IKH7mB5qq7)](undefined)
 
 `sbang` lets you run scripts with very long shebang (`#!`) lines.
 

sbang

@@ -1,7 +1,7 @@
 #!/bin/sh
 #
 # Copyright 2013-2020 Lawrence Livermore National Security, LLC and other
-# sbang Project Developers. See the top-level COPYRIGHT file for details.
+# sbang project developers. See the top-level COPYRIGHT file for details.
 #
 # SPDX-License-Identifier: (Apache-2.0 OR MIT)
 
@@ -67,6 +67,11 @@ done < "$script"
 # this saves arguments for later and intentionally assigns as an array
 args="$@"
 
+# error if we did not find any interpreter
+if [ -z "$shebang_line"  ]; then
+    die "error: sbang found no interpreter in $script"
+fi
+
 # handle scripts with sbang parameters, e.g.:
 #
 #   #!/<some-long-path>/perl -w
@@ -79,11 +84,6 @@ set -- "$@"
 interpreter="$1"
 arg1="$2"
 
-# error if we did not find any interpreter
-if [ -z "$interpreter" ]; then
-    die "error: sbang found no interpreter in $script"
-fi
-
 # Determine if the interpreter is a particular program, accounting for the
 # '#!/usr/bin/env PROGRAM' convention. So:
 #

test/Makefile

@@ -0,0 +1,17 @@
+# Copyright 2013-2020 Lawrence Livermore National Security, LLC and other
+# sbang project developers. See the top-level COPYRIGHT file for details.
+#
+# SPDX-License-Identifier: (Apache-2.0 OR MIT)
+
+# Run make to run the test suite with just sbang.
+# Run make COVERAGE=TRUE to run with kcov
+COVERAGE_DIR = ../coverage
+SBANG_SCRIPT = ../sbang
+SBANG = $(if $(COVERAGE),kcov $(COVERAGE_DIR) ,)$(SBANG_SCRIPT)
+
+test:
+	echo $(SBANG)
+	SBANG="$(SBANG)" ./test-suite.sh
+
+shellcheck:
+	shellcheck $(SBANG_SCRIPT)

test/shebangs/bash.bash

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/bin/bash

test/shebangs/lua.lua

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+--!/path/to/lua

test/shebangs/no-interpreter

@@ -0,0 +1,2 @@
+This is a simple file.
+It has no shebang and no interpreter.

test/shebangs/node.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+//!/path/to/node

test/shebangs/perl-env.pl

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/usr/bin/env perl

test/shebangs/perl-w-env.pl

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/usr/bin/env perl -w

test/shebangs/perl-w.pl

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/usr/bin/perl -w

test/shebangs/perl.pl

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/usr/bin/perl

test/shebangs/php.php

@@ -0,0 +1,3 @@
+#!/usr/bin/env sbang
+<?php #!/usr/bin/php ?>
+<?php echo "hello\n" ?>

test/shebangs/python-env.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env sbang
+#!/usr/bin/env python
+
+from __future__ import print_function
+
+print("python")

test/shebangs/python.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env sbang
+#!/usr/bin/python
+
+from __future__ import print_function
+
+print("python")

test/shebangs/ruby-env.rb

@@ -0,0 +1,4 @@
+#!/usr/bin/env sbang
+#!/usr/bin/env ruby
+
+puts "ruby"

test/shebangs/ruby.rb

@@ -0,0 +1,4 @@
+#!/usr/bin/env sbang
+#!/usr/bin/ruby
+
+puts "ruby"

test/shebangs/sbang

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/path/to/sbang

test/shebangs/sbang-env

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/usr/bin/env sbang

test/shebangs/sh.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env sbang
+#!/bin/sh