blacklight-spotlight 4.7.1 → 5.0.0.pre.alpha2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebea908eb8ae3ba884d61eb1b965f382443e87d479fd297f29c7f290f2bd5566
-  data.tar.gz: 2d73d341ada846d8870482711d63a020405185b3f3d75b8809f42ab67354790f
+  metadata.gz: d6b768d28b08beb72ad790c25c5bc961dde7f12aa0b9e518f3d8ff04ea326de6
+  data.tar.gz: 82ddfae5ccdd6b754a72050b5966dd3e11b4db6fda2a18f5bd2348a4c186e182
 SHA512:
-  metadata.gz: 3d9909da016ef1d4ac572ad2e1306b4cfe8fb9ed85e6f737d33e2619fcc71c7e4b2398ef71d4a04ed6ec7978821d1bf97d650958dc7e407c1823e59ea04910d5
-  data.tar.gz: 0d05c74d317579c3981ca44a93668c432ff786db7ec215315849eec0a095fa8f0e69dd98b032bdd6c696438790439686a4fd2c0e4fbfe99fa037f1258305e18f
+  metadata.gz: bc40beb8d7e6c7fe609279af38d5456112e32110e25f272fc8cb47274a212618f23aa14e50643a03abc93eb65b7f9013574e9435bab5dab68fdc2e6d79961c48
+  data.tar.gz: 494367ee396448177230ec9347b3c92ac628ba384b699e23c5dae86bca834f6ffbc390fe57fe94ed849b6493a5e37e9c3a3af46103457ed1359f332ce64e1a2a

data/README.md

@@ -9,17 +9,23 @@ Read more about what Spotlight is, our motivations for creating it, and how to i
 
 ## Requirements
 
-1. Ruby (2.7 or greater)
-2. Rails (5.2 or greater)
-3. Java (7 or greater) *for Solr*
+1. [Ruby](https://www.ruby-lang.org/) 3.1+
+2. [Ruby on Rails](https://rubyonrails.org/) 7.1+
+3. Java (11 or greater) *for Solr*
 4. ImageMagick (http://www.imagemagick.org/script/index.php) due to [carrierwave](https://github.com/carrierwaveuploader/carrierwave#adding-versions)
 
 ## Installation
 
-To bootstrap a new Rails application:
+To bootstrap a new Rails application using [importmap-rails](https://github.com/rails/importmap-rails):
 
 ```
-$ SKIP_TRANSLATION=1 rails new app-name -m https://raw.githubusercontent.com/projectblacklight/spotlight/main/template.rb
+$ SKIP_TRANSLATION=1 rails new app-name -m https://raw.githubusercontent.com/projectblacklight/spotlight/main/template.rb -a propshaft --css bootstrap
+```
+
+or using [jsbundling-rails](https://github.com/rails/jsbundling-rails) with [esbuild](https://esbuild.github.io/):
+
+```
+$ SKIP_TRANSLATION=1 rails new app-name -m https://raw.githubusercontent.com/projectblacklight/spotlight/main/template.rb -a propshaft -j esbuild --css bootstrap
 ```
 
 or from an existing Rails application:
@@ -51,7 +57,7 @@ $ solr_wrapper
 and the Rails development server:
 
 ```
-$ rails server
+$ bin/dev
 ```
 
 Go to http://localhost:3000 in your browser.
@@ -60,22 +66,34 @@ Go to http://localhost:3000 in your browser.
 
 ### Default ActionMailer configuration
 
-Spotlight introduces functionality that depends on being able to send emails to exhibit curators and contacts. Be sure to configure your application's environments appropriately (see the Rails Guide for [Action Mailer Configuration](http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration)).
+Spotlight introduces functionality that depends on being able to send emails to exhibit curators and contacts. Be sure to configure your application's environments appropriately (see the Rails Guide for [Action Mailer Configuration](https://guides.rubyonrails.org/v7.2/action_mailer_basics.html#action-mailer-configuration)).
 
 See the [Spotlight wiki](https://github.com/projectblacklight/spotlight/wiki) for more detailed information on configuring Spotlight.
 
 # Developing Spotlight
 
-Spotlight:
+## Branches
+
+* The `main` branch is for development of the upcoming 5.0 release.
+* The `4.x` series is on the [release-4.x](https://github.com/projectblacklight/spotlight/tree/release-4.x) branch for backports of features and bug fixes.
+
+## Spotlight
 
 * is a Rails engine and needs to be used in the context of a Rails application. We use [engine_cart](https://github.com/cbeer/engine_cart) to create an internal test application at .internal_test_app/
 * uses Solr as part of its integration tests. We use [solr_wrapper](https://github.com/cbeer/solr_wrapper) to manage the Solr instance used for development and test.
 
-Our `$ rake ci` and `$ rake spotlight:server` tasks utilize Solr and the testing rails app automatically.
-
 See more detailed instructions for development environment setup at ["Contributing to Spotlight"](https://github.com/projectblacklight/spotlight/wiki/Contributing-to-Spotlight)
 
-## With Docker
+## Run a development server
+
+### With EngineCart
+```
+$ rake spotlight:server
+```
+
+Then visit http://localhost:3000. A Solr instance will be running on port 8983. When using importmap (the default configuration), JavaScript changes in development should not require [bundling](#updating-the-javascript-bundle) or a server restart.
+
+### With Docker
 
 ```sh
 # because of how docker compose handles named images, running `docker compose up --build` will error when the Rails images have not been built locally
@@ -134,4 +152,4 @@ You only need to update `package.json` and prepare/publish the JavaScript packag
 5. Push the release to rubygems and GitHub: `bundle exec rake release`
 6. Run `npm publish` to push the JavaScript package to https://npmjs.org/package/spotlight-frontend
 
-See "Updating the JavaScript bundle" above for more details.
+See [Updating the JavaScript bundle](#updating-the-javascript-bundle) above for more details.

data/Rakefile

@@ -31,6 +31,13 @@ require 'engine_cart/rake_task'
 
 require 'spotlight/version'
 
+# Build with our opinionated defaults if none are provided.
+rails_options = ENV.fetch('ENGINE_CART_RAILS_OPTIONS', '')
+rails_options = "#{rails_options} -a propshaft" unless rails_options.match?(/-a\s|--asset-pipeline/)
+rails_options = "#{rails_options} -j importmap" unless rails_options.match?(/-j\s|--javascript/)
+rails_options = "#{rails_options} --css bootstrap" unless rails_options.match?(/--css/)
+ENV['ENGINE_CART_RAILS_OPTIONS'] = rails_options
+
 def system_with_error_handling(*args)
   Open3.popen3(*args) do |_stdin, stdout, stderr, thread|
     puts stdout.read
@@ -93,7 +100,7 @@ namespace :spotlight do
             system 'bin/rails spotlight:initialize spotlight_test:solr:seed'
             File.open('.initialized', 'w') {}
           end
-          system 'bin/rails s'
+          system 'bin/dev'
         end
       end
     end

data/app/assets/javascripts/spotlight/application.js

@@ -3,6 +3,5 @@
 //= require sir-trevor
 //= require clipboard
 //= require tiny-slider
-//= require typeahead.bundle.min.js
 
 //= require spotlight/spotlight