+ ![]()
+
+
+
+
+Installing old packages from the CRAN archives
+ + + +installing-old-packages-from-the-cran-archives.Rmd
+library(rix)This generates the following default.nix file:
#>
-#> # This file was generated by the {rix} R package on Tue Aug 1 20:38:11 2023
-#> # It uses nixpkgs' revision e0e6b6909977de63dab514efbf5470bc31e7055e for reproducibility purposes
+#> # This file was generated by the {rix} R package on Wed Aug 2 12:46:48 2023
+#> # It uses nixpkgs' revision 96112a3ed5d12bb1758b42c63b924c004b6c0bc9 for reproducibility purposes
#> # which will install R version current
#> # Report any issues to https://github.com/b-rodrigues/rix
-#> { pkgs ? import (fetchTarball "https://github.com/NixOS/nixpkgs/archive/e0e6b6909977de63dab514efbf5470bc31e7055e.tar.gz") {} }:
+#> { pkgs ? import (fetchTarball "https://github.com/NixOS/nixpkgs/archive/96112a3ed5d12bb1758b42c63b924c004b6c0bc9.tar.gz") {} }:
#>
#> with pkgs;
#>
@@ -236,11 +237,11 @@ Day-to-day use of {rix}(note the value provided to the ide argument).
This generates the following default.nix file:
#>
-#> # This file was generated by the {rix} R package on Tue Aug 1 20:38:11 2023
-#> # It uses nixpkgs' revision e0e6b6909977de63dab514efbf5470bc31e7055e for reproducibility purposes
+#> # This file was generated by the {rix} R package on Wed Aug 2 12:46:49 2023
+#> # It uses nixpkgs' revision 96112a3ed5d12bb1758b42c63b924c004b6c0bc9 for reproducibility purposes
#> # which will install R version current
#> # Report any issues to https://github.com/b-rodrigues/rix
-#> { pkgs ? import (fetchTarball "https://github.com/NixOS/nixpkgs/archive/e0e6b6909977de63dab514efbf5470bc31e7055e.tar.gz") {} }:
+#> { pkgs ? import (fetchTarball "https://github.com/NixOS/nixpkgs/archive/96112a3ed5d12bb1758b42c63b924c004b6c0bc9.tar.gz") {} }:
#>
#> with pkgs;
#>
@@ -289,7 +290,7 @@ Running old projects with {rix}= TRUE)
The file looks like this:
#>
-#> # This file was generated by the {rix} R package on Tue Aug 1 20:38:12 2023
+#> # This file was generated by the {rix} R package on Wed Aug 2 12:46:49 2023
#> # It uses nixpkgs' revision 79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a for reproducibility purposes
#> # which will install R version 4.2.1
#> # Report any issues to https://github.com/b-rodrigues/rix
@@ -348,7 +349,7 @@ Installing packages from Github
cat(readLines(paste0(path_default_nix, "/default.nix")), sep = "\n")
#>
-#> # This file was generated by the {rix} R package on Tue Aug 1 20:38:12 2023
+#> # This file was generated by the {rix} R package on Wed Aug 2 12:46:49 2023
#> # It uses nixpkgs' revision 79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a for reproducibility purposes
#> # which will install R version 4.2.1
#> # Report any issues to https://github.com/b-rodrigues/rix
diff --git a/articles/index.html b/articles/index.html
index 9c94b9f7..4e3362e7 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
@@ -51,6 +52,8 @@ All vignettes
- Building reproducible development environments with rix
+ -
+
- Installing old packages from the CRAN archives
-
- Interactive use
-
diff --git a/articles/installing-old-packages-from-the-cran-archives.html b/articles/installing-old-packages-from-the-cran-archives.html
new file mode 100644
index 00000000..042ca857
--- /dev/null
+++ b/articles/installing-old-packages-from-the-cran-archives.html
@@ -0,0 +1,109 @@
+
+
+
+
+
+
+
+
+
Installing old packages from the CRAN archives • rix
+
+
+
+
+
+
+
+
+
+ Skip to contents
+
+
+
+
+
+
+
+
+
+ ![]()
Installing old packages from the CRAN archives
+
+
+
+ installing-old-packages-from-the-cran-archives.Rmd
+
+
+
+
+
+library(rix)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/articles/interactive-use.html b/articles/interactive-use.html
index 1d163b5a..d20824ef 100644
--- a/articles/interactive-use.html
+++ b/articles/interactive-use.html
@@ -42,6 +42,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/articles/non-interactive-use.html b/articles/non-interactive-use.html
index 322cd051..be6bc7dc 100644
--- a/articles/non-interactive-use.html
+++ b/articles/non-interactive-use.html
@@ -42,6 +42,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/articles/save-the-nix-package-versions-data.html b/articles/save-the-nix-package-versions-data.html
index dea784fb..5b10affe 100644
--- a/articles/save-the-nix-package-versions-data.html
+++ b/articles/save-the-nix-package-versions-data.html
@@ -42,6 +42,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/authors.html b/authors.html
index 2ddfda96..78a79afb 100644
--- a/authors.html
+++ b/authors.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/index.html b/index.html
index cbf094e0..e9efc489 100644
--- a/index.html
+++ b/index.html
@@ -44,6 +44,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/news/index.html b/news/index.html
index 6c21fc7d..568fce31 100644
--- a/news/index.html
+++ b/news/index.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/pkgdown.yml b/pkgdown.yml
index b20c2aba..6aa6d28b 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -3,8 +3,9 @@ pkgdown: 2.0.7
pkgdown_sha: ~
articles:
building-reproducible-development-environments-with-rix: building-reproducible-development-environments-with-rix.html
+ installing-old-packages-from-the-cran-archives: installing-old-packages-from-the-cran-archives.html
interactive-use: interactive-use.html
non-interactive-use: non-interactive-use.html
save-the-nix-package-versions-data: save-the-nix-package-versions-data.html
-last_built: 2023-08-01T20:38Z
+last_built: 2023-08-02T12:46Z
diff --git a/reference/available_r.html b/reference/available_r.html
index cc7ae01f..318e528c 100644
--- a/reference/available_r.html
+++ b/reference/available_r.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/reference/find_rev.html b/reference/find_rev.html
index 990d5b09..ad46b058 100644
--- a/reference/find_rev.html
+++ b/reference/find_rev.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/reference/get_current.html b/reference/get_current.html
index 016f092b..73e3e72d 100644
--- a/reference/get_current.html
+++ b/reference/get_current.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/reference/index.html b/reference/index.html
index a207292f..0cf0aed2 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/reference/r_nix_revs.html b/reference/r_nix_revs.html
index 98267cf0..46422eab 100644
--- a/reference/r_nix_revs.html
+++ b/reference/r_nix_revs.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/reference/rix.html b/reference/rix.html
index 7c508e3c..2bb587a0 100644
--- a/reference/rix.html
+++ b/reference/rix.html
@@ -25,6 +25,7 @@
Articles
Building reproducible development environments with rix
+ Installing old packages from the CRAN archives
Interactive use
Non-interactive use
Save the Nix Package Versions data
diff --git a/search.json b/search.json
index a18bc7bf..dcf0f824 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 3, 29 June 2007Copyright © 2007 Free Software Foundation, Inc. .","code":" Copyright (C) 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 (at your option) 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 Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are welcome to redistribute it under certain conditions; type 'show c' for details."},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"introduction-and-installation","dir":"Articles","previous_headings":"","what":"Introduction and installation","title":"Building reproducible development environments with rix","text":"goal {rix} provide easy way generate default.nix files. files used Nix package manager build environment according instructions defined . Users can specify version R, R packages, needed software, IDE etc available within environment. Writing files can daunting newcomers, {rix} provides function called rix(), takes care bulk work {rix} require Nix installed generate default.nix files, generate file one machine, build use environment another machine Nix installed (CI/CD service like Github Actions example). wish fully take advantage Nix, suggest use Determinate System’s installer. Nix can installed Linux, macOS Windows (Windows WSL2 must enabled). Linux, Nix instaled, software installed saved /nix directory root partition. Complete development environments built Nix can take much space, available space root parttion limited, advise mount /nix folder another partition space (example, secondary hard drive). , edit /etc/fstab add following line end: map /nix /home/path_to/nix can larger partition. enough space root partition, can ignore instructions.","code":"/home/path_to/nix /nix none bind 0 0"},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"nix-environments","dir":"Articles","previous_headings":"","what":"Nix environments","title":"Building reproducible development environments with rix","text":"environment built Nix totally isolated rest system. Suppose program sl installed system, suppose build Nix environment also comes sl. activate environment, version sl run called one included Nix environment. , however, start sl Nix environment come , system’s sl get used instead. can useful working interactively Nix environment, can use usual IDE work . exception RStudio: RStudio looks R predefined paths “see” R provided Nix environment, instead use version installed machine. means use RStudio work interactively R, need install RStudio inside environment. rix::rix() can generate default.nix file .","code":""},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"day-to-day-use-of-rix","dir":"Articles","previous_headings":"","what":"Day-to-day use of {rix}","title":"Building reproducible development environments with rix","text":"ideal workflow using {rix} create new, separate environment start project. Let’s say wish analyse data set, need dplyr ggplot2. Let’s also suppose use RStudio IDE. rix::rix() function, can easily generate right default.nix file. need provide following inputs rix(): r_ver: version R required. Use “current” latest version; r_pkgs: required R packages. example “dplyr”; other_pkgs: required system packages, needed. example “quarto”, Python interpreter; git_pkgs: list git packages add. See example ; ide: integrated development editor use. example “rstudio” want use RStudio. Refer “Interactive work {rix}” details; path: path save default.nix file. overwrite: whether overwrite default.nix file . situation, create environment following call rix(): generates following default.nix file: start using environment, open console folder containing default.nix use following Nix command: nix-build Nix command builds environment according specifications found default.nix file. environment done building, find new file called result next default.nix file. file symlink software installed Nix. now use environment, type: can now start RStudio provided environment typing rstudio. start version RStudio specific environment. already RStudio installed using operating system’s installer, version RStudio able interact Nix environments. RStudio looks R certain specific paths don’t include Nix environments. case editors like Visual Studio Code Emacs. use Visual Studio Code, can use following call rix(): (note value provided ide argument). generates following default.nix file: can see, specifying ide = \"code\" adds languageserver package list packages must installed environment. Visual Studio Code requires package interact R. install Nix environment-specific version Visual Studio Code. Now, instead typing rstudio Nix shell environment, type code start Visual Studio Code usually use. use another editor, like Emacs, use ide = \"\", start editor inside activated Nix environment. details interactive use, read “Interactive use” vignette.","code":"path_default_nix <- tempdir() rix(r_ver = \"current\", r_pkgs = c(\"dplyr\", \"ggplot2\"), other_pkgs = NULL, git_pkgs = NULL, ide = \"rstudio\", path = path_default_nix, overwrite = TRUE) #> #> # This file was generated by the {rix} R package on Tue Aug 1 20:38:11 2023 #> # It uses nixpkgs' revision e0e6b6909977de63dab514efbf5470bc31e7055e for reproducibility purposes #> # which will install R version current #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/e0e6b6909977de63dab514efbf5470bc31e7055e.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr ggplot2 #> ]; #> }; #> my-rstudio = rstudioWrapper.override { #> packages = with rPackages; [ #> dplyr ggplot2 #> ]; #> }; #> in #> mkShell { #> buildInputs = [ #> my-r #> my-rstudio #> ]; #> } nix-build nix-shell path_default_nix <- tempdir() rix(r_ver = \"current\", r_pkgs = c(\"dplyr\", \"ggplot2\"), other_pkgs = NULL, git_pkgs = NULL, ide = \"code\", path = path_default_nix, overwrite = TRUE) #> #> # This file was generated by the {rix} R package on Tue Aug 1 20:38:11 2023 #> # It uses nixpkgs' revision e0e6b6909977de63dab514efbf5470bc31e7055e for reproducibility purposes #> # which will install R version current #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/e0e6b6909977de63dab514efbf5470bc31e7055e.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr ggplot2 languageserver #> ]; #> }; #> in #> mkShell { #> buildInputs = [ #> my-r #> ]; #> }"},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"running-old-projects-with-rix","dir":"Articles","previous_headings":"","what":"Running old projects with {rix}","title":"Building reproducible development environments with rix","text":"example shows create default.nix instructions build environment R version 4.2.1, dplyr janitor packages specific IDE: file looks like : first line quite important, shows revision nixpkgs used environment. revision commit hash particular release nixpkgs, : 79b3d4bcae8. revision nixpkgs one shipped version 4.2.1 R, dplyr janitor packages get installed versions available revision well. means R versions package versions always coupled using Nix. However, need specific version R, also specific version package available particular Nix revision, one solution install package Github.","code":"path_default_nix <- tempdir() rix(r_ver = \"4.2.1\", r_pkgs = c(\"dplyr\", \"janitor\"), other_pkgs = c(\"quarto\"), git_pkgs = NULL, ide = \"other\", path = path_default_nix, overwrite = TRUE) #> #> # This file was generated by the {rix} R package on Tue Aug 1 20:38:12 2023 #> # It uses nixpkgs' revision 79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a for reproducibility purposes #> # which will install R version 4.2.1 #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr janitor #> ]; #> }; #> other-pkgs = [quarto]; #> in #> mkShell { #> buildInputs = [ #> my-r #> other-pkgs #> ]; #> }"},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"installing-packages-from-github","dir":"Articles","previous_headings":"","what":"Installing packages from Github","title":"Building reproducible development environments with rix","text":"also possible install packages Github: install two packages Github: {housing} package specifically code fusen branch. commit also provided, pin exact version package needed. fusen package also installed, main branch commit d617172447d. learn using {rix} daily basis, read Interactive use vignette.","code":"rix(r_ver = \"4.2.1\", r_pkgs = c(\"dplyr\", \"janitor\"), other_pkgs = c(\"quarto\"), git_pkgs = list( list(package_name = \"housing\", repo_url = \"https://github.com/rap4all/housing/\", branch_name = \"fusen\", commit = \"1c860959310b80e67c41f7bbdc3e84cef00df18e\"), list(package_name = \"fusen\", repo_url = \"https://github.com/ThinkR-open/fusen\", branch_name = \"main\", commit = \"d617172447d2947efb20ad6a4463742b8a5d79dc\") ), ide = \"other\", path = path_default_nix, overwrite = TRUE) cat(readLines(paste0(path_default_nix, \"/default.nix\")), sep = \"\\n\") #> #> # This file was generated by the {rix} R package on Tue Aug 1 20:38:12 2023 #> # It uses nixpkgs' revision 79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a for reproducibility purposes #> # which will install R version 4.2.1 #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr janitor #> (buildRPackage { #> name = \"housing\"; #> src = fetchgit { #> url = \"https://github.com/rap4all/housing/\"; #> branchName = \"fusen\"; #> rev = \"1c860959310b80e67c41f7bbdc3e84cef00df18e\"; #> sha256 = \"sha256-s4KGtfKQ7hL0sfDhGb4BpBpspfefBN6hf+XlslqyEn4=\"; #> }; #> propagatedBuildInputs = [ #> dplyr ggplot2 janitor purrr readxl rlang rvest stringr tidyr #> ]; #> }) #> (buildRPackage { #> name = \"fusen\"; #> src = fetchgit { #> url = \"https://github.com/ThinkR-open/fusen\"; #> branchName = \"main\"; #> rev = \"d617172447d2947efb20ad6a4463742b8a5d79dc\"; #> sha256 = \"sha256-TOHA1ymLUSgZMYIA1a2yvuv0799svaDOl3zOhNRxcmw=\"; #> }; #> propagatedBuildInputs = [ #> attachment cli desc glue here magrittr parsermd roxygen2 stringi tibble tidyr usethis yaml #> ]; #> }) #> ]; #> }; #> other-pkgs = [quarto]; #> in #> mkShell { #> buildInputs = [ #> my-r #> other-pkgs #> ]; #> }"},{"path":"/articles/interactive-use.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Interactive use","text":"vignette describes interactive use environments built {rix} using GUI editor like RStudio. discuss two scenarios: one already R RStudio installed operating system using usual installation method operating system, another used Nix install R RStudio (IDE).","code":""},{"path":"/articles/interactive-use.html","id":"scenario-1-you-installed-r-and-rstudio-as-usual","dir":"Articles","previous_headings":"","what":"Scenario 1: you installed R and RStudio as usual","title":"Interactive use","text":"Let’s suppose already running R RStudio wish start using {rix} define reproducible environments new projects starting today. environments get built using Nix package manager include required R packages project also specific version R, required system-level dependency well. used using RStudio, also need install RStudio using Nix project-specific environments. run project-specific version RStudio R, first need create default.nix file build environment defined therein using Nix. done, need activate environment running project-specific version RStudio. Suppose example generated default.nix file project called “kmeans”, suppose project following path: ~/Documents/kmeans (Windows something like C:\\Users\\Billy\\Documents\\kmeans). Navigate folder using terminal, run nix-shell. dropped Nix shell. can type rstudio run project specific version RStudio packages. can work usual. can also define shortcut project take care activating environment launching rstudio. example, define bash alias like : execute RStudio right project simply typing kmeans terminal. ’s also possible create executable script can save PATH: Name script something like kmeans_project, make executable (using chmod +x kmeans_project) now can run RStudio within environment anywhere.","code":"alias kmeans='nix-shell ~/Documents/kmeans/default.nix --run rstudio # !/usr/bin/env nix-shell # !nix-shell /home/Billy/Document/kmeans/default.nix -i bash rstudio"},{"path":"/articles/interactive-use.html","id":"scenario-2-you-install-r-and-rstudio-using-nix","dir":"Articles","previous_headings":"","what":"Scenario 2: you install R and RStudio using Nix","title":"Interactive use","text":"case don’t R installed, use {rix} package generate new expressions. case might consider installing Nix first, using expression , install latest development version {rix} R: Save default.nix file run nix-build nix-shell drop R console. can start using {rix} generate new complex environments.","code":"{ pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/8ad5e8132c5dcf977e308e7bf5517cc6cc0bf7d8.tar.gz\") {} }: with pkgs; let bootstrap_env = rWrapper.override { packages = with rPackages; [ (buildRPackage { name = \"rix\"; src = fetchgit { url = \"https://github.com/b-rodrigues/rix/\"; branchName = \"master\"; rev = \"935fb194b38adfb085a5bda9ebe5dc5bb504f2cb\"; sha256 = \"sha256-qMKcBcoemx3CcayA0Vt3LcDCAskhWyWXJBJVN8BaIOw=\"; }; propagatedBuildInputs = [ httr jsonlite ]; }) ]; }; in mkShell { buildInputs = [bootstrap_env]; shellHook = \"R\"; }"},{"path":"/articles/interactive-use.html","id":"other-ides","dir":"Articles","previous_headings":"","what":"Other IDEs","title":"Interactive use","text":"Visual Studio Code Emacs tested unlike RStudio, can use version either VS Code Emacs already installed system. ’s nothing stopping installing project-specific version VS Code Emacs well. Configuration settings accessible across every version every environment, since globally defined level system.","code":""},{"path":[]},{"path":"/articles/non-interactive-use.html","id":"running-a-targets-pipeline","dir":"Articles","previous_headings":"","what":"Running a {targets} pipeline","title":"Non-interactive use","text":"use targets execute pipeline environment running: ’s possible execute pipeline automatically using -called “shell hook”. See “Non-interactive use” vignette details.","code":"nix-shell /absolute/path/to/housing/default.nix --run Rscript -e 'targets::tar_make()'"},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Bruno Rodrigues. Author, maintainer.","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Rodrigues B (2023). rix: Rix: Reproducible Environments Nix. R package version 0.0.0.9000.","code":"@Manual{, title = {rix: Rix: Reproducible Environments With Nix}, author = {Bruno Rodrigues}, year = {2023}, note = {R package version 0.0.0.9000}, }"},{"path":[]},{"path":"/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Rix: Reproducible Environments With Nix","text":"can install development version rix GitHub :","code":"# install.packages(\"remotes\") remotes::install_github(\"b-rodrigues/rix\")"},{"path":"/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Rix: Reproducible Environments With Nix","text":"{rix} R package provides functions help setup reproducible development environments contain required packages need project. achieved using Nix package manager must install separately. Nix package manager extremely powerful: , possible work totally reproducible development environments, even install old releases R R packages. Nix, essentially possible replace renv Docker combined. need tools languages like Python Julia, can also done easily. Nix available Linux, macOS Windows.","code":""},{"path":"/index.html","id":"the-nix-package-manager","dir":"","previous_headings":"","what":"The Nix package manager","title":"Rix: Reproducible Environments With Nix","text":"Nix piece software can installed computer (regardless OS) can used install software like package manager. ’re familiar Ubuntu Linux distribution, likely used apt-get install software. macOS, may used homebrew similar purposes. Nix functions similar way, many advantages classic package managers. main advantage Nix, least purposes, repository software huge. writing, contains 80’000 packages, entirety CRAN available Nix’s repositories. means using Nix, possible install R, also packages required project. obvious question use Nix instead simply installing R R packages usual. answer Nix makes sure install every dependency package, required system libraries. example, xlsx package requires Java programming language installed computer successfully install. can difficult achieve, xlsx bullied many R developers throughout years (especially using Linux distribution, sudo R CMD javareconf still plagues nightmares). Nix, suffices declare want xlsx package project, Nix figures automatically Java required installs configures . just happens without required intervention user. second advantage Nix possible pin certain revision project. Pinning revision ensures every package Nix installs always exactly versions, regardless future packages get installed.","code":""},{"path":"/index.html","id":"rix-workflow","dir":"","previous_headings":"","what":"Rix workflow","title":"Rix: Reproducible Environments With Nix","text":"idea {rix} declare environment need, using provided rix() function, turn generates required file Nix actually generate environment. can use environment either work interactively, run R scripts. possible many environments projects. environment isolated (, ’s ). main function {rix} called rix(). rix() several arguments: R version need project list R packages project needs optional list additional software (example, Python interpreter, Quarto) optional list packages install Github whether want use RStudio IDE project (VS Code, another environment) path save file called default.nix. example: call writes default.nix file current working directory. default.nix can turn used Nix build environment containing RStudio, current (latest) version R, latest versions dplyr {chronicler} packages. th case RStudio, actually needs installed environment. RStudio changes default environment variables globally installed RStudio (one install normally) recognize R installed Nix environment. case IDEs VS code Emacs. Another example: call generate default.nix installs R version 4.1.0, dplyr {chronicler} packages. user wishes use VS Code, ide argument set “code”. installs required languageserver package well, unlike ide = \"rstudio\" install VS Code environment. Users instead use globally installed VS Code.","code":"rix(r_ver = \"current\", pkgs = c(\"dplyr\", \"chronicler\"), ide = \"rstudio\") rix(r_ver = \"4.1.0\", pkgs = c(\"dplyr\", \"chronicler\"), ide = \"code\")"},{"path":"/index.html","id":"defaultnix","dir":"","previous_headings":"Rix workflow","what":"default.nix","title":"Rix: Reproducible Environments With Nix","text":"Nix package manager can used build reproducible development environments according specifications found file called default.nix. make easier R programmers use Nix, {rix} can used write file . file written, go chose write (ideally new, empty folder root folder project) use Nix package manager build environment. Call following function terminal: Nix done building environment, can start working interactively using following command: drop Nix shell. can now call IDE choice. RStudio, simply call: start RStudio. RStudio use version R library packages environment.","code":"nix-build nix-shell rstudio"},{"path":"/index.html","id":"running-programs-from-an-environment","dir":"","previous_headings":"Rix workflow","what":"Running programs from an environment","title":"Rix: Reproducible Environments With Nix","text":"create bash script put path make process streamlined. example, project called housing, create script execute start project: execute RStudio environment housing project. use targets execute pipeline environment running: ’s possible execute pipeline automatically using -called “shell hook”. See “Non-interactive use” vignette details.","code":"!#/bin/bash nix-shell /absolute/path/to/housing/default.nix --run rstudio nix-shell /absolute/path/to/housing/default.nix --run Rscript -e 'targets::tar_make()'"},{"path":"/index.html","id":"contributing","dir":"","previous_headings":"","what":"Contributing","title":"Rix: Reproducible Environments With Nix","text":"package developed using fusen package. want contribute, please edit .Rmd files found dev/ folder. , inflate package using fusen::inflate_all(). errors found (warning notes ok), commit open PR. learn use fusen (don’t worry, ’s super easy), refer vignette.","code":""},{"path":"/reference/available_r.html","id":null,"dir":"Reference","previous_headings":"","what":"available_r List available R versions — available_r","title":"available_r List available R versions — available_r","text":"available_r List available R versions","code":""},{"path":"/reference/available_r.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"available_r List available R versions — available_r","text":"","code":"available_r()"},{"path":"/reference/available_r.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"available_r List available R versions — available_r","text":"character vector containing available R versrions.","code":""},{"path":"/reference/available_r.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"available_r List available R versions — available_r","text":"","code":"available_r() #> [1] \"current\" \"3.0.2\" \"3.0.3\" \"3.1.0\" \"3.1.2\" \"3.1.3\" \"3.2.0\" #> [8] \"3.2.1\" \"3.2.2\" \"3.2.3\" \"3.2.4\" \"3.3.3\" \"3.4.0\" \"3.4.1\" #> [15] \"3.4.2\" \"3.4.3\" \"3.4.4\" \"3.5.0\" \"3.5.1\" \"3.5.2\" \"3.5.3\" #> [22] \"3.6.0\" \"3.6.1\" \"3.6.2\" \"3.6.3\" \"4.0.0\" \"4.0.2\" \"4.0.3\" #> [29] \"4.0.4\" \"4.1.1\" \"4.1.2\" \"4.1.3\" \"4.2.0\" \"4.2.1\" \"4.2.2\""},{"path":"/reference/find_rev.html","id":null,"dir":"Reference","previous_headings":"","what":"find_rev Find the right Nix revision — find_rev","title":"find_rev Find the right Nix revision — find_rev","text":"find_rev Find right Nix revision","code":""},{"path":"/reference/find_rev.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"find_rev Find the right Nix revision — find_rev","text":"","code":"find_rev(r_version)"},{"path":"/reference/find_rev.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"find_rev Find the right Nix revision — find_rev","text":"r_version Character. R version look , example, \"4.2.0\"","code":""},{"path":"/reference/find_rev.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"find_rev Find the right Nix revision — find_rev","text":"character. Nix revision use","code":""},{"path":"/reference/find_rev.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"find_rev Find the right Nix revision — find_rev","text":"","code":"find_rev(\"4.2.0\") #> [1] \"f597e7e9fcf37d8ed14a12835ede0a7d362314bd\""},{"path":"/reference/get_current.html","id":null,"dir":"Reference","previous_headings":"","what":"get_current Get the current R version and packages — get_current","title":"get_current Get the current R version and packages — get_current","text":"get_current Get current R version packages","code":""},{"path":"/reference/get_current.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"get_current Get the current R version and packages — get_current","text":"","code":"get_current()"},{"path":"/reference/get_current.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"get_current Get the current R version and packages — get_current","text":"character. commit hash latest nixpkgs-unstable revision","code":""},{"path":"/reference/r_nix_revs.html","id":null,"dir":"Reference","previous_headings":"","what":"r_nix_revs — r_nix_revs","title":"r_nix_revs — r_nix_revs","text":"Nix revisions old R releases","code":""},{"path":"/reference/r_nix_revs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"r_nix_revs — r_nix_revs","text":"","code":"r_nix_revs"},{"path":"/reference/r_nix_revs.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"r_nix_revs — r_nix_revs","text":"data frame 34 rows 3 variables: version R version revision Nix revision containing version R date Date revision available","code":""},{"path":"/reference/r_nix_revs.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"r_nix_revs — r_nix_revs","text":"Nix Package Version, Marcelo Lazaroni","code":""},{"path":"/reference/rix.html","id":null,"dir":"Reference","previous_headings":"","what":"rix Build a reproducible development environment definition — rix","title":"rix Build a reproducible development environment definition — rix","text":"rix Build reproducible development environment definition","code":""},{"path":"/reference/rix.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rix Build a reproducible development environment definition — rix","text":"","code":"rix( r_ver = \"current\", r_pkgs, other_pkgs = NULL, git_pkgs = NULL, ide = \"other\", path = \".\", overwrite = FALSE )"},{"path":"/reference/rix.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rix Build a reproducible development environment definition — rix","text":"r_ver Character, defaults \"current\". required R version. use current version R, use \"current\". can check R versions available using available_r. r_pkgs Vector characters. List required R packages analysis . other_pkgs Vector characters. List software wish install git_pkgs List. list packages install Git. See details information. R packages. ide Character, defaults \"\". wish use RStudio work interactively use \"rstudio\", \"code\" Visual Studio Code. editors, use \"\". tested RStudio, VS Code Emacs. editors work, please open issue. path Character, defaults current working directory. write default.nix, example \"/home/path//project\". file thus written \"/home/path//project/default.nix\". overwrite Logical, defaults FALSE. TRUE, overwrite default.nix file specified path.","code":""},{"path":"/reference/rix.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rix Build a reproducible development environment definition — rix","text":"Nothing, function side-effect writing file called \"default.nix\" working directory. file contains instructions build reproducible environment using Nix package manager.","code":""},{"path":"/reference/rix.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rix Build a reproducible development environment definition — rix","text":"function write default.nix chosen path. Using Nix package manager, possible build reproducible development environment using nix-build command path. environment contain chosen version R packages, interfere installed version (via Nix ) machine. Every dependency, including R package dependencies also system dependencies like compilers get installed well environment. use RStudio interactive work, set rstudio parameter TRUE. use another IDE (example Emacs Visual Studio Code), need add default.nix file, can simply use version installed computer. use Visual Studio Code however, need install {languageserver} package, forget add list packages. built environment using nix-build, can drop interactive session using nix-shell. See \"-Nix\" vignette detailled instructions. Packages install Github must provided list 4 elements: \"package_name\", \"repo_url\", \"branch_name\" \"commit\". fifth, optional element, \"sri_hash\" can provided well. argument can also list lists 4 elements. See \"Installing packages Github\" detailled instructions.","code":""},{"path":"/news/index.html","id":"rix-development-version","dir":"Changelog","previous_headings":"","what":"rix (development version)","title":"rix (development version)","text":"Basic functionality added.","code":""}]
+[{"path":"/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"GNU General Public License","title":"GNU General Public License","text":"Version 3, 29 June 2007Copyright © 2007 Free Software Foundation, Inc. .","code":" Copyright (C) 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 (at your option) 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 Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are welcome to redistribute it under certain conditions; type 'show c' for details."},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"introduction-and-installation","dir":"Articles","previous_headings":"","what":"Introduction and installation","title":"Building reproducible development environments with rix","text":"goal {rix} provide easy way generate default.nix files. files used Nix package manager build environment according instructions defined . Users can specify version R, R packages, needed software, IDE etc available within environment. Writing files can daunting newcomers, {rix} provides function called rix(), takes care bulk work {rix} require Nix installed generate default.nix files, generate file one machine, build use environment another machine Nix installed (CI/CD service like Github Actions example). wish fully take advantage Nix, suggest use Determinate System’s installer. Nix can installed Linux, macOS Windows (Windows WSL2 must enabled). Linux, Nix instaled, software installed saved /nix directory root partition. Complete development environments built Nix can take much space, available space root parttion limited, advise mount /nix folder another partition space (example, secondary hard drive). , edit /etc/fstab add following line end: map /nix /home/path_to/nix can larger partition. enough space root partition, can ignore instructions.","code":"/home/path_to/nix /nix none bind 0 0"},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"nix-environments","dir":"Articles","previous_headings":"","what":"Nix environments","title":"Building reproducible development environments with rix","text":"environment built Nix totally isolated rest system. Suppose program sl installed system, suppose build Nix environment also comes sl. activate environment, version sl run called one included Nix environment. , however, start sl Nix environment come , system’s sl get used instead. can useful working interactively Nix environment, can use usual IDE work . exception RStudio: RStudio looks R predefined paths “see” R provided Nix environment, instead use version installed machine. means use RStudio work interactively R, need install RStudio inside environment. rix::rix() can generate default.nix file .","code":""},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"day-to-day-use-of-rix","dir":"Articles","previous_headings":"","what":"Day-to-day use of {rix}","title":"Building reproducible development environments with rix","text":"ideal workflow using {rix} create new, separate environment start project. Let’s say wish analyse data set, need dplyr ggplot2. Let’s also suppose use RStudio IDE. rix::rix() function, can easily generate right default.nix file. need provide following inputs rix(): r_ver: version R required. Use “current” latest version; r_pkgs: required R packages. example “dplyr”; other_pkgs: required system packages, needed. example “quarto”, Python interpreter; git_pkgs: list git packages add. See example ; ide: integrated development editor use. example “rstudio” want use RStudio. Refer “Interactive work {rix}” details; path: path save default.nix file. overwrite: whether overwrite default.nix file . situation, create environment following call rix(): generates following default.nix file: start using environment, open console folder containing default.nix use following Nix command: nix-build Nix command builds environment according specifications found default.nix file. environment done building, find new file called result next default.nix file. file symlink software installed Nix. now use environment, type: can now start RStudio provided environment typing rstudio. start version RStudio specific environment. already RStudio installed using operating system’s installer, version RStudio able interact Nix environments. RStudio looks R certain specific paths don’t include Nix environments. case editors like Visual Studio Code Emacs. use Visual Studio Code, can use following call rix(): (note value provided ide argument). generates following default.nix file: can see, specifying ide = \"code\" adds languageserver package list packages must installed environment. Visual Studio Code requires package interact R. install Nix environment-specific version Visual Studio Code. Now, instead typing rstudio Nix shell environment, type code start Visual Studio Code usually use. use another editor, like Emacs, use ide = \"\", start editor inside activated Nix environment. details interactive use, read “Interactive use” vignette.","code":"path_default_nix <- tempdir() rix(r_ver = \"current\", r_pkgs = c(\"dplyr\", \"ggplot2\"), other_pkgs = NULL, git_pkgs = NULL, ide = \"rstudio\", path = path_default_nix, overwrite = TRUE) #> #> # This file was generated by the {rix} R package on Wed Aug 2 12:46:48 2023 #> # It uses nixpkgs' revision 96112a3ed5d12bb1758b42c63b924c004b6c0bc9 for reproducibility purposes #> # which will install R version current #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/96112a3ed5d12bb1758b42c63b924c004b6c0bc9.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr ggplot2 #> ]; #> }; #> my-rstudio = rstudioWrapper.override { #> packages = with rPackages; [ #> dplyr ggplot2 #> ]; #> }; #> in #> mkShell { #> buildInputs = [ #> my-r #> my-rstudio #> ]; #> } nix-build nix-shell path_default_nix <- tempdir() rix(r_ver = \"current\", r_pkgs = c(\"dplyr\", \"ggplot2\"), other_pkgs = NULL, git_pkgs = NULL, ide = \"code\", path = path_default_nix, overwrite = TRUE) #> #> # This file was generated by the {rix} R package on Wed Aug 2 12:46:49 2023 #> # It uses nixpkgs' revision 96112a3ed5d12bb1758b42c63b924c004b6c0bc9 for reproducibility purposes #> # which will install R version current #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/96112a3ed5d12bb1758b42c63b924c004b6c0bc9.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr ggplot2 languageserver #> ]; #> }; #> in #> mkShell { #> buildInputs = [ #> my-r #> ]; #> }"},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"running-old-projects-with-rix","dir":"Articles","previous_headings":"","what":"Running old projects with {rix}","title":"Building reproducible development environments with rix","text":"example shows create default.nix instructions build environment R version 4.2.1, dplyr janitor packages specific IDE: file looks like : first line quite important, shows revision nixpkgs used environment. revision commit hash particular release nixpkgs, : 79b3d4bcae8. revision nixpkgs one shipped version 4.2.1 R, dplyr janitor packages get installed versions available revision well. means R versions package versions always coupled using Nix. However, need specific version R, also specific version package available particular Nix revision, one solution install package Github.","code":"path_default_nix <- tempdir() rix(r_ver = \"4.2.1\", r_pkgs = c(\"dplyr\", \"janitor\"), other_pkgs = c(\"quarto\"), git_pkgs = NULL, ide = \"other\", path = path_default_nix, overwrite = TRUE) #> #> # This file was generated by the {rix} R package on Wed Aug 2 12:46:49 2023 #> # It uses nixpkgs' revision 79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a for reproducibility purposes #> # which will install R version 4.2.1 #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr janitor #> ]; #> }; #> other-pkgs = [quarto]; #> in #> mkShell { #> buildInputs = [ #> my-r #> other-pkgs #> ]; #> }"},{"path":"/articles/building-reproducible-development-environments-with-rix.html","id":"installing-packages-from-github","dir":"Articles","previous_headings":"","what":"Installing packages from Github","title":"Building reproducible development environments with rix","text":"also possible install packages Github: install two packages Github: {housing} package specifically code fusen branch. commit also provided, pin exact version package needed. fusen package also installed, main branch commit d617172447d. learn using {rix} daily basis, read Interactive use vignette.","code":"rix(r_ver = \"4.2.1\", r_pkgs = c(\"dplyr\", \"janitor\"), other_pkgs = c(\"quarto\"), git_pkgs = list( list(package_name = \"housing\", repo_url = \"https://github.com/rap4all/housing/\", branch_name = \"fusen\", commit = \"1c860959310b80e67c41f7bbdc3e84cef00df18e\"), list(package_name = \"fusen\", repo_url = \"https://github.com/ThinkR-open/fusen\", branch_name = \"main\", commit = \"d617172447d2947efb20ad6a4463742b8a5d79dc\") ), ide = \"other\", path = path_default_nix, overwrite = TRUE) cat(readLines(paste0(path_default_nix, \"/default.nix\")), sep = \"\\n\") #> #> # This file was generated by the {rix} R package on Wed Aug 2 12:46:49 2023 #> # It uses nixpkgs' revision 79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a for reproducibility purposes #> # which will install R version 4.2.1 #> # Report any issues to https://github.com/b-rodrigues/rix #> { pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/79b3d4bcae8c7007c9fd51c279a8a67acfa73a2a.tar.gz\") {} }: #> #> with pkgs; #> #> let #> my-r = rWrapper.override { #> packages = with rPackages; [ #> dplyr janitor #> (buildRPackage { #> name = \"housing\"; #> src = fetchgit { #> url = \"https://github.com/rap4all/housing/\"; #> branchName = \"fusen\"; #> rev = \"1c860959310b80e67c41f7bbdc3e84cef00df18e\"; #> sha256 = \"sha256-s4KGtfKQ7hL0sfDhGb4BpBpspfefBN6hf+XlslqyEn4=\"; #> }; #> propagatedBuildInputs = [ #> dplyr ggplot2 janitor purrr readxl rlang rvest stringr tidyr #> ]; #> }) #> (buildRPackage { #> name = \"fusen\"; #> src = fetchgit { #> url = \"https://github.com/ThinkR-open/fusen\"; #> branchName = \"main\"; #> rev = \"d617172447d2947efb20ad6a4463742b8a5d79dc\"; #> sha256 = \"sha256-TOHA1ymLUSgZMYIA1a2yvuv0799svaDOl3zOhNRxcmw=\"; #> }; #> propagatedBuildInputs = [ #> attachment cli desc glue here magrittr parsermd roxygen2 stringi tibble tidyr usethis yaml #> ]; #> }) #> ]; #> }; #> other-pkgs = [quarto]; #> in #> mkShell { #> buildInputs = [ #> my-r #> other-pkgs #> ]; #> }"},{"path":"/articles/interactive-use.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Interactive use","text":"vignette describes interactive use environments built {rix} using GUI editor like RStudio. discuss two scenarios: one already R RStudio installed operating system using usual installation method operating system, another used Nix install R RStudio (IDE).","code":""},{"path":"/articles/interactive-use.html","id":"scenario-1-you-installed-r-and-rstudio-as-usual","dir":"Articles","previous_headings":"","what":"Scenario 1: you installed R and RStudio as usual","title":"Interactive use","text":"Let’s suppose already running R RStudio wish start using {rix} define reproducible environments new projects starting today. environments get built using Nix package manager include required R packages project also specific version R, required system-level dependency well. used using RStudio, also need install RStudio using Nix project-specific environments. run project-specific version RStudio R, first need create default.nix file build environment defined therein using Nix. done, need activate environment running project-specific version RStudio. Suppose example generated default.nix file project called “kmeans”, suppose project following path: ~/Documents/kmeans (Windows something like C:\\Users\\Billy\\Documents\\kmeans). Navigate folder using terminal, run nix-shell. dropped Nix shell. can type rstudio run project specific version RStudio packages. can work usual. can also define shortcut project take care activating environment launching rstudio. example, define bash alias like : execute RStudio right project simply typing kmeans terminal. ’s also possible create executable script can save PATH: Name script something like kmeans_project, make executable (using chmod +x kmeans_project) now can run RStudio within environment anywhere.","code":"alias kmeans='nix-shell ~/Documents/kmeans/default.nix --run rstudio # !/usr/bin/env nix-shell # !nix-shell /home/Billy/Document/kmeans/default.nix -i bash rstudio"},{"path":"/articles/interactive-use.html","id":"scenario-2-you-install-r-and-rstudio-using-nix","dir":"Articles","previous_headings":"","what":"Scenario 2: you install R and RStudio using Nix","title":"Interactive use","text":"case don’t R installed, use {rix} package generate new expressions. case might consider installing Nix first, using expression , install latest development version {rix} R: Save default.nix file run nix-build nix-shell drop R console. can start using {rix} generate new complex environments.","code":"{ pkgs ? import (fetchTarball \"https://github.com/NixOS/nixpkgs/archive/8ad5e8132c5dcf977e308e7bf5517cc6cc0bf7d8.tar.gz\") {} }: with pkgs; let bootstrap_env = rWrapper.override { packages = with rPackages; [ (buildRPackage { name = \"rix\"; src = fetchgit { url = \"https://github.com/b-rodrigues/rix/\"; branchName = \"master\"; rev = \"935fb194b38adfb085a5bda9ebe5dc5bb504f2cb\"; sha256 = \"sha256-qMKcBcoemx3CcayA0Vt3LcDCAskhWyWXJBJVN8BaIOw=\"; }; propagatedBuildInputs = [ httr jsonlite ]; }) ]; }; in mkShell { buildInputs = [bootstrap_env]; shellHook = \"R\"; }"},{"path":"/articles/interactive-use.html","id":"other-ides","dir":"Articles","previous_headings":"","what":"Other IDEs","title":"Interactive use","text":"Visual Studio Code Emacs tested unlike RStudio, can use version either VS Code Emacs already installed system. ’s nothing stopping installing project-specific version VS Code Emacs well. Configuration settings accessible across every version every environment, since globally defined level system.","code":""},{"path":[]},{"path":"/articles/non-interactive-use.html","id":"running-a-targets-pipeline","dir":"Articles","previous_headings":"","what":"Running a {targets} pipeline","title":"Non-interactive use","text":"use targets execute pipeline environment running: ’s possible execute pipeline automatically using -called “shell hook”. See “Non-interactive use” vignette details.","code":"nix-shell /absolute/path/to/housing/default.nix --run Rscript -e 'targets::tar_make()'"},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Bruno Rodrigues. Author, maintainer.","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Rodrigues B (2023). rix: Rix: Reproducible Environments Nix. R package version 0.0.0.9000.","code":"@Manual{, title = {rix: Rix: Reproducible Environments With Nix}, author = {Bruno Rodrigues}, year = {2023}, note = {R package version 0.0.0.9000}, }"},{"path":[]},{"path":"/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Rix: Reproducible Environments With Nix","text":"can install development version rix GitHub :","code":"# install.packages(\"remotes\") remotes::install_github(\"b-rodrigues/rix\")"},{"path":"/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Rix: Reproducible Environments With Nix","text":"{rix} R package provides functions help setup reproducible development environments contain required packages need project. achieved using Nix package manager must install separately. Nix package manager extremely powerful: , possible work totally reproducible development environments, even install old releases R R packages. Nix, essentially possible replace renv Docker combined. need tools languages like Python Julia, can also done easily. Nix available Linux, macOS Windows.","code":""},{"path":"/index.html","id":"the-nix-package-manager","dir":"","previous_headings":"","what":"The Nix package manager","title":"Rix: Reproducible Environments With Nix","text":"Nix piece software can installed computer (regardless OS) can used install software like package manager. ’re familiar Ubuntu Linux distribution, likely used apt-get install software. macOS, may used homebrew similar purposes. Nix functions similar way, many advantages classic package managers. main advantage Nix, least purposes, repository software huge. writing, contains 80’000 packages, entirety CRAN available Nix’s repositories. means using Nix, possible install R, also packages required project. obvious question use Nix instead simply installing R R packages usual. answer Nix makes sure install every dependency package, required system libraries. example, xlsx package requires Java programming language installed computer successfully install. can difficult achieve, xlsx bullied many R developers throughout years (especially using Linux distribution, sudo R CMD javareconf still plagues nightmares). Nix, suffices declare want xlsx package project, Nix figures automatically Java required installs configures . just happens without required intervention user. second advantage Nix possible pin certain revision project. Pinning revision ensures every package Nix installs always exactly versions, regardless future packages get installed.","code":""},{"path":"/index.html","id":"rix-workflow","dir":"","previous_headings":"","what":"Rix workflow","title":"Rix: Reproducible Environments With Nix","text":"idea {rix} declare environment need, using provided rix() function, turn generates required file Nix actually generate environment. can use environment either work interactively, run R scripts. possible many environments projects. environment isolated (, ’s ). main function {rix} called rix(). rix() several arguments: R version need project list R packages project needs optional list additional software (example, Python interpreter, Quarto) optional list packages install Github whether want use RStudio IDE project (VS Code, another environment) path save file called default.nix. example: call writes default.nix file current working directory. default.nix can turn used Nix build environment containing RStudio, current (latest) version R, latest versions dplyr {chronicler} packages. th case RStudio, actually needs installed environment. RStudio changes default environment variables globally installed RStudio (one install normally) recognize R installed Nix environment. case IDEs VS code Emacs. Another example: call generate default.nix installs R version 4.1.0, dplyr {chronicler} packages. user wishes use VS Code, ide argument set “code”. installs required languageserver package well, unlike ide = \"rstudio\" install VS Code environment. Users instead use globally installed VS Code.","code":"rix(r_ver = \"current\", pkgs = c(\"dplyr\", \"chronicler\"), ide = \"rstudio\") rix(r_ver = \"4.1.0\", pkgs = c(\"dplyr\", \"chronicler\"), ide = \"code\")"},{"path":"/index.html","id":"defaultnix","dir":"","previous_headings":"Rix workflow","what":"default.nix","title":"Rix: Reproducible Environments With Nix","text":"Nix package manager can used build reproducible development environments according specifications found file called default.nix. make easier R programmers use Nix, {rix} can used write file . file written, go chose write (ideally new, empty folder root folder project) use Nix package manager build environment. Call following function terminal: Nix done building environment, can start working interactively using following command: drop Nix shell. can now call IDE choice. RStudio, simply call: start RStudio. RStudio use version R library packages environment.","code":"nix-build nix-shell rstudio"},{"path":"/index.html","id":"running-programs-from-an-environment","dir":"","previous_headings":"Rix workflow","what":"Running programs from an environment","title":"Rix: Reproducible Environments With Nix","text":"create bash script put path make process streamlined. example, project called housing, create script execute start project: execute RStudio environment housing project. use targets execute pipeline environment running: ’s possible execute pipeline automatically using -called “shell hook”. See “Non-interactive use” vignette details.","code":"!#/bin/bash nix-shell /absolute/path/to/housing/default.nix --run rstudio nix-shell /absolute/path/to/housing/default.nix --run Rscript -e 'targets::tar_make()'"},{"path":"/index.html","id":"contributing","dir":"","previous_headings":"","what":"Contributing","title":"Rix: Reproducible Environments With Nix","text":"package developed using fusen package. want contribute, please edit .Rmd files found dev/ folder. , inflate package using fusen::inflate_all(). errors found (warning notes ok), commit open PR. learn use fusen (don’t worry, ’s super easy), refer vignette.","code":""},{"path":"/reference/available_r.html","id":null,"dir":"Reference","previous_headings":"","what":"available_r List available R versions — available_r","title":"available_r List available R versions — available_r","text":"available_r List available R versions","code":""},{"path":"/reference/available_r.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"available_r List available R versions — available_r","text":"","code":"available_r()"},{"path":"/reference/available_r.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"available_r List available R versions — available_r","text":"character vector containing available R versrions.","code":""},{"path":"/reference/available_r.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"available_r List available R versions — available_r","text":"","code":"available_r() #> [1] \"current\" \"3.0.2\" \"3.0.3\" \"3.1.0\" \"3.1.2\" \"3.1.3\" \"3.2.0\" #> [8] \"3.2.1\" \"3.2.2\" \"3.2.3\" \"3.2.4\" \"3.3.3\" \"3.4.0\" \"3.4.1\" #> [15] \"3.4.2\" \"3.4.3\" \"3.4.4\" \"3.5.0\" \"3.5.1\" \"3.5.2\" \"3.5.3\" #> [22] \"3.6.0\" \"3.6.1\" \"3.6.2\" \"3.6.3\" \"4.0.0\" \"4.0.2\" \"4.0.3\" #> [29] \"4.0.4\" \"4.1.1\" \"4.1.2\" \"4.1.3\" \"4.2.0\" \"4.2.1\" \"4.2.2\""},{"path":"/reference/find_rev.html","id":null,"dir":"Reference","previous_headings":"","what":"find_rev Find the right Nix revision — find_rev","title":"find_rev Find the right Nix revision — find_rev","text":"find_rev Find right Nix revision","code":""},{"path":"/reference/find_rev.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"find_rev Find the right Nix revision — find_rev","text":"","code":"find_rev(r_version)"},{"path":"/reference/find_rev.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"find_rev Find the right Nix revision — find_rev","text":"r_version Character. R version look , example, \"4.2.0\"","code":""},{"path":"/reference/find_rev.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"find_rev Find the right Nix revision — find_rev","text":"character. Nix revision use","code":""},{"path":"/reference/find_rev.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"find_rev Find the right Nix revision — find_rev","text":"","code":"find_rev(\"4.2.0\") #> [1] \"f597e7e9fcf37d8ed14a12835ede0a7d362314bd\""},{"path":"/reference/get_current.html","id":null,"dir":"Reference","previous_headings":"","what":"get_current Get the current R version and packages — get_current","title":"get_current Get the current R version and packages — get_current","text":"get_current Get current R version packages","code":""},{"path":"/reference/get_current.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"get_current Get the current R version and packages — get_current","text":"","code":"get_current()"},{"path":"/reference/get_current.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"get_current Get the current R version and packages — get_current","text":"character. commit hash latest nixpkgs-unstable revision","code":""},{"path":"/reference/r_nix_revs.html","id":null,"dir":"Reference","previous_headings":"","what":"r_nix_revs — r_nix_revs","title":"r_nix_revs — r_nix_revs","text":"Nix revisions old R releases","code":""},{"path":"/reference/r_nix_revs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"r_nix_revs — r_nix_revs","text":"","code":"r_nix_revs"},{"path":"/reference/r_nix_revs.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"r_nix_revs — r_nix_revs","text":"data frame 34 rows 3 variables: version R version revision Nix revision containing version R date Date revision available","code":""},{"path":"/reference/r_nix_revs.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"r_nix_revs — r_nix_revs","text":"Nix Package Version, Marcelo Lazaroni","code":""},{"path":"/reference/rix.html","id":null,"dir":"Reference","previous_headings":"","what":"rix Build a reproducible development environment definition — rix","title":"rix Build a reproducible development environment definition — rix","text":"rix Build reproducible development environment definition","code":""},{"path":"/reference/rix.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rix Build a reproducible development environment definition — rix","text":"","code":"rix( r_ver = \"current\", r_pkgs, other_pkgs = NULL, git_pkgs = NULL, ide = \"other\", path = \".\", overwrite = FALSE )"},{"path":"/reference/rix.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rix Build a reproducible development environment definition — rix","text":"r_ver Character, defaults \"current\". required R version. use current version R, use \"current\". can check R versions available using available_r. r_pkgs Vector characters. List required R packages analysis . other_pkgs Vector characters. List software wish install git_pkgs List. list packages install Git. See details information. R packages. ide Character, defaults \"\". wish use RStudio work interactively use \"rstudio\", \"code\" Visual Studio Code. editors, use \"\". tested RStudio, VS Code Emacs. editors work, please open issue. path Character, defaults current working directory. write default.nix, example \"/home/path//project\". file thus written \"/home/path//project/default.nix\". overwrite Logical, defaults FALSE. TRUE, overwrite default.nix file specified path.","code":""},{"path":"/reference/rix.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rix Build a reproducible development environment definition — rix","text":"Nothing, function side-effect writing file called \"default.nix\" working directory. file contains instructions build reproducible environment using Nix package manager.","code":""},{"path":"/reference/rix.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rix Build a reproducible development environment definition — rix","text":"function write default.nix chosen path. Using Nix package manager, possible build reproducible development environment using nix-build command path. environment contain chosen version R packages, interfere installed version (via Nix ) machine. Every dependency, including R package dependencies also system dependencies like compilers get installed well environment. use RStudio interactive work, set rstudio parameter TRUE. use another IDE (example Emacs Visual Studio Code), need add default.nix file, can simply use version installed computer. use Visual Studio Code however, need install {languageserver} package, forget add list packages. built environment using nix-build, can drop interactive session using nix-shell. See \"-Nix\" vignette detailled instructions. Packages install Github must provided list 4 elements: \"package_name\", \"repo_url\", \"branch_name\" \"commit\". fifth, optional element, \"sri_hash\" can provided well. argument can also list lists 4 elements. See \"Installing packages Github\" detailled instructions.","code":""},{"path":"/news/index.html","id":"rix-development-version","dir":"Changelog","previous_headings":"","what":"rix (development version)","title":"rix (development version)","text":"Basic functionality added.","code":""}]
diff --git a/sitemap.xml b/sitemap.xml
index b7ddbbd0..b2047587 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -12,6 +12,9 @@
/articles/index.html
+
+ /articles/installing-old-packages-from-the-cran-archives.html
+
/articles/interactive-use.html