How Landlab Specifies Dependencies¶
The Landlab package dependencies are found in the top-level directory file
requirements.txt
.
The setup.py
file looks to this file and reads it when compiling the
package. In this way, we only state the dependencies in one location.
In addition to the core set of dependencies, development with Landlab, and common use of Landlab (e.g., running the notebooks) may have additional dependencies. These dependencies are described in the following files:
requirements-notebooks.txt
indicates dependencies for running the notebooks.requirements-testing.txt
indicates dependencies for running tests.requirements-dev.txt
indicates dependencies for development (less building the documentation).
We provide two convenience environment files that address the two most common use cases.
environment.yml
specifies an environment which installs a Landlab binary and all of the notebook dependencies.environment-dev.yml
specifies an environment with all development dependencies.
If a developer wants to build the documentation locally there are some
additional dependencies. We do not include these in requirements-dev.txt
because it is uncommon for developers to need to build the docs locally.
An environment specifying documentation-building requirements can be found at
landlab/docs/environment.yml
.