bankai 0.14.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe9b1776bfdff5af83481b22cec737cdb8195272b225596a5704768f54a2bf3f
-  data.tar.gz: bff0047859348263752e86c09db55faa42da2f2956d887cfdf90fb4bbdc1c769
+  metadata.gz: 071eeba50ff152ec4a06b72062f9945424e379239ae02f900a02931c96b06d12
+  data.tar.gz: db429ae75b6ddf8b6eb0923b3c60117465a0caa03b845396e9f680b01e98dcf6
 SHA512:
-  metadata.gz: c6b706b63a08723885ccc9a1ed219190bd023219970e1a464ee603c7c236485cc85e0962246b9130932f9ebb37b774861ed8c1ece28d2348b80d59879d1a71e9
-  data.tar.gz: efd17a139f4a3a821a2861fb019fbad3f79b2720edca691ba81cb50425d1214fb487b36ec04cc9a3c69d811c5073b6adb14ea86d421c2f0112cae75f951ce120
+  metadata.gz: ce4d77ed36e3dba7d184a9c4c7edcca8a88ec1687aa9a3e209eeda4ca802a2a3cfa03a79ac34adc4f1a04bb5b45b0a5122dbf1ea3e33a6d994faeacebf22a483
+  data.tar.gz: 1efdf6257b89a00dee66362de7fb606d54a00723051e4f35ec61d29f859f06ff4938c9279c25d3293d0af81a70005d176ce2b777310d221c0aa350fe3d997201

data/.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
       fail-fast: false
       matrix:
         ruby-version: ['3.2', '3.3', '3.4', '4.0']
-        rails-version: ['7.0', '7.1', '7.2', '8.1']
+        rails-version: ['8.0', '8.1']
 
     name: Ruby ${{ matrix.ruby-version }} / Rails ${{ matrix.rails-version }}
 

data/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
+this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Releases before 1.0.0 are not listed; see the [git tags](https://github.com/5xRuby/bankai/tags)
+for that history.
+
+## [Unreleased]
+
+## [1.0.0] - 2026-09-09
+
+The generated stack changed substantially and Rails 7 is no longer supported,
+so this release is not backwards compatible with `0.14`.
+
+### Changed
+
+- **Default database is now `sqlite3`** (was `postgresql`).
+- **Solid Queue / Cache / Cable are installed by default** — `--skip-solid` now
+  defaults to `false`.
+- **Falcon replaces Puma as the app server.** `puma` is filtered out of the
+  Gemfile, `config/puma.rb` is removed, and `bin/dev` runs
+  `falcon serve --bind http://localhost:3000 --count 1`.
+- **Thruster is now installed by default** (`--skip-thruster` defaults to
+  `false`) and fronts Falcon in the Dockerfile, for HTTP/2, public asset
+  caching, X-Sendfile and compression. TLS stays off unless `TLS_DOMAIN` is set.
+- **Generated projects use Minitest instead of RSpec.** The surrounding tooling
+  is unchanged: `factory_bot_rails`, `faker`, `shoulda-matchers`,
+  `database_rewinder`, `simplecov` and `simplecov-cobertura`. `shoulda-context`
+  is added so the `should` macro is available. Note that fixtures are not used:
+  DatabaseRewinder truncates every table, which conflicts with `fixtures :all`,
+  so `use_transactional_tests` is off and test data comes from factories.
+- **`.rubocop.yml` inherits `rubocop-rails-omakase`** instead of carrying
+  bankai's own cop list, and is written with `force: true` to overwrite the one
+  Rails generates. `rubocop-rspec` is replaced by `rubocop-minitest`.
+- `annotate` (unmaintained) is replaced by `annotaterb`.
+- `.gitlab-ci.yml` runs `bin/rails test`, and only declares `services:` when
+  PostgreSQL or MySQL is actually in use.
+- Scaffolded directories are now `test/factories`, `test/requests` and
+  `test/support/{matchers,mixins}`.
+- Development dependencies were unpinned from ancient versions (`rake ~> 13`,
+  `rubocop ~> 1.90`, `simplecov ~> 0.22`) so `bundle exec` works on Ruby 4.0.
+
+### Removed
+
+- **Rails 7 support.** The gem now requires `rails >= 8.0.0`; the CI matrix is
+  Ruby 3.2/3.3/3.4/4.0 x Rails 8.0/8.1. `falcon-rails` requires Rails >= 8.0,
+  so Rails 7 could only ever have run on a degraded path.
+- The `--skip-rspec` option. Use `--skip-test` (default `false`) instead.
+- The `RUBOCOP_VERSION` constant, now that RuboCop is not version-pinned in the
+  Gemfile template.
+- Dead version branches: the `SUPPORTED_DATABASES` fallback chain, the
+  pre-Rails-6 `app_name` branch, and the `options.skip_yarn?` block in the
+  gitignore template.
+
+### Fixed
+
+- `exe/bankai` computed its load path as `"#{dirname}../lib"`, missing a
+  separator, and appended rather than prepended it — so running it from a
+  checkout silently used the *installed* bankai gem, making local generator
+  changes untestable.
+- `TargetRubyVersion: <%= RUBY_VERSION %>` in the RuboCop template produced
+  `4.0.6` on Ruby 4.0, which RuboCop rejects (it only accepts `major.minor`),
+  breaking RuboCop in every generated project.
+- `templates/Gemfile.erb` replaces Rails' own Gemfile template wholesale, which
+  silently dropped everything Rails declares there (`solid_*`, `kamal`,
+  `rubocop-rails-omakase`). Those are now declared by bankai.
+- Deprecated Bundler platform names (`%i[mingw mswin x64_mingw]`) are now
+  `%i[windows jruby]` / `%i[mri windows]`.
+- The deprecated `SimpleCov.add_filter` call is now `SimpleCov.skip`.
+- Rails' Dockerfile `CMD` is rewritten to run `falcon serve`. It shipped as
+  `bin/rails server`, which cannot start Falcon — falcon-rails deliberately does
+  not load Falcon during boot, so the Rackup handler is unavailable and
+  `rails server` fails with "Could not find a server gem" — meaning the
+  generated Dockerfile would not have booted at all. With `--no-skip-thruster`
+  the `CMD` becomes `./bin/thrust sh -c 'exec ... --bind http://0.0.0.0:$PORT'`,
+  so `$PORT` expands in the shell Thruster starts rather than in one wrapping it.
+- `gem "thruster"` is declared in the Gemfile template, so `--no-skip-thruster`
+  actually installs it (same omission as `solid_*` and `kamal`).
+- The generated Gemfile now pins `gem 'bankai', '~> <major>.<minor>'`. It was
+  unpinned, so running an unreleased `exe/bankai` without `--path` silently
+  bundled an older published bankai and ran *its* `bankai:*` sub-generators;
+  now `bundle install` fails instead. `--path` replaces the whole line, since a
+  path source and a version requirement cannot both be given.
+
+[Unreleased]: https://github.com/5xRuby/bankai/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/5xRuby/bankai/compare/v0.14.0...v1.0.0

data/CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-Bankai is a Rails application template generator by 5xRuby (inspired by thoughtbot's Suspenders). It generates new Rails projects pre-configured with 5xRuby's standard tooling: RSpec, Rubocop, Overcommit, GitLab CI, and more.
+Bankai is a Rails application template generator by 5xRuby (inspired by thoughtbot's Suspenders). It generates new Rails projects pre-configured with 5xRuby's standard tooling: Minitest, Rubocop, Overcommit, GitLab CI, and more.
 
 The CLI entry point is `exe/bankai`, which invokes `Bankai::Generator`.
 
@@ -50,14 +50,24 @@ ERB templates for generated project files (Gemfile, .rubocop.yml, .gitlab-ci.yml
 
 ## Key Options
 
-The generator accepts: `--database` (postgresql/mysql2/sqlite3, default: postgresql), `--capistrano`, `--skip-rspec`, `--skip-kamal` (default: true), `--skip-solid` (default: true), `--skip-thruster` (default: true), `--api`, `--path` (local gem path for testing).
+The generator accepts: `--database` (postgresql/mysql2/sqlite3, default: sqlite3), `--capistrano`, `--skip-test`, `--skip-kamal` (default: true), `--skip-solid` (default: false), `--skip-thruster` (default: false), `--api`, `--path` (local gem path for testing).
 
 ## Rails Version Compatibility
 
-- Supports Rails 7.0 through 8.1+
-- Rails 8+ features (Kamal, Solid Queue/Cache/Cable, Thruster) are skipped by default
-- Rails 8+ auto-generates `.rubocop.yml`, so bankai skips its own rubocop config/autocorrect on Rails 8+
-- `inject_into_file` in sub-generators uses `Rails.application.configure do\n` as anchor (works across all Rails versions)
+- Supports Rails 8.0 and 8.1 only (Rails 7 support was dropped: falcon-rails requires Rails >= 8.0)
+- Defaults: sqlite3 + Solid Queue/Cache/Cable + falcon-rails as the app server
+- Tests are Minitest (Rails' default), with factory_bot + faker for data and DatabaseRewinder
+  instead of transactional fixtures; `templates/test_helper.rb` replaces the one Rails generates
+- Thruster is enabled by default and fronts Falcon; it is not Puma-specific (it proxies to
+  whatever command it wraps, passing the backend port via `$PORT`). Kamal stays skipped
+- `Builder#rewrite_dockerfile_cmd` rewrites Rails' Dockerfile `CMD`, which uses
+  `bin/rails server`. That cannot run Falcon: falcon-rails deliberately avoids loading
+  Falcon during boot, so the Rackup handler is unavailable and `rails server` reports
+  "Could not find a server gem". Use `falcon serve` directly
+- `templates/Gemfile.erb` replaces Rails' own Gemfile wholesale, so anything Rails declares in its Gemfile template (solid_*, kamal, rubocop-rails-omakase) must be repeated there
+- `.rubocop.yml` inherits `rubocop-rails-omakase`; bankai writes it with `force: true` to overwrite the one Rails 8 generates
+- Puma is filtered out of `gemfile_entries`; `Builder#remove_puma_config` deletes `config/puma.rb` and rewrites `bin/dev` to run `falcon serve`
+- `inject_into_file` in sub-generators uses `Rails.application.configure do\n` as anchor
 - `Bundler.with_unbundled_env` wraps sub-generator invocations and `rails_command` to prevent Bundler env leakage
 
 ## Testing Locally
@@ -74,5 +84,5 @@ cd /tmp && bankai testapp --skip-rspec
 
 - All Ruby files use `# frozen_string_literal: true`
 - Version constants are in `lib/bankai/version.rb`
-- Required Ruby version: >= 3.2.0
+- Required Ruby version: >= 3.2.0; CI matrix is Ruby 3.2/3.3/3.4/4.0 x Rails 8.0/8.1
 - Generated project README templates are in Traditional Chinese (zh-TW)

data/README.md

@@ -20,20 +20,24 @@ bankai projectname
 ## Requirement
 
 * Ruby >= 3.2.0
-* `~> 0.13` required `rails >= 7.0` (tested up to Rails 8.1)
+* `>= 1.0` requires `rails >= 8.0` (tested against Rails 8.0 and 8.1)
+* `~> 0.13` required `rails >= 7.0`
 * `<= 0.12` required `rails >= 5.2`
 
+See [CHANGELOG.md](CHANGELOG.md) for what changed in 1.0.
+
 ## Gemfile
 
 * [Oj](http://www.ohler.com/oj/)
+* [Falcon](https://github.com/socketry/falcon-rails) - app server (replaces Puma)
 
 ### Development
 
 * [Brakeman](https://github.com/presidentbeef/brakeman)
 * [Bundler Audit](https://github.com/rubysec/bundler-audit)
-* [Rubocop](https://github.com/bbatsov/rubocop)
+* [Rubocop](https://github.com/rubocop/rubocop) - inherits [rubocop-rails-omakase](https://github.com/rails/rubocop-rails-omakase)
 * [Rack Mini Profiler](https://github.com/MiniProfiler/rack-mini-profiler) - Enable with `RACK_MINI_PROFILER=1`
-* [Annotate](https://github.com/ctran/annotate_models)
+* [AnnotateRb](https://github.com/drwl/annotaterb)
 * [Bullet](https://github.com/flyerhzm/bullet)
 * [Dotenv](https://github.com/bkeepers/dotenv)
 * [Letter Opener](https://github.com/ryanb/letter_opener)
@@ -42,11 +46,13 @@ bankai projectname
 
 ### Test
 
+* [Minitest](https://guides.rubyonrails.org/testing.html) - Rails' built-in test framework
 * [Capybara](https://github.com/teamcapybara/capybara)
 * [Factory Bot](https://github.com/thoughtbot/factory_bot)
-* [Faker](https://github.com/stympy/faker)
-* [Rspec](https://github.com/rspec/rspec)
+* [Faker](https://github.com/faker-ruby/faker)
+* [Shoulda Context](https://github.com/thoughtbot/shoulda-context)
 * [Shoulda Matchers](https://github.com/thoughtbot/shoulda-matchers)
+* [Database Rewinder](https://github.com/amatsuda/database_rewinder)
 * [Simplecov](https://github.com/colszowka/simplecov) - Enable with `COVERAGE=1`
 
 ## Others
@@ -62,12 +68,28 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ### Test Gem
 
-If you want to test the changes for generator is works well, you can add `--path` options to use your local version
+To try your local changes, run `exe/bankai` straight out of the checkout and
+point `--path` at that same checkout:
 
 ```
-bankai projectname --path=YOUR_LOCAL_GEM_PATH
+cd /somewhere/else
+ruby /path/to/bankai/exe/bankai projectname --path=/path/to/bankai
 ```
 
+Both parts matter, and they do different things:
+
+* which `exe/bankai` you run decides whose `lib/` and `templates/` generate the app
+* `--path` decides which bankai the **generated app** bundles, and therefore
+  which version runs the `bankai:*` sub-generators (testing, ci, lint, ...)
+
+Without `--path` the generated Gemfile asks for the released
+`gem 'bankai', '~> <major>.<minor>'`, so an unreleased version fails at
+`bundle install` rather than silently running an older gem's sub-generators.
+
+Do not run this from inside the bankai repo, and do not set `BUNDLE_GEMFILE` —
+the generated app's `bundle install` would then resolve against bankai's own
+Gemfile.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/5xRuby/bankai. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

data/bankai.gemspec

@@ -29,11 +29,11 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'bundler-audit'
   spec.add_development_dependency 'overcommit'
-  spec.add_development_dependency 'rake', '~> 12.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'rspec_junit_formatter'
-  spec.add_development_dependency 'rubocop', '~> 1.8.1'
-  spec.add_development_dependency 'simplecov', '~> 0.17.1'
+  spec.add_development_dependency 'rubocop', '~> 1.90'
+  spec.add_development_dependency 'simplecov', '~> 0.22'
 
   # TODO: Allow specify rails version
   spec.add_dependency 'rails', ">= #{Bankai::RAILS_VERSION}"

data/exe/bankai

@@ -1,10 +1,9 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require 'pathname'
-
-source_path = File.expand_path("#{Pathname.new(__FILE__).dirname}../lib")
-$LOAD_PATH << source_path
+# Prepend, so running this file straight out of a checkout uses that checkout
+# rather than whichever bankai gem happens to be installed.
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
 
 require 'bankai'
 

data/lib/bankai/builder.rb

@@ -3,6 +3,15 @@
 module Bankai
   # :nodoc:
   class Builder < Rails::AppBuilder
+    # Thruster sets $PORT for its child, so the expansion has to happen in a
+    # shell that Thruster itself starts, not in one wrapping it.
+    DOCKERFILE_CMD_REPLACEMENTS = {
+      'CMD ["./bin/thrust", "./bin/rails", "server"]' =>
+        'CMD ["./bin/thrust", "sh", "-c", "exec bundle exec falcon serve --bind http://0.0.0.0:$PORT"]',
+      'CMD ["./bin/rails", "server"]' =>
+        'CMD ["bundle", "exec", "falcon", "serve", "--bind", "http://0.0.0.0:3000"]'
+    }.freeze
+
     def readme
       template 'README.md.erb', 'README.md'
     end
@@ -17,20 +26,44 @@ module Bankai
 
     def replace_gemfile(path)
       template 'Gemfile.erb', 'Gemfile', force: true do |content|
-        if path
-          content.gsub(/gem .bankai./) { |s| %(#{s}, path: "#{path}") }
-        else
-          content
+        next content unless path
+
+        # Replace the whole line: a path source and a version requirement
+        # cannot both be given.
+        content.sub(/^(\s*)gem 'bankai'.*$/) do
+          %(#{Regexp.last_match(1)}gem 'bankai', path: "#{path}")
         end
       end
     end
 
-    def configure_puma_dev
+    def configure_dev_hosts
       application(nil, env: 'development') do
         "config.hosts << '.test'"
       end
     end
 
+    # Falcon replaces Puma as the app server.
+    def remove_puma_config
+      remove_file('config/puma.rb')
+      create_file('bin/dev', <<~SH, force: true)
+        #!/usr/bin/env sh
+        exec bundle exec falcon serve --bind http://localhost:3000 --count 1 "$@"
+      SH
+      chmod('bin/dev', 0o755)
+      rewrite_dockerfile_cmd
+    end
+
+    # Rails' Dockerfile boots the app with `bin/rails server`, which cannot run
+    # Falcon: falcon-rails deliberately avoids loading Falcon during boot, so
+    # the Rackup handler is unavailable. Run `falcon serve` directly instead.
+    def rewrite_dockerfile_cmd
+      return unless File.exist?("#{destination_root}/Dockerfile")
+
+      DOCKERFILE_CMD_REPLACEMENTS.each do |from, to|
+        gsub_file('Dockerfile', from, to, verbose: false)
+      end
+    end
+
     def configure_quiet_assets
       return if options[:api]
       return if options[:skip_asset_pipeline]
@@ -40,16 +73,11 @@ module Bankai
       end
     end
 
-    # rubocop:disable Metrics/MethodLength
     def configure_generators
       application do
         <<-RUBY
     config.generators do |generate|
       generate.helper false
-      generate.request_specs false
-      generate.routing_specs false
-      generate.test_framework :rspec
-      generate.view_specs false
     end
         RUBY
       end
@@ -57,17 +85,14 @@ module Bankai
 
     def setup_default_directories
       [
-        'spec/lib',
-        'spec/controllers',
-        'spec/helpers',
-        'spec/support/matchers',
-        'spec/support/mixins',
-        'spec/support/shared_examples'
+        'test/factories',
+        'test/requests',
+        'test/support/matchers',
+        'test/support/mixins'
       ].each do |dir|
         empty_directory_with_keep_file dir
       end
     end
-    # rubocop:enable Metrics/MethodLength
 
     def clear_seed_file
       File.write("#{destination_root}/db/seeds.rb", '')

data/lib/bankai/generator.rb

@@ -9,34 +9,23 @@ module Bankai
   class Generator < Rails::Generators::AppGenerator
     hide!
 
-    SUPPORTED_DATABASES = if defined?(Rails::Generators::Database::DATABASES)
-                            Rails::Generators::Database::DATABASES
-                          elsif defined?(DATABASES)
-                            DATABASES
-                          else
-                            %w[postgresql mysql2 sqlite3]
-                          end
-
-    class_option :database, type: :string, aliases: '-d', default: 'postgresql',
+    class_option :database, type: :string, aliases: '-d', default: 'sqlite3',
                             desc: 'Configure for selected database ' \
-                                  "(options: #{SUPPORTED_DATABASES.join('/')})"
+                                  "(options: #{Rails::Generators::Database::DATABASES.join('/')})"
 
     class_option :capistrano, type: :boolean, default: false,
                               desc: 'Use Capistrano'
 
-    class_option :skip_test, type: :boolean, default: true,
+    class_option :skip_test, type: :boolean, default: false,
                              desc: 'Skip test files'
 
-    class_option :skip_rspec, type: :boolean, default: false,
-                              desc: 'Skip rspec files'
-
     class_option :skip_kamal, type: :boolean, default: true,
                               desc: 'Skip Kamal setup'
 
-    class_option :skip_solid, type: :boolean, default: true,
+    class_option :skip_solid, type: :boolean, default: false,
                               desc: 'Skip Solid Queue/Cache/Cable setup'
 
-    class_option :skip_thruster, type: :boolean, default: true,
+    class_option :skip_thruster, type: :boolean, default: false,
                                  desc: 'Skip Thruster setup'
 
     class_option :path, type: :string, default: nil,
@@ -52,6 +41,7 @@ module Bankai
       invoke :setup_development_environment
       invoke :configure_app
       invoke :setup_dotfiles
+      invoke :install_binstubs
       invoke :generate_default
       invoke :setup_default_directories
     end
@@ -64,7 +54,8 @@ module Bankai
     def setup_development_environment
       say 'Setting up the development environment'
       build :configure_quiet_assets
-      build :configure_puma_dev
+      build :configure_dev_hosts
+      build :remove_puma_config
       build :configure_generators
       build :clear_seed_file
       # TODO: Add setup script
@@ -80,16 +71,19 @@ module Bankai
       build :copy_dotfiles
     end
 
-    def generate_default
+    def install_binstubs
       run('bundle binstubs bundler')
+    end
+
+    def generate_default
       Bundler.with_original_env do
-        generate('bankai:testing') unless options[:skip_rspec]
+        generate('bankai:testing') unless options[:skip_test]
         generate('bankai:ci', options.api? ? '--api' : '')
         generate('bankai:json')
         generate('bankai:db_optimizations')
         generate('bankai:mailer')
         generate('bankai:deploy') if options[:capistrano]
-        generate('annotate:install')
+        generate('annotate_rb:install')
         generate('bankai:lint')
       end
     end
@@ -99,7 +93,7 @@ module Bankai
     end
 
     def depends_on_system_test?
-      !(options[:skip_system_test] || options[:skip_rspec] || options[:api])
+      !(options[:skip_system_test] || options[:skip_test] || options[:api])
     end
 
     def self.banner

data/lib/bankai/generators/base.rb

@@ -15,11 +15,7 @@ module Bankai
       private
 
       def app_name
-        if Rails::VERSION::MAJOR >= 6
-          Rails.app_class.module_parent_name.demodulize.underscore.dasherize
-        else
-          Rails.app_class.parent_name.demodulize.underscore.dasherize
-        end
+        Rails.app_class.module_parent_name.demodulize.underscore.dasherize
       end
     end
   end

data/lib/bankai/generators/lint_generator.rb

@@ -10,10 +10,9 @@ module Bankai
         template 'overcommit.yml.erb', '.overcommit.yml'
       end
 
+      # Overwrites the .rubocop.yml Rails 8 generates for itself.
       def configure_rubocop
-        return if Rails::VERSION::MAJOR >= 8
-
-        template 'rubocop.yml.erb', '.rubocop.yml'
+        template 'rubocop.yml.erb', '.rubocop.yml', force: true
       end
 
       def install_overcommit
@@ -21,14 +20,10 @@ module Bankai
       end
 
       def rubocop_autocorrect
-        return if Rails::VERSION::MAJOR >= 8
-
-        run 'bundle exec rubocop --auto-correct-all'
+        run 'bundle exec rubocop --autocorrect-all'
       end
 
       def rubocop_todo
-        return if Rails::VERSION::MAJOR >= 8
-
         run 'bundle exec rubocop --auto-gen-config'
       end
     end

data/lib/bankai/generators/testing_generator.rb

@@ -6,29 +6,20 @@ module Bankai
   module Generators
     # :nodoc:
     class TestingGenerator < Base
-      def generate_rspec
-        generate 'rspec:install'
+      def configure_minitest
+        template 'test_helper.rb', 'test/test_helper.rb', force: true
       end
 
-      def configure_rspec
-        remove_file 'spec/rails_helper.rb'
-        remove_file 'spec/spec_helper.rb'
-        copy_file 'rails_helper.rb', 'spec/rails_helper.rb'
-        copy_file 'spec_helper.rb', 'spec/spec_helper.rb'
+      def provide_coverage_config
+        copy_file 'test/coverage.rb', 'test/support/coverage.rb'
       end
 
       def provide_shoulda_matchers_config
-        copy_file(
-          'spec/shoulda_matchers.rb',
-          'spec/support/shoulda_matchers.rb'
-        )
+        copy_file 'test/shoulda_matchers.rb', 'test/support/shoulda_matchers.rb'
       end
 
       def provide_database_rewinder_config
-        copy_file(
-          'spec/database_rewinder.rb',
-          'spec/support/database_rewinder.rb'
-        )
+        copy_file 'test/database_rewinder.rb', 'test/support/database_rewinder.rb'
       end
     end
   end

data/lib/bankai/version.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module Bankai
-  VERSION = '0.14.0'
-  RAILS_VERSION = '7.0.0'
-  RUBOCOP_VERSION = '1.24.1'
-  CAPISTRANO_VERSION = '3.16.0'
+  VERSION = '1.0.0'
+  RAILS_VERSION = '8.0.0'
+  CAPISTRANO_VERSION = '3.19.2'
 end

data/templates/Gemfile.erb

@@ -3,7 +3,7 @@ git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 
 ruby '<%= RUBY_VERSION -%>'
 
-<% gemfile_entries.each do |gemfile_entry| %>
+<% gemfile_entries.reject { |entry| entry.name == 'puma' }.each do |gemfile_entry| %>
 <%= gemfile_entry %>
 <% end -%>
 <% unless options.minimal? -%>
@@ -15,22 +15,39 @@ ruby '<%= RUBY_VERSION -%>'
 # gem "bcrypt", "~> 3.1.7"
 <% end -%>
 
+# Use Falcon as the app server [https://github.com/socketry/falcon-rails]
+gem "falcon-rails"
+
 # Windows does not include zoneinfo files, so bundle the tzinfo-data gem
-gem "tzinfo-data", platforms: %i[ mingw mswin x64_mingw jruby ]
+gem "tzinfo-data", platforms: %i[ windows jruby ]
+<% unless options.skip_solid? -%>
+
+# Use the database-backed adapters for Rails.cache, Active Job, and Action Cable
+gem "solid_cache"
+gem "solid_queue"
+<% unless options.skip_action_cable? -%>
+gem "solid_cable"
+<% end -%>
+<% end -%>
+<% unless options.skip_kamal? -%>
+
+# Deploy this application anywhere as a Docker container [https://kamal-deploy.org]
+gem "kamal", require: false
+<% end -%>
+<% unless options.skip_thruster? -%>
+
+# Add HTTP asset caching/compression and X-Sendfile acceleration [https://github.com/basecamp/thruster/]
+gem "thruster", require: false
+<% end -%>
 <% if depend_on_bootsnap? -%>
 
 # Reduces boot times through caching; required in config/boot.rb
 gem "bootsnap", require: false
 <% end -%>
-<% unless (respond_to?(:skip_sprockets?) ? skip_sprockets? : true) || options.minimal? -%>
-
-# Use Sass to process CSS
-# gem "sassc-rails"
-<% end -%>
 <% unless skip_active_storage? -%>
 
 # Use Active Storage variants [https://guides.rubyonrails.org/active_storage_overview.html#transforming-images]
-# gem "image_processing", "~> 1.2"
+gem "image_processing", "~> 1.2"
 <% end -%>
 <%- if options.api? -%>
 
@@ -41,27 +58,24 @@ gem "bootsnap", require: false
 
 group :development, :test do
   # See https://guides.rubyonrails.org/debugging_rails_applications.html#debugging-with-the-debug-gem
-  gem "debug", platforms: %i[ mri mingw x64_mingw ]
+  gem "debug", platforms: %i[ mri windows ], require: "debug/prelude"
 
   gem 'brakeman', require: false
   gem 'bundler-audit', require: false
-  gem 'rubocop', '~> <%= Bankai::RUBOCOP_VERSION %>', require: false
-  gem 'rubocop-performance', require: false
-  gem 'rubocop-rails', require: false
-  gem 'rubocop-rspec', require: false
+  gem 'rubocop-rails-omakase', require: false
+  gem 'rubocop-minitest', require: false
 
-<%- unless options[:skip_rspec] -%>
+<%- unless options[:skip_test] -%>
   gem 'database_rewinder'
   gem 'factory_bot_rails'
   gem 'faker'
-  gem 'rspec', require: false
-  gem 'rspec-rails', require: false
+  gem 'shoulda-context', require: false
   gem 'shoulda-matchers', require: false
   gem 'simplecov', require: false
   gem 'simplecov-cobertura', require: false
 <%- end -%>
 
-  gem 'bankai'
+  gem 'bankai', '~> <%= Bankai::VERSION.split('.').first(2).join('.') %>'
   gem 'oj'
 end
 <% end -%>
@@ -75,9 +89,6 @@ group :development do
   # gem "rack-mini-profiler"
 
 <%- end -%>
-  # Speed up commands on slow machines / big apps [https://github.com/rails/spring]
-  # gem "spring"
-
 <% if options[:capistrano] -%>
   gem 'capistrano', '<%= Bankai::CAPISTRANO_VERSION %>'
   gem 'capistrano-bundler'
@@ -86,7 +97,7 @@ group :development do
   # gem 'capistrano-passenger'
 <% end -%>
 
-  gem 'annotate'
+  gem 'annotaterb'
   gem 'bullet'
   gem 'dotenv-rails'
   gem 'letter_opener'

data/templates/README.md.erb

@@ -173,15 +173,21 @@ bundle exec rake db:migrate
 和 Rails 伺服器同時打開後，就可以看到正常的網站畫面
 
 <%- end -%>
-<%- unless options[:skip_rspec] -%>
+<%- unless options[:skip_test] -%>
 ### 運行測試
 
-這個專案使用 RSpec 進行測試，可以透過執行以下指令運行
+這個專案使用 Minitest 進行測試，可以透過執行以下指令運行
 
 ```bash
-bundle exec rspec
+bin/rails test           # 全部
+bin/rails test test/models/user_test.rb
+bin/rails test test/models/user_test.rb:42
+COVERAGE=1 bin/rails test # 加上覆蓋率報告
 ```
 
+測試資料使用 factory_bot（factory 放在 `test/factories/`）與 faker，
+資料庫由 DatabaseRewinder 在每個 test 後清空，所以沒有使用 fixtures。
+
 <%- end -%>
 ### Ruby 語法檢查
 

data/templates/gitignore.erb

@@ -11,6 +11,7 @@
 # Ignore the default SQLite database.
 /db/*.sqlite3
 /db/*.sqlite3-journal
+/storage/*.sqlite3*
 
 <% end -%>
 # Ignore all logfiles and tempfiles.
@@ -31,21 +32,14 @@
 <% end -%>
 <% end -%>
 
-<% unless options.skip_yarn? -%>
-/node_modules
-yarn-debug.log*
-yarn-error.log*
-.yarn-integrity
-
-<% end -%>
 <% unless options.api? -%>
 /public/assets
 <% end -%>
 .byebug_history
 
-<% unless options[:skip_rspec] -%>
+<% unless options[:skip_test] -%>
 /coverage/
-/spec/tmp
+/test/tmp
 <% end -%>
 
 # Dotenv

data/templates/gitlab-ci.yml.erb

@@ -74,10 +74,12 @@ bundler-leak:
     - if: $CI_MERGE_REQUEST_ID
     - if: $CI_PIPELINE_SOURCE == 'schedule'
 
-rspec:
+minitest:
   extends: .common
   stage: test
+<%- if pg? || mysql? -%>
   services:
+<%- end -%>
 <%- if pg? -%>
     - postgres:16-alpine
 <%- end -%>
@@ -87,7 +89,7 @@ rspec:
 <%- end -%>
   script:
     - bundle exec rake db:migrate
-    - bundle exec rspec
+    - bin/rails test
   rules:
     - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
     - if: $CI_MERGE_REQUEST_ID

data/templates/rubocop.yml.erb

@@ -1,28 +1,18 @@
-require:
+inherit_gem:
+  rubocop-rails-omakase: rubocop.yml
+
+plugins:
   - rubocop-performance
   - rubocop-rails
-  - rubocop-rspec
+  - rubocop-minitest
 
 inherit_mode:
   merge:
     - Exclude
 
 AllCops:
-  NewCops: enable
-  TargetRubyVersion: <%= RUBY_VERSION %>
-  DisplayCopNames: true
   SuggestExtensions: false
   Exclude:
-    - vendor/ruby/**/*
+    - vendor/**/*
     - node_modules/**/*
-    - .licenses/**/*
-Rails:
-  Enabled: true
-Metrics/BlockLength:
-  Exclude:
-    - db/migrate/*
-    - config/environments/*
-    - lib/tasks/**/*
-    - spec/**/*
-Style/Documentation:
-  Enabled: false
+    - db/schema.rb

data/templates/test/coverage.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+return unless ENV.fetch('COVERAGE', false) || ENV.fetch('CI', false)
+
+require 'simplecov'
+require 'simplecov-cobertura'
+
+SimpleCov.formatter = SimpleCov::Formatter::CoberturaFormatter if ENV.fetch('GITLAB_CI', false)
+SimpleCov.refuse_coverage_drop
+
+SimpleCov.start 'rails' do
+  skip 'vendor'
+end

data/templates/test/database_rewinder.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+DatabaseRewinder.clean_all
+
+module DatabaseRewinderCleanup
+  def after_teardown
+    super
+    DatabaseRewinder.clean
+  end
+end
+
+ActiveSupport::TestCase.include(DatabaseRewinderCleanup)

data/templates/{spec → test}/shoulda_matchers.rb

@@ -2,7 +2,7 @@
 
 Shoulda::Matchers.configure do |config|
   config.integrate do |with|
-    with.test_framework :rspec
+    with.test_framework :minitest
     with.library :rails
   end
 end

data/templates/test_helper.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# Must be loaded before the application, so SimpleCov sees every file.
+require_relative 'support/coverage'
+
+ENV['RAILS_ENV'] ||= 'test'
+require_relative '../config/environment'
+
+abort('The Rails is running in production mode!') if Rails.env.production?
+
+require 'rails/test_help'
+require 'shoulda-context'
+require 'shoulda/matchers'
+require 'faker'
+
+Dir[Rails.root.join('test/support/**/*.rb')].each { |f| require f }
+
+module ActiveSupport
+  # :nodoc:
+  class TestCase
+    include FactoryBot::Syntax::Methods
+
+    # Test data comes from factories, so there are no fixtures to preserve and
+    # DatabaseRewinder does the cleaning instead of a wrapping transaction.
+    self.use_transactional_tests = false
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bankai
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 1.0.0
 platform: ruby
 authors:
 - 5xRuby
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -86,42 +86,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: '1.90'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: '1.90'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.1
+        version: '0.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.1
+        version: '0.22'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.0.0
+        version: 8.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.0.0
+        version: 8.0.0
 description: The tool to generate Rails template for 5xRuby
 email:
 - hi@5xruby.tw
@@ -139,6 +139,7 @@ files:
 - ".rubocop.yml"
 - ".ruby-version"
 - ".travis.yml"
+- CHANGELOG.md
 - CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -172,11 +173,11 @@ files:
 - templates/gitlab-ci.yml.erb
 - templates/overcommit.yml.erb
 - templates/rack_mini_profiler.rb
-- templates/rails_helper.rb
 - templates/rubocop.yml.erb
-- templates/spec/database_rewinder.rb
-- templates/spec/shoulda_matchers.rb
-- templates/spec_helper.rb
+- templates/test/coverage.rb
+- templates/test/database_rewinder.rb
+- templates/test/shoulda_matchers.rb
+- templates/test_helper.rb
 homepage: https://github.com/5xRuby/bankai
 licenses: []
 metadata: {}
@@ -194,7 +195,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.16
 specification_version: 4
 summary: The Rails template for 5xRuby
 test_files: []

data/templates/rails_helper.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-ENV['RAILS_ENV'] ||= 'test'
-require File.expand_path('../config/environment', __dir__)
-
-abort('The Rails is running in production mode!') if Rails.env.production?
-require 'rspec/rails'
-
-require 'shoulda/matchers'
-require 'faker'
-require 'factory_bot'
-
-Dir[Rails.root.join('spec/support/**/*.rb')].sort.each { |f| require f }
-
-begin
-  ActiveRecord::Migration.maintain_test_schema!
-rescue ActiveRecord::PendingMigrationError => e
-  puts e.to_s.strip
-  exit 1
-end
-RSpec.configure do |config|
-  config.fixture_path = "#{::Rails.root}/spec/fixtures"
-
-  config.use_transactional_fixtures = false
-  config.infer_spec_type_from_file_location!
-  config.filter_rails_from_backtrace!
-
-  config.include FactoryBot::Syntax::Methods
-  # config.include Devise::Test::IntegrationHelpers, type: :request
-end

data/templates/spec/database_rewinder.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-RSpec.configure do |config|
-  config.before(:suite) do
-    DatabaseRewinder.clean_all
-  end
-
-  config.after do
-    DatabaseRewinder.clean
-  end
-end

data/templates/spec_helper.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-if ENV.fetch('COVERAGE', false) || ENV.fetch('CI', false)
-  require 'simplecov'
-  require 'simplecov-cobertura'
-
-  SimpleCov.formatter = SimpleCov::Formatter::CoberturaFormatter if ENV.fetch('GITLAB_CI', false)
-  SimpleCov.refuse_coverage_drop
-
-  SimpleCov.start 'rails' do
-    add_filter 'vendor'
-  end
-end
-
-RSpec.configure do |config|
-  config.expect_with :rspec do |expectations|
-    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
-  end
-
-  config.mock_with :rspec do |mocks|
-    mocks.verify_partial_doubles = true
-  end
-
-  config.shared_context_metadata_behavior = :apply_to_host_groups
-
-  config.expect_with :rspec do |c|
-    c.syntax = :expect
-  end
-end