Sha256: 73e69dd855dc0cd122ef0cf115c327f8c3604d43de9581d681822c28c55440bb

Contents?: true

Size: 1.5 KB

Versions: 19

Compression:

Stored size: 1.5 KB

Contents

# Contributing

## Developing

If you'd like to submit a patch:

1. Fork the project.
2. Make your feature addition or bug fix.
3. Add [tests](#testing) for it. This is important so that it isn't broken in a
   future version unintentionally.
4. Commit. **Do not touch any unrelated code, such as the gemspec or version.**
   If you must change unrelated code, do it in a commit by itself, so that it
   can be ignored.
5. Send a pull request.

## Testing

### Install prerequisites

Install git on your test system.

Install the latest version of [Bundler](http://gembundler.com)

    $ gem install bundler

Clone the project

    $ git clone git://github.com/berkshelf/berkshelf.git

and run:

    $ cd berkshelf
    $ bundle install

Bundler will install all gems and their dependencies required for testing and developing.

### Running unit (RSpec) and acceptance (Cucumber) tests

We use Chef Zero - an in-memory Chef Server for running tests. It is automatically managed by the Specs and Cukes. Simply run:

    $ bundle exec guard start

See [here](https://github.com/tdegrunt/vagrant-chef-server-bootstrap) for a
quick way to get a testing chef server up.

### Debugging Issues
By default, Berkshelf will only give you the top-level output from a failed command. If you're working deep inside the core, an error like:

    Berkshelf Error: wrong number of arguments (2 for 1)

isn't exactly helpful...

Specify the `BERKSHELF_DEBUG` flag when running your command to see a full stack trace and other helpful debugging information.

Version data entries

19 entries across 19 versions & 1 rubygems

Version Path
berkshelf-4.0.1 CONTRIBUTING.md
berkshelf-4.0.0 CONTRIBUTING.md
berkshelf-3.3.0 CONTRIBUTING.md
berkshelf-3.2.4 CONTRIBUTING.md
berkshelf-3.2.3 CONTRIBUTING.md
berkshelf-3.2.2 CONTRIBUTING.md
berkshelf-3.2.1 CONTRIBUTING.md
berkshelf-3.2.0 CONTRIBUTING.md
berkshelf-3.1.5 CONTRIBUTING.md
berkshelf-3.1.4 CONTRIBUTING.md
berkshelf-3.1.3 CONTRIBUTING.md
berkshelf-3.1.2 CONTRIBUTING.md
berkshelf-3.1.1 CONTRIBUTING.md
berkshelf-3.1.0 CONTRIBUTING.md
berkshelf-3.0.1 CONTRIBUTING.md
berkshelf-3.0.0 CONTRIBUTING.md
berkshelf-3.0.0.rc1 CONTRIBUTING.md
berkshelf-3.0.0.beta9 CONTRIBUTING.md
berkshelf-3.0.0.beta8 CONTRIBUTING.md