dash-tools - An Open-Source Plotly Dash CLI Toolchain

Create a templated multi-page Plotly Dash app with CLI in less than 7 seconds!

About

dash-tools is an open-source toolchain for Plotly Dash Framework. With a user-friendly command line interface, creating Dash applications will never be quicker.

With user and developer-friendly templates, generating a new app only takes senconds. In fact, it will take longer to install this tool than it will to use it!

Installation

dash-tools is available through pip.

pip install dash-tools

Examples

Below are common usage examples. See Commands section for more details.

# Create a new Dash app called MyDashApp
dash-tools --init MyDashApp

Templates are also available using the optional template argument after --init:

# Create a new Dash app called MyDashApp using 'minimal' theme
dash-tools --init MyDashApp minimal

Templates

Listed below are available project template templates. Please see the above example on how to use templates.

default - the default multi-page template. Includes examples of ClientsideCallbacks, multi-page routing, external stylesheets, header, footer, and 404 page.
minimal - for the minimalists. Not much here but the bare bones.
heroku - Build for deployment with Heroku. Includes necessary deploy files. Build on the minimal template.

If you would like to develop templates, please read the Creating Templates section below.

Commands

Project Build Commands

--init, -i Args: REQUIRED (project name) OPTIONAL (template) : Creates a Plotly Dash app with the given name in the current working directory. Optional args specified can be used for templates.
--templates : List available templates.

Other

--help, -h: Display CLI helpful hints
--version: Display current version.

Development

Creating Templates

Templates are found here: dash_tools/templating/templates/<Template Name>. When a user uses CLI to choose a template with the name <Template Name> the template will be copied to their system.
Adding a new template to the templates directory requires adding the new template to the Enum list in templating.templateUtils:Templates Enum. Template name must match Enum value, eg.
```
class Templates(Enum):
DEFAULT = 'default'
MINIMAL = 'minimal'
<NEWTEMPLATE> = '<newtemplate>'
```
Any file names or files containing the strings {appName} or {createTime} will be formatted with the given app name and creation time. Eg. README.md.template: {# Created on {createTime} will copy to the user's filesystem as # Creaded on 2022-03-30 22:06:07
All template files must end in .template

License

MIT License. See LICENSE.txt file.

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Release files for dash-tools 0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dash-tools 0.3
File	Size	Uploaded
dash-tools-0.3.tar.gz	4.0 MB	Apr 2, 2022	Details

Release files / dash-tools-0.3.tar.gz

Download URL	dash-tools-0.3.tar.gz
Size	4.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`042f5044747c56a8640429c991d39460c6f325abd84e3b10d212ad3123e27292`
BLAKE2b-256 checksum How to use checksums	`a5597543ba2b99b4c056ed9361551ef25e4ce2d3fbbeaa85c76baa1e080af87b`
Upload date	Apr 2, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.0 CPython/3.7.8`