hdf rest服务器
h5serv的Python项目详细描述
简介
h5serv是为hdf5数据存储实现基于rest的web服务的web服务。 如文中所述:http://hdfgroup.org/pubs/papers/RESTful_HDF5.pdf。
网站
快速安装
安装python(2.7或更高版本)和以下软件包:
- numpy 1.10.4或更高版本
- H5PY 2.5或更高版本
- 龙卷风4.0.2或更高版本
- 看门狗0.8.3或更高版本
- 请求2.3或更高版本(用于客户测试)
克隆hdf5 json项目:git clone https://github.com/HDFGroup/hdf5-json.git。 接下来,cd到hdf5 json文件夹并运行:python setup.py install。
克隆此项目:git clone https://github.com/HDFGroup/h5serv.git。
运行服务器
启动服务器:cd h5serv/server; python app.py。
默认情况下,服务器将监听端口5000。端口和其他几个默认值可以修改 使用命令行选项。例如,要使用端口8888,请运行:python app.py --port=8888。
有关与服务器交互的示例,请参见测试用例。从测试目录运行:python testall.py。 运行整个测试套件。
此外,还可以在浏览器中浏览接口(至少是读取请求)。转到:http://127.0.0.1:5000/。 json浏览器插件将有助于格式化来自服务器的响应,使其更具可读性。
请参阅h5serv/docs/installation.rst以了解分步安装说明。
与Docker一起运行
要将h5serv作为docker容器运行,只需安装docker(不需要python、h5py等)。
- 安装docker:https://docs.docker.com/installation/#installation。
- 运行h5serv映像:docker run -p 5000:5000 -d-v<mydata>:/data hdfgroup/h5serv,其中<;mydata>;是包含您希望通过h5serv rest api提供的任何hdf5文件的文件夹路径。因为对服务器的请求可以修改(或删除!)内容,您可能需要创建一个新文件夹并将文件复制到其中。
- 转到浏览器中的http://192.168.99.100:5000/以验证服务器是否已启动并正在运行(用运行容器的系统或虚拟机的IP地址替换192.168.99.100)。
编写客户端应用程序
作为rest服务,客户机几乎可以使用任何编程语言进行开发。这个 h5serv/test/integ下的测试程序说明了一些peforming方法 使用python的不同操作。
相关项目:https://github.com/HDFGroup/h5pyd提供了(主要)h5py兼容 python客户机的服务器接口。
卸载
h5serv不会修改它所在目录之外的系统中的任何内容 已安装,因此只需删除安装目录和所有要卸载的内容。
报告错误(和一般反馈)
在http://github.com/HDFGroup/h5serv/issues为您发现的任何问题创建新问题。
对于一般问题/反馈,请使用列表(hdf-forum@lists.hdfgroup.org)。