.travis.yml

## Note, "[ci skip]" or "[skip ci]" within a commit message _should_
##  cause Travis Continuous Integration to skip the following


## Clone settings for repository
##   1. Reduce log _fluff_ with `true`
##   2. Clone submodules when cloning this branch with `true`
##   3. Clone the whole Git history with `false`, or set integer limit
git:
  quite: false
  submodules: true
  depth: false


## The dialect that will be spoken
##   1. Really what Jest speaks
##   2. Version of `node_js` to target
language: node_js
node_js:
  - "10"


## Things to keep between CI runs
##   keep `node_modules` sub-directory to speed up future tests, maybe?
cache:
  directories:
    - node_modules


## Operating systems to spin-up
##   1. When `true` some blocks such as `script` terminates at first failure
##   2. List of OS configurations (FrontMater _blocks_) Travis should test with
matrix:
  fast_finish: true
  include:
    ## Default 'dist' was 'trusty' as of 2019
    - name: 'Linux Xenial'
      os: linux
      dist: xenial


## Restrict what branches are cloned with Git
##   1. Fetch `only` `gh-pages` or _`test-`_ prefixed branches
##   2. Specifically ignore fetching the `master` branch
branches:
  only:
    - master
    - /^(?i:test)-.*$/
  except:
    - gh-pages


## Install deps and run CI/Jest tests under `.ci-jest/` directory
##   Note, `npm ci` takes the place of `npm install` to ensure
##   all dependencies are installed, and that there are no sync
##   bugs between `package.json` and `package-lock.json` files.
before_install:
  - npm update
install:
  - npm ci
script:
  - npm run ci-test