ekleinod/rscript repository overview

⁠etg-docker: ekleinod/rscript

⁠Quick reference

• Maintained by: ekleinod⁠
• Docker hub: ekleinod/rscript⁠
• Where to get help: gitlab⁠, issue tracker⁠

⁠Supported tags

• 1.6.0, 1.6.0-4.5.2, latest
• 1.5.0, 1.5.0-4.5.1
• 1.4.0, 1.4.0-4.5.1
• 1.3.0, 1.3.0-4.5.1
• 1.2.0, 1.2.0-4.5.1
• 1.1.0, 1.1.0-4.5.1
• 1.0.0, 1.0.0-4.1.3

⁠What is this image?

This is a docker image for the R (statistics language) command line tool Rscript. The image has the name ekleinod/rscript. It is based on the excellent official r-ver image⁠ and extends it with the libraries/plugins/extensions needed for my projects.

The additional libraries are:

• data.table – https://cran.r-project.org/web/packages/data.table/⁠
• FITfileR – https://github.com/grimbough/FITfileR⁠
• ggthemes – https://cran.r-project.org/web/packages/ggthemes/⁠
• ggthemes – https://cran.r-project.org/web/packages/ggthemes/⁠
• RColorBrewer – https://cran.r-project.org/web/packages/RColorBrewer/⁠
• readODS – https://cran.r-project.org/web/packages/readODS/⁠ (writes, too)
• remotes – https://cran.r-project.org/web/packages/remotes/⁠ (needed to install FITfileR from github)
• showtext – https://cran.r-project.org/web/packages/showtext/⁠
  • showtextdb – https://cran.r-project.org/web/packages/showtextdb/⁠ (needed for showtext)
  • sysfonts – https://cran.r-project.org/web/packages/sysfonts/⁠ (needed for showtext)
• tidyverse – https://www.tidyverse.org/⁠ (metapackage, see website for included packages), I am using:
  • dplyr
  • ggplot2
  • lubridate
  • readxl
• writexl – https://cran.r-project.org/web/packages/writexl/⁠

Additional fonts are:

• fonts-noto
• fonts-linuxlibertine
• fonts-ubuntu

For the complete changelog, see changelog.md⁠

⁠How to use the image

You can use the image as follows:

docker run --rm --interactive --tty --name <containername> --user "$(id -u):$(id -g)" --volume "${PWD}":/usr/src/myscripts ekleinod/rscript <command>

Please note, that /usr/src/myscripts is the work directory of the image.

For a simple test showing the rscript version, run

$ docker run --rm --name rscript ekleinod/rscript --version

You can see examples at work in the test folder. Clone the repository or download the folder. Call them as follows:

$ cd test
$ ./test_help.sh
$ ./test_hello-world.sh
$ ./test_version.sh

⁠Releases

The latest release will always be available with:

ekleinod/rscript:latest

There are two naming schemes:

1. ekleinod/rscript:<internal>-<rscript>

   Example: ekleinod/rscript:1.0.0-4.1.3

2. internal version number ekleinod/rscript:<major>.<minor>.<patch>

   Example: ekleinod/rscript:1.0.0

⁠Build locally

In order to build the image locally, clone the repository and call

$ cd image
$ ./build_image.sh

⁠Git-Repository

The branching model regards to the stable mainline model described in https://www.bitsnbites.eu/a-stable-mainline-branching-model-for-git/⁠.

This means, there is always a stable mainline, the main branch. This branch ist always compileable and testable, both without errors.

Features are developed using feature branches. Special feature branches are used (different from the mainline model) for finalizing releases.

Releases are created as branches of the mainline. Additionally, each release is tagged, tags contain the patch and, if needed, additional identifiers, such as rc1 or beta.

Patches are made in the according release branch. Minor version changes get their own release branch.

⁠Copyright

Copyright 2022-2025 Ekkart Kleinod [email protected]⁠

The program is distributed under the terms of the GNU General Public License, either version 3 of the License, or any later version.

See COPYING for details.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/⁠.