thoughtbot--shoulda-matchers/CONTRIBUTING.md

Contributing to shoulda-matchers

We love contributions from the community! Here's a quick guide to making a pull request.

1. If you haven't contributed before, please read and understand the Code of Conduct.

2. Ensure that you have a working Ruby environment.

3. Fork the repo on GitHub, then clone it to your machine.

4. Now that you've cloned the repo, navigate to it and install dependencies by running:

   bundle install

5. All tests should be passing, but it's a good idea to run them anyway before starting any work:

   bundle exec rake

6. If you're adding functionality or fixing a bug, you'll want to add a failing test for the issue first.

7. Now you can implement the feature or bugfix.

8. Since we only accept pull requests with passing tests, it's a good idea to run the tests again. Since you're probably working on a single file, you can run the tests for that file with the following command:

   bundle exec appraisal rspec

   You can find a list of valid Appraisals by running:

   bundle exec rake appraisal:list

   (If you're familiar with Zeus, you can also run unit tests by running zeus start in one shell, and then running the following in another:)

   zeus rspec

   In any case, to run the entire test suite again, say:

   bundle exec rake

9. Finally, push to your fork and submit a pull request.

At this point, you're waiting on us. We may suggest some changes to make to your code to fit within the project style, or discuss alternate ways of addressing the issue in question. When we're happy with everything, we'll bring your changes into master. Now you're a contributor!

Addendum: Setting up your environment

Installing Ruby

shoulda-matchers is only compatible with Ruby 2.x. A .ruby-version is included in the repo, so if you're using one of the Ruby version manager tools, then you should be using (or have been prompted to install) the latest version of Ruby. If not, you'll want to do that.

Linux-specific instructions

Debian/Ubuntu

Run this command to install necessary dependencies:

sudo apt-get install -y ruby-dev libpq-dev libsqlite3-dev nodejs

RedHat

Run this command to install necessary dependencies:

sudo yum install -y ruby-devel postgresql-devel sqlite-devel zlib-devel

Then, install one of the JavaScript runtimes supported by execjs. For instance, to install node.js:

sudo su
curl -sL https://rpm.nodesource.com/setup | bash -
yum install -y nodejs