Installation¶
Required dependencies¶
pandaSDMX is a pure Python package requiring Python 3.7 or higher, which can be installed:
from the Python website, or
using a scientific Python distribution that includes other packages useful for data analysis, such as Anaconda, Canopy, or others listed on the Python wiki.
pandaSDMX also depends on:
Optional dependencies for extra features¶
for
cache
, allowing the caching of SDMX messages in memory, MongoDB, Redis, and more: requests-cache.for
test
, to run the test suite: pytest, pytest-remotedata, and requests-mock.
Instructions¶
(optional) If using Anaconda, use
source activate [ENV]
to activate the environment in which to install pandaSDMX.From the command line, issue:
$ pip install pandasdmx
To also install optional dependencies, use commands like:
$ pip install pandasdmx[cache] # just requests-cache $ pip install pandasdmx[cache,doc,test] # all extras
From source¶
Download the latest code:
from Github as a zip archive, or
by cloning the Github repository:
$ git clone git@github.com:dr-leo/pandaSDMX.git
In the package directory, issue:
$ pip install .
Running tests¶
Install from source, including the tests
optional dependencies.
Then, in the package directory, issue:
$ py.test
By default, tests that involve retrieving data over the network are skipped. To also run these tests, use:
$ py.test --remote-data
pytest offers many command-line options to control test invocation; see py.test --help
or the documentation.