semvec/pypi-packages huggingface dataset:
phildb-client 0.1.0
PhilDB timeseries database client
License: BSD

PhilDBClient
============

The PhilDB timeseries database client aims to provide a
`PhilDB database API
<https://phildb.readthedocs.org/en/latest/api/phildb.html#module-phildb.database>`_
compatible object. At this stage mostly the read related methods have been implemented.
None of the write related methods have been implemented.
Any methods yet to be implemented in the client will raise a NotImplementedError if called.

Example usage
-------------

.. code::

    from phildb_client import PhilDBClient
    db = PhilDBClient('http://localhost:8889')

    db.ts_list()

Notes
-----
This client is experimental and depends on the experimental `PhilDB server
<https://github.com/amacd31/phildb_server>`_.
By default the client reads data from the server in the `msgpack
<https://msgpack.org>`_ format.
The data served by the server and read by the client is using the
`experimental Pandas msgpack implementation
<http://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.to_msgpack.html>`_,
as such it is dependant on the version of Pandas used by the server and the client being compatible.
There is a known issue with Pandas < v0.17 (which has been made a dependency for the server),
the client however can use an older version of Pandas and use JSON as the transport format instead of msgpack if required.
For example:
.. code::

    from phildb_client import PhilDBClient
    db = PhilDBClient('http://localhost:8889', 'json')
phildb-server 0.1.0
PhilDB timeseries database server
License: BSD

PhilDB Server
=============

|PYPI Version| |PYPI Python versions| |PYPI License|

PhilDB server, for HTTP access to a `PhilDB
<https://github.com/amacd31/phildb>`_ instance.

Dependencies
------------

Requires Python 2.7 or Python 3.4 or greater.

Installation
------------

PhilDB server is pip installable.

The latest stable version can be installed from pypi with::

    pip install phildb-server

The latest development version can be installed from github with::

    pip install git+https://github.com/amacd31/phildb_server.git@dev

Usage
=====

Start a PhilDB using a specified PhilDB instance:

::

    phildb-server phildb_directory

List help options:

::

    phildb-server --help

.. |PYPI Version| image:: https://img.shields.io/pypi/v/phildb-server.svg
    :target: https://pypi.python.org/pypi/PhilDB

.. |PYPI Python versions| image:: https://img.shields.io/pypi/pyversions/phildb-server.svg
    :target: https://pypi.python.org/pypi/PhilDB-Server

.. |PYPI License| image:: https://img.shields.io/pypi/l/phildb-server.svg
    :target: https://github.com/amacd31/phildb-server/blob/master/LICENSE