Tools for evaluating s3 compatibility
Switch branches/tags
Nothing to show
Clone or download
Latest commit 6ee11c3 Sep 1, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Use nose.loader to probe for tests Nov 23, 2016
ceph-tests @ b5e7295 Up-rev ceph/s3tests Sep 1, 2017
config Initial commit Sep 21, 2015
data Add support for custom test attributes Oct 19, 2015
output Initial commit Sep 21, 2015
.gitignore Initial commit Sep 21, 2015
.gitmodules Initial commit Sep 21, 2015 Initial commit Sep 21, 2015 Update Nov 25, 2015
requirements.txt Manage ceph/s3-tests requirements from s3compat Feb 24, 2017


s3compat is a project to gather useful ways of measuring the level of S3 compatability provided by the OpenStack Swift object store (primarily through the Swift3[1] middleware). It is intended to wrap around other test suites and provide information and tools for executing these suites, reporting on the results, and tracking progress toward the goal of full(er) S3 compatibility.

At present it is centered around the ceph-s3 tests, but we will add other test suites based around real use cases at a later date.


This instructions are based on Ubuntu 14.04 LTS

  1. Install virtualenv and create one for this project. [Not strictly necessary, but recommended]
  2. Update git submodules
git submodule update --init
  1. Install package-based dependencies through your package manager, e.g.:
sudo apt-get install libyaml-dev libevent-dev
  1. Install python dependencies:
pip install -r requirements.txt
pip install -r ceph-tests/requirements.txt
  1. Create a configuration file
cp config/ceph-s3.cfg.SAMPLE config/ceph-s3.cfg
  1. Edit values for the Swift cluster and users to suit the Swift cluster you are using


To run the ceph-s3 tests, run


The xml output file will be placed in "./output/ceph-s3.out.xml".


Generate test attributes file:


The yaml test attributes will be stored in output/ceph-s3.out.yaml

Generate detailed report:

./bin/ -d output/ceph-s3.out.yaml -df console output/ceph-s3.out.xml

Generate report with mediawiki formatted table:

./bin/ -d output/ceph-s3.out.yaml -df wiki output/ceph-s3.out.xml

Generate detailed report with custom attributes:

./bin/ -d output/ceph-s3.out.yaml -df console output/ceph-s3.out.xml -c data/classification_sample.yaml

A sample custom attribute file is provided, classifying ceph-s3 tests into categories.