Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jumpingrivers/inteRgrate
Continuous integration
https://github.com/jumpingrivers/inteRgrate
ci gitlab-ci rstats travis-ci
Last synced: 21 days ago
JSON representation
Continuous integration
- Host: GitHub
- URL: https://github.com/jumpingrivers/inteRgrate
- Owner: jumpingrivers
- Created: 2019-10-10T09:43:02.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-06-21T09:15:30.000Z (6 months ago)
- Last Synced: 2024-11-15T11:17:33.584Z (28 days ago)
- Topics: ci, gitlab-ci, rstats, travis-ci
- Language: R
- Homepage: https://jumpingrivers.github.io/inteRgrate/
- Size: 318 KB
- Stars: 19
- Watchers: 2
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.Rmd
Awesome Lists containing this project
- jimsghstars - jumpingrivers/inteRgrate - Continuous integration (R)
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# inteRgrate: Very opinated package development
[](https://www.tidyverse.org/lifecycle/#experimental)
[](https://cran.r-project.org/package=inteRgrate)
[](https://codecov.io/gh/jumpingrivers/inteRgrate?branch=master)
[](https://github.com/jumpingrivers/inteRgrate/actions)
The goal of inteRgrate is to provide an very opinionated set of rules for R package development.
The idea is that when many people contribute to a package, it's easy for standards to diverge. We
think that CI can help here.
This package has the same functions for both travis and Gitlab-CI environments.
Currently, the package is used by [Jumping Rivers](https://www.jumpingrivers.com) on GitHub and
GitLab.
The rationale behind this package is
* While checking R packages on travis is easy, support for GitLab (and others) is lacking.
* When developing a package, sometimes we want to specify the exact number of NOTES
and WARNINGS we expect/allow.
* Having a consistent system for different CI is desirable.
* For our CI steps, we have a few other checks that we tend to implement, e.g. lints, not
using imports within namespaces.
This package is still being developed, but we are now actively using it, so hopefully we can
avoid breaking changes.
## Installation
As the package is currently being developed, it isn't yet on CRAN.
The development version can be installed from [GitHub](https://github.com/) with:
```{r, eval = FALSE}
install.packages("remotes")
remotes::install_github("jumpingrivers/inteRgrate")
```
## Functions
The package is meant to be used within a continuous integration framework, e.g. travis, GitLab
runner. This package contains a number functions that are useful for CI:
* `check_pkg()` - installs package dependencies, builds & installs the package, before
running package check. By default, __any__ notes or warnings will raise an error message.
This can be changed by setting the environment variables `ALLOWED_NOTES` and
`ALLOWED_WARNINGS`.
* `check_lintr()` - runs lintr on the package, README.Rmd and vignettes.
* `check_namespace()` - check for instances of `import()` in the NAMESPACE file. By default,
no imports are allowed. This can be changed via the environment variable `NO_IMPORTS`
* `check_r_filenames()` - ensures file extensions are `.R` and all names are lower case.
* `check_version()` - ensures that the package description has been updated.
* `check_gitignore()` - .gitignore contains standard files.
* `check_readme()` - checks README.Rmd timestamps
* `check_tidy_description()` - ensure that the DESCRIPTION file is tidy,
via `usethis::use_tidy_description()`
* `check_file_permissions()`, `check_line_breaks()` - ensures that linux line breaks are used and file permissions are
sensible.
* `create_tag()` - autotag via the CI.
See the help pages for customisation.
There's also a pre-commit hook to help. Run `inteRgrate::add_pre_commit()` in root git directory
of your repo and checks will be run before committing.
### Example .travis.yml file
Within a CI file, it's often better to use `check_via_env()` that will automatically call all checks.
Specific checks can be switch on/off via environment variables.
```
language: r
cache: packages
env:
global:
- ALLOWED_WARNINGS=0
- ALLOWED_NOTES=0
- NO_IMPORTS=0
script:
- Rscript -e "inteRgrate::check_via_env(default = 'true')"
```
### Example .gitlab.yml file
```
image: rocker/r-ubuntu:18.04
variables:
ALLOWED_WARNINGS: 0
ALLOWED_NOTES: 0
NO_IMPORTS: 0
before_script:
- Rscript -e "install.packages('remotes')"
- Rscript -e "remotes::install_github('jumpingrivers/inteRgrate')"
check:
script:
- Rscript -e "inteRgrate::check_via_env(default = 'true')"
```
### Command line
You can also use it at the command line
```{r, eval = FALSE}
library("inteRgrate")
check_pkg()
check_r_filenames()
```
Other information
-----------------
* ROpensci are developing a related package - [tic](https://github.com/ropenscilabs/tic).
The [tic](https://github.com/ropenscilabs/tic) package aims to specify the CI environment purely by an R script.
* If you have any suggestions or find bugs, please use the github [issue tracker](https://github.com/jumpingrivers/inteRgrate/issues)
* Feel free to submit pull requests
---
Development of this package was supported by [Jumping Rivers](https://www.jumpingrivers.com)