Contents

# Contributing guide

## Installing daru development dependencies

To install dependencies, execute the following commands:

``` bash
sudo apt-get update -qq
sudo apt-get install libmagickwand-dev imagemagick
bundle install
```

And run the test suite (should be all green with pending tests):

  `bundle exec rspec`

While preparing your pull requests, don't forget to check your code with Rubocop:

  `bundle exec rubocop`

[Optional] Install all Ruby versions which Daru currently supports with `rake spec setup`.


## Basic Development Flow

1. Create a new branch with `git checkout -b <branch_name>`.
2. Make your changes. Write tests covering every case how your feature will be used. If creating new files for tests, refer to the 'Testing' section [below](#Testing).
3. Try out these changes with `rake pry`.
4. Run the test suite with `rake spec`. (Alternatively you can use `guard` as described [here](https://github.com/SciRuby/daru/blob/master/CONTRIBUTING.md#testing). Also run Rubocop coding style guidelines with `rake cop`.
5. Commit the changes with `git commit -am "briefly describe what you did"` and submit pull request.

[Optional] You can run rspec for all Ruby versions at once with `rake spec run all`. But remember to first have all Ruby versions installed with `ruby spec setup`.


## Testing

Daru has automatic testing with Guard. Just execute the following code before you start editting a file and any change you make will trigger the appropriate tests-

```
guard
```

**NOTE**: Please make sure that you place test for your file at the same level and with same itermediatary directories. For example if code file lies in `lib/xyz/abc.rb` then its corresponding test should lie in `spec/xyz/abc_spec.rb`. This is to ensure correct working of Guard.

## Daru internals

To get an overview of certain internals of daru and their implementation, go over [this blog post](http://v0dro.github.io/blog/2015/08/16/elaboration-on-certain-internals-of-daru/).

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
daru_lite-0.1.3	CONTRIBUTING.md
daru_lite-0.1.2	CONTRIBUTING.md
daru_lite-0.1.1	CONTRIBUTING.md
daru_lite-0.1	CONTRIBUTING.md