-
Notifications
You must be signed in to change notification settings - Fork 314
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
53 additions
and
53 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,53 +1,53 @@ | ||
# 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 and mercurial on your test system. (http://mercurial.selenic.com/wiki/Download) | ||
|
||
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. | ||
# 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 and mercurial on your test system. (http://mercurial.selenic.com/wiki/Download) | ||
|
||
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. |