active_scaffold 4.3.2 → 4.4.1

data/lib/active_scaffold.rb

@@ -58,6 +58,174 @@ module ActiveScaffold
   mattr_accessor :javascripts, instance_writer: false
   self.javascripts = []
 
+  # A way to define the tags and html attributes used in different places.
+  # Changing the class or replacing the attributes may break the default AS stylesheets, but not JS or functionality.
+  #
+  # The keys in the hash are the names used by ActiveScaffold to identify the
+  # elements.
+  # The values are a hash of attributes used to create the markup, supporting the following keys:
+  # * The :tag key can be used to specify a different tag name for the element.
+  # * The :attributes key can be used to specify additional html attributes.
+  # * The :proc key can be used to specify a method to dinamically return the tag and attributes hash, as an array.
+  #   When :proc is present, :tag and :attributes won't be used. The proc will receive an options hash, which usually
+  #   will be a hash with html attributes, but in some cases may have other options:
+  #   * For :action_link_group the hash will have keys such as :level, :first_action, and other options supported by
+  #     +display_action_links+
+  #   * For :action_link_separator the hash will have keys such as :level, :level_0_tag, and other options supported by
+  #     +display_action_links+
+  #   * Form and search elements receive the column and the configured UI in the options hash.
+  #   * Action link elements receive the link, record, rendering options, and authorized state.
+  #   * Pagination elements receive the page number and, for links, the optional text key.
+  # Some keys don't have a :tag key, because only attributes are used, the tag is hardcoded, usually elements that are
+  # rendered as a form or table, or a table's element (thead, tbody, tr, td, th, tfoot, etc.). For those elements,
+  # the :tag key will be ignored if it's set, so the tag can't be changed.
+  mattr_reader :ui_elements
+  @@ui_elements ||= {
+    list: {tag: :div},
+    list_header: {tag: :div},
+    list_title: {tag: :h2},
+    list_actions: {tag: :div},
+    filters: {tag: :div, attributes: {class: 'filters'}},
+    before_header_table: {tag: :table},
+    list_content: {tag: :div},
+    list_table: {}, # table
+    list_table_head: {}, # thead
+    list_table_head_row: {}, # tr
+    list_records: {}, # tbody
+    list_messages: {attributes: {class: 'messages'}}, # tbody
+    list_messages_container: {}, # td
+    list_action_messages: {tag: :div},
+    filtered_message: {tag: :div, attributes: {class: 'filtered-message'}},
+    applied_filters_message: {tag: :div, attributes: {class: 'filtered-message applied-filters'}},
+    empty_message: {tag: :p},
+    message_reset: {tag: :div, attributes: {class: 'reset'}},
+    message_close: {tag: :a, attributes: {href: '#', class: 'close'}},
+    server_error: {tag: :p, attributes: {class: 'error-message message server-error'}},
+    info_message: {tag: :div, attributes: {class: 'info-message message'}},
+    warning_message: {tag: :div, attributes: {class: 'warning-message message'}},
+    error_message: {tag: :div, attributes: {class: 'error-message message'}},
+    list_footer: {tag: :div, attributes: {class: 'active-scaffold-footer'}},
+    list_found: {tag: :div},
+    list_found_count: {tag: :span},
+    list_calculations: {}, # tr
+    pagination_links: {tag: :div},
+    pagination_link: {}, # a
+    pagination_active_page: {tag: :span},
+    record_actions_cell: {}, # td
+    record_action_links: {}, # table
+    action_link_group: {
+      proc: lambda do |options|
+        if options[:level]&.zero?
+          tag = :div
+          attributes = {class: 'action_group'}
+        else
+          tag = :li
+          attributes = {class: ('top' if options[:first_action]).to_s}
+        end
+        attributes[:class] += ' hover_click' if hover_via_click?
+        [tag, attributes]
+      end
+    },
+    action_link_separator: {
+      proc: lambda do |options|
+        tag = options[:level_0_tag] || :a if options[:level]&.zero?
+        [tag || :li, {class: 'separator'}]
+      end
+    },
+    action_link_group_title: {tag: :div},
+    action_link_group_content: {tag: :ul},
+    action_link: {}, # a
+    action_link_item: {tag: :li},
+    dynamic_action_group: {tag: :ul, attributes: {class: 'dynamic-menu'}},
+    dynamic_action_group_element: {tag: :li},
+    search_form: {}, # form
+    search_field: {attributes: {class: 'text-input', size: 50, autocomplete: :off}}, # input type=search
+    search_control: {}, # input, select or textarea
+    search_submit: {attributes: {class: 'submit'}}, # input type=submit
+    search_reset: {attributes: {class: 'reset'}}, # a
+    field_search_form: {}, # form
+    field_search_fields_columns: {tag: :div, attributes: {class: 'form-columns'}},
+    field_search_fields_container: {tag: :ol},
+    field_search_subsection: {tag: :li, attributes: {class: 'sub-section'}},
+    field_search_element: {tag: :li},
+    field_search_submit: {attributes: {class: 'submit'}}, # input type=submit
+    field_search_reset: {attributes: {class: 'reset'}}, # a
+    field_search_footer: {tag: :p},
+    form: {}, # form
+    form_title: {tag: :h4},
+    form_messages_container: {tag: :div},
+    form_fields_columns: {tag: :div, attributes: {class: 'form-columns'}},
+    fields_container: {tag: :ol},
+    form_subsection: {tag: :li, attributes: {class: 'sub-section'}},
+    form_subsection_header: {tag: :h5},
+    subform: {tag: :li},
+    subform_header: {tag: :h5},
+    subform_footer: {tag: :div, attributes: {class: 'footer'}},
+    subform_record_remove: {}, # a
+    subform_record_remove_reason: {tag: :span, attributes: {class: 'destroy reason'}},
+    subform_create_another: {}, # a
+    subform_replace_with_new: {}, # a
+    subform_add_existing: {}, # a
+    form_element: {tag: :li},
+    form_attribute: {tag: :dl},
+    form_attribute_label: {tag: :dt},
+    form_attribute_field: {tag: :dd},
+    search_attribute: {tag: :dl},
+    search_attribute_label: {tag: :dt},
+    search_attribute_field: {tag: :dd},
+    form_control: {}, # input, select or textarea
+    form_field_description: {tag: :span, attributes: {class: 'description'}},
+    form_field_description_close: {tag: :span, attributes: {class: 'close'}},
+    form_footer: {tag: :p},
+    form_submit: {attributes: {class: 'submit'}}, # input type=submit
+    form_apply: {attributes: {class: 'submit'}}, # input type=submit
+    form_cancel: {}, # a
+    field_add_new_subform: {},
+    field_add_new_popup: {},
+    show_title: {tag: :h4},
+    show_actions: {tag: :div},
+    show_columns_block: {tag: :dl},
+    show_label_block: {tag: :dt},
+    show_columns_group: {tag: :dd},
+    show_value_block: {tag: :dd},
+    show_footer: {tag: :p, attributes: {class: 'form-footer'}},
+    show_cancel: {} # a
+  }
+
+  def self.set_element_tag(name, tag)
+    (ui_elements[name] ||= {})[:tag] = tag
+  end
+
+  # Replace an element's complete definition. Use a block instead of +tag+ and
+  # +attributes+ to define a dynamic element.
+  def self.set_element(name, tag: nil, attributes: nil, &proc)
+    if proc && (tag || attributes)
+      raise ArgumentError, 'tag and attributes cannot be used with a proc'
+    end
+
+    ui_elements[name] = if proc
+                          {proc: proc}
+                        else
+                          {}.tap do |element|
+                            element[:tag] = tag if tag
+                            element[:attributes] = attributes.as_html_attrs if attributes
+                          end
+                        end
+  end
+
+  def self.set_element_proc(name, &block)
+    (ui_elements[name] ||= {})[:proc] = block
+  end
+
+  def self.set_element_attributes(name, attributes)
+    (ui_elements[name] ||= {})[:attributes] = attributes.as_html_attrs
+  end
+
+  def self.add_element_attributes(name, attributes)
+    attrs = (ui_elements[name] ||= {})[:attributes] || {}
+    ui_elements[name][:attributes] = attrs.smart_merge(attributes)
+  end
+
   def self.threadsafe!; end
 
   mattr_writer :jquery_ui_loaded, instance_writer: false
@@ -106,3 +274,4 @@ require 'active_scaffold/engine'
 require 'ice_nine'
 require 'ice_nine/core_ext/object'
 require 'request_store'
+require 'html_attrs'

data/lib/generators/active_scaffold/install/install_generator.rb

@@ -1,11 +1,18 @@
 # frozen_string_literal: true
 
 require 'rails/generators/base'
-# require 'generators/active_scaffold_controller/active_scaffold_controller_generator'
 
 module ActiveScaffold
   module Generators
     class InstallGenerator < Rails::Generators::Base
+      IMPORTMAP = 'config/importmap.rb'
+      JS_ASSET = 'app/assets/javascripts/application.js'
+      JS_APP = 'app/javascript/application.js'
+      LAYOUT = 'app/views/layouts/application.html.erb'
+      MANIFEST = 'app/assets/config/manifest.js'
+      SCSS_ASSET = 'app/assets/stylesheets/application.scss'
+      CSS_ASSETS = %w[app/assets/stylesheets/application.css app/assets/stylesheets/application.css.erb].freeze
+
       def self.base_root
         File.expand_path '../..', __dir__
       end
@@ -15,151 +22,249 @@ module ActiveScaffold
         route 'concern :active_scaffold_association, ActiveScaffold::Routing::Association.new'
       end
 
-      IMPORTMAP = 'config/importmap.rb'
-      JS_ASSET = 'app/assets/javascripts/application.js'
-      JS_APP = 'app/javascript/application.js'
-      MANIFEST = 'app/assets/config/manifest.js'
-
       def add_javascript
         if File.exist?(IMPORTMAP)
-          add_to_importmap
-          add_to_js_app
-        elsif File.exist?(JS_ASSET) # rails 6.1
-          original_js = File.binread(JS_ASSET)
-          if original_js.include?('require active_scaffold')
-            say_status('skipped', "insert into #{JS_ASSET}", :yellow)
-          else
-            insert_into_file JS_ASSET, after: %r{//= require +.*ujs['"]?\n} do
-              "//= require active_scaffold\n"
-            end
-            add_to_manifest 'active_scaffold/manifest.js'
-          end
-          setup_jquery JS_ASSET, original_js
+          add_importmap_javascript
+        elsif use_sprockets_javascript?
+          add_sprockets_javascript
+        elsif propshaft? || File.exist?(JS_APP)
+          add_propshaft_javascript_tags
         else
-          create_javascript_manifest JS_ASSET
+          raise Thor::Error, 'Unable to configure ActiveScaffold JavaScript: no import map, Propshaft setup, ' \
+                             "#{JS_APP}, or #{JS_ASSET} was found"
         end
       end
 
-      def add_to_stylesheet_manifest
-        file = 'app/assets/stylesheets/application.css'
-        return unless File.exist?(file)
-
-        original_css = File.binread(file)
-        if original_css.match?(/require active_scaffold$/)
-          say_status('skipped', 'insert into app/assets/stylesheets/application.css', :yellow)
+      def add_stylesheet
+        if File.exist?(SCSS_ASSET)
+          add_to_scss_asset
         else
-          insert_into_file 'app/assets/stylesheets/application.css', before: %r{ *\*/} do
-            " *= require active_scaffold\n"
-          end
+          add_to_css_asset
         end
       end
 
       protected
 
+      def add_importmap_javascript
+        unless File.exist?(JS_APP)
+          raise Thor::Error, "Unable to configure import maps: #{JS_APP} does not exist"
+        end
+
+        add_to_importmap
+        add_to_js_app
+        add_importmap_layout_tags if propshaft?
+      end
+
       def add_to_importmap
         original_js = File.binread(IMPORTMAP)
-        if original_js.match?(/^pin +['"]active_scaffold['"](?=,|$)/)
+        pin = propshaft? ? "pin 'active_scaffold', to: 'active_scaffold/load.js'" : "pin 'active_scaffold'"
+        current_pin = original_js[/^pin +['"]active_scaffold['"].*$/, 0]
+        if current_pin == pin
           say_status('skipped', "append active_scaffold to #{IMPORTMAP}", :yellow)
+        elsif current_pin && generated_active_scaffold_pin?(current_pin)
+          gsub_file IMPORTMAP, current_pin, pin
         else
-          append_to_file IMPORTMAP do
-            "pin 'active_scaffold'\n"
-          end
+          append_to_file IMPORTMAP, "#{pin}\n"
         end
-        if Object.const_defined?(:Jquery)
-          if original_js.match?(/^pin +['"]jquery['"](?=,|$)/)
-            say_status('skipped', "append jquery to #{IMPORTMAP}", :yellow)
-          else
-            append_to_file IMPORTMAP do
-              "pin 'jquery'\n"
-            end
-          end
-          if original_js.match?(%r{^pin +['"](jquery_ujs|@rails/ujs)['"](?=,|$)})
-            say_status('skipped', "append jquery_ujs to #{IMPORTMAP}", :yellow)
-          else
-            append_to_file IMPORTMAP do
-              "pin 'jquery_ujs'\n"
-            end
-          end
+
+        if jquery?
+          add_importmap_pin original_js, 'jquery'
+          add_importmap_pin original_js, 'jquery_ujs', alternatives: ['@rails/ujs']
         else
-          say_status('missing', 'no jquery-rails gem, load jquery, and jquery_ujs or @rails/ujs, in your layout, or add jquery-rails ' \
-                                "to Gemfile and add pin \"jquery\" and pin \"jquery_ujs\" or pin \"@rails/ujs\", to #{IMPORTMAP}", :red)
+          say_status('missing', 'no jquery-rails gem; load jquery and jquery_ujs or @rails/ujs manually', :red)
         end
       end
 
-      def add_to_js_app
-        original_js = File.binread(JS_APP)
-        if original_js.match?(/^import +['"]active_scaffold['"]/)
-          say_status('skipped', "append active_scaffold to #{JS_APP}", :yellow)
+      def add_importmap_pin(original_js, name, alternatives: [])
+        names = [name, *alternatives].map { |item| Regexp.escape(item) }.join('|')
+        if original_js.match?(/^pin +['"](?:#{names})['"](?=,|$)/)
+          say_status('skipped', "append #{name} to #{IMPORTMAP}", :yellow)
         else
-          append_to_file JS_APP do
-            "import 'active_scaffold'\n"
-          end
+          append_to_file IMPORTMAP, "pin '#{name}'\n"
         end
-        manifest = ['active_scaffold/manifest.js']
-        if Object.const_defined?(:Jquery)
-          if original_js.match?(/^import +['"]jquery['"]/)
-            say_status('skipped', "append jquery to #{JS_APP}", :yellow)
-          else
-            manifest << 'jquery.js'
-            insert_into_file JS_APP, before: /import +['"]active_scaffold['"]\n/ do
-              "import 'jquery'\n"
-            end
+      end
+
+      def generated_active_scaffold_pin?(pin)
+        pin.match?(%r{\Apin +['"]active_scaffold['"](?:, *to: *['"]active_scaffold/load\.js['"])?\z})
+      end
+
+      def add_to_js_app
+        original_js = File.binread(JS_APP)
+        add_js_import original_js, 'active_scaffold'
+        manifest_files = ['active_scaffold/manifest.js']
+
+        if jquery?
+          unless js_import?(original_js, 'jquery')
+            add_js_import original_js, 'jquery', before: 'active_scaffold'
+            manifest_files << 'jquery.js'
           end
-          if original_js.match?(%r{^import +(['"]jquery_ujs['"]|Rails from ['"]@rails/ujs['"])})
-            say_status('skipped', "append jquery_ujs to #{JS_APP}", :yellow)
-          else
-            manifest << 'jquery_ujs.js'
-            insert_into_file JS_APP, before: /import +['"]active_scaffold['"]\n/ do
-              "import 'jquery_ujs'\n"
-            end
+          unless original_js.match?(%r{^import +(['"]jquery_ujs['"]|Rails from ['"]@rails/ujs['"])})
+            add_js_import original_js, 'jquery_ujs', before: 'active_scaffold'
+            manifest_files << 'jquery_ujs.js'
           end
         end
-        add_to_manifest(*manifest)
-      end
-
-      def create_javascript_manifest(file)
-        FileUtils.mkdir_p File.dirname(file)
-        js_content = "// This is a manifest file that'll be compiled into application.js, which will include all the files
-// listed below.
-//
-// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, or any plugin's
-// vendor/assets/javascripts directory can be referenced here using a relative path.
-//
-// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
-// compiled file. JavaScript code in this file should be added after the last require_* statement.
-//
-// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
-// about supported directives.
-//
-//= require active_scaffold
-"
-        File.open(file, 'w') { |f| f << js_content } unless options[:pretend]
-        say_status('create', file)
-        insert_into_file 'app/views/layouts/application.html.erb', after: /javascript_pack_tag 'application'.*\n/ do
-          "    <%= javascript_include_tag 'application', 'data-turbolinks-track': 'reload', 'data-turbo-track': 'reload' %>\n"
-        end
-        add_to_manifest 'application.js', 'active_scaffold/manifest.js'
-        setup_jquery file, js_content, where: 'active_scaffold'
+
+        add_to_manifest(*manifest_files) if sprockets?
+      end
+
+      def add_js_import(original_js, name, before: nil)
+        if js_import?(original_js, name)
+          say_status('skipped', "add #{name} to #{JS_APP}", :yellow)
+        elsif before
+          insert_into_file JS_APP, "import '#{name}'\n", before: /^import +['"]#{Regexp.escape(before)}['"]\n/
+        else
+          append_to_file JS_APP, "import '#{name}'\n"
+        end
+      end
+
+      def js_import?(content, name)
+        content.match?(/^import +['"]#{Regexp.escape(name)}['"]/)
+      end
+
+      def add_importmap_layout_tags
+        tags = []
+        content = layout_content
+        tags << '<%= javascript_importmap_tags %>' unless content.include?('javascript_importmap_tags')
+        tags << '<%= active_scaffold_javascript_tag %>' unless content.include?('active_scaffold_javascript_tag')
+        add_layout_tags tags
+      end
+
+      def add_propshaft_javascript_tags
+        tags = []
+        content = layout_content
+        if jquery? && !content.match?(/javascript_include_tag .*jquery/)
+          tags << "<%= javascript_include_tag 'jquery', 'jquery_ujs' %>"
+        elsif !jquery?
+          say_status('missing', 'no jquery-rails gem; load jquery and jquery_ujs or @rails/ujs in the layout', :red)
+        end
+        tags << '<%= active_scaffold_javascript_tag %>' unless content.include?('active_scaffold_javascript_tag')
+        add_layout_tags tags
+      end
+
+      def layout_content
+        unless File.exist?(LAYOUT)
+          raise Thor::Error, "Unable to configure ActiveScaffold JavaScript: #{LAYOUT} does not exist"
+        end
+
+        File.binread(LAYOUT)
+      end
+
+      def add_layout_tags(tags)
+        return if tags.empty?
+
+        content = File.binread(LAYOUT)
+        unless content.include?('</head>')
+          raise Thor::Error, "Unable to configure ActiveScaffold JavaScript: no </head> tag found in #{LAYOUT}"
+        end
+
+        insert_into_file LAYOUT, tags.map { |tag| "    #{tag}\n" }.join, before: %r{^[ \t]*</head>}
+      end
+
+      def add_sprockets_javascript
+        original_js = File.binread(JS_ASSET)
+        unless original_js.match?(%r{//= require +active_scaffold(?:\s|$)})
+          append_to_file JS_ASSET, "\n//= require active_scaffold\n"
+        end
+        setup_sprockets_jquery original_js
+        add_to_manifest 'active_scaffold/manifest.js'
+      end
+
+      def use_sprockets_javascript?
+        File.exist?(JS_ASSET) && (sprockets? || (!propshaft? && !File.exist?(JS_APP)))
+      end
+
+      def setup_sprockets_jquery(original_js)
+        if jquery?
+          return if original_js.match?(%r{//= require +jquery(?:\s|$)})
+
+          insert_into_file JS_ASSET, "//= require jquery\n", before: %r{//= require +active_scaffold(?:\s|$)}
+        else
+          say_status('missing', 'no jquery-rails gem; load jquery manually before ActiveScaffold', :red)
+        end
       end
 
       def add_to_manifest(*files)
-        append_to_file MANIFEST do
-          files.map { |file| "//= link #{file}\n" }.join
+        original_manifest = File.exist?(MANIFEST) ? File.binread(MANIFEST) : ''
+        files.each do |file|
+          next if original_manifest.match?(%r{^//= link #{Regexp.escape(file)}$})
+
+          append_to_file MANIFEST, "//= link #{file}\n"
         end
       end
 
-      def setup_jquery(file, original_js = nil, where: 'ujs')
-        original_js ||= File.binread(file)
-        if Object.const_defined?(:Jquery)
-          unless original_js.include?('require jquery')
-            insert_into_file file, before: %r{//= require +.*#{where}['"]?\n} do
-              "//= require jquery\n"
-            end
-          end
+      def add_to_scss_asset
+        dependency = scss_dependency
+        unless dependency
+          say_status('missing', "could not detect dartsass-rails or dartsass-sprockets; update #{SCSS_ASSET} manually", :red)
+          return
+        end
+
+        original_scss = File.binread(SCSS_ASSET)
+        if original_scss.match?(%r{^@use +['"]active_scaffold(?:/core)?['"]})
+          say_status('skipped', "add ActiveScaffold to #{SCSS_ASSET}", :yellow)
+        else
+          prepend_to_file SCSS_ASSET, "@use '#{dependency}';\n"
+        end
+      end
+
+      def scss_dependency
+        if gem_loaded?('dartsass-sprockets')
+          'active_scaffold'
+        elsif gem_loaded?('dartsass-rails')
+          'active_scaffold/core'
+        end
+      end
+
+      def add_to_css_asset
+        file = CSS_ASSETS.find do |path|
+          File.exist?(path) && File.binread(path).match?(/\*= require(?:_tree)?\b/)
+        end
+        unless file
+          say_status('missing', 'no Dart Sass entrypoint or Sprockets stylesheet manifest found', :red)
+          return
+        end
+
+        original_css = File.binread(file)
+        if original_css.match?(/\*= require +active_scaffold(?:\s|$)/)
+          say_status('skipped', "add ActiveScaffold to #{file}", :yellow)
         else
-          say_status('missing', 'no jquery-rails gem, load jquery in your layout, or add jquery-rails to Gemfile and add //= require jquery to application.js', :red)
+          insert_into_file file, " *= require active_scaffold\n", after: /^[ \t]*\*= require(?:_tree)?\b.*\n/
         end
       end
+
+      def propshaft?
+        asset_pipeline == :propshaft
+      end
+
+      def sprockets?
+        asset_pipeline == :sprockets
+      end
+
+      def asset_pipeline
+        return :propshaft if propshaft_active?
+        return :sprockets if sprockets_active?
+        return :propshaft if gem_loaded?('propshaft')
+
+        :sprockets if gem_loaded?('sprockets-rails')
+      end
+
+      def propshaft_active?
+        defined?(Propshaft::Assembly) && Rails.application.respond_to?(:assets) &&
+          Rails.application.assets.is_a?(Propshaft::Assembly)
+      end
+
+      def sprockets_active?
+        defined?(Sprockets::Environment) && Rails.application.respond_to?(:assets) &&
+          Rails.application.assets.is_a?(Sprockets::Environment)
+      end
+
+      def jquery?
+        Object.const_defined?(:Jquery)
+      end
+
+      def gem_loaded?(name)
+        Gem.loaded_specs.key?(name)
+      end
     end
   end
 end

data/lib/tasks/bundle.rake

@@ -16,7 +16,8 @@ namespace :bundle do
     gemfiles.each do |gemfile|
       puts "Locking #{File.basename(gemfile)}..."
       Bundler.with_unbundled_env do
-        system("bundle lock --gemfile='#{gemfile}'")
+        command = ['bundle', 'lock', "--gemfile=#{gemfile}", '--add-platform', 'ruby']
+        system(*command, exception: true)
       end
     end
 

data/lib/tasks/mock_app.rake

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+namespace :mock_app do
+  desc 'Build the mock app stylesheets'
+  task :assets do
+    environment = {
+      'BUNDLE_GEMFILE' => File.expand_path(ENV.fetch('BUNDLE_GEMFILE', 'Gemfile'))
+    }
+    Dir.chdir('test/mock_app') do
+      system(environment, 'rails', 'dartsass:build', exception: true)
+    end
+  end
+
+  desc 'Start the mock_app server and Dart Sass watcher (default port 3000)'
+  task :server do
+    args = ARGV.drop_while { |a| a != '--' }.drop(1)
+    Dir.chdir('test/mock_app') do
+      environment = {'BUNDLE_GEMFILE' => File.expand_path('../../Gemfile', __dir__)}
+      system(environment, 'rails', 'dartsass:build', exception: true)
+      watcher = Process.spawn(environment, 'rails', 'dartsass:watch')
+      _pid, status = Process.wait2(Process.spawn(environment, 'rails', 'server', *args))
+      exit status.exitstatus
+    ensure
+      begin
+        if watcher
+          Process.kill('TERM', watcher)
+          Process.wait(watcher)
+        end
+      rescue Errno::ECHILD, Errno::ESRCH
+        # The watcher already exited.
+      end
+    end
+  end
+
+  desc 'Start the mock_app console'
+  task :console do
+    args = ARGV.drop_while { |a| a != '--' }.drop(1)
+    Dir.chdir('test/mock_app') do
+      exec({'BUNDLE_GEMFILE' => File.expand_path('../../Gemfile', __dir__)},
+           'rails', 'console', *args)
+    end
+  end
+end