Installing¶

Which Python?¶

You’ll need Python >= 3.5.

Warning

Python 2.7 is no longer supported. Use Pooch <= 0.6.0 if you need 2.7 support.

We recommend using the Anaconda Python distribution 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.

Dependencies¶

Required:

Optional:

tqdm: Required to print a download progress bar (see pooch.HTTPDownloader).

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:

pip install pooch

Installing the latest development version¶

You can use pip to install the latest source from Github:

pip install https://github.com/fatiando/pooch/archive/master.zip

Alternatively, you can clone the git repository locally and install from there:

git clone https://github.com/fatiando/pooch.git
cd pooch
pip install .

Testing your install¶

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:

import pooch
pooch.test()