Skip to contents

Install Micromamba Binaries in the condathis Controlled Path

Source: R/install_micromamba.R
install_micromamba.Rd

Downloads and installs the Micromamba binaries in the path managed by the condathis package. Micromamba is a lightweight implementation of the Conda package manager and provides an efficient way to create and manage conda environments.

Usage

install_micromamba(
  micromamba_version = "2.5.0-2",
  timeout_limit = 3600,
  download_method = "auto",
  force = FALSE,
  verbose = c("output", "silent", "cmd", "spinner", "full")
)

Arguments

micromamba_version

Character string specifying the version of Micromamba to download. Defaults to "2.5.0-2".

timeout_limit

Numeric value specifying the timeout limit for downloading the Micromamba binaries, in seconds. Defaults to 3600 seconds (1 hour).

download_method

Character string passed to the method argument of the utils::download.file() function used for downloading the binaries when the curl package is not available. Defaults to "auto".

force

Logical. If set to TRUE, the download and installation of the Micromamba binaries will be forced, even if they already exist in the system or condathis controlled path. Defaults to FALSE.

verbose

Character string indicating the verbosity level of the function. Can be one of "full", "output", "silent". Defaults to "output".

Value

Invisibly returns the path to the installed Micromamba binary.

Details

This function checks if Micromamba is already installed in the condathis controlled path. If not, it downloads the specified version from multiple mirror sources and installs it.

The download strategy is:

  • If system tar and bzip2 are available, download the compressed .tar.bz2 archive (smaller download) and extract it.

  • If tar or bzip2 are not available, or if extraction fails, download the uncompressed standalone binary directly.

Multiple mirror sources are tried in order:

  • GitHub Releases (https://github.com/mamba-org/micromamba-releases/releases/)

  • micro.mamba.pm (official CDN) (https://micro.mamba.pm/api/micromamba/)

  • conda-forge via Anaconda (https://api.anaconda.org/download/conda-forge/)

  • conda-forge via prefix.dev (https://repo.prefix.dev/conda-forge/)

The downloaded binary is verified against the SHA256 checksum published on GitHub releases. The curl package is preferred for downloads when available, with utils::download.file() as a fallback.

Examples

if (FALSE) { # \dontrun{
condathis::with_sandbox_dir({
  # Install the default version of Micromamba
  condathis::install_micromamba()

  # Install a specific version of Micromamba
  condathis::install_micromamba(micromamba_version = "2.0.2-2")

  # Force reinstallation of Micromamba
  condathis::install_micromamba(force = TRUE)
})
} # }