railties 7.0.10 → 7.1.0.beta1

data/CHANGELOG.md

@@ -1,453 +1,784 @@
-## Rails 7.0.10 (October 28, 2025) ##
+## Rails 7.1.0.beta1 (September 13, 2023) ##
 
-*   No changes.
+*   `rails new --javascript` generator now supports Bun
 
+    ```bash
+    rails new my_new_app --javascript=bun
+    ```
 
-## Rails 7.0.9 (October 28, 2025) ##
+    *Jason Meller*
 
-*   No changes.
+*   bin/setup uses `bun` instead of `yarn` when generated an app with bun
 
+    Use `bun install` on `bin/setup` when using `bun`.
 
-## Rails 7.0.8.7 (December 10, 2024) ##
+    *Cadu Ribeiro*
 
-*   No changes.
+*   `config/application.rb` now includes
 
+    ```ruby
+    config.autoload_lib(ignore: %w(assets tasks))
+    ```
 
-## Rails 7.0.8.6 (October 23, 2024) ##
+    In practice, this means that new 7.1 applications autoload from `lib` out of the box.
 
-*   No changes.
+    *Xavier Noria*
 
+*   Add an option to start rails console in sandbox mode by default
 
-## Rails 7.0.8.5 (October 15, 2024) ##
+    `sandbox_by_default` option is added to start rails console in sandbox
+    mode by default. With this option turned on, `--no-sandbox` must be
+    specified to start rails in non-sandbox mode.
 
-*   No changes.
+    Note that this option is ignored when rails environment is development
+    or test.
 
+    *Shouichi Kamiya*
 
-## Rails 7.0.8.4 (June 04, 2024) ##
+*   Omit `webdrivers` gem dependency from `Gemfile` template
 
-*   No changes.
+    *Sean Doyle*
 
+*   Support filtering tests by line ranges
 
-## Rails 7.0.8.3 (May 17, 2024) ##
+    The new syntax allows you to filter tests by line ranges. For example, the
+    following command runs tests from line 10 to 20.
 
-*   No changes.
+    ```bash
+    $ rails test test/models/user_test.rb:10-20
+    ```
 
+    *Shouichi Kamiya*, *Seonggi Yang*, *oljfte*, *Ryohei UEDA*
 
-## Rails 7.0.8.2 (May 16, 2024) ##
+*   Update default scaffold templates to set 303 (See Other) as status code
+    on redirect for the update action for XHR requests other than GET or POST
+    to avoid issues (e.g browsers trying to follow the redirect using the
+    original request method resulting in double PATCH/PUT)
 
-*   No changes.
+    *Guillermo Iguaran*
 
+*   The new `config.autoload_lib_once` is similar to `config.autoload_lib`,
+    except that it adds `lib` to `config.autoload_once_paths` instead.
 
-## Rails 7.0.8.1 (February 21, 2024) ##
+    By calling `config.autoload_lib_once`, classes and modules in `lib` can be
+    autoloaded, even from application initializers, but won't be reloaded.
 
-*   No changes.
+    Please, see further details in the [autoloading
+    guide](https://guides.rubyonrails.org/v7.1/autoloading_and_reloading_constants.html).
 
+    *Xavier Noria*
 
-## Rails 7.0.8 (September 09, 2023) ##
+*   Add `config.action_dispatch.debug_exception_log_level` to configure the log
+    level used by `ActionDispatch::DebugExceptions`.
 
-*   Omit `webdrivers` gem dependency from `Gemfile` template
+    The default is `:fatal`, but with `load_defaults "7.1"` the default will be
+    `:error`.
 
-    *Sean Doyle*
+    *Hartley McGuire*
 
-## Rails 7.0.7.2 (August 22, 2023) ##
+*   Add `DATABASE` option to `railties:install:migrations`
 
-*   No changes.
+    This allows you to specify which database the migrations should be copied to
+    when running `rails railties:install:migrations`.
 
+    ```bash
+    $ rails railties:install:migrations DATABASE=animals
+    ```
 
-## Rails 7.0.7.1 (August 22, 2023) ##
+    *Matthew Hirst*
 
-*   No changes.
+*   The new method `config.autoload_lib(ignore:)` provides a simple way to
+    autoload from `lib`:
 
+    ```ruby
+    # config/application.rb
+    config.autoload_lib(ignore: %w(assets tasks))
+    ```
 
-## Rails 7.0.7 (August 09, 2023) ##
+    Please, see further details in the [autoloading
+    guide](https://guides.rubyonrails.org/v7.1/autoloading_and_reloading_constants.html).
 
-*   Update default scaffold templates to set 303 (See Other) as status code
-    on redirect for the update action for XHR requests other than GET or POST
-    to avoid issues (e.g browsers trying to follow the redirect using the
-    original request method resulting in double PATCH/PUT)
+    *Xavier Noria*
 
-    *Guillermo Iguaran*
+*   Don't show secret_key_base for `Rails.application.config#inspect`.
 
+    Before:
 
-## Rails 7.0.6 (June 29, 2023) ##
-*   Avoid escaping paths when editing credentials.
+    ```ruby
+    Rails.application.config.inspect
+    "#<Rails::Application::Configuration:0x00000001132b02a0 @root=... @secret_key_base=\"b3c631c314c0bbca50c1b2843150fe33\" ... >"
+    ```
 
-    *Jonathan Hefner*
+    After:
 
+    ```ruby
+    Rails.application.config.inspect
+    "#<Rails::Application::Configuration:0x00000001132b02a0>"
+    ```
 
-## Rails 7.0.5.1 (June 26, 2023) ##
+    *Petrik de Heus*
 
-*   No changes.
+*   Deprecate calling `Rails.application.secrets`.
 
+    Rails `secrets` have been deprecated in favor of `credentials`.
+    Calling `Rails.application.secrets` should show a deprecation warning.
 
-## Rails 7.0.5 (May 24, 2023) ##
+    *Petrik de Heus*
 
-*   Add puma app server to Gemfile in order to start test/dummy.
+*   Store `secret_key_base` in `Rails.config` for local environments.
 
-    *Donapieppo*
+    Rails `secrets` have been deprecated in favor of `credentials`.
+    For the local environments the `secret_key_base` is now stored in
+    `Rails.config.secret_key_base` instead of the soft deprecated
+    `Rails.application.secrets.secret_key_base`.
 
-*   Rails console now disables `IRB`'s autocompletion feature in production by default.
+    *Petrik de Heus*
 
-    Setting `IRB_USE_AUTOCOMPLETE=true` can override this default.
+*   Enable force_ssl=true in production by default: Force all access to the app over SSL,
+    use Strict-Transport-Security, and use secure cookies
 
-    *Stan Lo*
+    *Justin Searls*, *Aaron Patterson*, *Guillermo Iguaran*, *Vinícius Bispo*
 
-*   Send 303 See Other status code back for the destroy action on newly generated
-    scaffold controllers.
+*   Add engine's draw paths to application route set, so that the application
+    can draw route files defined in engine paths.
 
-    *Tony Drake*
+    *Gannon McGibbon*
 
+*   Support `VISUAL` environment variable for commands which open an editor,
+    and prefer it over `EDITOR`.
 
-## Rails 7.0.4.3 (March 13, 2023) ##
+    *Summer ☀️*
 
-*   No changes.
+*   Add engine's `test/fixtures` path to `fixture_paths` in `on_load` hook if
+    path exists and is under the Rails application root.
 
+    *Chris Salzberg*
 
-## Rails 7.0.4.2 (January 24, 2023) ##
+*   `bin/rails app:template` now runs `bundle install` and any `after_bundle`
+    blocks after the template is executed.
 
-*   No changes.
+    *Jonathan Hefner* and *Gerry Caulfield*
 
+*   Enable passing column size to migration generator
 
-## Rails 7.0.4.1 (January 17, 2023) ##
+    Previously you could pass a limit to the migration generator:
 
-*   No changes.
+    `rails generate migration CreateAuthor name:text{65535}`
 
+    Now, a size attribute can be passed to the migration generator:
 
-## Rails 7.0.4 (September 09, 2022) ##
+    `rails generate migration CreateAuthor name:text{medium}`
 
-*   `config.allow_concurrency = false` now use a `Monitor` instead of a `Mutex`
+    This generates a migration which includes the size attribute:
 
-    This allows to enable `config.active_support.executor_around_test_case` even
-    when `config.allow_concurrency` is disabled.
+    ```ruby
+    class CreateAuthor < ActiveRecord::Migration[7.1]
+      def change
+        create_table :authors do |t|
+          t.text :name, size: :medium
+        end
+      end
+    end
+    ```
 
-    *Jean Boussier*
+    *Josh Broughton*, *Hartley McGuire*
 
-*   Skip Active Storage and Action Mailer if Active Job is skipped.
+*   Trying to set a config key with the same name of a method now raises:
 
-    *Étienne Barrié*
+    ```ruby
+    config.load_defaults = 7.0
+    # NoMethodError: Cannot assign to `load_defaults`, it is a configuration method
+    ```
 
-*   Correctly check if frameworks are disabled when running app:update.
+    *Xavier Noria*
 
-    *Étienne Barrié* and *Paulo Barros*
+*   Deprecate `secrets:edit/show` and remove `secrets:setup`
 
-*   Fixed `config.active_support.cache_format_version` never being applied.
+    `bin/rails secrets:setup` has been deprecated since Rails 5.2 in favor of
+    credentials. This command has been removed.
 
-    Rails 7.0 shipped with a new serializer for Rails.cache, but the associated config
-    wasn't working properly. Note that even after this fix, it can only be applied from
-    the `application.rb` file.
+    `bin/rails secrets:show` and `bin/rails secrets:edit` have been deprecated
+    in favor of credentials.
 
-    *Alex Ghiculescu*
+    Run `bin/rails credentials:help` for more information
 
+    *Petrik de Heus*
 
-## Rails 7.0.3.1 (July 12, 2022) ##
+*   `bin/rails --help` will now list only framework and plugin commands. Rake
+    tasks defined in `lib/tasks/*.rake` files will no longer be included. For a
+    list of those tasks, use `rake -T`.
 
-*   No changes.
+    *Jonathan Hefner*
 
+*   Allow calling `bin/rails restart` outside of app directory.
 
-## Rails 7.0.3 (May 09, 2022) ##
+    The following would previously fail with a "No Rakefile found" error.
 
-*   If reloading and eager loading are both enabled, after a reload Rails eager loads again the application code.
+    ```bash
+    $ blog/bin/rails restart
+    ```
 
-    *Xavier Noria*
+    *Petrik de Heus*
 
-*   Use `controller_class_path` in `Rails::Generators::NamedBase#route_url`
+*   Support prerelease rubies in Gemfile template if RubyGems version is 3.3.13 or higher.
 
-    The `route_url` method now returns the correct path when generating
-    a namespaced controller with a top-level model using `--model-name`.
+    *Yasuo Honda*, *David Rodríguez*
 
-    Previously, when running this command:
+*   Autoloading setup honors root directories manually set by the user.
+
+    This is relevant for custom namespaces. For example, if you'd like classes
+    and modules under `app/services` to be defined in the `Services` namespace
+    without an extra `app/services/services` directory, this is now enough:
+
+    ```ruby
+    # config/initializers/autoloading.rb
+
+    # The namespace has to exist.
+    #
+    # In this example we define the module on the spot. Could also be created
+    # elsewhere and its definition loaded here with an ordinary `require`. In
+    # any case, `push_dir` expects a class or module object.
+    module Services; end
 
-    ``` sh
-    bin/rails generate scaffold_controller Admin/Post --model-name Post
+    Rails.autoloaders.main.push_dir("#{Rails.root}/app/services", namespace: Services)
     ```
 
-    the comments above the controller action would look like:
+    Check the autoloading guide for further details.
 
-    ``` ruby
-    # GET /posts
-    def index
-      @posts = Post.all
-    end
+    *Xavier Noria*
+
+*   Railties now requires the irb gem as a dependency, which means when you install Rails, irb will also
+    be installed as a gem. Rails will then use the installed version of irb for its console instead of
+    relying on Ruby's built-in version.
+    This ensures that Rails has access to the most up-to-date and reliable version of irb for its console.
+
+    *Stan Lo*
+
+*   Use infinitive form for all rails command descriptions verbs.
+
+    *Petrik de Heus*
+
+*   Credentials commands (e.g. `bin/rails credentials:edit`) now respect
+    `config.credentials.content_path` and `config.credentials.key_path` when set
+    in `config/application.rb` or `config/environments/#{Rails.env}.rb`.
+
+    Before:
+
+      * `bin/rails credentials:edit` ignored `RAILS_ENV`, and would always edit
+        `config/credentials.yml.enc`.
+
+      * `bin/rails credentials:edit --environment foo` would create and edit
+        `config/credentials/foo.yml.enc`.
+
+      * If `config.credentials.content_path` or `config.credentials.key_path`
+        was set, `bin/rails credentials:edit` could not be used to edit the
+        credentials.  Editing credentials required using `bin/rails
+        encrypted:edit path/to/credentials --key path/to/key`.
+
+    After:
+
+      * `bin/rails credentials:edit` will edit the credentials file that the app
+        would load for the current `RAILS_ENV`.
+
+      * `bin/rails credentials:edit` respects `config.credentials.content_path`
+        and `config.credentials.key_path` when set in `config/application.rb`
+        or `config/environments/#{Rails.env}.rb`.
+
+      * `bin/rails credentials:edit --environment foo` will create and edit
+        `config/credentials/foo.yml.enc` _if_ `config.credentials.content_path`
+        has not been set for the `foo` environment.  Ultimately, it will edit
+        the credentials file that the app would load for the `foo` environment.
+
+    *Jonathan Hefner*
+
+*   Add descriptions for non-Rake commands when running `rails -h`.
+
+    *Petrik de Heus*
+
+*   Show relevant commands when calling help
+
+    When running `rails -h` or just `rails` outside a Rails application,
+    Rails outputs all options for running the `rails new` command. This can be
+    confusing to users when they probably want to see the common Rails commands.
+
+    Instead, we should always show the common commands when running `rails -h`
+    inside or outside a Rails application.
+
+    As the relevant commands inside a Rails application differ from the
+    commands outside an application, the help USAGE file has been split to
+    show the most relevant commands for the context.
+
+    *Petrik de Heus*
+
+*   Add Rails::HealthController#show and map it to /up for newly generated applications.
+    Load balancers and uptime monitors all need a basic endpoint to tell whether the app is up.
+    This is a good starting point that'll work in many situations.
+
+    *DHH*
+
+*   Only use HostAuthorization middleware if `config.hosts` is not empty
+
+    *Hartley McGuire*
+
+*   Raise an exception when a `before_action`'s "only" or "except" filter
+    options reference an action that doesn't exist. This will be enabled by
+    default but can be overridden via config.
+
+    ```ruby
+    # config/environments/production.rb
+    config.action_controller.raise_on_missing_callback_actions = false
     ```
 
-    afterwards, they now look like this:
+    *Jess Bees*
 
-    ``` ruby
-    # GET /admin/posts
-    def index
-      @posts = Post.all
-    end
+*   Use physical processor count as the default Puma worker count in production.
+    This can be overridden by setting `ENV["WEB_CONCURRENCY"]` or editing the
+    generated "config/puma.rb" directly.
+
+    *DHH*
+
+*   Add Docker files by default to new apps: Dockerfile, .dockerignore, bin/docker-entrypoint.
+    These files can be skipped with `--skip-docker`. They're intended as a starting point for
+    a production deploy of the application. Not intended for development (see Docked Rails for that).
+
+    Example:
+
+    ```bash
+    $ docker build -t app .
+    $ docker volume create app-storage
+    $ docker run --rm -it -v app-storage:/rails/storage -p 3000:3000 --env RAILS_MASTER_KEY=<see config/master.key> app
     ```
 
-    Fixes #44662.
+    You can also start a console or a runner from this image:
 
-    *Andrew White*
+    ```bash
+    $ docker run --rm -it -v app-storage:/rails/storage --env RAILS_MASTER_KEY=<see config/master.key> app console
+    ```
 
-## Rails 7.0.2.4 (April 26, 2022) ##
+    To create a multi-platform image on Apple Silicon to deploy on AMD or Intel and push to Docker Hub for user/app:
 
-*   No changes.
+    ```bash
+    $ docker login -u <user>
+    $ docker buildx create --use
+    $ docker buildx build --push --platform=linux/amd64,linux/arm64 -t <user/image> .
+    ```
 
+    *DHH, Sam Ruby*
 
-## Rails 7.0.2.3 (March 08, 2022) ##
+*   Add ENV["SECRET_KEY_BASE_DUMMY"] for starting production environment with a generated secret base key,
+    which can be used to run tasks like `assets:precompile` without making the RAILS_MASTER_KEY available
+    to the build process.
 
-*   No changes.
+    Dockerfile layer example:
 
+    ```
+    RUN SECRET_KEY_BASE_DUMMY=1 bundle exec rails assets:precompile
+    ```
 
-## Rails 7.0.2.2 (February 11, 2022) ##
+    *DHH*
 
-*   No changes.
+*   Show descriptions for all commands in Rails help
 
+    When calling `rails help` most commands missed their description. We now
+    show the same descriptions as shown in `rails -T`.
 
-## Rails 7.0.2.1 (February 11, 2022) ##
+    *Petrik de Heus*
 
-*   No changes.
+*   Always generate the storage/ directory with rails new to ensure there's a stable place to
+    put permanent files, and a single mount point for containers to map. Then default sqlite3 databases
+    to live there instead of db/, which is only meant for configuration, not data.
 
+    *DHH*
 
-## Rails 7.0.2 (February 08, 2022) ##
+*   Rails console now disables `IRB`'s autocompletion feature in production by default.
 
-*   No changes.
+    Setting `IRB_USE_AUTOCOMPLETE=true` can override this default.
 
+    *Stan Lo*
 
-## Rails 7.0.1 (January 06, 2022) ##
+*   Add `config.precompile_filter_parameters`, which enables precompilation of
+    `config.filter_parameters` using `ActiveSupport::ParameterFilter.precompile_filters`.
+    Precompilation can improve filtering performance, depending on the quantity
+    and types of filters.
 
-*   Prevent duplicate entries in plugin Gemfile.
+    `config.precompile_filter_parameters` defaults to `true` for
+    `config.load_defaults 7.1` and above.
 
     *Jonathan Hefner*
 
-*   Fix asset pipeline errors for plugin dummy apps.
+*   Add `after_routes_loaded` hook to `Rails::Railtie::Configuration` for
+    engines to add a hook to be called after application routes have been
+    loaded.
+
+    ```ruby
+    MyEngine.config.after_routes_loaded do
+      # code that must happen after routes have been loaded
+    end
+    ```
+
+    *Chris Salzberg*
+
+*   Send 303 See Other status code back for the destroy action on newly generated
+    scaffold controllers.
+
+    *Tony Drake*
+
+*   Add `Rails.application.deprecators` as a central point to manage deprecators
+    for an application.
+
+    Individual deprecators can be added and retrieved from the collection:
+
+    ```ruby
+    Rails.application.deprecators[:my_gem] = ActiveSupport::Deprecation.new("2.0", "MyGem")
+    Rails.application.deprecators[:other_gem] = ActiveSupport::Deprecation.new("3.0", "OtherGem")
+    ```
+
+    And the collection's configuration methods affect all deprecators in the
+    collection:
+
+    ```ruby
+    Rails.application.deprecators.debug = true
+
+    Rails.application.deprecators[:my_gem].debug
+    # => true
+    Rails.application.deprecators[:other_gem].debug
+    # => true
+    ```
+
+    Additionally, all deprecators in the collection can be silenced for the
+    duration of a given block:
+
+    ```ruby
+    Rails.application.deprecators.silence do
+      Rails.application.deprecators[:my_gem].warn    # => silenced (no warning)
+      Rails.application.deprecators[:other_gem].warn # => silenced (no warning)
+    end
+    ```
 
     *Jonathan Hefner*
 
-*   Fix generated route revocation.
+*   Move dbconsole logic to Active Record connection adapter.
+
+    Instead of hosting the connection logic in the command object, the
+    database adapter should be responsible for connecting to a console session.
+    This patch moves #find_cmd_and_exec to the adapter and exposes a new API to
+    lookup the adapter class without instantiating it.
+
+    *Gannon McGibbon*, *Paarth Madan*
+
+*   Add `Rails.application.message_verifiers` as a central point to configure
+    and create message verifiers for an application.
+
+    This allows applications to, for example, rotate old `secret_key_base`
+    values:
+
+    ```ruby
+    config.before_initialize do |app|
+      app.message_verifiers.rotate(secret_key_base: "old secret_key_base")
+    end
+    ```
+
+    And for libraries to create preconfigured message verifiers:
+
+    ```ruby
+    ActiveStorage.verifier = Rails.application.message_verifiers["ActiveStorage"]
+    ```
 
     *Jonathan Hefner*
 
-*   Addresses an issue in which Sidekiq jobs could not reload certain
-    namespaces.
+*   Support MySQL's ssl-mode option for the dbconsole command.
 
-    See [fxn/zeitwerk#198](https://github.com/fxn/zeitwerk/issues/198) for
-    details.
+    Verifying the identity of the database server requires setting the ssl-mode
+    option to VERIFY_CA or VERIFY_IDENTITY. This option was previously ignored
+    for the dbconsole command.
 
-    *Xavier Noria*
+    *Petrik de Heus*
+
+*   Delegate application record generator description to orm hooked generator.
 
-*   Fix plugin generator to a plugin that pass all the tests.
+    *Gannon McGibbon*
 
-    *Rafael Mendonça França*
+*   Show BCC recipients when present in Action Mailer previews.
 
+    *Akshay Birajdar*
 
-## Rails 7.0.0 (December 15, 2021) ##
+*   Extend `routes --grep` to also filter routes by matching against path.
 
-*   No changes.
+    Example:
 
+    ```bash
+    $ bin/rails routes --grep /cats/1
+    Prefix Verb   URI Pattern         Controller#Action
+       cat GET    /cats/:id(.:format) cats#show
+           PATCH  /cats/:id(.:format) cats#update
+           PUT    /cats/:id(.:format) cats#update
+           DELETE /cats/:id(.:format) cats#destroy
+    ```
 
-## Rails 7.0.0.rc3 (December 14, 2021) ##
+    *Orhan Toy*
 
-*   Allow localhost with a port by default in development
+*   Improve `rails runner` output when given a file path that doesn't exist.
 
-    [Fixes: #43864]
+    *Tekin Suleyman*
 
-## Rails 7.0.0.rc2 (December 14, 2021) ##
+*   `config.allow_concurrency = false` now use a `Monitor` instead of a `Mutex`
 
-*   No changes
+    This allows to enable `config.active_support.executor_around_test_case` even
+    when `config.allow_concurrency` is disabled.
+
+    *Jean Boussier*
 
-## Rails 7.0.0.rc1 (December 06, 2021) ##
+*   Add `routes --unused` option to detect extraneous routes.
 
-*   Remove deprecated `config` in `dbconsole`.
+    Example:
 
-    *Rafael Mendonça França*
+    ```bash
+    $ bin/rails routes --unused
 
-*   Change default `X-XSS-Protection` header to disable XSS auditor
+    Found 2 unused routes:
 
-    This header has been deprecated and the XSS auditor it triggered
-    has been removed from all major modern browsers (in favour of
-    Content Security Policy) that implemented this header to begin with
-    (Firefox never did).
+    Prefix Verb URI Pattern    Controller#Action
+       one GET  /one(.:format) action#one
+       two GET  /two(.:format) action#two
+    ```
 
-    [OWASP](https://owasp.org/www-project-secure-headers/#x-xss-protection)
-    suggests setting this header to '0' to disable the default behaviour
-    on old browsers as it can introduce additional security issues.
+    *Gannon McGibbon*
 
-    Added the new behaviour as a framework default from Rails 7.0.
+*   Add `--parent` option to controller generator to specify parent class of job.
 
-    *Christian Sutter*
+    Example:
 
-*   Scaffolds now use date_field, time_field and datetime_field instead of
-    date_select, time_select and datetime_select; thus providing native date/time pickers.
+    `bin/rails g controller admin/users --parent=admin_controller` generates:
 
-    *Martijn Lafeber*
+    ```ruby
+    class Admin::UsersController < AdminController
+      # ...
+    end
+    ```
 
-*   Fix a regression in which autoload paths were initialized too late.
+    *Gannon McGibbon*
 
-    *Xavier Noria*
+*   In-app custom credentials templates are now supported.  When a credentials
+    file does not exist, `rails credentials:edit` will now try to use
+    `lib/templates/rails/credentials/credentials.yml.tt` to generate the
+    credentials file, before falling back to the default template.
 
-## Rails 7.0.0.alpha2 (September 15, 2021) ##
+    This allows e.g. an open-source Rails app (which would not include encrypted
+    credentials files in its repo) to include a credentials template, so that
+    users who install the app will get a custom pre-filled credentials file when
+    they run `rails credentials:edit`.
 
-*   Fix activestorage dependency in the npm package.
+    *Jonathan Hefner*
 
-    *Rafael Mendonça França*
+*   Except for `dev` and `test` environments, newly generated per-environment
+    credentials files (e.g. `config/credentials/production.yml.enc`) now include
+    a `secret_key_base` for convenience, just as `config/credentials.yml.enc`
+    does.
 
-## Rails 7.0.0.alpha1 (September 15, 2021) ##
+    *Jonathan Hefner*
 
-*   New and upgraded Rails apps no longer generate `config/initializers/application_controller_renderer.rb`
-    or `config/initializers/cookies_serializer.rb`
+*   `--no-*` options now work with the app generator's `--minimal` option, and
+    are both comprehensive and precise.  For example:
+
+    ```bash
+    $ rails new my_cool_app --minimal
+    Based on the specified options, the following options will also be activated:
+
+      --skip-active-job [due to --minimal]
+      --skip-action-mailer [due to --skip-active-job, --minimal]
+      --skip-active-storage [due to --skip-active-job, --minimal]
+      --skip-action-mailbox [due to --skip-active-storage, --minimal]
+      --skip-action-text [due to --skip-active-storage, --minimal]
+      --skip-javascript [due to --minimal]
+      --skip-hotwire [due to --skip-javascript, --minimal]
+      --skip-action-cable [due to --minimal]
+      --skip-bootsnap [due to --minimal]
+      --skip-dev-gems [due to --minimal]
+      --skip-system-test [due to --minimal]
+
+    ...
+
+    $ rails new my_cool_app --minimal --no-skip-active-storage
+    Based on the specified options, the following options will also be activated:
+
+      --skip-action-mailer [due to --minimal]
+      --skip-action-mailbox [due to --minimal]
+      --skip-action-text [due to --minimal]
+      --skip-javascript [due to --minimal]
+      --skip-hotwire [due to --skip-javascript, --minimal]
+      --skip-action-cable [due to --minimal]
+      --skip-bootsnap [due to --minimal]
+      --skip-dev-gems [due to --minimal]
+      --skip-system-test [due to --minimal]
+
+    ...
+    ```
 
-    The default value for `cookies_serializer` (`:json`) has been moved to `config.load_defaults("7.0")`.
-    The new framework defaults file can be used to upgrade the serializer.
+    *Brad Trick* and *Jonathan Hefner*
 
-    *Alex Ghiculescu*
+*   Add `--skip-dev-gems` option to app generator to skip adding development
+    gems (like `web-console`) to the Gemfile.
 
-*   New applications get a dependency on the new `debug` gem, replacing `byebug`.
+    *Brad Trick*
 
-    *Xavier Noria*
+*   Skip Active Storage and Action Mailer if Active Job is skipped.
 
-*   Add SSL support for postgresql in `bin/rails dbconsole`.
+    *Étienne Barrié*
 
-    Fixes #43114.
+*   Correctly check if frameworks are disabled when running app:update.
 
-    *Michael Bayucot*
+    *Étienne Barrié* and *Paulo Barros*
 
-*   Add support for comments above gem declaration in Rails application templates, e.g. `gem("nokogiri", comment: "For XML")`.
+*   Delegate model generator description to orm hooked generator.
 
-    *Linas Juškevičius*
+    *Gannon McGibbon*
 
-*   The setter `config.autoloader=` has been deleted. `zeitwerk` is the only
-    available autoloading mode.
+*   Execute `rails runner` scripts inside the executor.
 
-    *Xavier Noria*
+    Enables error reporting, query cache, etc.
 
-*   `config.autoload_once_paths` can be configured in the body of the
-    application class defined in `config/application.rb` or in the configuration
-    for environments in `config/environments/*`.
+    *Jean Boussier*
 
-    Similarly, engines can configure that collection in the class body of the
-    engine class or in the configuration for environments.
+*   Avoid booting in development then test for test tasks.
 
-    After that, the collection is frozen, and you can autoload from those paths.
-    They are managed by the `Rails.autoloaders.once` autoloader, which does not
-    reload, only autoloads/eager loads.
+    Running one of the rails test subtasks (e.g. test:system, test:models) would
+    go through Rake and cause the app to be booted twice. Now all the test:*
+    subtasks are defined as Thor tasks and directly load the test environment.
 
-    *Xavier Noria*
+    *Étienne Barrié*
 
-*   During initialization, you cannot autoload reloadable classes or modules
-    like application models, unless they are wrapped in a `to_prepare` block.
-    For example, from `config/initializers/*`, or in application, engines, or
-    railties initializers.
+*   Deprecate `Rails::Generators::Testing::Behaviour` in favor of `Rails::Generators::Testing::Behavior`.
 
-    Please check the [autoloading
-    guide](https://guides.rubyonrails.org/v7.0/autoloading_and_reloading_constants.html#autoloading-when-the-application-boots)
-    for details.
+    *Gannon McGibbon*
 
-    *Xavier Noria*
+*   Allow configuration of logger size for local and test environments
 
-*   While they are allowed to have elements in common, it is no longer required
-    that `config.autoload_once_paths` is a subset of `config.autoload_paths`.
-    The former are managed by the `once` autoloader. The `main` autoloader
-    manages the latter minus the former.
+    `config.log_file_size`
 
-    *Xavier Noria*
+    Defaults to `100` megabytes.
 
-*   Show Rake task description if command is run with `-h`.
+    *Bernie Chiu*
 
-    Adding `-h` (or `--help`) to a Rails command that's a Rake task now outputs
-    the task description instead of the general Rake help.
+*   Enroll new apps in decrypted diffs of credentials by default.  This behavior
+    can be opted out of with the app generator's `--skip-decrypted-diffs` flag.
 
-    *Petrik de Heus*
+    *Jonathan Hefner*
 
-*   Add missing `plugin new` command to help.
+*   Support declarative-style test name filters with `bin/rails test`.
 
-    *Petrik de Heus
+    This makes it possible to run a declarative-style test such as:
 
-*   Fix `config_for` error when there's only a shared root array.
+    ```ruby
+    class MyTest < ActiveSupport::TestCase
+      test "does something" do
+        # ...
+      end
+    end
+    ```
 
-    *Loïc Delmaire*
+    Using its declared name:
 
-*   Raise an error in generators if an index type is invalid.
+    ```bash
+    $ bin/rails test test/my_test.rb -n "does something"
+    ```
 
-    *Petrik de Heus*
+    Instead of having to specify its expanded method name:
 
-*   `package.json` now uses a strict version constraint for Rails JavaScript packages on new Rails apps.
+    ```bash
+    $ bin/rails test test/my_test.rb -n test_does_something
+    ```
 
-    *Zachary Scott*, *Alex Ghiculescu*
+    *Jonathan Hefner*
 
-*   Modified scaffold generator template so that running
-    `rails g scaffold Author` no longer generates tests called "creating
-    a Author", "updating a Author", and "destroying a Author".
+*   Add `--js` and `--skip-javascript` options to `rails new`
 
-    Fixes #40744.
+    `--js` alias to `rails new --javascript ...`
 
-    *Michael Duchemin*
+    Same as `-j`, e.g. `rails new --js esbuild ...`
 
-*   Raise an error in generators if a field type is invalid.
+    `--skip-js` alias to `rails new --skip-javascript ...`
 
-    *Petrik de Heus*
+    Same as `-J`, e.g. `rails new --skip-js ...`
 
-*   `bin/rails tmp:clear` deletes also files and directories in `tmp/storage`.
+    *Dorian Marié*
 
-    *George Claghorn*
+*   Allow relative paths with leading dot slash to be passed to `rails test`.
 
-*   Fix compatibility with `psych >= 4`.
+    Fix `rails test ./test/model/post_test.rb` to run a single test file.
 
-    Starting in Psych 4.0.0 `YAML.load` behaves like `YAML.safe_load`. To preserve compatibility
-    `Rails.application.config_for` now uses `YAML.unsafe_load` if available.
+    *Shouichi Kamiya* and *oljfte*
 
-    *Jean Boussier*
+*   Deprecate `config.enable_dependency_loading`. This flag addressed a limitation of the `classic` autoloader and has no effect nowadays. To fix this deprecation, please just delete the reference.
 
-*   Allow loading nested locales in engines.
+    *Xavier Noria*
 
-    *Gannon McGibbon*
+*   Define `config.enable_reloading` to be `!config.cache_classes` for a more intuitive name. While `config.enable_reloading` and `config.reloading_enabled?` are preferred from now on, `config.cache_classes` is supported for backwards compatibility.
 
-*   Ensure `Rails.application.config_for` always cast hashes to `ActiveSupport::OrderedOptions`.
+    *Xavier Noria*
 
-    *Jean Boussier*
+*   Add JavaScript dependencies installation on bin/setup
 
-*   Remove `Rack::Runtime` from the default middleware stack and deprecate
-    referencing it in middleware operations without adding it back.
+    Add  `yarn install` to bin/setup when using esbuild, webpack, or rollout.
 
-    *Hartley McGuire*
+    *Carlos Ribeiro*
 
-*   Allow adding additional authorized hosts in development via `ENV['RAILS_DEVELOPMENT_HOSTS']`.
+*   Use `controller_class_path` in `Rails::Generators::NamedBase#route_url`
 
-    *Josh Abernathy*, *Debbie Milburn*
+    The `route_url` method now returns the correct path when generating
+    a namespaced controller with a top-level model using `--model-name`.
 
-*   Add app concern and test keepfiles to generated engine plugins.
+    Previously, when running this command:
 
-    *Gannon McGibbon*
+    ```bash
+    $ bin/rails generate scaffold_controller Admin/Post --model-name Post
+    ```
 
-*   Stop generating a license for in-app plugins.
+    the comments above the controller action would look like:
 
-    *Gannon McGibbon*
+    ``` ruby
+    # GET /posts
+    def index
+      @posts = Post.all
+    end
+    ```
 
-*   `rails app:update` no longer prompts you to overwrite files that are generally modified in the
-    course of developing a Rails app. See [#41083](https://github.com/rails/rails/pull/41083) for
-    the full list of changes.
+    afterwards, they now look like this:
 
-    *Alex Ghiculescu*
+    ``` ruby
+    # GET /admin/posts
+    def index
+      @posts = Post.all
+    end
+    ```
 
-*   Change default branch for new Rails projects and plugins to `main`.
+    Fixes #44662.
 
-    *Prateek Choudhary*
+    *Andrew White*
 
-*   The new method `Rails.benchmark` gives you a quick way to measure and log the execution time taken by a block:
+*   No longer add autoloaded paths to `$LOAD_PATH`.
 
-        def test_expensive_stuff
-          Rails.benchmark("test_expensive_stuff") { ... }
-        end
+    This means it won't be possible to load them with a manual `require` call, the class or module can be referenced instead.
 
-    This functionality was available in some contexts only before.
+    Reducing the size of `$LOAD_PATH` speed-up `require` calls for apps not using `bootsnap`, and reduce the
+    size of the `bootsnap` cache for the others.
 
-    *Simon Perepelitsa*
+    *Jean Boussier*
 
-*   Applications generated with `--skip-sprockets` no longer get `app/assets/config/manifest.js` and `app/assets/stylesheets/application.css`.
+*   Remove default `X-Download-Options` header
 
-    *Cindy Gao*
+    This header is currently only used by Internet Explorer which
+    will be discontinued in 2022 and since Rails 7 does not fully
+    support Internet Explorer this header should not be a default one.
 
-*   Add support for stylesheets and ERB views to `rails stats`.
+    *Harun Sabljaković*
 
-    *Joel Hawksley*
+*   Add .node-version files for Rails apps that use Node.js
 
-*   Allow appended root routes to take precedence over internal welcome controller.
+    Node version managers that make use of this file:
+      https://github.com/shadowspawn/node-version-usage#node-version-file-usage
 
-    *Gannon McGibbon*
+    The generated Dockerfile will use the same node version.
 
+    *Sam Ruby*
 
-Please check [6-1-stable](https://github.com/rails/rails/blob/6-1-stable/railties/CHANGELOG.md) for previous changes.
+Please check [7-0-stable](https://github.com/rails/rails/blob/7-0-stable/railties/CHANGELOG.md) for previous changes.