GitLocker: The Coding Marketplace

Description:

finishline 0.3.0

Finish Line is a framework for quickly building beautiful customizable dashboards in Plotly Dash.
The framework provides utility for developers to easily plugin new interactive visualization
components into the dashboard. Components are automatically added to the dashboard using a responsive
grid layout.

How to use Finish Line
An example use of the framework is located in the GitHub repo under the example directory. The
following shows the minimum code required to start a Finish Line dashboard server.
from finishline import FinishLine
import dash

app = dash.Dash()
data = load_my_data()

fl = FinishLine(app=app, data=data)
fl.load_plugins()
app.layout = fl.generate_layout()

if __name__ == '__main__':
fl.run_server(debug=True, port=5000, host='0.0.0.0')
Visualization components are loaded from the plugins folder. The default location is in a folder
called plugins in the current working directory (directory the web server is started). Individual
plugins are located in subfolders under the plugins folder. The entry point to a plugin is in the
file __init__.py.
Here is an example component. The code is placed in ./plugins/HelloWorld/__init__.py
import dash_html_components as html
import dash_core_components as dcc

def initialize(app, data, fl):

fl.register_vis(
'HelloWorld',
dcc.Graph(
id='basic-chart',
figure={
'data': [
{
'x': [1, 2, 3, 4],
'y': [4, 1, 3, 5],
'text': ['a', 'b', 'c', 'd'],
'customdata': ['c.a', 'c.b', 'c.c', 'c.d'],
'name': 'Trace 1',
'mode': 'markers',
'marker': {'size': 12}
},
{
'x': [1, 2, 3, 4],
'y': [9, 4, 1, 4],
'text': ['w', 'x', 'y', 'z'],
'customdata': ['c.w', 'c.x', 'c.y', 'c.z'],
'name': 'Trace 2',
'mode': 'markers',
'marker': {'size': 12}
}
]
},
config={
'autosizable': True
}
)
)

def finalize(app, data, fl):
pass

Installation
Finish Line depends upon dash. Note, we have only tested with python3.
Requirements:

dash
dash-responsive-grid-layout

Install Options
pip3 install finishline

Build
Create distribution

edit setup.py and change version number

python3 setup.py sdist bdist_wheel
Install distribution locally
pip3 uninstall finishline
pip3 install dist/finishline-VERSION-py3-none-any.whl
Push to test pip
twine upload --repository-url https://test.pypi.org/legacy/ dist/*VERSION*
pip3 install -U --index-url https://test.pypi.org/simple/ finishline
Push to production pip
twine upload dist/*VERSION*
pip3 install -U finishline

Features

Client and server side data store API
Plugin visualization component API
Responsive grid layout
Customizable grid layout via drag and drop
Developer mode

To Do List

Save layout
Reusable components API
Hide/Show components
Support multiple pages
Better support for resizing plotly charts