python-redfish
==============

This repository will be used to house the Redfish python library, a reference
implementation to enable Python developers to communicate with the Redfish API
(http://www.dmtf.org/standards/redfish).

NOTE::

    DRAFT - WORK IN PROGRESS

    The current Redfish specification revision is 1.0.0 - Note that the mockup 
    is still at version 0.99.0a and may not reflect what the standard provides 
    fully


Project Structure
-------------------

This project follows the same convention as OpenStack projects, eg. using pbr
for build and test automation::

    doc/            # documentation
    doc/source      # the doc source files live here
    doc/build/html  # output of building any docs will go here
    dmtf            # Reference documents and mockup provided by the DMTF
    examples/       # any sample code using this library, eg. for education
                    # should be put here
    redfish/        # the redfish library
    redfish/tests/  # python unit test suite

Requirements
------------

To use the enclosed examples, you will need Python 2.7
(https://www.python.org/downloads/).  Note that Python 2.7.9 enforces greater
SSL verification requiring server certificates be installed. Parameters to
relax the requirements are available in the library, but these configurations
are discouraged due to security.

Python requirements are listed in requirements.txt; additional requirements for
running the unit test suite are listed in test-requirements.txt.

Get the sources
---------------

The sources are available on github and can be retrieve using::

    git clone https://github.com/uggla/python-redfish

As python redefish is currently in heavy development we recommend to checkout the devel branch using::

    cd python-redfish
    git checkout devel

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

Please refer to the following link.

http://pythonhosted.org/python-redfish/installation.html

Contacts
--------

Distribution list: python-redfish@mondorescue.org

Further References
------------------

The specification can be found here :
 http://www.dmtf.org/sites/default/files/standards/documents/DSP0266_1.0.1.pdf

The data model documentation can be found here:
 http://redfish.dmtf.org/schemas/

The overall protocol documentation can be found here:
 http://www.dmtf.org/standards/redfish