dash_extra_components v0.0.1
dash-extra-components
This package provides extra React components for Dash.
Why Dash Extra Components?
Dash Core Components is our "essential" component suite for Dash. Not all components make the cut!
Dash Extra Components is a more specialized collection of components written by Plotly. Some components were created for our own projects (dec.TableOfContents
was written for the Dash User Guide) while others were made for our Dash Deployment Server customers (e.g. dec.SuggestionsInput
).
Instead of creating a separate repository for each component, we decided to bundle them as a new package to ease discoverability and maintenance.
Dash Extra Components are maintained by Plotly. However, we don't view them quite as essential as our other Dash components and, as such, won't be giving them as much attention with respect to upkeep and documentation. What you see is what you get!
Installation
$ pip install dash-extra-components
Usage
Importing dash-extra-components:
import dash_extra_components as dec
Development
- Clone the repo.
$ git clone https://github.com/plotly/dash-extra-components
- cd to the project
$ cd dash-extra-components
- Create a virtual named
venv
in order to build the components. Thebuild:py
command expect avenv
environment folder in the project root.$ virtualenv venv
or$ python -m venv venv
for Python 3. - Install either
requirements.txt
ortests/requirements
if you want to run the tests locally.$ pip install -r requirements.txt
- Install npm dependencies.
$ npm install
- Modify/add js code in
src/lib/components
- Build the components
$ npm run build:all
Testing
Testing is performed using pytest-dash. To run the tests locally:
$ pytest tests --driver Chrome
Make sure Chromedriver is available on your PATH.
make sure to rebuild the components before starting the tests
More links
5 years ago