Developer tasksΒΆ

This document includes instructions development environment for the dashboards layout extension. It also includes common steps in the developer workflow such as running tests, building docs, etc.

Install conda on your system. Then clone this repository in a local directory.

# make a directory under ~ to put source
mkdir -p ~/projects
cd !$

# clone this repo
git clone https://github.com/jupyter/dashboards.git

Create a conda environment with the necessary dev and test dependencies.

cd dashboards
make env

Install the necessary JS dependencies. Re-run this command any time your bower.json or package.json changes.

make js

Run a notebook server with the dashboard extension enabled.

make notebook

Travis runs a small set of UI smoke tests using Selenium on Sauce Labs on every merge to the git master branch. You can run these tests locally if you install Selenium.

# install selenium first, e.g., on OSX
brew install selenium-server-standalone
# run the smoke tests
make test

ReadTheDocs builds the project documentation on every merge to git master. You can build the documentation locally as well.

make docs

Run make help to get a full list of development tasks.