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].

1. Ensure that you have a [working Ruby environment].

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

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

      bundle install

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

      bundle exec rake

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

1. Now you can implement the feature or bugfix.

1. 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 <Appraisal name> rspec <path of test file to run>

   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 <path of test file to run>

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

      bundle exec rake

1. 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.

[working Ruby environment]: #addendum-setting-up-your-environment
[Code of Conduct]: https://thoughtbot.com/open-source-code-of-conduct
[execjs]: https://github.com/sstephenson/execjs

### 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
```