lightning-python 1.2.1

[](https://travis-ci.org/lightning-viz/lightning-python)
[](https://gitter.im/lightning-viz/lightning?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)


Lightning Python客户端
================

lightning API的Python客户端

## 安装
使用以下方式安装

```
pip install lightning-python
```
兼容Python 2.7和3.4。

## 使用

### 创建会话

```python
from lightning import Lightning

lgn = Lightning(host="http://my-lightning-instance.herokuapp.com")

lgn.create_session()
lgn.create_session("提供一个可选的会话名称")
```

### 创建可视化
Lightning自带默认可视化类型的方法可用
```python
lgn.line([1,2,3,4,5,6,7,8,0,-2,2])
lgn.scatter([1,2,3],[2,9,4])
```

### 设置选项
可以通过可选参数自定义可视化
```python
lgn.scatter([1,2,3],[2,9,4], label=[1,2,3], size=[5,10,20])
```
### 使用自定义图表
对于默认集合中未包含的自定义图表，请指定名称并提供数据字典
```python
lgn.plot(data={"series": [1,2,3]}, type='line')
```

## 示例

请参阅[IPython notebooks](http://nbviewer.ipython.org/github/lightning-viz/lightning-example-notebooks/tree/master/)集合。

## 完整文档

可在[此处](http://lightning-viz.github.io/lightning-python/)找到。

## 运行测试

需要[pytest](https://pytest.cn/latest/)

克隆存储库并在本地安装库

```sh
$ pip install -e .
```

测试需要在Lightning服务器上运行。默认情况下，它们期望
此内容可在 `https://:3000` 中找到。

要运行测试

```
$ py.test
```

或者使用自定义主机 URL


```
$ py.test --host=http://mylightninghost.herokuapp.com
```

## 帮助

我们在 gitter 上维护了一个 [聊天室](https://gitter.im/lightning-viz/lightning)。如果那里没有回应：提交问题或在推特上联系（[@mathisonian](http://twitter.com/matisonian)，[@thefreemanlab](http://twitter.com/thefreemanlab)）