**DO NOT READ THIS FILE ON GITHUB, GUIDES ARE PUBLISHED ON https://guides.rubyonrails.org.** Ruby on Rails 6.0 Release Notes =============================== Highlights in Rails 6.0: * Action Mailbox * Action Text * Parallel Testing * Action Cable Testing These release notes cover only the major changes. To learn about various bug fixes and changes, please refer to the change logs or check out the [list of commits](https://github.com/rails/rails/commits/6-0-stable) in the main Rails repository on GitHub. -------------------------------------------------------------------------------- Upgrading to Rails 6.0 ---------------------- If you're upgrading an existing application, it's a great idea to have good test coverage before going in. You should also first upgrade to Rails 5.2 in case you haven't and make sure your application still runs as expected before attempting an update to Rails 6.0. A list of things to watch out for when upgrading is available in the [Upgrading Ruby on Rails](upgrading_ruby_on_rails.html#upgrading-from-rails-5-2-to-rails-6-0) guide. Major Features -------------- ### Action Mailbox [Pull Request](https://github.com/rails/rails/pull/34786) [Action Mailbox](https://github.com/rails/rails/tree/6-0-stable/actionmailbox) allows you to route incoming emails to controller-like mailboxes. You can read more about Action Mailbox in the [Action Mailbox Basics](action_mailbox_basics.html) guide. ### Action Text [Pull Request](https://github.com/rails/rails/pull/34873) [Action Text](https://github.com/rails/rails/tree/6-0-stable/actiontext) brings rich text content and editing to Rails. It includes the [Trix editor](https://trix-editor.org) that handles everything from formatting to links to quotes to lists to embedded images and galleries. The rich text content generated by the Trix editor is saved in its own RichText model that's associated with any existing Active Record model in the application. Any embedded images (or other attachments) are automatically stored using Active Storage and associated with the included RichText model. You can read more about Action Text in the [Action Text Overview](action_text_overview.html) guide. ### Parallel Testing [Pull Request](https://github.com/rails/rails/pull/31900) [Parallel Testing](testing.html#parallel-testing) allows you to parallelize your test suite. While forking processes is the default method, threading is supported as well. Running tests in parallel reduces the time it takes your entire test suite to run. ### Action Cable Testing [Pull Request](https://github.com/rails/rails/pull/33659) [Action Cable testing tools](testing.html#testing-action-cable) allow you to test your Action Cable functionality at any level: connections, channels, broadcasts. Railties -------- Please refer to the [Changelog][railties] for detailed changes. ### Removals * Remove deprecated `after_bundle` helper inside plugins templates. ([Commit](https://github.com/rails/rails/commit/4d51efe24e461a2a3ed562787308484cd48370c7)) * Remove deprecated support to `config.ru` that uses the application class as argument of `run`. ([Commit](https://github.com/rails/rails/commit/553b86fc751c751db504bcbe2d033eb2bb5b6a0b)) * Remove deprecated `environment` argument from the rails commands. ([Commit](https://github.com/rails/rails/commit/e20589c9be09c7272d73492d4b0f7b24e5595571)) * Remove deprecated `capify!` method in generators and templates. ([Commit](https://github.com/rails/rails/commit/9d39f81d512e0d16a27e2e864ea2dd0e8dc41b17)) * Remove deprecated `config.secret_token`. ([Commit](https://github.com/rails/rails/commit/46ac5fe69a20d4539a15929fe48293e1809a26b0)) ### Deprecations * Deprecate passing Rack server name as a regular argument to `rails server`. ([Pull Request](https://github.com/rails/rails/pull/32058)) * Deprecate support for using `HOST` environment to specify server IP. ([Pull Request](https://github.com/rails/rails/pull/32540)) * Deprecate accessing hashes returned by `config_for` by non-symbol keys. ([Pull Request](https://github.com/rails/rails/pull/35198)) ### Notable changes * Add an explicit option `--using` or `-u` for specifying the server for the `rails server` command. ([Pull Request](https://github.com/rails/rails/pull/32058)) * Add ability to see the output of `rails routes` in expanded format. ([Pull Request](https://github.com/rails/rails/pull/32130)) * Run the seed database task using inline Active Job adapter. ([Pull Request](https://github.com/rails/rails/pull/34953)) * Add a command `rails db:system:change` to change the database of the application. ([Pull Request](https://github.com/rails/rails/pull/34832)) * Add `rails test:channels` command to test only Action Cable channels. ([Pull Request](https://github.com/rails/rails/pull/34947)) * Introduce guard against DNS rebinding attacks. ([Pull Request](https://github.com/rails/rails/pull/33145)) * Add ability to abort on failure while running generator commands. ([Pull Request](https://github.com/rails/rails/pull/34420)) * Make Webpacker the default JavaScript compiler for Rails 6. ([Pull Request](https://github.com/rails/rails/pull/33079)) * Add multiple database support for `rails db:migrate:status` command. ([Pull Request](https://github.com/rails/rails/pull/34137)) * Add ability to use different migration paths from multiple databases in the generators. ([Pull Request](https://github.com/rails/rails/pull/34021)) * Add support for multi environment credentials. ([Pull Request](https://github.com/rails/rails/pull/33521)) * Make `null_store` as default cache store in test environment. ([Pull Request](https://github.com/rails/rails/pull/33773)) Action Cable ------------ Please refer to the [Changelog][action-cable] for detailed changes. ### Removals ### Deprecations ### Notable changes * The ActionCable javascript package has been converted from CoffeeScript to ES2015, and we now publish the source code in the npm distribution. This allows ActionCable users to depend on the javascript source code rather than the compiled code, which can produce smaller javascript bundles. This change includes some breaking changes to optional parts of the ActionCable javascript API: - Configuration of the WebSocket adapter and logger adapter have been moved from properties of `ActionCable` to properties of `ActionCable.adapters`. - The `ActionCable.startDebugging()` and `ActionCable.stopDebugging()` methods have been removed and replaced with the property `ActionCable.logger.enabled`. Action Pack ----------- Please refer to the [Changelog][action-pack] for detailed changes. ### Removals ### Deprecations ### Notable changes Action View ----------- Please refer to the [Changelog][action-view] for detailed changes. ### Removals ### Deprecations ### Notable changes Action Mailer ------------- Please refer to the [Changelog][action-mailer] for detailed changes. ### Removals ### Deprecations ### Notable changes Active Record ------------- Please refer to the [Changelog][active-record] for detailed changes. ### Removals ### Deprecations ### Notable changes Active Storage -------------- Please refer to the [Changelog][active-storage] for detailed changes. ### Removals ### Deprecations ### Notable changes Active Model ------------ Please refer to the [Changelog][active-model] for detailed changes. ### Removals ### Deprecations ### Notable changes * Add a configuration option to customize format of the `ActiveModel::Errors#full_message`. ([Pull Request](https://github.com/rails/rails/pull/32956)) * Add support for configuring attribute name for `has_secure_password`. ([Pull Request](https://github.com/rails/rails/pull/26764)) * Add `#slice!` method to `ActiveModel::Errors`. ([Pull Request](https://github.com/rails/rails/pull/34489)) * Add `ActiveModel::Errors#of_kind?` to check presence of a specific error. ([Pull Request](https://github.com/rails/rails/pull/34866)) Active Support -------------- Please refer to the [Changelog][active-support] for detailed changes. ### Removals ### Deprecations ### Notable changes Active Job ---------- Please refer to the [Changelog][active-job] for detailed changes. ### Removals * Remove support for Qu gem. ([Pull Request](https://github.com/rails/rails/pull/32300)) ### Deprecations ### Notable changes * Add support for custom serializers for Active Job arguments. ([Pull Request](https://github.com/rails/rails/pull/30941)) * Add support for executing Active Jobs in the timezone in which they were enqueued. ([Pull Request](https://github.com/rails/rails/pull/32085)) * Allow passing multiple exceptions to `retry_on`/`discard_on`. ([Commit](https://github.com/rails/rails/commit/3110caecbebdad7300daaf26bfdff39efda99e25)) * Allow calling `assert_enqueued_with` and `assert_enqueued_email_with` without a block. ([Pull Request](https://github.com/rails/rails/pull/33258)) * Wrap the notifications for `enqueue` and `enqueue_at` in the `around_enqueue` callback instead of `after_enqueue` callback. ([Pull Request](https://github.com/rails/rails/pull/33171)) * Allow calling `perform_enqueued_jobs` without a block. ([Pull Request](https://github.com/rails/rails/pull/33626)) * Allow calling `assert_performed_with` without a block. ([Pull Request](https://github.com/rails/rails/pull/33635)) * Add `:queue` option to job assertions and helpers. ([Pull Request](https://github.com/rails/rails/pull/33635)) * Add hooks to Active Job around retries and discards. ([Pull Request](https://github.com/rails/rails/pull/33751)) * Add a way to test for subset of arguments when performing jobs. ([Pull Request](https://github.com/rails/rails/pull/33995)) * Include deserialized arguments in jobs returned by Active Job test helpers. ([Pull Request](https://github.com/rails/rails/pull/34204)) * Allow Active Job assertion helpers to accept Proc for `only` keyword. ([Pull Request](https://github.com/rails/rails/pull/34339)) * Drop microseconds and nanoseconds from the job arguments in assertion helpers. ([Pull Request](https://github.com/rails/rails/pull/35713)) Ruby on Rails Guides -------------------- Please refer to the [Changelog][guides] for detailed changes. ### Notable changes Credits ------- See the [full list of contributors to Rails](https://contributors.rubyonrails.org/) for the many people who spent many hours making Rails, the stable and robust framework it is. Kudos to all of them. [railties]: https://github.com/rails/rails/blob/6-0-stable/railties/CHANGELOG.md [action-pack]: https://github.com/rails/rails/blob/6-0-stable/actionpack/CHANGELOG.md [action-view]: https://github.com/rails/rails/blob/6-0-stable/actionview/CHANGELOG.md [action-mailer]: https://github.com/rails/rails/blob/6-0-stable/actionmailer/CHANGELOG.md [action-cable]: https://github.com/rails/rails/blob/6-0-stable/actioncable/CHANGELOG.md [active-record]: https://github.com/rails/rails/blob/6-0-stable/activerecord/CHANGELOG.md [active-storage]: https://github.com/rails/rails/blob/6-0-stable/activestorage/CHANGELOG.md [active-model]: https://github.com/rails/rails/blob/6-0-stable/activemodel/CHANGELOG.md [active-support]: https://github.com/rails/rails/blob/6-0-stable/activesupport/CHANGELOG.md [active-job]: https://github.com/rails/rails/blob/6-0-stable/activejob/CHANGELOG.md [guides]: https://github.com/rails/rails/blob/6-0-stable/guides/CHANGELOG.md