x/python-redfish
Code Issues Proposed changes
Python library and client for Redfish support
117 Commits 1 Branch 8 Tags 18 MiB
HTML 88.1%
Python 9%
ApacheConf 1.8%
Shell 0.6%
RPM Spec 0.3%
c34d85fbc5
Go to file
Uggla c34d85fbc5 Documentation update 
- Put in place sphinx mechanism to build documentation.
  Most of the documentation is generated from python docstrings.
- redfish-client.py usage is a bit modified to display a decent
  documentation.
- A link rfclient.py to redfish-client.py was created to allow sphinx
  parsing. The '-' char is not allowed for module and so sphinx autodoc
  module.
- Note : Copyright may need to be reviewed as well as main.py.
2016-02-11 16:20:00 +01:00
dmtf Improve docker container management 2016-01-18 16:36:23 +01:00
doc Documentation update 2016-02-11 16:20:00 +01:00
examples Improve error management 2016-01-02 11:33:58 +01:00
pbconf Fix deb package build dependencies 2016-01-22 01:52:13 +01:00
redfish Documentation update 2016-02-11 16:20:00 +01:00
redfish-client Documentation update 2016-02-11 16:20:00 +01:00
.coveragerc cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
.gitattributes Added Attributes 2015-03-23 12:05:45 -05:00
.gitignore Project-Builder support for python-redfish 2016-01-18 16:50:55 +01:00
.gitreview cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
.mailmap cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
.testr.conf cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
babel.cfg cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
CONTRIBUTING.rst cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
HACKING.rst cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
LICENSE Add LICENCE file. 2015-12-02 20:54:51 +01:00
MANIFEST.in cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
openstack-common.conf cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
README.rst Documentation update 2016-02-11 16:20:00 +01:00
requirements.txt Documentation update 2016-02-11 16:20:00 +01:00
setup.cfg First working 0.1 version 2015-12-02 20:33:03 +01:00
setup.py cookie cutter ify this repo, will clean up later 2015-03-25 13:46:58 -07:00
test-requirements.txt First working 0.1 version 2015-12-02 20:33:03 +01:00
tox.ini improve tox.ini with OS conventions 2015-03-28 21:54:23 -07:00

README.rst

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.

Developer setup

To initialize a local development environment (eg, so you can run unit tests) you should run the following commands

Contacts

Distribution list : python-redfish@mondorescue.org

Further References

The data model documentation can be found here:

http://www.redfishspecification.org/redfish-data-model-and-schema/

The overall protocol documentation can be found here:

http://www.redfishspecification.org/