一个简单的django仪表板应用程序,可以可视化关于您的项目的有趣数据。
django-dashing的Python项目详细描述
django dashing是一个可定制的模块化仪表板应用程序框架,用于django可视化有关项目的有趣数据。灵感来源于超赞的仪表板框架Dashing
查看here上的演示。
先决条件
- Django 1.5.+
- Django压缩机(可选)
关键概念
- 使用预先制作的小部件,或者使用css、html和javascript完全创建自己的小部件。
- 使用api将数据推送到仪表板。
- 用于重新排列小部件的拖放界面。
安装
- 从pypi安装最新稳定版本:
$ pip install django-dashing
- 将破折号添加到项目的INSTALLED_APPS。
INSTALLED_APPS=(...'dashing',)
- 在项目url.py中包含仪表板urlconf,如下所示:
fromdashing.utilsimportrouter...url(r'^dashboard/',include(router.urls)),
- 启动开发服务器并访问http://127.0.0.1:8000/dashboard/ 查看虚拟仪表板。
快速启动
要制作自己的仪表板并从django检索数据,您应该:
- 使用widgets.py文件创建django仪表板应用程序
- 创建扩展自numberwidget、listwidget、graphwidget或简单的widget(来自dashing.widgets)的小部件,例如see。
- 在url.py中注册小部件,例如:
fromdjango.conf.urlsimporturl,includefromdashing.utilsimportrouterfromproject.dashboard.widgetsimportCustomWidgetrouter.register(CustomWidget,'custom_widget')urlpatterns=[url(r'^dashboard/',include(router.urls)),]
创建一个dashing-config.js文件,其中包含一个小部件,用于检索静态目录中的数据,如:
varmyDashboard=newDashboard();myDashboard.addWidget('customWidget','Number',{getData:function(){varself=this;Dashing.utils.get('custom_widget',function(data){$.extend(self.scope,data);});},interval:3000});
另外,如果您想在另一个目录中找到配置文件,您可以在template dirs中创建一个dashing/dashboard.html文件,并替换config\$file块到javascript配置文件的路由,请参阅docs。
测试
安装依赖项。
$ npm install $ pip install -r requirements.txt
运行测试。
$ npm test