Rails-spec.md

+# Ecriture de fichier spec
+
+## Spec de `Model`
+## Spec de `View`
+
+### Helpers
+
+- _matcher_ `have_link_for_each_item`  qui permet d'itérer sur tous les éléments d'une collection, et de vérifier - pour chacun - qu'on a un lien vers l'URL désirée (dans [`spec/support/integration_spec_helper.rb`](http://github.com/af83/stif-boiv/blob/f83df1a0b39b2af7d3088db9c98365c4088bc021/spec/support/integration_spec_helper.rb#L22)).
+- _matcher_ `have_the_right_number_of_links`  qui permet d'itérer sur tous les éléments d'une collection, et de vérifier - pour chacun - qu'on a le bon nombre de liens (dans [`spec/support/integration_spec_helper.rb`](http://github.com/af83/stif-boiv/blob/f83df1a0b39b2af7d3088db9c98365c4088bc021/spec/support/integration_spec_helper.rb#L22)).
+- `with_permission permission_name do ...` qui permet de tester le rendu avec un utilisateur disposant de la permission désirée (dans [`spec/support/integration_spec_helper.rb`](http://github.com/af83/stif-boiv/blob/f83df1a0b39b2af7d3088db9c98365c4088bc021/spec/support/integration_spec_helper.rb#L22)).
+- `build_paginated_collection(:factory_name, decorator_class, factory_options, context: decorator_context)` permet de construire une collection d'objets et de les décorer, de façon similaire à ce que ferait un controlleur (dans [`spec/support/integration_spec_helper.rb`](http://github.com/af83/stif-boiv/blob/f83df1a0b39b2af7d3088db9c98365c4088bc021/spec/support/integration_spec_helper.rb#L22).
+
+### Tips
+
+- pour _nester_ la vue, par exemple émuler une URL `/parents/:parent_id/objects`: `controller.request.path_parameters[:parent_id] = parent.id`
+
+### Exemple
+
+Pour une vue d'__index__, dans laquelle on veut vérifier:
+- le nombre de lignes du tableau
+- la présence de lien pour chaque ligne (en fonction des permissions)
+
+```ruby
+require 'spec_helper'
+
+describe "/objects/index", :type => :view do
+  let(:parent) { assign :parent, create(:parent) }
+  let(:context) {
+     {
+       foo: bar,
+       bar: baz
+     }
+   }
+  let(:objects) do
+    assign :objects, build_paginated_collection(:object, ObjectDecorator, parent: parent, context: context)
+  end
+
+  before :each do
+    allow(view).to receive(:collection).and_return(objects)
+    allow(view).to receive(:current_referential).and_return(parent)
+    controller.request.path_parameters[:parent_id] = parent.id
+    render
+  end
+
+  common_items = ->{
+    it { should have_link_for_each_item(objects, "show", -> (object){ view.parent_object_path(parent, object) }) }
+    it { should have_link_for_each_item(objects, "foo", -> (object){ view.parent_foo_path(parent, object.foo) }) }
+    it { should have_link_for_each_item(objects, "bar", -> (object){ view.parent_bar_path(parent, object.bar) }) }
+  }
+
+  common_items.call()
+  it { should have_the_right_number_of_links(objects, 3) }
+
+  with_permission "objects.activate" do
+    common_items.call()
+    it { should have_link_for_each_item(objects, "activate", -> (object){ view.activate_parent_object_path(parent, object) }) }
+    it { should have_the_right_number_of_links(objects, 4) }
+  end
+end
+```
+
+## Spec de `Controller`
+
+### Helpers
+
+- `login_user` pour créer un utilisateur et le passer dans la session
+- `with_permission permission do ...` pour ajouter la permission à l'utilisateur connecté dans le contexte
+
+### Exemple
+
+```ruby
+RSpec.describe ObjectController, :type => :controller do
+  login_user
+
+  let(:parent) { create :parent }
+  let(:object) { create :object, parent: parent }
+
+  describe 'PUT deactivate' do
+    let(:request){ put :deactivate, id: object.id, parent_id: parent.id }
+
+    it 'should redirect to 403' do
+       expect(request).to redirect_to "/403"
+    end
+
+    with_permission "foo.bar" do
+      it 'returns HTTP success' do
+        expect(request).to redirect_to [parent, object]
+        expect(object.reload).to be_deactivated
+      end
+    end
+  end
+
+  describe 'PUT activate' do
+    let(:request){ put :activate, id: object.id, parent_id: parent.id }
+    before(:each){
+      object.deactivate!
+    }
+    it 'should redirect to 403' do
+       expect(request).to redirect_to "/403"
+    end
+
+    with_permission "objects.change_status" do
+      it 'returns HTTP success' do
+        expect(request).to redirect_to [parent, object]
+        expect(object.reload).to be_activated
+      end
+    end
+  end
+end
+```