Skip to content

Latest commit

 

History

History
94 lines (63 loc) · 1.68 KB

CONTRIBUTING.md

File metadata and controls

94 lines (63 loc) · 1.68 KB
Raw

Contributing

If you find any issues please create a Github Issue with as much info as possible, the best way is a submit reproducible notebook and some screenshots of the dashboard.

Setup development environment

Dependencies:

  • Node.js
  • Python
  • Optional: Task

1. Javascript

Install dependencies

task js-install

2. Python

Create Python env

cd python

hatch env create
hatch shell

3. Download 3rd-party assets and test data

task download-assets download-testdata

Iteration cycle

With both environments ready we can have a nice iteration cycle between JS and Python:

  1. Start webpack in watch mode, this will also place the bundle files in the nbconvert and voila static directories.
task js-dev
  1. Now you can start the Voila server and iterate quickly on the JS or Python code.

Start the Voila in the examples directory:

task voila-examples

Tests

A system based on docker is provided and it's the same the CI system runs.

  1. Start Selenium locally task selenium-server or in Docker task selenium-docker
  2. Start voila server locally: make voila-examples
  3. Run pytest locally against Selenium
# Run a group of tests
PYTEST_M=layouts task pytest

# Run a specific test
PYTEST_K=ipysheet task pytest

# Run all tests
task pytest-all

To generate/update the test baselines just run the tests

Installing Selenium and the Chrome driver on mac

brew install chromedriver
brew install selenium-server-standalone
brew install --cask google-chrome

Docs

task docs
task docs-serve