Metadata-Version: 2.4
Name: cradox
Version: 2.1.0
Summary: Python libraries for the Ceph librados library with use cython instead of ctypes
Home-page: https://github.com/sileht/pycradox
Author: Mehdi Abaakouk
Author-email: sileht@sileht.net
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
License-File: LICENSE
License-File: AUTHORS
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: home-page
Dynamic: license-file
Dynamic: summary

======
cradox
======

.. image:: https://travis-ci.org/sileht/pycradox.png?branch=master
   :target: https://travis-ci.org/sileht/pycradox

.. image:: https://img.shields.io/pypi/v/cradox.svg
   :target: https://pypi.python.org/pypi/cradox/
   :alt: Latest Version

.. image:: https://img.shields.io/pypi/dm/cradox.svg
   :target: https://pypi.python.org/pypi/cradox/
   :alt: Downloads

/!\ DON'T USE IT, but use upstream python-rados, except you really can't /!\

Python libraries for the Ceph librados library with use cython instead of ctypes

This a standalone library initially comes from this Ceph PR https://github.com/ceph/ceph/pull/7621

But can be built against older version of Ceph from 10.2.X (jewel) to latest.

(For older version use cradox< 2.0)

This is designed for application that want to use a recent python-rados API without upgrading
the whole ceph cluster.

Rados C handles provided by this library can't be used with the ceph rbd.py or librbdpy.

The API of this python lib will be keep in sync with the upstream Ceph rados.py API.

* Free software: LGPL 2.1
* Documentation: http://docs.ceph.com/docs/master/rados/api/python/
* Source: http://github.com/sileht/pycradox


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

Pre-requires::

    $ sudo apt-get install cython librados2 librados-dev

Then, at the command line::

    $ pip install cradox

Or, if you have virtualenvwrapper installed::

    $ mkvirtualenv cradox
    $ pip install cradox

Usage
-----

::

  import cradox as rados


Functionnal Tests
-----------------

Ceph packages must be installed, the suite create a temporary Ceph
cluster run the tests and destroy it.

::

    tox

