Skip to content

Latest commit

 

History

History
40 lines (24 loc) · 4.36 KB

README.md

File metadata and controls

40 lines (24 loc) · 4.36 KB

doyouspeakOCCI

doyouspeakOCCI is a Google App Engine (GAE)-based checking tool for the Open Cloud Computing Interface (OCCI) family of specifications. More specifically, it provides a full compliance test suite for the OCCI Core (GFD.183), OCCI Infrastructure (GFD.184), and OCCI RESTful HTTP Rendering (GFD.185) specifications.

doyouspeakOCCI is written in Python and heavily building on the GAE services, mainly Task Queue, URL Fetch, and the webapp Framework.

Note that doyouspeakOCCI is not to be considered the "official" testing suite for OCCI endorsed by the Open Grid Forum, but rather than that, a third-party contribution which aims to be as close as possible. For a more thorough explanation, please take a look at the wiki pages.

How to use

doyouspeakOCCI was hard to implement, but is simple to use. Just point your browser to http://doyouspeakocci.appspot.com, enter the base URL of your OCCI implementation, and press "Go!".

Optionally, you can provide credentials for HTTP basic auth, if your service is secured. We strongly recommend to use a one-time test account; although we promise to use the credentials only for the compliance test, we cannot guarantee what others on the way (especially GAE) will do with them.

Please note that doyouspeakOCCI records data on every test run in the GAE DataStore. This is done solely for the sake of displaying usage statistics. Within the limitations of applicable jurisdiction and the GAE Terms of Service, we will not disclose this data to anyone beyond what is being displayed on the doyouspeakOCCI web presence.

For other questions, please also take a look at the FAQ.

Where to get

doyouspeakOCCI is available as a source code release only, which can be obtained by two ways:

Alternatively, you might want to pick one of the advertised downloads (click on the "Downloads" button in the upper right of the doyouspeakOCCI home at GitHub.

If you wish to run the service on your local system for testing purposes, please take a look at the doyouspeakOCCI Installation Guide for a detailed explanation on how to setup the environment.

Contributing

doyouspeakOCCI aims to be a community effort, and help is always welcome. Please contact us on the mailing lists to learn more.

License

We think that doyouspeakOCCI should be available to everyone with the upmost amount of freedom. To make sure that contributions to doyouspeakOCCI itself remain perpetually free, the code has been developed under the GNU General Public License, Version 3. The documentation coming with doyouspeakocci is available under a Creative Commons Attribution Share-Alike 3.0 License.

Issues

If you think that you have discovered a bug in doyouspeakOCCI, or you would like to see an additional feature in the future, please use the doyouspeakOCCI GitHub Tracker to submit an issue.

Patches

You are welcome to contribute code for any kind of recorded issue. However, patches via email are not accepted. Rather than that, please fork our repository, commit the patch, and send us a pull request —we will then have a look at it. Remember to add a link to the issue you aim to fix.