This cookbook includes both unit tests via ChefSpec and integration tests via Test Kitchen. Contributions to this cookbook will only be accepted if all tests pass successfully:
kitchen test
rspec
Install the latest version of Vagrant and VirtualBox (free) or VMWare Fusion (paid).
Clone the latest version of the cookbook from the repository.
git clone git@github.com:socrata-cookbooks/java.git
cd java
Install the gems used for testing:
bundle install
Install the berkshelf plugin for vagrant:
vagrant plugin install vagrant-berkshelf
ChefSpec unit tests are located in spec. Each recipe has a recipename_spec.rb file that contains unit tests for that recipe. Your new functionality or bug fix should have corresponding test coverage - if it's a change, make sure it doesn't introduce a regression (existing tests should pass). If it's a change or introduction of new functionality, add new tests as appropriate.
To run ChefSpec for the whole cookbook:
rspec
To run ChefSpec for a specific recipe:
rspec spec/set_java_home_spec.rb
Test Kitchen test suites are defined in .kitchen.yml. Running kitchen test will cause Test Kitchen to spin up each platform VM in turn, running the java::default recipe with differing parameters in order to test all possible combinations of platform, install_flavor, and JDK version. If the Chef run completes successfully, corresponding tests in test/integration are executed. These must also pass.