View source: R/VC_library_writing.R
lib.convert | R Documentation |
After this conversion is completed and you configure (temporarily by using lib.location(...)
or for eternity by setting the equally named environment variable)
the R_MV_LIBRARY_LOCATION env var, you are good to go! You can directly use lib.load
for loading packages. Thanks for using multiversion
!!
This function creates the R_MV_library structure by moving normally
installed packages to a parallel library structure.
<lib1>/BH/DESCRIPTION
becomes<lib2>/BH/1.60.0-2/BH/DESCRIPTION
so that also 1.60.0-3
etc. can be installed.
This functionality is also used (with it's default values) for converting
installed packages from the temporary installation directory to the final R_MV_library.
The TEMP installation directory is in a standard flat library structure.
Note that it is really no problem to perform a conversion again, it will
only move new versions of already present packages and will never overwrite.
To continue with a clean Temp folder, run lib.clean_install_dir()
which will remove the folder.
lib.convert( source_lib = lib.location_install_dir(destination_mv_lib), destination_mv_lib = lib.location(), force_overwrite = FALSE, packages_to_convert )
source_lib |
The temporary library where a package is temporarily
installed (having a normal library structure).
By default, the path is generated using |
destination_mv_lib |
The folder containing a structure where all packages
in the temp folder must be moved to. By default, it checks the environment
variable |
force_overwrite |
If you are experimenting and you would like to overwrite the newly installed package. Normally only desired when the package you are experimenting with is a self maintained package and you are sure you increased the version to a new one. |
packages_to_convert |
A character vector with the names of the packages that need to be converted to the R_MV_library. If missing or empty, all will be converted. |
No return value, it is called for it's side-effect. Will convert a set of packages from a normal package library structure to a multiversion library version. By default, from the temporary multiversion installation directory to the final multiversion library.
# As an experiment (or when getting started) you could run this with # your complete standard library (not your base library). #> lib.convert(source_lib = Sys.getenv("R_LIBS_USER"), #> destination_mv_lib = "./REMOVE_ME_example_library") # Running the same operation a second time will result # in a notification that all files were already copied. # Just running it will use the R_MV_library defined by the environment # variable and look inside for the Temp folder to use. #> lib.convert() # It is sufficient to only provide the destination_mv_lib, # it will look for the "/TEMP_install_location" folder as the 'source_lib' by default. #> lib.convert(destination_mv_lib = "./R_MV_library")
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.