reticulate (version 1.11.1)

virtualenv-tools: Interface to Python Virtual Environments

Description

R functions for managing Python virtual environments.

Usage

virtualenv_list()

virtualenv_create(envname, python = NULL)

virtualenv_install(envname, packages, ignore_installed = TRUE)

virtualenv_remove(envname, packages = NULL, confirm = interactive())

virtualenv_root()

virtualenv_python(envname)

Arguments

envname

The name of, or path to, a Python virtual environment. If this name contains any slashes, the name will be interpreted as a path; if the name does not contain slashes, it will be treated as a virtual environment within virtualenv_root().

python

The path to a Python interpreter, to be used with the created virtual environment. When NULL, the Python interpreter associated with the current session will be used.

packages

A character vector with package names to install or remove.

ignore_installed

Boolean; ignore previously-installed versions of the requested packages? (This should normally be TRUE, so that pre-installed packages available in the site libraries are ignored and hence packages are installed into the virtual environment.)

confirm

Boolean; confirm before removing packages or virtual environments?

Details

Virtual environments are by default located at ~/.virtualenvs (accessed with the virtualenv_root function). You can change the default location by defining defining the WORKON_HOME environment variable.

Virtual environment functions are not supported on Windows (the use of conda environments is recommended on Windows).