Note: This repository is deprecated in favour of r-ci
which is a portable generalization suitable for GitHub Actions, Azure
Pipelines, Travi, and likely more. This repo and its script run.sh
still
work, but updates will happen over at r-ci.
This repository is was a maintained fork of the (now deprecated) original
r-travis repository by Craig Citro et al. I was an early
contributor to this project, and quite
like its design and features -- so I have been keeping it around, maintained and extended it. It is
my 'go-to' CI setup for a few dozen repositories affecting a fairly decent number of users.
Maintained and used across Travis and GitHub Actions -- and also usable with Azure Pipelines, locally using Docker, ...
Its main advantages as are strong portability as well as ease of use and customizability.
Note that as it is used beyond just one Continuous Integration (CI) backend, we decided to change the name away from reflecting only one of the backends. So please see the r-ci for the continuation of this work.
A minimal example of use with Travis follows:
language: c
sudo: required
dist: focal
before_install:
- curl -OLs https://eddelbuettel.github.io/r-ci/run.sh && chmod 0755 run.sh
- ./run.sh bootstrap
install:
- ./run.sh install_deps
script:
- ./run.sh run_tests
This downloads the run.sh
script, uses it to bootstrap the test environment, then installs
dependencies via install_deps
and finally runs tests. For a realistic but real example see e.g.
this .travis.yml file of package
digest.
For another example, see package tidyCpp which shows how
to use the run.sh
script with Travis
CI as well as with GitHub
Actions.
Numerous variations are possible: running 'test matrices' across macOS and Linux, using BSPM for binaries (both of those are used by digest, running with several g++ versions (as used by RcppSimdjson, ...
We also use the same approach of downloading run.sh
and invoking it for the different steps in
with GitHub Actions (e.g. for
tidyCpp). Similarly,
Azure Pipelines can be used (as was done by a test repo on Azure).
There are also other options of use with PPAs and more---for fullest details see the source of the
shell script run.sh
.
See the webpage for r-travis for more on this repo, and the webpage for r-ci for more on its successor and continuation.
Dirk Eddelbuettel (for this maintained fork)
Craig Citro, Kirill Mueller, Dirk Eddelbuettel, ... (for the original r-travis)