Skip to content

A containerised development environment for editing and compiling the R source code.

License

Notifications You must be signed in to change notification settings

r-devel/r-dev-env

This branch is up to date with main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

90a6b50 · Feb 14, 2025
Aug 29, 2024
Feb 14, 2025
Sep 4, 2024
Sep 4, 2024
Jun 7, 2024
Jun 7, 2024
Sep 4, 2024
Aug 6, 2024
Sep 4, 2024
Jun 19, 2024
Jun 19, 2024
Jul 22, 2024
Sep 4, 2024
Jun 14, 2024
Jul 11, 2023
Sep 4, 2024
Aug 29, 2024
Sep 4, 2024
Jul 25, 2023

Repository files navigation

R Dev Container

Release

The aim of the R Dev Container is to provide a standard environment for the exploration and development of the R source code. A prototype was developed under Google Summer of Code 2023 and development is continuing under Google Summer of Code 2024.

Getting started

Run in a web browser with GitHub Codespace

Click on the button below followed by "Create Codespace" to create and enter your own web based containerised develoment environment.

Open in GitHub Codespaces

The Starting Codespace section of the R Dev Container Docs will walk you through the process. Then you can work through the tutorials in the docs to lean how to use the codespace for R development.

More details about GitHub codespaces can be found in the GitHub Codespaces Docs. GitHub currently offers up to 60 hours for free on dual core codespaces.

Run on your local computer

The R Dev Container can also be run locally on your computer. Running the environment requires you to have Docker, VSCode, and the VSCode Dev Containers extension installed. Upon opening a copy of the r-dev-env repository in VSCode you will be prompted to start the dev container.

The Local setup section of the R Dev Container Docs will walk you through the process. Then you can work through the following the tutorials in the docs to learn how to use the codespace for R development.

More information about Dev Containers can be found in the Microsoft Documentation.

Project Background

The standard development process used by members of the R Core Team involves an iterative process of making changes to the source code, re-building R and exploring/testing the changes made. This process presents a big hurdle for new contributors to R, as setting up their system to build R can be non-trivial, requiring a lot of trouble-shooting, especially on Windows and macOS. On Linux and macOS, it is not straight-forward to work with different versions of R side-by-side and care needs to be taken not to corrupt or over-write the user's existing version of R/R packages.

For these reasons, we propose to create containerized development environments for R. Our focus will be on creating a complete environment, including an IDE, that will provide a familiar space for R developers to work on contributions to base R.

Contributors

GSoC contributor: Atharva Shirdhankar

Mentors: Heather Turner, James Tripp, Iain Emsley

About

A containerised development environment for editing and compiling the R source code.

Resources

License

Code of conduct

Citation

Stars

Watchers

Forks