README.md in fakes3-0.2.4 vs README.md in fakes3-0.2.5

- old
+ new

@@ -1,62 +1,34 @@ ## Introduction -FakeS3 is a lightweight server that responds to the same calls Amazon S3 responds to. -It is extremely useful for testing of S3 in a sandbox environment without actually -making calls to Amazon, which not only require network, but also cost you precious dollars. +Fake S3 is a lightweight server that responds to the same API of Amazon S3. + +It is extremely useful for testing of S3 in a sandbox environment without actually making calls to Amazon, which not only requires a network connection, but also costs money with every use. + The goal of Fake S3 is to minimize runtime dependencies and be more of a -development tool to test S3 calls in your code rather than a production server -looking to duplicate S3 functionality. Trying RiakCS, ParkPlace/Boardwalk, or -Ceph might be a place to start if that is your goal. +development tool to test S3 calls in your code rather than a production server looking to duplicate S3 functionality. -FakeS3 doesn't support all of the S3 command set, but the basic ones like put, get, -list, copy, and make bucket are supported. More coming soon. +Many commands are supported, including put, get, list, copy, and make bucket. ## Installation gem install fakes3 ## Running -To run a fakes3 server, you just specify a root and a port. +To run the server, you just specify a root and a port. fakes3 -r /mnt/fakes3_root -p 4567 -## Connecting to FakeS3 +## Connecting to Fake S3 -Take a look at the test cases to see client example usage. For now, FakeS3 is +Take a look at the test cases to see client example usage. For now, Fake S3 is mainly tested with s3cmd, aws-s3 gem, and right_aws. There are plenty more libraries out there, and please do mention if other clients work or not. Here is a running list of [supported clients](https://github.com/jubos/fake-s3/wiki/Supported-Clients "Supported Clients") -## Running Tests +## Contributing -There are some pre-requesites to actually being able to run the unit/integration tests +Contributions in the form of pull requests, bug reports, documentation, or anything else are welcome! Please read the CONTRIBUTING.md file for more info: -### On OSX - -Edit your /etc/hosts and add the following line: - - 127.0.0.1 posttest.localhost - -Then ensure that the following packages are installed (boto, s3cmd) - - > pip install boto - > brew install s3cmd - - -Start the test server using - - rake test_server - -Then in another terminal window run - - rake test - -It is a still a TODO to get this to be just one command - -## More Information - -Check out the [wiki](https://github.com/jubos/fake-s3/wiki) - -[![Join the chat at https://gitter.im/jubos/fake-s3](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/jubos/fake-s3?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) +(https://github.com/jubos/fake-s3/CONTRIBUTING.md)[https://github.com/jubos/fake-s3/CONTRIBUTING.md]