Installation

Required dependencies

pandaSDMX is a pure Python package requiring Python 3.7 or higher, which can be installed:

pandaSDMX also depends on:

Optional dependencies for extra features

Instructions

  1. (optional) If using Anaconda, use source activate [ENV] to activate the environment in which to install pandaSDMX.

  2. 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

  1. Download the latest code:

    • from PyPI,

    • from Github as a zip archive, or

    • by cloning the Github repository:

      $ git clone git@github.com:dr-leo/pandaSDMX.git
      
  2. In the package directory, issue:

    $ pip install  .
    

Note

The build process adheres to PEP 517 using flit as build backend.

To also install optional dependencies, use commands like:

$ pip install .[cache]             # just requests-cache
$ pip install .[cache,doc,test]  # all extras

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.