blacklight 7.43.1 → 8.0.0.beta1

data/lib/blacklight.rb

@@ -1,14 +1,23 @@
 # frozen_string_literal: true
+
 require 'kaminari'
-require 'deprecation'
+require 'blacklight/open_struct_with_hash_access'
+require 'blacklight/nested_open_struct_with_hash_access'
 require 'jbuilder'
-require "zeitwerk"
-loader = Zeitwerk::Loader.for_gem
-loader.ignore("#{__dir__}/generators")
-loader.setup
 
 module Blacklight
-  extend Deprecation
+  autoload :AbstractRepository, 'blacklight/abstract_repository'
+  autoload :Component, 'blacklight/component'
+  autoload :Configuration, 'blacklight/configuration'
+  autoload :Exceptions,  'blacklight/exceptions'
+  autoload :Parameters,  'blacklight/parameters'
+  autoload :Routes,      'blacklight/routes'
+  autoload :RuntimeRegistry, 'blacklight/runtime_registry'
+  autoload :SearchBuilder, 'blacklight/search_builder'
+  autoload :SearchState, 'blacklight/search_state'
+  autoload :Solr, 'blacklight/solr'
+
+  require 'blacklight/version'
   require 'blacklight/engine' if defined?(Rails)
 
   def self.blacklight_config_file
@@ -58,9 +67,6 @@ module Blacklight
 
   def defaults_version
     @defaults_version ||= blacklight_yml['load_defaults'] ||
-                          # this config parameter was introduced in Blacklight 7.11, so to be safe,
-                          # we pin any 7.x app to the 7.10 behavior
-                          (Blacklight::VERSION.starts_with?('7') && '7.10.0') ||
                           Blacklight::VERSION
 
     @defaults_version == 'latest' ? Blacklight::VERSION : @defaults_version
@@ -76,13 +82,17 @@ module Blacklight
     end
 
     begin
-      blacklight_erb = ERB.new(IO.read(blacklight_config_file)).result(binding)
+      blacklight_erb = ERB.new(File.read(blacklight_config_file)).result(binding)
     rescue StandardError, SyntaxError => e
       raise("#{blacklight_config_file} was found, but could not be parsed with ERB. \n#{e.inspect}")
     end
 
     begin
-      @blacklight_yml = YAML.safe_load(blacklight_erb, aliases: true)
+      @blacklight_yml = if RUBY_VERSION > '2.6'
+                          YAML.safe_load(blacklight_erb, aliases: true)
+                        else
+                          YAML.safe_load(blacklight_erb, [], [], true)
+                        end
     rescue => e
       raise("#{blacklight_config_file} was found, but could not be parsed.\n#{e.inspect}")
     end
@@ -99,9 +109,7 @@ module Blacklight
   end
 
   def self.logger
-    @logger ||= begin
-      ::Rails.logger if defined? Rails && Rails.respond_to?(:logger)
-    end
+    @logger ||= (::Rails.logger if defined? Rails && Rails.respond_to?(:logger))
   end
 
   def self.logger= logger
@@ -120,4 +128,8 @@ module Blacklight
   def self.root
     @root ||= File.expand_path(File.dirname(File.dirname(__FILE__)))
   end
+
+  def self.deprecation
+    @deprecation ||= ActiveSupport::Deprecation.new('9.0', 'Blacklight')
+  end
 end

data/lib/generators/blacklight/assets/importmap_generator.rb

@@ -14,15 +14,10 @@ module Blacklight
       def import_javascript_assets
         append_to_file 'config/importmap.rb' do
           <<~CONTENT
-            pin "@github/auto-complete-element", to: "https://cdn.skypack.dev/@github/auto-complete-element"
             pin "@popperjs/core", to: "https://ga.jspm.io/npm:@popperjs/core@2.11.6/dist/umd/popper.min.js"
             pin "bootstrap", to: "https://ga.jspm.io/npm:bootstrap@#{(defined?(Bootstrap) && Bootstrap::VERSION) || '5.2.2'}/dist/js/bootstrap.js"
-          CONTENT
-        end
-
-        append_to_file 'app/assets/config/manifest.js' do
-          <<~CONTENT
-            //= link blacklight/manifest.js
+            pin "blacklight", to: "blacklight/blacklight.js"
+            pin "dialog-polyfill", to: "https://ga.jspm.io/npm:dialog-polyfill@0.5.6/dist/dialog-polyfill.js"
           CONTENT
         end
       end
@@ -31,8 +26,12 @@ module Blacklight
         append_to_file 'app/javascript/application.js' do
           <<~CONTENT
             import bootstrap from "bootstrap"
-            import githubAutoCompleteElement from "@github/auto-complete-element"
-            import Blacklight from "blacklight"
+            import "blacklight"
+            import dialogPolyfill from "dialog-polyfill"
+            Blacklight.onLoad(() => {
+              const dialog = document.querySelector('dialog')
+              dialogPolyfill.registerDialog(dialog)
+            })
           CONTENT
         end
       end

data/lib/generators/blacklight/assets/propshaft_generator.rb

@@ -4,15 +4,7 @@ module Blacklight
   module Assets
     class PropshaftGenerator < Rails::Generators::Base
       def add_package
-        if ENV['CI']
-          run "yarn add blacklight-frontend:#{Blacklight::Engine.root}"
-        else
-          run 'yarn add blacklight-frontend'
-        end
-      end
-
-      def add_third_party_packages
-        run 'yarn add @github/auto-complete-element'
+        run 'yarn add blacklight-frontend'
       end
 
       def add_package_assets
@@ -24,8 +16,7 @@ module Blacklight
 
         append_to_file 'app/javascript/application.js' do
           <<~CONTENT
-            import Blacklight from "blacklight-frontend";
-            import githubAutoCompleteElement from "@github/auto-complete-element";
+            import Blacklight from "blacklight-frontend/app/assets/javascripts/blacklight/blacklight.esm";
           CONTENT
         end
       end

data/lib/generators/blacklight/assets/sprockets_generator.rb

@@ -3,46 +3,25 @@
 module Blacklight
   module Assets
     class SprocketsGenerator < Rails::Generators::Base
-      class_option :'bootstrap-version', type: :string, default: ENV.fetch('BOOTSTRAP_VERSION', '~> 4.0'), desc: "Set the generated app's bootstrap version"
-
-      def replace_propshaft_with_sprockets
-        return if defined?(Sprockets)
-
-        # Rails 8+ defaults to Propshaft, but Blacklight 7.x JS requires Sprockets
-        gsub_file 'Gemfile', /^gem ['"]propshaft['"].*$/, '# \0'
-        gem 'sprockets-rails'
-      end
+      class_option :'bootstrap-version', type: :string, default: ENV.fetch('BOOTSTRAP_VERSION', '~> 5.1'), desc: "Set the generated app's bootstrap version"
 
+      # This could be skipped if you want to use webpacker
       def add_javascript_dependencies
         gem 'bootstrap', options[:'bootstrap-version'].presence
-        gem 'jquery-rails'
-        gem 'twitter-typeahead-rails', '0.11.1.pre.corejavascript'
+        gem 'jquery-rails' if bootstrap_4? # Bootstrap 4 has a dependency on jquery
       end
 
-      def add_sass_support
-        gem "sassc-rails", "~> 2.1" if Rails.version > '7'
-      end
+      ##
+      # Remove the empty generated app/assets/images directory. Without doing this,
+      # the default Sprockets 4 manifest will raise an exception.
+      def appease_sprockets4
+        return if Rails.version > '7' || Sprockets::VERSION < '4'
 
-      def setup_sprockets_manifest
-        if !defined?(Sprockets)
-          # Rails 8+ with Propshaft replaced: create Sprockets config from scratch
-          directory = File.expand_path('app/assets/config', destination_root)
-          FileUtils.mkdir_p(directory)
-          create_file 'app/assets/config/manifest.js' do
-            <<~CONTENT
-              //= link_tree ../images
-              //= link_directory ../stylesheets .css
-              //= link application.js
-            CONTENT
-          end
-          empty_directory 'app/assets/images'
-        elsif defined?(Sprockets::VERSION) && Sprockets::VERSION >= '4'
-          append_to_file 'app/assets/config/manifest.js', "\n//= link application.js"
-          empty_directory 'app/assets/images'
-        end
+        append_to_file 'app/assets/config/manifest.js', "\n//= link application.js"
+        empty_directory 'app/assets/images'
       end
 
-      def assets # rubocop:disable Metrics/MethodLength
+      def assets
         create_file 'app/assets/stylesheets/blacklight.scss' do
           <<~CONTENT
             @import 'bootstrap';
@@ -50,42 +29,29 @@ module Blacklight
           CONTENT
         end
 
-        # Ensure application.css is a proper Sprockets manifest that loads blacklight styles
-        application_css = File.expand_path('app/assets/stylesheets/application.css', destination_root)
-        if File.exist?(application_css)
-          content = File.read(application_css)
-          unless content.include?('require blacklight')
-            create_file 'app/assets/stylesheets/application.css', force: true do
-              <<~CONTENT
-                /*
-                 *= require blacklight
-                 *= require_self
-                 */
-              CONTENT
-            end
-          end
-        end
+        gem "sassc-rails", "~> 2.1" if Rails.version > '7'
 
         # Ensure this method is idempotent
         return if has_blacklight_assets?
 
         create_file 'app/assets/javascripts/application.js' do
           <<~CONTENT
-            //= require jquery3
             //= require rails-ujs
+            #{'//= require jquery3' if bootstrap_4?}
 
             // Required by Blacklight
             //= require popper
-            // Twitter Typeahead for autocomplete
-            //= require twitter/typeahead
             //= require bootstrap
-            //= require blacklight/blacklight
           CONTENT
         end
       end
 
       private
 
+      def bootstrap_4?
+        options[:'bootstrap-version'].match?(/\A[^0-9]*4\./)
+      end
+
       def has_blacklight_assets?
         application_js.include?('blacklight/blacklight')
       end

data/lib/generators/blacklight/assets_generator.rb

@@ -1,17 +1,21 @@
 # frozen_string_literal: true
 
-require 'shellwords'
-
 module Blacklight
   class AssetsGenerator < Rails::Generators::Base
-    class_option :'bootstrap-version', type: :string, default: ENV.fetch('BOOTSTRAP_VERSION', '~> 4.0'), desc: "Set the generated app's bootstrap version"
+    class_option :'bootstrap-version', type: :string, default: ENV.fetch('BOOTSTRAP_VERSION', '~> 5.1'), desc: "Set the generated app's bootstrap version"
 
     def run_asset_pipeline_specific_generator
-      generated_options = "--bootstrap-version='#{Shellwords.escape(options[:'bootstrap-version'])}'" if options[:'bootstrap-version']
+      generated_options = "--bootstrap-version='#{options[:'bootstrap-version']}'" if options[:'bootstrap-version']
+
+      generator = if defined?(Propshaft)
+                    'blacklight:assets:propshaft'
+                  elsif defined?(Importmap)
+                    'blacklight:assets:importmap'
+                  elsif defined?(Sprockets)
+                    'blacklight:assets:sprockets'
+                  end
 
-      # Blacklight 7.x JS is distributed via Sprockets (//= require directives, jQuery, etc.)
-      # so we always use the sprockets generator regardless of what Rails defaulted to.
-      generate 'blacklight:assets:sprockets', generated_options
+      generate generator, generated_options if generator
     end
   end
 end

data/lib/generators/blacklight/controller_generator.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 module Blacklight
   class ControllerGenerator < Rails::Generators::Base
     source_root File.expand_path('../templates', __FILE__)
@@ -16,8 +17,8 @@ module Blacklight
     def inject_blacklight_controller_behavior
       inject_into_class "app/controllers/application_controller.rb", "ApplicationController" do
         "  # Adds a few additional behaviors into the application controller\n" \
-        "  include Blacklight::Controller\n" \
-        "  layout :determine_layout if respond_to? :layout\n\n"
+          "  include Blacklight::Controller\n" \
+          "  layout :determine_layout if respond_to? :layout\n\n"
       end
     end
 
@@ -30,7 +31,7 @@ module Blacklight
       route <<-EOF
   concern :searchable, Blacklight::Routes::Searchable.new
 
-  resource :catalog, only: [], as: 'catalog', path: '/catalog', controller: 'catalog' do
+  resource :catalog, only: [:index], as: 'catalog', path: '/catalog', controller: 'catalog' do
     concerns :searchable
   end
       EOF

data/lib/generators/blacklight/document_generator.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require 'rails/generators'
 
 module Blacklight

data/lib/generators/blacklight/install_generator.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 module Blacklight
   class Install < Rails::Generators::Base
     source_root File.expand_path('../templates', __FILE__)
@@ -11,10 +12,7 @@ module Blacklight
     class_option :devise, type: :boolean, default: false, aliases: "-d", desc: "Use Devise as authentication logic."
     class_option :marc, type: :boolean, default: false, aliases: "-m", desc: "Generate MARC-based demo."
     class_option :'bootstrap-version', type: :string, default: nil, desc: "Set the generated app's bootstrap version"
-    # skip-assets should only happen by default if there's no Sprockets and
-    # Jsbundling is defined instead. Should only effect the generator, but this
-    # is the setup blacklight_range_limit relies on.
-    class_option :'skip-assets', type: :boolean, default: !defined?(Sprockets) && !defined?(Jsbundling).nil?, desc: "Skip generating javascript and css assets into the application"
+    class_option :'skip-assets', type: :boolean, default: false, desc: "Skip generating javascript and css assets into the application"
     class_option :'skip-solr', type: :boolean, default: false, desc: "Skip generating solr configurations."
 
     desc <<-EOS
@@ -87,7 +85,7 @@ module Blacklight
       return unless options[:marc]
 
       blacklight_marc = String.new('blacklight-marc')
-      gem blacklight_marc, '>= 7.0.0.rc1', '< 8'
+      gem blacklight_marc, '~> 8.0'
 
       bundle_install
 

data/lib/generators/blacklight/models_generator.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require 'rails/generators'
 require 'rails/generators/migration'
 require 'blacklight/version'

data/lib/generators/blacklight/search_builder_generator.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require 'rails/generators'
 
 module Blacklight

data/lib/generators/blacklight/solr_generator.rb

@@ -36,7 +36,7 @@ module Blacklight
 
     def bundle_install
       inside destination_root do
-        Bundler.with_clean_env do
+        Bundler.with_unbundled_env do
           run "bundle install"
         end
       end

data/lib/generators/blacklight/templates/catalog_controller.rb

@@ -5,7 +5,16 @@ class <%= controller_name.classify %>Controller < ApplicationController
 
   include Blacklight::Catalog
 
+  # If you'd like to handle errors returned by Solr in a certain way,
+  # you can use Rails rescue_from with a method you define in this controller,
+  # uncomment:
+  #
+  # rescue_from Blacklight::Exceptions::InvalidRequest, with: :my_handling_method
+
   configure_blacklight do |config|
+    ## Specify the style of markup to be generated (may be 4 or 5)
+    # config.bootstrap_version = 5
+    #
     ## Class for sending and receiving requests from a search index
     # config.repository_class = Blacklight::Solr::Repository
     #
@@ -29,23 +38,32 @@ class <%= controller_name.classify %>Controller < ApplicationController
     # solr path which will be added to solr base url before the other solr params.
     #config.solr_path = 'select'
     #config.document_solr_path = 'get'
-    #config.json_solr_path = 'advanced'
 
     # items to show per page, each number in the array represent another option to choose from.
     #config.per_page = [10,20,50,100]
 
     # solr field configuration for search results/index views
     config.index.title_field = 'title_tsim'
-    #config.index.display_type_field = 'format'
-    #config.index.thumbnail_field = 'thumbnail_path_ss'
+    # config.index.display_type_field = 'format'
+    # config.index.thumbnail_field = 'thumbnail_path_ss'
+
+    # The presenter is the view-model class for the page
+    # config.index.document_presenter_class = MyApp::IndexPresenter
 
-    config.add_results_document_tool(:bookmark, partial: 'bookmark_control', if: :render_bookmarks_control?)
+    # Some components can be configured
+    # config.index.document_component = MyApp::SearchResultComponent
+    # config.index.constraints_component = MyApp::ConstraintsComponent
+    # config.index.search_bar_component = MyApp::SearchBarComponent
+    # config.index.search_header_component = MyApp::SearchHeaderComponent
+    # config.index.document_actions.delete(:bookmark)
+
+    config.add_results_document_tool(:bookmark, component: Blacklight::Document::BookmarkComponent, if: :render_bookmarks_control?)
 
     config.add_results_collection_tool(:sort_widget)
     config.add_results_collection_tool(:per_page_widget)
     config.add_results_collection_tool(:view_type_group)
 
-    config.add_show_tools_partial(:bookmark, partial: 'bookmark_control', if: :render_bookmarks_control?)
+    config.add_show_tools_partial(:bookmark, component: Blacklight::Document::BookmarkComponent, if: :render_bookmarks_control?)
     config.add_show_tools_partial(:email, callback: :email_action, validator: :validate_email_params)
     config.add_show_tools_partial(:sms, if: :render_sms_action?, callback: :sms_action, validator: :validate_sms_params)
     config.add_show_tools_partial(:citation)
@@ -54,9 +72,17 @@ class <%= controller_name.classify %>Controller < ApplicationController
     config.add_nav_action(:search_history, partial: 'blacklight/nav/search_history')
 
     # solr field configuration for document/show views
-    #config.show.title_field = 'title_tsim'
-    #config.show.display_type_field = 'format'
-    #config.show.thumbnail_field = 'thumbnail_path_ss'
+    # config.show.title_field = 'title_tsim'
+    # config.show.display_type_field = 'format'
+    # config.show.thumbnail_field = 'thumbnail_path_ss'
+    #
+    # The presenter is a view-model class for the page
+    # config.show.document_presenter_class = MyApp::ShowPresenter
+    #
+    # These components can be configured
+    # config.show.document_component = MyApp::DocumentComponent
+    # config.show.sidebar_component = MyApp::SidebarComponent
+    # config.show.embed_component = MyApp::EmbedComponent
 
     # solr fields that will be treated as facets by the blacklight application
     #   The ordering of the field names is the order of the display

data/lib/generators/blacklight/templates/solr/conf/solrconfig.xml

@@ -16,14 +16,14 @@
     </updateLog>
   </updateHandler>
 
-  <!-- solr lib dirs, which are needed for Solr 8 compatibility but ignored in solr 9.8 and above -->
+  <!-- solr lib dirs -->
   <lib dir="${solr.install.dir:../../../..}/modules/analysis-extras/lib" />
   <lib dir="${solr.install.dir:../../../..}/contrib/analysis-extras/lib" />
   <lib dir="${solr.install.dir:../../../..}/contrib/analysis-extras/lucene-libs" />
 
   <dataDir>${solr.data.dir:}</dataDir>
 
-  <requestHandler name="/select" class="solr.SearchHandler" default="true">
+  <requestHandler name="search" class="solr.SearchHandler" default="true">
     <!-- default values for query parameters can be specified, these
          will be overridden by parameters in the request
       -->
@@ -47,6 +47,7 @@
           full_title_tsim
           short_title_tsim
           alternative_title_tsim
+          active_fedora_model_ssi
           title_tsim
           author_tsim
           subject_tsim
@@ -83,73 +84,7 @@
        <str name="facet">true</str>
        <str name="facet.mincount">1</str>
        <str name="facet.limit">10</str>
-       <str name="facet.field">subject_ssim</str>
-
-       <str name="spellcheck">true</str>
-       <str name="spellcheck.dictionary">default</str>
-       <str name="spellcheck.onlyMorePopular">true</str>
-       <str name="spellcheck.extendedResults">true</str>
-       <str name="spellcheck.collate">false</str>
-       <str name="spellcheck.count">5</str>
-
-     </lst>
-    <arr name="last-components">
-      <str>spellcheck</str>
-    </arr>
-  </requestHandler>
-
-  <requestHandler name="/advanced" class="solr.SearchHandler">
-    <!-- a lucene request handler for using the JSON Query DSL,
-         specifically for advanced search.
-         Using a separate requestHandler is a workaround to
-         https://issues.apache.org/jira/browse/SOLR-16916, although
-         it could be desirable for other reasons as well.
-      -->
-     <lst name="defaults">
-       <str name="defType">lucene</str>
-       <str name="echoParams">explicit</str>
-        <str name="df">title_tsim</str>
-        <str name="qf">
-          id
-          full_title_tsim
-          short_title_tsim
-          alternative_title_tsim
-          title_tsim
-          author_tsim
-          subject_tsim
-          all_text_timv
-        </str>
-        <str name="pf">
-          all_text_timv^10
-        </str>
-
-       <str name="author_qf">
-          author_tsim
-       </str>
-       <str name="author_pf">
-       </str>
-       <str name="title_qf">
-          title_tsim
-          full_title_tsim
-          short_title_tsim
-          alternative_title_tsim
-       </str>
-       <str name="title_pf">
-       </str>
-       <str name="subject_qf">
-          subject_tsim
-       </str>
-       <str name="subject_pf">
-       </str>
-
-       <str name="fl">
-         *,
-         score
-       </str>
-
-       <str name="facet">true</str>
-       <str name="facet.mincount">1</str>
-       <str name="facet.limit">10</str>
+       <str name="facet.field">active_fedora_model_ssi</str>
        <str name="facet.field">subject_ssim</str>
 
        <str name="spellcheck">true</str>
@@ -253,8 +188,8 @@
 
   <requestHandler name="/replication" class="solr.ReplicationHandler" startup="lazy" />
 
-  <requestDispatcher>
-    <requestParsers multipartUploadLimitInKB="2048" />
+  <requestDispatcher handleSelect="true" >
+    <requestParsers enableRemoteStreaming="true" multipartUploadLimitInKB="2048" />
   </requestDispatcher>
 
   <requestHandler name="/analysis/field" startup="lazy" class="solr.FieldAnalysisRequestHandler" />

data/lib/generators/blacklight/test_support_generator.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 # Copy Blacklight test support material in place
 
 # Need the requires here so we can call the generator from environment.rb
@@ -17,7 +18,7 @@ module Blacklight
       copy_file "alternate_controller.rb", "app/controllers/alternate_controller.rb"
 
       routing_code = <<-EOF
-    resource :alternate, controller: 'alternate', only: [] do
+    resource :alternate, controller: 'alternate', only: [:index] do
       concerns :searchable
     end
       EOF
@@ -41,9 +42,10 @@ module Blacklight
     end
 
     def configure_action_mailer
-      insert_into_file "config/environments/test.rb", after: "config.action_mailer.delivery_method = :test\n" do <<-EOF
+      insert_into_file "config/environments/test.rb", after: "config.action_mailer.delivery_method = :test\n" do
+        <<-EOF
          config.action_mailer.default_options = {from: 'no-reply@example.org'}
-      EOF
+        EOF
       end
     end
   end

data/lib/generators/blacklight/user_generator.rb

@@ -25,7 +25,7 @@ module Blacklight
       gem "devise-guests", "~> 0.8"
 
       inside destination_root do
-        Bundler.with_clean_env do
+        Bundler.with_unbundled_env do
           run "bundle install"
         end
       end
@@ -36,12 +36,10 @@ module Blacklight
 
       # add the #to_s to the model.
       insert_into_file("app/models/#{model_name}.rb", before: /end(\n| )*$/) do
-        "\n  # Method added by Blacklight; Blacklight uses #to_s on your\n" \
-        "  # user class to get a user-displayable login/identifier for\n" \
-        "  # the account.\n" \
-        "  def to_s\n" \
-        "    email\n" \
-        "  end\n"
+        "\n  # Configuration added by Blacklight; Blacklight::User uses a method key on your\n" \
+          "  # user class to get a user-displayable login/identifier for\n" \
+          "  # the account.\n" \
+          "  self.string_display_key ||= :email\n"
       end
       gsub_file("config/initializers/devise.rb", "config.sign_out_via = :delete", "config.sign_out_via = :get")
     end
@@ -52,10 +50,10 @@ module Blacklight
       if File.exist?(File.expand_path(file_path, destination_root))
         inject_into_class file_path, model_name.classify do
           "\n  # Connects this user object to Blacklights Bookmarks." \
-          "\n  include Blacklight::User\n"
+            "\n  include Blacklight::User\n"
         end
       else
-        say_status "warning", <<-EOS.strip_heredoc, :yellow
+        say_status "warning", <<~EOS, :yellow
           Blacklight authenticated user functionality not installed, as a user model
           could not be found at /app/models/user.rb. If you used a different name,
           please re-run the migration and provide that name as an argument. E.g.:

data/lib/railties/blacklight.rake

@@ -19,9 +19,8 @@ namespace :blacklight do
     task seed: [:environment] do
       require 'yaml'
 
-      app_file = Rails.root && Rails.root + 'spec/fixtures/sample_solr_documents.yml'
-      file = ENV['FILE'] ||
-             (app_file && File.exist?(app_file) && app_file) ||
+      app_file = Rails.root && "#{Rails.root}spec/fixtures/sample_solr_documents.yml"
+      file = ENV.fetch('FILE') { (app_file && File.exist?(app_file) && app_file) } ||
              File.join(Blacklight.root, 'spec', 'fixtures', 'sample_solr_documents.yml')
       docs = YAML.safe_load(File.open(file))
       conn = Blacklight.default_index.connection
@@ -41,7 +40,7 @@ namespace :blacklight do
         exit 1
       end
     rescue => e
-      puts e
+      puts e.to_s
       exit 1
     end
 
@@ -71,7 +70,7 @@ namespace :blacklight do
         end
       rescue => e
         errors += 1
-        puts e
+        puts e.to_s
       end
 
       print " - search_results: "
@@ -93,7 +92,7 @@ namespace :blacklight do
         end
       rescue => e
         errors += 1
-        puts e
+        puts e.to_s
       end
 
       print " - fetch: "
@@ -113,7 +112,7 @@ namespace :blacklight do
         end
       rescue => e
         errors += 1
-        puts e
+        puts e.to_s
       end
 
       exit 1 if errors > 0