README.md in consul-1.0.1 vs README.md in consul-1.0.2

- old
+ new

@@ -6,11 +6,11 @@ Consul is an authorization solution for Ruby on Rails where you describe *sets of accessible things* to control what a user can see or edit. We have used Consul in combination with [assignable_values](https://github.com/makandra/assignable_values) to solve a variety of authorization requirements ranging from boring to bizarre. Also see our crash course video: [Solving bizare authorization requirements with Rails](http://bizarre-authorization.talks.makandra.com/). -Consul is tested with Rails 3.2, 4.2, and 5.2 on Ruby 1.8.7, 2.1, and 2.4 (only if supported, for each Ruby/Rails combination). If you need support for Rails 3.2, please use [v0.13.2](https://github.com/makandra/consul/tree/v0.13.2). +Consul is tested with Rails 3.2, 4.2, 5.2, and 6.0 on Ruby 2.3, 2.4, and 2.5 (only if supported, for each Ruby/Rails combination). If you need support for Rails 3.2, please use [v0.13.2](https://github.com/makandra/consul/tree/v0.13.2). Describing access to your application ------------------------------------- @@ -761,10 +761,20 @@ This section Some hints for testing authorization with Consul. ### Test that a controller checks against a power +Include the Consul Matcher `spec/support/consul_matchers.rb`: + +``` +require 'consul/spec/matchers' + +RSpec.configure do |c| + c.include Consul::Spec::Matchers +end +``` + You can say this in any controller spec: ```rb describe CakesController do @@ -832,15 +842,15 @@ Development ----------- -Test applications for various Rails versions lives in `spec`. You can run specs from the project root by saying: - -``` -rake all:bundle -rake all:spec -``` +- There are tests in `spec`. We only accept PRs with tests. +- We currently develop using Ruby 2.3.8 (see `.ruby-version`) since that version works for all versions of ActiveRecord that we support. Travis CI will test additional Ruby versions (2.4.5 and 2.5.3). +- Put your database credentials into `spec/support/database.yml`. There's a `database.sample.yml` you can use as a template. +- There are gem bundles in the project root for each rails version that we support. +- You can bundle all test applications by saying `bundle exec rake matrix:install` +- You can run specs from the project root by saying `bundle exec rake matrix:spec`. This will run all gemfiles compatible with your current Ruby. If you would like to contribute: - Fork the repository. - Push your changes **with specs**.