    .---. .-..-..-.,-. .--.
    : .; `: :; :`.  .'`._-.'
    : ._.'`._. ;:_,._;`.__.'
    : :    .-. :
    :_;    `._.'       0.4.2-dev

    -- XenStore access the Python way!

# What is `pyxs`?

It’s a pure Python XenStore client implementation, which covers all of the `libxs` features and adds some nice Pythonic sugar on top. Here’s a shortlist:

- `pyxs` supports both Python 2 and 3,

- works over a Unix socket or XenBus,

- has a clean and well-documented API,

- is written in easy to understand Python,

- can be used with gevent or eventlet.

# Installation

If you have pip you can do the usual:

    pip install --user pyxs

Otherwise, download the source from GitHub and run:

    python setup.py install

Fedora users can install the package from the system repository:

    dnf install python2-pyxs
    dnf install python3-pyxs

RHEL/CentOS users can install the package from the EPEL repository:

    yum install python2-pyxs
    yum install python34-pyxs

# Show me the code!

Head over to our brief Tutorial or, if you’re feeling brave, dive right into the API reference; `pyxs` also has a couple of examples in the examples directory.