Pkg, Project.toml, Manifest.toml and Environments
2019-07-23, 11:00–11:30, Room 349

One of the major features of Julia's new package manager is package environments. This presentation will explain how environments work, what they are useful for and how to use them effectively.


Julia's new package manager, Pkg, was released together with version 1.0 of the Julia language. The new package manager is a complete rewrite of the old one, and solves many of the problems observed in the old version. One major feature of the new package manager is the concept of package environments, which can be described as independent, sandboxed, sets of packages.

A package environment is represented by a Project.toml and Manifest.toml file pair. These files keep track of what packages, and what versions, are available in a given environment. Since environments are "cheap", just two files, they can be used liberally. It is often useful to create new environments for every new coding project, instead of installing packages on the global level. Since the package manager modifies the current project, e.g. when adding, removing or updating packages, there is no risk for these operations to mess up other environments.

The fact that exact versions of packages in the environment is being recorded means that Julia has reproducibility built-in. As long as the Project.toml and Manifest.toml file pair is available it is possible to replicate exactly the same package environment. Some typical use cases include being able to replicate the same package environment on a different machine, and being able to go back in time and run some old code which might require some old versions of packages.

In this presentation we will discuss how environments work, how they interact with the package manager and Julia's code loading, and how to effectively use them. Hopefully you will be more comfortable working with, and seeing the usefulness of, environments after this presentation.


Co-authors