X-Git-Url: https://git.jsancho.org/?p=datasette-pytables.git;a=blobdiff_plain;f=README.md;h=0806c9b7269fe8035962feeb48956c4025cb08f0;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hb=ab111327f9822300ab1d8605ff86cfcebb78aeee;hpb=f09e9ea8de59e13702fcda7030e27904c5e89282 diff --git a/README.md b/README.md index e69de29..0806c9b 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,22 @@ +[![Build Status](https://travis-ci.org/PyTables/datasette-pytables.svg?branch=master)](https://travis-ci.org/PyTables/datasette-pytables) + + +# datasette-pytables + +Datasette-PyTables provides a web interface and a JSON API for [PyTables](https://github.com/PyTables/PyTables) files, allowing them to be accessible for e.g. Javascript programs. It works in conjunction with [Datasette](https://github.com/simonw/datasette), which provides a web interface for SQLite files. Thanks to [Datasette-Connectors](https://github.com/PyTables/datasette-connectors), Datasette can accept external connectors for any kind of database files, so you can develop your own connector for your favourite data container if you want (read [developers doc](https://github.com/PyTables/datasette-pytables/blob/master/DEVELOPERS.md)). + +## Installation + +Run `pip install datasette-pytables` to install both Datasette and the PyTables connector. Easy as pie! + +## How to serve PyTables files + + datasette serve path/to/data.h5 + +This will start a web server on port 8001; then you can access to your data visiting [http://localhost:8001/](http://localhost:8001/) + +Read the [Datasette documentation](http://datasette.readthedocs.io/en/latest/) for more advanced options. + +See how a typical Table query looks like in the Datasette-PyTables web interface: + +![Datasette Screenshot](/images/Datasette-Screenshot.png)