Installing¶

Which Python?¶

You’ll need Python >= 3.6 (see Python version compatibility if you require support for older versions).

We recommend using the Anaconda or Miniconda Python distributions to ensure you have all dependencies installed and the conda package manager available. Installing Anaconda does not require administrative rights to your computer and doesn’t interfere with any other Python installations in your system.

Installing with conda¶

You can install pooch using the conda package manager that comes with the Anaconda distribution:

conda install pooch --channel conda-forge

Installing with pip¶

Alternatively, you can also use the pip package manager:

python -m pip install pooch

Installing the latest development version¶

You can use pip to install the latest version of the source code from GitHub:

python -m pip install --upgrade git+https://github.com/fatiando/pooch

Dependencies¶

The required dependencies should be installed automatically when you install Pooch using conda or pip. Optional dependencies have to be installed manually.

Required:

Optional:

tqdm: Required to print a download progress bar (see pooch.HTTPDownloader).
paramiko: Required for SFTP downloads (see pooch.SFTPDownloader).

Testing your install¶

Note

This step is optional.

We ship a full test suite with the package. To run the tests, you’ll need to install some extra dependencies first:

pytest

After that, you can test your installation by running the following inside a Python interpreter or Jupyter notebook:

import pooch
pooch.test()

Python version compatibility¶

If you require support for older Python versions, please pin Pooch to the following releases to ensure compatibility:

Python version	Last compatible Pooch release
2.7	0.6.0
3.5	1.2.0