Dash Core Components
This package provides the core React component suite for Dash.
- Install the dependencies with:
$ npm i
- Build the code:
$ npm run build-dev
- Install the library
$ cd dash-core-components $ npm run copy-lib $ python setup.py install
I recommend installing the library and running the examples in a fresh virtualenv in a separate folder:
$ mkdir dash_examples # create a new folder to test examples $ cd dash_examples $ virtualenv venv # create a virtual env $ source venv/bin/activate # use the virtual env
(and then repeat step 3).
- Add the following line to your Dash app
app.scripts.config.serve_locally = True
You can start up a demo development server to see a demo of the rendered components:
$ builder run demo$ open http://localhost:9000
You have to maintain the list of components in
Code quality and tests
To run integration tests (test_integration.py)
We run our integration tests on CircleCI with help from Tox. There’s a tox.ini file which holds the configuration, refer to tox's documentation for help. You may need to set environment variables in your terminal, like
TOX_PYTHON_27 to my version of python that I wanted tox to use. So running:
TOX_PYTHON_27 env variable to point to
python2, which is Python 2.7 running on my machine.
You could also look in
tox.ini and see which tests it runs, and run those commands yourself:
python -m unittest test.test_integration
Testing your components in Dash
Build development bundle to
lib/and watch for changes
# Once this is started, you can just leave it running. $ npm start
Install module locally (after every change)
Run the dash layout you want to test
# Import dash_core_components to your layout, then run it: $ python my_dash_layout.py
Installing python package locally
Before publishing to PyPi, you can test installing the module locally:
# Install in `site-packages` on your machine$ npm run install-local
Uninstalling python package locally
$ npm run uninstall-local
See the Publishing New Components/Features section of the Contributing guide for step-by-step instructions on publishing new components.
Builder / Archetype
We use Builder to centrally manage build configuration, dependencies, and scripts.
To see all
builder scripts available:
$ builder help
See the dash-components-archetype repo for more information.