semvec/pypi-packages huggingface dataset:
pycerebro 0.8.3.1
Python client for the Cerebro Data Access Service
License: Apache License, Version 2.0

pycerebro
=========

Python client for RecordService implementations.

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

Required:

-  Python 3.4+

-  ``six``, ``bit_array``, ``thriftpy >=0.3.9``

.. code:: shell

    pip3 install six bit_array 'thriftpy>=0.3.9'

Optional:

-  ``pandas`` for conversion to ``DataFrame`` objects

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

.. code:: shell

    pip3 install pycerebro

To verify:

.. code:: python

    >>> import cerebro.cdas
    >>> cerebro.cdas.version()
    '0.8.0-beta3'

Usage
~~~~~

.. code:: python

    from cerebro import context
    ctx = context()
    with ctx.connect(host='localhost', port=12050) as conn:
        conn.list_databases()
        pd = conn.scan_as_pandas("cerebro_sample.sample")
        pd

To enable a connection to a server with token-authentication:

.. code:: python

    from cerebro import context
    ctx = context()
    ctx.enable_token_auth(token_str='my-token')
    with ctx.connect(host='localhost', port=12050) as conn:
        conn.list_databases()

To enable a connection to a server with kerberos-authentication:

.. code:: python

    from cerebro import context
    ctx = context()
    # Connecting to server principal 'cerebro/service@REALM'
    ctx.enable_kerberos('cerebro', host_override='service')
    with ctx.connect(host='localhost', port=12050) as conn:
        conn.list_databases()