2012-12-06 13:20:56 +00:00
|
|
|
# Contributing to CarrierWave
|
|
|
|
|
2013-05-30 15:39:35 +00:00
|
|
|
CarrierWave thrives on a large number of [contributors](https://github.com/carrierwaveuploader/carrierwave/contributors),
|
2012-12-06 13:20:56 +00:00
|
|
|
and pull requests are very welcome. Before submitting a pull request, please make sure that your changes are well tested.
|
|
|
|
|
2015-04-02 21:42:37 +00:00
|
|
|
First, make sure you have `imagemagick` and `ghostscript` installed. You may need `libmagic` as well.
|
2012-12-06 13:20:56 +00:00
|
|
|
|
|
|
|
Then, you'll need to install bundler and the gem dependencies:
|
|
|
|
|
2013-07-18 07:19:36 +00:00
|
|
|
`gem install bundler && bundle install`
|
2012-12-06 13:20:56 +00:00
|
|
|
|
|
|
|
You should now be able to run the local tests:
|
|
|
|
|
2013-07-21 12:11:23 +00:00
|
|
|
`bundle exec rake`
|
2012-12-06 13:20:56 +00:00
|
|
|
|
|
|
|
You can also run the remote specs by creating a ~/.fog file:
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
:carrierwave:
|
|
|
|
:aws_access_key_id: xxx
|
|
|
|
:aws_secret_access_key: yyy
|
|
|
|
:rackspace_username: xxx
|
|
|
|
:rackspace_api_key: yyy
|
|
|
|
:google_storage_access_key_id: xxx
|
|
|
|
:google_storage_secret_access_key: yyy
|
|
|
|
```
|
|
|
|
|
|
|
|
You should now be able to run the remote tests:
|
|
|
|
|
2013-04-13 22:47:50 +00:00
|
|
|
REMOTE=true bundle exec rake
|
2012-12-06 13:20:56 +00:00
|
|
|
|
2015-12-14 13:17:05 +00:00
|
|
|
Please test with the latest Ruby 2.2.x version using RVM if possible.
|