S3 ninja

S3 ninja emulates the S3 API for development and testing purposes.

Download Contribute
Screenshot
Install
  1. Download the release as ZIP file.
  2. Unzip into your favorite directory.
  3. To change the configuration create a file instance.conf in the root directory and adapt the settings. Most of the configuration can be found in app/application.conf - Do not modify this file, as it will be overridden with the next patch.
  4. Install Java 8 JRE (if not present yet)
  5. Start the ninja using sirius.sh start (on any UNIX platform with java in the PATH) or java IPL to start it manually
  6. Navigate to http://localhost:9444 - or the port you set with http.port in the config.
  7. Run S3 API-Calls against http://localhost:9444/s3 (e.g. http://localhost:9444/s3/test-bucket/test-object)
  8. Use sirius.sh stop or java -Dkill=true -Dport=9191 IPL to terminate the server
API
Currently the ninja supports only object methods: GET, PUT, HEAD, DELETE. ACLs are also ignored but for non-public buckets, the given Authorization hash is verified using the credentials shown on the page.
Contribute
Contributions are welcome - the source code is available on GitHub: https://github.com/scireum/s3ninja
License
The MIT License (MIT)

Copyright (c) 2015 scireum GmbH

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
            

S3 ninja is made with all the love in the world by scireum in Remshalden
F**k me on GitHub