magic-dash 0.5.0rc6

A command-line tool for quickly generating standard Dash application projects.

magic-dash

magic-dash是面向Dash应用开发的命令行脚手架，用于快速生成可运行、可扩展的Python数据应用项目。它内置单页面工具、多页面持续扩展应用和支持复杂用户与部门关系的管理系统模板，覆盖路由、菜单、配置、回调组织、状态页、数据库模型、用户登录、管理与鉴权等常见工程起点。

1 快速开始

安装&更新

• 最新正式版本

pip install magic-dash -U

• 最新预发布版本

pip install magic-dash -U --pre

查看当前安装版本：

magic-dash --version

查看内置模板项目列表

magic-dash list

当前可直接创建的内置模板包括：

• simple-tool
• magic-dash
• magic-dash-pro

以magic-dash模板为例创建项目

magic-dash create --name magic-dash --backend fastapi

等价的简写形式为：

magic-dash create -n magic-dash -b fastapi

也可以省略--backend或-b，通过交互式菜单选择后端类型。随后命令会继续提示输入项目名称，直接回车时，默认生成名为magic-dash的项目目录。

进入已创建项目，安装依赖并启动应用

cd magic-dash
pip install -r requirements.txt
python app.py

默认访问地址：

http://127.0.0.1:8050

更多命令细节见CLI命令说明。

内置模板公共静态资源

magic-dash-pro相关模板共用的登录页视频和背景图片由包内public_assets统一维护。通过magic-dash create创建magic-dash-pro项目时，CLI会自动把这些资源复制到生成项目的assets/目录。

源码开发时，可使用以下命令同步或清理内置模板目录下的公共静态资源副本：

magic-dash init-assets
magic-dash remove-assets

2 内置模板列表

模板	适用场景	子文档入口
simple-tool	单页面数据工具、计算器、内部小工具原型	项目创建 / 二次开发指南
magic-dash	适用于多页面、持续扩展的Dash应用，内置侧边菜单、路由、状态页和页面组织规范	项目创建 / 配置参数 / 二次开发指南
magic-dash-pro	适用于多页面、持续扩展的管理型Dash应用，支持复杂用户与部门关系、用户名密码、邮件验证码及OTP动态口令登录、管理和鉴权能力	项目创建 / 配置参数 / 二次开发指南

3 反馈和社区

• GitHub仓库：HogaStack/magic-dash
• 问题反馈：GitHub Issues
• PyPI发布页：magic-dash
• 作者邮箱：[e-mail]

微信公众号
_{关注项目动态与实用教程}

知识星球
_{加入社区交流与答疑}

许可证

本项目基于MIT License开源。