Add test cases

kinegratii · kinegratii · commit 9f26e89c7878 · 2017-11-28T16:37:43.000+08:00
diff --git a/changelog.md b/changelog.md
@@ -9,10 +9,9 @@
 
 * ### version 0.3.0 (dev)
     * 图表`render` 方法增加 `template_name` 、`object_name`、`extra_context` 等参数，全面支持自定义模板
-    * 重写底层逻辑，支持在模板文件中使用 `echarts_*` 系列模板函数，`render_embed` 方法不再推荐使用
+    * 重写底层逻辑，支持在模板文件中使用 `echarts_*` 系列模板函数
     * js 依赖文件支持外部链接方式引入。
     * 新增统一配置函数 `pyecharts.configure` ，支持设置模板目录，JS文件仓库路径。
-    * `pyecharts.online` 全局函数不再推荐使用
     * `pyecharts.custom.Page` 类实现 `list` 协议，支持迭代、索引、添加、扩展等操作。
     * 图表 width 和 height 支持 '50%' 、'78px' 等其他 css 有效长度形式。
     * [issue#252](https://github.com/chenjiandongx/pyecharts/issues/252) 新增 `xaxis_label_textsize`, `xaxis_label_textcolor`, `yaxis_label_textsize`, `yaxis_label_textcolor` 四个参数修改坐标轴标签的字体和颜色
@@ -48,7 +47,7 @@
 
     #### Changed
     * 将 label 通用配置项的 `is_emphasis` 参数更改为 `is_label_emphasis`
-	* show_config() 修改用 JSON 显示
+    * show_config() 修改用 JSON 显示
 
     #### Fixed
     * [issue#195](https://github.com/chenjiandongx/pyecharts/issues/195) 修复 HeatMap 图配置 x、y 轴属性无效的问题
@@ -152,8 +151,8 @@
 
     #### Added
     * 为 xyAxis 模块新增下列参数
-     `xaxis_interval`, `xaxis_name_size`, `xaxis_name_gap`, `xaxis_margin`, `is_xaxislabel_align`
-     `yaxis_interval`, `yaxis_name_size`, `yaxis_name_gap`, `yaxis_margin`, `is_yaxislabel_align`
+       `xaxis_interval`, `xaxis_name_size`, `xaxis_name_gap`, `xaxis_margin`, `is_xaxislabel_align`
+        `yaxis_interval`, `yaxis_name_size`, `yaxis_name_gap`, `yaxis_margin`, `is_yaxislabel_align`
     * [issue#86](https://github.com/chenjiandongx/pyecharts/issues/86) 为 3D 图新增参数用于配置坐标轴选项（参见通用配置项中的 axis3D）
     * 修改自定义模块的接口，现自定义模块有以下 4 个类，具体用法参见文档
         * Grid 类：并行显示多张图
diff --git a/docs/zh-cn/doc_flask.md b/docs/zh-cn/doc_flask.md
@@ -124,13 +124,14 @@ $ flask run
 
 自 V0.3.0 起， pyecharts 支持在 Flask 使用 `echarts_*` 系列模板函数。
 
-### 第一步：实现 Flask 应用的自定义模板引擎
+### Step 0：实现 Flask 应用的自定义模板引擎
 
 主要有三个要点：
 
 - 创建一个继承自 `flask.templating.Environment` 的模板引擎类`FlaskEchartsEnvironment` 。
 - 通过使用 `pyecharts.engine.PyEchartsConfigMixin` 提供一个配置对象 。
 - 在构造函数 `__init__` 中添加模板函数到全局字典中。
+- 在自己的 Flask 应用类中指定 `FlaskEchartsEnvironment` 为默认模板引擎。
 
 ```python
 from flask import Flask, render_template
@@ -154,9 +155,34 @@ class MyFlask(Flask):
 
 
 app = MyFlask(__name__)
+
+@app.route("/")
+def hello():
+    hm = create_heatmap()
+    return render_template('flask_tpl.html', hm=hm)
+
+
+def create_heatmap():
+    begin = datetime.date(2017, 1, 1)
+    end = datetime.date(2017, 12, 31)
+    data = [[str(begin + datetime.timedelta(days=i)),
+             random.randint(1000, 25000)] for i in
+            range((end - begin).days + 1)]
+    heatmap = HeatMap("日历热力图示例", "某人 2017 年微信步数情况", width=1100)
+    heatmap.add("", data, is_calendar_heatmap=True,
+                visual_text_color='#000', visual_range_text=['', ''],
+                visual_range=[1000, 25000], calendar_cell_size=['auto', 30],
+                is_visualmap=True, calendar_date_range="2017",
+                visual_orient="horizontal", visual_pos="center",
+                visual_top="80%", is_piecewise=True)
+    return heatmap
+
+app.run(port=10200)
 ```
 
-### 第二步：创建模板文件
+**注意的是：视图函数中 `render_template` 传给模板的是图表实例 hm ，而不再是其若干个属性，这是和第一种方式最大的区别之一。**
+
+### Step 1：创建模板文件
 
 在同目录下 templates 文件夹创建 flask_demo.html 文件写入如下的代码。
 
@@ -185,4 +211,8 @@ app = MyFlask(__name__)
 使用外链形式优点在于：
 
 - 减少最后生成文件大小
-- 更容易与 web 框架整合，便于大型项目开发
+- 更容易与 web 框架整合，便于大型项目开发
+
+### Step 2: 运行
+
+之后脚本运行步骤同第一种方式。
diff --git a/test/test_conf.py b/test/test_conf.py
@@ -18,6 +18,7 @@ def test_with_default_value():
     eq_(SCRIPT_LOCAL_JSHOST, target_config.jshost)
     eq_(SCRIPT_LOCAL_JSHOST, target_config.get_current_jshost_for_script())
     eq_(JUPYTER_LOCAL_JSHOST, target_config.get_current_jshost_for_jupyter())
+    eq_('http://demo', target_config.get_current_jshost_for_script('http://demo'))
 
     assert target_config.js_embed
 
diff --git a/test/test_template_function.py b/test/test_template_function.py
@@ -1,8 +1,11 @@
 # coding=utf8
+import unittest
+
+from nose.tools import raises
 
 from pyecharts.utils import get_resource_dir
 from pyecharts import Bar
-from pyecharts.engine import EchartsEnvironment
+from pyecharts.engine import BaseEnvironment, EchartsEnvironment
 
 ECHARTS_ENV = EchartsEnvironment()
 
@@ -73,3 +76,8 @@ def test_echarts_js_content_wrap():
     bar = create_demo_bar()
     html = tpl.render(bar=bar)
     assert len(html) > 0
+
+
+@raises(TypeError)
+def test_create_environment_without_config():
+    be = BaseEnvironment()
