/r

Stencila for R

Primary LanguageRApache License 2.0Apache-2.0

Stencila for R

Build status Code coverage CRAN Community Chat

Install

This package isn't on CRAN yet, but you can install it from this repository using the devtools package,

devtools::install_github("stencila/r")

Alternatively, check the releases page for prebuilt versions.

Then install the package so that other Stencila packages and applications can detect it:

stencila:::install()

Use

This package lets you run R code from inside Stencila Documents. When you start the Stencila Desktop it will be automatically detect the installed R package and you'll be able to execute R code cells from within your documents.

More documentation is available at https://stencila.github.io/r

Discuss

We love feedback. Create a new issue, add to existing issues or chat with members of the community.

Develop

Most development tasks can be run using make shortcuts or RStudio keyboard shortcuts.

Task make RStudio
Install dependencies make setup
Run tests make test Ctrl+Shift+T
Run tests with coverage make cover
Build documentation make docs
Check the package make check Ctrl+Shift+E
Build make build Ctrl+Shift+B
Clean make clean

To get started, please read our contributor code of conduct, then get in touch or checkout the platform-wide, cross-repository kanban board, or just send in a pull request!

Unit tests live in the tests folder and are mostly written using testthat. Documentation is written using roxygen2 and the documentation site is generated by pkgdown into the docs folder and published on Github pages.

Tests are run on Travis and code coverage tracked at Codecov.