Installation¶
Install release from PyPI¶
The Python Package Index (PyPI) is a repository of software for the Python programming language. To install or update nwbindexer from PyPI run:
$pip install -U nwbindexer
This will automatically install the following dependencies as well as nwbindexer:
- parsimonious
- h5py
- numpy
Testing the installation (optional)¶
To test the installation, pytest must be installed. It can be installed using:
$pip install pytest
Once pytest is installed, the nwbindexer installation can be tested by running:
$pytest --pyargs nwbindexer
Output should indicate all all tests (5) passed.
Install from Git repository¶
First clone the repository and cd into the created directory:
$git clone https://github.com/jeffteeters/nwbindexer.git
$cd nwbindexer
Test local files, not yet installed (optional)¶
To test the locally cloned files before installing, first packages parsimonious, h5py and pytest must be installed. They can be installed using:
$pip install parsimonious
$pip install h5py
$pip install pytest
Then, the tests can be run when inside the top-level nwbindexer directory created from the clone (which contains file setup.py), by entering pytest with no arguments:
$pytest
Output should indicate all tests (5) passed.
Completing the installation¶
To complete the installation, when directly inside the directory created by the clone (containing file setup.py) either enter the following for a normal installation (not used for development):
$pip install .
OR enter the following to create an editable install which is recommended for development (include the -e option):
$pip install -e .
Test the installation (optional)¶
To test the installation (separately from the cloned files downloaded), cd to a directory that does not contain the cloned nwbindexer directory, then type:
$pytest --pyargs nwbindexer
Output should indicate all all tests (5) passed.