specs: migrate from features to system specs

System specs have been available since Rails 5.1, and are better
integrated with the Rails framework.

- Rename `spec/features` to `spec/system`
- Rename `feature do` to `describe do`
- Configure Capybara for system specs

Steps mostly taken from https://medium.com/table-xi/a-quick-guide-to-rails-system-tests-in-rspec-b6e9e8a8b5f6

.github/workflows/ci.yml

@@ -59,7 +59,7 @@ jobs:
           - bin/rspec spec/controllers/*_spec.rb
           - bin/rspec spec/controllers/[a-l]**/*_spec.rb
           - bin/rspec spec/controllers/[m-z]**/*_spec.rb
-          - bin/rspec spec/features
+          - bin/rspec spec/system
           - bin/rspec spec/helpers spec/lib spec/middlewares
           - bin/rspec spec/mailers spec/jobs spec/policies
           - bin/rspec spec/models

.rubocop.yml

@@ -722,7 +722,7 @@ Rails/DelegateAllowBlank:
 Rails/DynamicFindBy:
   Enabled: true
   Exclude:
-    - "spec/features/**/*.rb"
+    - "spec/system/**/*.rb"
 
 Rails/EnumUniqueness:
   Enabled: true

Gemfile

@@ -89,10 +89,10 @@ group :test do
   gem 'capybara' # Integration testing
   gem 'capybara-email' # Access emails during integration tests
   gem 'capybara-screenshot' # Save a dump of the page when an integration test fails
-  gem 'capybara-selenium'
   gem 'factory_bot'
   gem 'launchy'
   gem 'rails-controller-testing'
+  gem 'selenium-webdriver'
   gem 'shoulda-matchers', require: false
   gem 'timecop'
   gem 'vcr'

Gemfile.lock

@@ -162,9 +162,6 @@ GEM
     capybara-screenshot (1.0.25)
       capybara (>= 1.0, < 4)
       launchy
-    capybara-selenium (0.0.6)
-      capybara
-      selenium-webdriver
     case_transform (0.2)
       activesupport
     caxlsx (3.1.0)
@@ -792,7 +789,6 @@ DEPENDENCIES
   capybara
   capybara-email
   capybara-screenshot
-  capybara-selenium
   charlock_holmes
   chartkick
   chunky_png
@@ -867,6 +863,7 @@ DEPENDENCIES
   sanitize-url
   sassc-rails
   scss_lint
+  selenium-webdriver
   sentry-delayed_job
   sentry-rails
   sentry-ruby

Guardfile

@@ -2,7 +2,7 @@
 # More info at https://github.com/guard/guard#readme
 
 ## Uncomment and set this to only include directories you want to watch
-# directories %w(app lib config test spec features) \
+# directories %w(app lib config test spec system) \
 #  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
 
 ## Note: if you are using the `directories` clause above and you are not
@@ -77,8 +77,8 @@ guard :rspec, cmd: 'spring rspec' do
   watch('app/controllers/application_controller.rb')  { "spec/controllers" }
   watch('spec/rails_helper.rb')                       { "spec" }
 
-  # Capybara features specs
+  # Capybara system specs
-  watch(%r{^app/views/(.+)/.*\.(erb|haml|slim)$})     { |m| "spec/features/#{m[1]}_spec.rb" }
+  watch(%r{^app/views/(.+)/.*\.(erb|haml|slim)$})     { |m| "spec/system/#{m[1]}_spec.rb" }
 
   # Turnip features and steps
   watch(%r{^spec/acceptance/(.+)\.feature$})

spec/rails_helper.rb

@@ -127,4 +127,5 @@ RSpec.configure do |config|
   config.include Shoulda::Matchers::ActiveModel, type: :model
   config.include Devise::Test::ControllerHelpers, type: :controller
   config.include Devise::Test::ControllerHelpers, type: :view
+  config.include Devise::Test::IntegrationHelpers, type: :system
 end

spec/support/capybara.rb

@@ -3,9 +3,6 @@ require 'capybara-screenshot/rspec'
 require 'capybara/email/rspec'
 require 'selenium/webdriver'
 
-Capybara.javascript_driver = :headless_chrome
-Capybara.ignore_hidden_elements = false
-
 Capybara.register_driver :chrome do |app|
   Capybara::Selenium::Driver.new(app, browser: :chrome)
 end
@@ -36,6 +33,8 @@ end
 
 Capybara.default_max_wait_time = 2
 
+Capybara.ignore_hidden_elements = false
+
 # Save a snapshot of the HTML page when an integration test fails
 Capybara::Screenshot.autosave_on_failure = true
 # Keep only the screenshots generated from the last failing test suite
@@ -46,13 +45,21 @@ Capybara::Screenshot.register_driver :headless_chrome do |driver, path|
 end
 
 RSpec.configure do |config|
-  # Set the user preferred language before Javascript feature specs.
+  config.before(:each, type: :system) do
+    driven_by :rack_test
+  end
+
+  config.before(:each, type: :system, js: true) do
+    driven_by :headless_chrome
+  end
+
+  # Set the user preferred language before Javascript system specs.
   #
-  # Features specs without Javascript run in a Rack stack, and respect the Accept-Language value.
+  # System specs without Javascript run in a Rack stack, and respect the Accept-Language value.
   # However specs using Javascript are run into a Headless Chrome, which doesn't support setting
   # the default Accept-Language value reliably.
   # So instead we set the locale cookie explicitly before each Javascript test.
-  config.before(:each, js: true) do
+  config.before(:each, type: :system, js: true) do
     visit '/' # Webdriver needs visiting a page before setting the cookie
     Capybara.current_session.driver.browser.manage.add_cookie(
       name: :locale,

spec/support/system_helpers.rb

@@ -1,4 +1,4 @@
-module FeatureHelpers
+module SystemHelpers
   include ActiveJob::TestHelper
 
   def login_admin
@@ -177,5 +177,5 @@ module FeatureHelpers
 end
 
 RSpec.configure do |config|
-  config.include FeatureHelpers, type: :feature
+  config.include SystemHelpers, type: :system
 end

spec/system/accessibilite/wcag_usager_spec.rb

@@ -1,4 +1,4 @@
-feature 'wcag rules for usager', js: true do
+describe 'wcag rules for usager', js: true do
   let(:procedure) { create(:procedure, :with_type_de_champ, :with_all_champs, :with_service, :for_individual, :published) }
   let(:password) { 'a very complicated password' }
   let(:litteraire_user) { create(:user, password: password) }

spec/system/admin/admin_creation_spec.rb

@@ -1,4 +1,4 @@
-feature 'As an administrateur', js: true do
+describe 'As an administrateur', js: true do
   let(:super_admin) { create(:super_admin) }
   let(:admin_email) { 'new_admin@gouv.fr' }
   let(:new_admin) { Administrateur.by_email(admin_email) }

spec/system/admin/procedure_cloning_spec.rb

@@ -1,6 +1,6 @@
-require 'features/admin/procedure_spec_helper'
+require 'system/admin/procedure_spec_helper'
 
-feature 'As an administrateur I wanna clone a procedure', js: true do
+describe 'As an administrateur I wanna clone a procedure', js: true do
   include ProcedureSpecHelper
 
   let(:administrateur) { create(:administrateur) }

spec/system/admin/procedure_creation_spec.rb

@@ -1,6 +1,6 @@
-require 'features/admin/procedure_spec_helper'
+require 'system/admin/procedure_spec_helper'
 
-feature 'As an administrateur I wanna create a new procedure', js: true do
+describe 'As an administrateur I wanna create a new procedure', js: true do
   include ProcedureSpecHelper
 
   let(:administrateur) { create(:administrateur, :with_procedure) }

spec/system/admin/procedure_locked_spec.rb

@@ -1,4 +1,4 @@
-feature 'procedure locked' do
+describe 'procedure locked' do
   let(:administrateur) { create(:administrateur) }
 
   before do

spec/system/admin/procedure_publish_spec.rb

@@ -1,6 +1,6 @@
-require 'features/admin/procedure_spec_helper'
+require 'system/admin/procedure_spec_helper'
 
-feature 'Publication de démarches', js: true do
+describe 'Publication de démarches', js: true do
   include ProcedureSpecHelper
 
   let(:administrateur) { create(:administrateur) }

spec/system/admin/procedure_update_spec.rb

@@ -1,6 +1,6 @@
-require 'features/admin/procedure_spec_helper'
+require 'system/admin/procedure_spec_helper'
 
-feature 'Administrateurs can edit procedures', js: true do
+describe 'Administrateurs can edit procedures', js: true do
   include ProcedureSpecHelper
 
   let(:administrateur) { create(:administrateur) }

spec/system/api_particulier/api_particulier_spec.rb

@@ -1,4 +1,4 @@
-feature 'fetch API Particulier Data', js: true do
+describe 'fetch API Particulier Data', js: true do
   let(:administrateur) { create(:administrateur) }
 
   let(:expected_token) { 'd7e9c9f4c3ca00caadde31f50fd4521a' }

spec/system/experts/expert_spec.rb

@@ -1,4 +1,4 @@
-feature 'Inviting an expert:' do
+describe 'Inviting an expert:' do
   include ActiveJob::TestHelper
   include ActionView::Helpers
 

spec/system/forgery_spec.rb

@@ -1,4 +1,4 @@
-feature 'Protecting against request forgeries:', :allow_forgery_protection, :show_exception_pages do
+describe 'Protecting against request forgeries:', :allow_forgery_protection, :show_exception_pages do
   let(:user) { create(:user, password: password) }
   let(:password) { 'ThisIsTheUserPassword' }
 

spec/system/france_connect/france_connect_particulier_spec.rb

@@ -1,4 +1,4 @@
-feature 'France Connect Particulier Connexion' do
+describe 'France Connect Particulier Connexion' do
   let(:code) { 'plop' }
   let(:given_name) { 'titi' }
   let(:family_name) { 'toto' }

spec/system/help_spec.rb

@@ -1,4 +1,4 @@
-feature 'Getting help:' do
+describe 'Getting help:' do
   scenario 'a Help button is visible on public pages' do
     visit '/'
     within('.new-header') do

spec/system/i18n_spec.rb

@@ -1,4 +1,4 @@
-feature 'Accessing the website in different languages:' do
+describe 'Accessing the website in different languages:' do
   context 'when the i18n feature-flag is enabled' do
     before { ENV['LOCALIZATION_ENABLED'] = 'true' }
     after { ENV['LOCALIZATION_ENABLED'] = 'false' }

spec/system/instructeurs/expert_spec.rb

@@ -1,4 +1,4 @@
-feature 'Inviting an expert:', js: true do
+describe 'Inviting an expert:', js: true do
   include ActiveJob::TestHelper
   include ActionView::Helpers
 

spec/system/instructeurs/instructeur_creation_spec.rb

@@ -1,4 +1,4 @@
-feature 'As an instructeur', js: true do
+describe 'As an instructeur', js: true do
   let(:administrateur) { create(:administrateur, :with_procedure) }
   let(:procedure) { administrateur.procedures.first }
   let(:instructeur_email) { 'new_instructeur@gouv.fr' }

spec/system/instructeurs/instruction_spec.rb

@@ -1,4 +1,4 @@
-feature 'Instructing a dossier:', js: true do
+describe 'Instructing a dossier:', js: true do
   include ActiveJob::TestHelper
 
   let(:password) { 'my-s3cure-p4ssword' }

spec/system/instructeurs/procedure_filters_spec.rb

@@ -1,4 +1,4 @@
-feature "procedure filters" do
+describe "procedure filters" do
   let(:instructeur) { create(:instructeur) }
   let(:procedure) { create(:procedure, :published, :with_type_de_champ, instructeurs: [instructeur]) }
   let!(:type_de_champ) { procedure.types_de_champ.first }

spec/system/new_administrateur/types_de_champ_spec.rb

@@ -1,4 +1,4 @@
-feature 'As an administrateur I can edit types de champ', js: true do
+describe 'As an administrateur I can edit types de champ', js: true do
   let(:administrateur) { procedure.administrateurs.first }
   let(:procedure) { create(:procedure) }
 

spec/system/outdated_browser_spec.rb

@@ -1,4 +1,4 @@
-feature 'Outdated browsers support:' do
+describe 'Outdated browsers support:' do
   context 'when the user browser is outdated' do
     before(:each) do
       ie_10_user_agent = 'Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; WOW64; Trident/6.0; .NET4.0E; .NET4.0C; InfoPath.3)'

spec/system/routing/full_scenario_spec.rb

@@ -1,4 +1,4 @@
-feature 'The routing', js: true do
+describe 'The routing', js: true do
   let(:password) { 'a very complicated password' }
   let(:procedure) { create(:procedure, :with_type_de_champ, :with_service, :for_individual) }
   let(:administrateur) { create(:administrateur, procedures: [procedure]) }

spec/system/sessions/sign_in_spec.rb

@@ -1,4 +1,4 @@
-feature 'Signin in:' do
+describe 'Signin in:' do
   let!(:user) { create(:user, password: password) }
   let(:password) { 'my-s3cure-p4ssword' }
 

spec/system/users/brouillon_spec.rb

@@ -1,4 +1,4 @@
-feature 'The user' do
+describe 'The user' do
   let(:password) { 'my-s3cure-p4ssword' }
   let!(:user) { create(:user, password: password) }
 

spec/system/users/change_email_spec.rb

@@ -1,4 +1,4 @@
-feature 'Changing an email' do
+describe 'Changing an email' do
   let(:old_email) { 'old@email.com' }
   let(:user) { create(:user, email: old_email) }
 

spec/system/users/dossier_creation_spec.rb

@@ -1,4 +1,4 @@
-feature 'Creating a new dossier:' do
+describe 'Creating a new dossier:' do
   let(:user)  { create(:user) }
   let(:siret) { '41816609600051' }
   let(:siren) { siret[0...9] }

spec/system/users/dossier_details_spec.rb

@@ -1,4 +1,4 @@
-require 'features/users/dossier_shared_examples.rb'
+require 'system/users/dossier_shared_examples.rb'
 
 describe 'Dossier details:' do
   let(:user) { create(:user) }

spec/system/users/invite_spec.rb

@@ -1,6 +1,6 @@
-require 'features/users/dossier_shared_examples.rb'
+require 'system/users/dossier_shared_examples.rb'
 
-feature 'Invitations' do
+describe 'Invitations' do
   let(:owner) { create(:user) }
   let(:invited_user) { create(:user, email: 'user_invite@exemple.fr') }
   let(:procedure) { create(:simple_procedure) }

spec/system/users/linked_dropdown_spec.rb

@@ -1,4 +1,4 @@
-feature 'linked dropdown lists' do
+describe 'linked dropdown lists' do
   let(:password) { 'my-s3cure-p4ssword' }
   let!(:user) { create(:user, password: password) }
 

spec/system/users/managing_password_spec.rb

@@ -1,4 +1,4 @@
-feature 'Managing password:' do
+describe 'Managing password:' do
   context 'for simple users' do
     let(:user) { create(:user) }
     let(:new_password) { 'a simple password' }

spec/system/users/sign_out_spec.rb

@@ -1,4 +1,4 @@
-feature 'Sign out' do
+describe 'Sign out' do
   context 'when a user is logged in' do
     let(:user) { create(:administrateur).user }
 

spec/system/users/sign_up_spec.rb

@@ -1,4 +1,4 @@
-feature 'Signing up:' do
+describe 'Signing up:' do
   let(:user_email) { generate :user_email }
   let(:user_password) { 'my-s3cure-p4ssword' }
   let(:procedure) { create :simple_procedure, :with_service }