railties 7.0.8.1 → 7.1.0.beta1

data/lib/rails/test_unit/test_parser.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require "ripper"
+
+module Rails
+  module TestUnit
+    # Parse a test file to extract the line ranges of all tests in both
+    # method-style (def test_foo) and declarative-style (test "foo" do)
+    class TestParser < Ripper # :nodoc:
+      # Helper to translate a method object into the path and line range where
+      # the method was defined.
+      def self.definition_for(method_obj)
+        path, begin_line = method_obj.source_location
+        begins_to_ends = new(File.read(path), path).parse
+        return unless end_line = begins_to_ends[begin_line]
+        [path, (begin_line..end_line)]
+      end
+
+      def initialize(*)
+        # A hash mapping the 1-indexed line numbers that tests start on to where they end.
+        @begins_to_ends = {}
+        super
+      end
+
+      def parse
+        super
+        @begins_to_ends
+      end
+
+      # method test e.g. `def test_some_description`
+      # This event's first argument gets the `ident` node containing the method
+      # name, which we have overridden to return the line number of the ident
+      # instead.
+      def on_def(begin_line, *)
+        @begins_to_ends[begin_line] = lineno
+      end
+
+      # Everything past this point is to support declarative tests, which
+      # require more work to get right because of the many different ways
+      # methods can be invoked in ruby, all of which are parsed differently.
+      #
+      # The approach is just to store the current line number when the
+      # "test" method is called and pass it up the tree so it's available at
+      # the point when we also know the line where the associated block ends.
+
+      def on_method_add_block(begin_line, end_line)
+        if begin_line && end_line
+          @begins_to_ends[begin_line] = end_line
+        end
+      end
+
+      def on_command_call(*, begin_lineno, _args)
+        begin_lineno
+      end
+
+      def first_arg(arg, *)
+        arg
+      end
+
+      def just_lineno(*)
+        lineno
+      end
+
+      alias on_method_add_arg first_arg
+      alias on_command first_arg
+      alias on_stmts_add first_arg
+      alias on_arg_paren first_arg
+      alias on_bodystmt first_arg
+
+      alias on_ident just_lineno
+      alias on_do_block just_lineno
+      alias on_stmts_new just_lineno
+      alias on_brace_block just_lineno
+
+      def on_args_new
+        []
+      end
+
+      def on_args_add(parts, part)
+        parts << part
+      end
+
+      def on_args_add_block(args, *rest)
+        args.first
+      end
+    end
+  end
+end

data/lib/rails/test_unit/testing.rake

@@ -1,18 +1,13 @@
 # frozen_string_literal: true
 
-gem "minitest"
 require "minitest"
 require "rails/test_unit/runner"
 
 task default: :test
 
-desc "Runs all tests in test folder except system ones"
+desc "Run all tests in test folder except system ones"
 task :test do
-  if ENV.key?("TEST")
-    Rails::TestUnit::Runner.rake_run([ENV["TEST"]])
-  else
-    Rails::TestUnit::Runner.rake_run
-  end
+  Rails::TestUnit::Runner.run_from_rake("test", Array(ENV["TEST"]))
 end
 
 namespace :test do
@@ -23,37 +18,22 @@ namespace :test do
 
   task run: %w[test]
 
-  desc "Run tests quickly, but also reset db"
+  desc "Reset the database and run `bin/rails test`"
   task :db do
     success = system({ "RAILS_ENV" => ENV.fetch("RAILS_ENV", "test") }, "rake", "db:test:prepare", "test")
     success || exit(false)
   end
 
-  ["models", "helpers", "channels", "controllers", "mailers", "integration", "jobs", "mailboxes"].each do |name|
-    task name => "test:prepare" do
-      Rails::TestUnit::Runner.rake_run(["test/#{name}"])
+  [
+    *Rails::TestUnit::Runner::TEST_FOLDERS,
+    :all,
+    :generators,
+    :units,
+    :functionals,
+    :system,
+  ].each do |name|
+    task name do
+      Rails::TestUnit::Runner.run_from_rake("test:#{name}")
     end
   end
-
-  desc "Runs all tests, including system tests"
-  task all: "test:prepare" do
-    Rails::TestUnit::Runner.rake_run(["test/**/*_test.rb"])
-  end
-
-  task generators: "test:prepare" do
-    Rails::TestUnit::Runner.rake_run(["test/lib/generators"])
-  end
-
-  task units: "test:prepare" do
-    Rails::TestUnit::Runner.rake_run(["test/models", "test/helpers", "test/unit"])
-  end
-
-  task functionals: "test:prepare" do
-    Rails::TestUnit::Runner.rake_run(["test/controllers", "test/mailers", "test/functional"])
-  end
-
-  desc "Run system tests only"
-  task system: "test:prepare" do
-    Rails::TestUnit::Runner.rake_run(["test/system"])
-  end
 end

data/lib/rails/version.rb

@@ -3,7 +3,7 @@
 require_relative "gem_version"
 
 module Rails
-  # Returns the currently loaded version of Rails as a string.
+  # Returns the currently loaded version of \Rails as a string.
   def self.version
     VERSION::STRING
   end

data/lib/rails.rb

@@ -10,8 +10,10 @@ require "active_support/core_ext/module/delegation"
 require "active_support/core_ext/array/extract_options"
 require "active_support/core_ext/object/blank"
 
-require "rails/application"
 require "rails/version"
+require "rails/deprecator"
+require "rails/application"
+require "rails/backtrace_cleaner"
 
 require "active_support/railtie"
 require "action_dispatch/railtie"
@@ -22,10 +24,12 @@ silence_warnings do
   Encoding.default_internal = Encoding::UTF_8
 end
 
+# :include: railties/README.rdoc
 module Rails
   extend ActiveSupport::Autoload
   extend ActiveSupport::Benchmarkable
 
+  autoload :HealthController
   autoload :Info
   autoload :InfoController
   autoload :MailersController
@@ -42,20 +46,16 @@ module Rails
 
     delegate :initialize!, :initialized?, to: :application
 
-    # The Configuration instance used to configure the Rails environment
+    # The Configuration instance used to configure the \Rails environment
     def configuration
       application.config
     end
 
     def backtrace_cleaner
-      @backtrace_cleaner ||= begin
-        # Relies on Active Support, so we have to lazy load to postpone definition until Active Support has been loaded
-        require "rails/backtrace_cleaner"
-        Rails::BacktraceCleaner.new
-      end
+      @backtrace_cleaner ||= Rails::BacktraceCleaner.new
     end
 
-    # Returns a Pathname object of the current Rails project,
+    # Returns a Pathname object of the current \Rails project,
     # otherwise it returns +nil+ if there is no project:
     #
     #   Rails.root
@@ -64,7 +64,7 @@ module Rails
       application && application.config.root
     end
 
-    # Returns the current Rails environment.
+    # Returns the current \Rails environment.
     #
     #   Rails.env # => "development"
     #   Rails.env.development? # => true
@@ -73,14 +73,14 @@ module Rails
       @_env ||= ActiveSupport::EnvironmentInquirer.new(ENV["RAILS_ENV"].presence || ENV["RACK_ENV"].presence || "development")
     end
 
-    # Sets the Rails environment.
+    # Sets the \Rails environment.
     #
     #   Rails.env = "staging" # => "staging"
     def env=(environment)
       @_env = ActiveSupport::EnvironmentInquirer.new(environment)
     end
 
-    # Returns the ActiveSupport::ErrorReporter of the current Rails project,
+    # Returns the ActiveSupport::ErrorReporter of the current \Rails project,
     # otherwise it returns +nil+ if there is no project.
     #
     #   Rails.error.handle(IOError) do
@@ -88,12 +88,12 @@ module Rails
     #   end
     #   Rails.error.report(error)
     def error
-      application && application.executor.error_reporter
+      ActiveSupport.error_reporter
     end
 
-    # Returns all Rails groups for loading based on:
+    # Returns all \Rails groups for loading based on:
     #
-    # * The Rails environment;
+    # * The \Rails environment;
     # * The environment variable RAILS_GROUPS;
     # * The optional envs given as argument and the hash with group dependencies;
     #
@@ -112,7 +112,7 @@ module Rails
     end
 
     # Returns a Pathname object of the public folder of the current
-    # Rails project, otherwise it returns +nil+ if there is no project:
+    # \Rails project, otherwise it returns +nil+ if there is no project:
     #
     #   Rails.public_path
     #     # => #<Pathname:/Users/someuser/some/path/project/public>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: railties
 version: !ruby/object:Gem::Version
-  version: 7.0.8.1
+  version: 7.1.0.beta1
 platform: ruby
 authors:
 - David Heinemeier Hansson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-21 00:00:00.000000000 Z
+date: 2023-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -16,28 +16,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.8.1
+        version: 7.1.0.beta1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.8.1
+        version: 7.1.0.beta1
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.8.1
+        version: 7.1.0.beta1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.8.1
+        version: 7.1.0.beta1
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -59,6 +73,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -66,48 +83,51 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.2
 - !ruby/object:Gem::Dependency
-  name: method_source
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.6'
 - !ruby/object:Gem::Dependency
-  name: zeitwerk
+  name: irb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: actionview
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.8.1
+        version: 7.1.0.beta1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.8.1
+        version: 7.1.0.beta1
 description: 'Rails internals: application bootup, plugins, generators, and rake tasks.'
 email: david@loudthinking.com
 executables:
@@ -117,7 +137,7 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - MIT-LICENSE
-- RDOC_MAIN.rdoc
+- RDOC_MAIN.md
 - README.rdoc
 - exe/rails
 - lib/minitest/rails_plugin.rb
@@ -131,7 +151,7 @@ files:
 - lib/rails/application/bootstrap.rb
 - lib/rails/application/configuration.rb
 - lib/rails/application/default_middleware_stack.rb
-- lib/rails/application/dummy_erb_compiler.rb
+- lib/rails/application/dummy_config.rb
 - lib/rails/application/finisher.rb
 - lib/rails/application/routes_reloader.rb
 - lib/rails/application_controller.rb
@@ -148,6 +168,7 @@ files:
 - lib/rails/command/environment_argument.rb
 - lib/rails/command/helpers/editor.rb
 - lib/rails/commands.rb
+- lib/rails/commands/about/about_command.rb
 - lib/rails/commands/application/application_command.rb
 - lib/rails/commands/console/console_command.rb
 - lib/rails/commands/credentials/USAGE
@@ -159,25 +180,33 @@ files:
 - lib/rails/commands/dev/dev_command.rb
 - lib/rails/commands/encrypted/USAGE
 - lib/rails/commands/encrypted/encrypted_command.rb
+- lib/rails/commands/gem_help/USAGE
+- lib/rails/commands/gem_help/gem_help_command.rb
 - lib/rails/commands/generate/generate_command.rb
 - lib/rails/commands/help/USAGE
 - lib/rails/commands/help/help_command.rb
 - lib/rails/commands/initializers/initializers_command.rb
+- lib/rails/commands/middleware/middleware_command.rb
 - lib/rails/commands/new/new_command.rb
 - lib/rails/commands/notes/notes_command.rb
 - lib/rails/commands/plugin/plugin_command.rb
 - lib/rails/commands/rake/rake_command.rb
+- lib/rails/commands/restart/restart_command.rb
 - lib/rails/commands/routes/routes_command.rb
 - lib/rails/commands/runner/USAGE
 - lib/rails/commands/runner/runner_command.rb
+- lib/rails/commands/secret/secret_command.rb
 - lib/rails/commands/secrets/USAGE
 - lib/rails/commands/secrets/secrets_command.rb
 - lib/rails/commands/server/server_command.rb
+- lib/rails/commands/test/USAGE
 - lib/rails/commands/test/test_command.rb
+- lib/rails/commands/unused_routes/unused_routes_command.rb
 - lib/rails/commands/version/version_command.rb
 - lib/rails/configuration.rb
 - lib/rails/console/app.rb
 - lib/rails/console/helpers.rb
+- lib/rails/deprecator.rb
 - lib/rails/dev_caching.rb
 - lib/rails/engine.rb
 - lib/rails/engine/commands.rb
@@ -214,6 +243,7 @@ files:
 - lib/rails/generators/named_base.rb
 - lib/rails/generators/rails/app/USAGE
 - lib/rails/generators/rails/app/app_generator.rb
+- lib/rails/generators/rails/app/templates/Dockerfile.tt
 - lib/rails/generators/rails/app/templates/Gemfile.tt
 - lib/rails/generators/rails/app/templates/README.md.tt
 - lib/rails/generators/rails/app/templates/Rakefile.tt
@@ -245,6 +275,7 @@ files:
 - lib/rails/generators/rails/app/templates/config/databases/postgresql.yml.tt
 - lib/rails/generators/rails/app/templates/config/databases/sqlite3.yml.tt
 - lib/rails/generators/rails/app/templates/config/databases/sqlserver.yml.tt
+- lib/rails/generators/rails/app/templates/config/databases/trilogy.yml.tt
 - lib/rails/generators/rails/app/templates/config/environment.rb.tt
 - lib/rails/generators/rails/app/templates/config/environments/development.rb.tt
 - lib/rails/generators/rails/app/templates/config/environments/production.rb.tt
@@ -254,15 +285,18 @@ files:
 - lib/rails/generators/rails/app/templates/config/initializers/cors.rb.tt
 - lib/rails/generators/rails/app/templates/config/initializers/filter_parameter_logging.rb.tt
 - lib/rails/generators/rails/app/templates/config/initializers/inflections.rb.tt
-- lib/rails/generators/rails/app/templates/config/initializers/new_framework_defaults_7_0.rb.tt
+- lib/rails/generators/rails/app/templates/config/initializers/new_framework_defaults_7_1.rb.tt
 - lib/rails/generators/rails/app/templates/config/initializers/permissions_policy.rb.tt
 - lib/rails/generators/rails/app/templates/config/locales/en.yml
 - lib/rails/generators/rails/app/templates/config/puma.rb.tt
 - lib/rails/generators/rails/app/templates/config/routes.rb.tt
 - lib/rails/generators/rails/app/templates/config/storage.yml.tt
 - lib/rails/generators/rails/app/templates/db/seeds.rb.tt
+- lib/rails/generators/rails/app/templates/docker-entrypoint.tt
+- lib/rails/generators/rails/app/templates/dockerignore.tt
 - lib/rails/generators/rails/app/templates/gitattributes.tt
 - lib/rails/generators/rails/app/templates/gitignore.tt
+- lib/rails/generators/rails/app/templates/node-version.tt
 - lib/rails/generators/rails/app/templates/public/404.html
 - lib/rails/generators/rails/app/templates/public/422.html
 - lib/rails/generators/rails/app/templates/public/500.html
@@ -282,6 +316,7 @@ files:
 - lib/rails/generators/rails/controller/controller_generator.rb
 - lib/rails/generators/rails/controller/templates/controller.rb.tt
 - lib/rails/generators/rails/credentials/credentials_generator.rb
+- lib/rails/generators/rails/credentials/templates/credentials.yml.tt
 - lib/rails/generators/rails/db/system/change/change_generator.rb
 - lib/rails/generators/rails/encrypted_file/encrypted_file_generator.rb
 - lib/rails/generators/rails/encryption_key_file/encryption_key_file_generator.rb
@@ -298,7 +333,6 @@ files:
 - lib/rails/generators/rails/master_key/master_key_generator.rb
 - lib/rails/generators/rails/migration/USAGE
 - lib/rails/generators/rails/migration/migration_generator.rb
-- lib/rails/generators/rails/model/USAGE
 - lib/rails/generators/rails/model/model_generator.rb
 - lib/rails/generators/rails/plugin/USAGE
 - lib/rails/generators/rails/plugin/plugin_generator.rb
@@ -375,8 +409,9 @@ files:
 - lib/rails/generators/test_unit/system/templates/application_system_test_case.rb.tt
 - lib/rails/generators/test_unit/system/templates/system_test.rb.tt
 - lib/rails/generators/testing/assertions.rb
-- lib/rails/generators/testing/behaviour.rb
+- lib/rails/generators/testing/behavior.rb
 - lib/rails/generators/testing/setup_and_teardown.rb
+- lib/rails/health_controller.rb
 - lib/rails/info.rb
 - lib/rails/info_controller.rb
 - lib/rails/initializable.rb
@@ -385,6 +420,7 @@ files:
 - lib/rails/plugin/test.rb
 - lib/rails/rack.rb
 - lib/rails/rack/logger.rb
+- lib/rails/rackup/server.rb
 - lib/rails/railtie.rb
 - lib/rails/railtie/configurable.rb
 - lib/rails/railtie/configuration.rb
@@ -395,9 +431,7 @@ files:
 - lib/rails/tasks/engine.rake
 - lib/rails/tasks/framework.rake
 - lib/rails/tasks/log.rake
-- lib/rails/tasks/middleware.rake
 - lib/rails/tasks/misc.rake
-- lib/rails/tasks/restart.rake
 - lib/rails/tasks/statistics.rake
 - lib/rails/tasks/tmp.rake
 - lib/rails/tasks/yarn.rake
@@ -414,6 +448,7 @@ files:
 - lib/rails/test_unit/railtie.rb
 - lib/rails/test_unit/reporter.rb
 - lib/rails/test_unit/runner.rb
+- lib/rails/test_unit/test_parser.rb
 - lib/rails/test_unit/testing.rake
 - lib/rails/version.rb
 - lib/rails/welcome_controller.rb
@@ -422,10 +457,10 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/rails/rails/issues
-  changelog_uri: https://github.com/rails/rails/blob/v7.0.8.1/railties/CHANGELOG.md
-  documentation_uri: https://api.rubyonrails.org/v7.0.8.1/
+  changelog_uri: https://github.com/rails/rails/blob/v7.1.0.beta1/railties/CHANGELOG.md
+  documentation_uri: https://api.rubyonrails.org/v7.1.0.beta1/
   mailing_list_uri: https://discuss.rubyonrails.org/c/rubyonrails-talk
-  source_code_uri: https://github.com/rails/rails/tree/v7.0.8.1/railties
+  source_code_uri: https://github.com/rails/rails/tree/v7.1.0.beta1/railties
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options:
@@ -440,11 +475,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.4.18
 signing_key:
 specification_version: 4
 summary: Tools for creating, working with, and running Rails applications.

data/RDOC_MAIN.rdoc

@@ -1,97 +0,0 @@
-= Welcome to \Rails
-
-== What's \Rails
-
-\Rails is a web-application framework that includes everything needed to
-create database-backed web applications according to the
-{Model-View-Controller (MVC)}[https://en.wikipedia.org/wiki/Model-view-controller]
-pattern.
-
-Understanding the MVC pattern is key to understanding \Rails. MVC divides your
-application into three layers: Model, View, and Controller, each with a specific responsibility.
-
-== Model layer
-
-The <em><b>Model layer</b></em> represents the domain model (such as Account, Product,
-Person, Post, etc.) and encapsulates the business logic specific to
-your application. In \Rails, database-backed model classes are derived from
-<tt>ActiveRecord::Base</tt>. {Active Record}[link:/files/activerecord/README_rdoc.html] allows you to present the data from
-database rows as objects and embellish these data objects with business logic
-methods. Although most \Rails models are backed by a database, models can also be ordinary
-Ruby classes, or Ruby classes that implement a set of interfaces as provided by
-the {Active Model}[link:/files/activemodel/README_rdoc.html] module.
-
-== Controller layer
-
-The <em><b>Controller layer</b></em> is responsible for handling incoming HTTP requests and
-providing a suitable response. Usually, this means returning \HTML, but \Rails controllers
-can also generate XML, JSON, PDFs, mobile-specific views, and more. Controllers load and
-manipulate models and render view templates in order to generate the appropriate HTTP response.
-In \Rails, incoming requests are routed by Action Dispatch to an appropriate controller, and
-controller classes are derived from <tt>ActionController::Base</tt>. Action Dispatch and Action Controller
-are bundled together in {Action Pack}[link:/files/actionpack/README_rdoc.html].
-
-== View layer
-
-The <em><b>View layer</b></em> is composed of "templates" that are responsible for providing
-appropriate representations of your application's resources. Templates can
-come in a variety of formats, but most view templates are \HTML with embedded
-Ruby code (ERB files). Views are typically rendered to generate a controller response,
-or to generate the body of an email. In \Rails, View generation is handled by {Action View}[link:/files/actionview/README_rdoc.html].
-
-== Frameworks and libraries
-
-{Active Record}[link:/files/activerecord/README_rdoc.html], {Active Model}[link:/files/activemodel/README_rdoc.html],
-{Action Pack}[link:/files/actionpack/README_rdoc.html], and {Action View}[link:/files/actionview/README_rdoc.html] can each be used independently outside \Rails.
-In addition to that, \Rails also comes with {Action Mailer}[link:/files/actionmailer/README_rdoc.html], a library
-to generate and send emails; {Action Mailbox}[link:/files/actionmailbox/README_md.html], a library to receive emails within a Rails application;
-{Active Job}[link:/files/activejob/README_md.html], a framework for declaring jobs and making them run on a variety of queueing
-backends; {Action Cable}[link:/files/actioncable/README_md.html], a framework to
-integrate WebSockets with a \Rails application; {Active Storage}[link:/files/activestorage/README_md.html],
-a library to attach cloud and local files to \Rails applications; {Action Text}[link:/files/actiontext/README_md.html], a library to handle rich text content;
-and {Active Support}[link:/files/activesupport/README_rdoc.html], a collection
-of utility classes and standard library extensions that are useful for \Rails,
-and may also be used independently outside \Rails.
-
-== Getting Started
-
-1. Install \Rails at the command prompt if you haven't yet:
-
-    $ gem install rails
-
-2. At the command prompt, create a new \Rails application:
-
-    $ rails new myapp
-
-   where "myapp" is the application name.
-
-3. Change directory to +myapp+ and start the web server:
-
-    $ cd myapp
-    $ bin/rails server
-
-   Run with <tt>--help</tt> or <tt>-h</tt> for options.
-
-4. Go to <tt>http://localhost:3000</tt>, and you'll see: "Yay! You’re on \Rails!"
-
-5. Follow the guidelines to start developing your application. You may find the following resources handy:
-
-   * The \README file created within your application.
-   * {Getting Started with \Rails}[https://guides.rubyonrails.org/getting_started.html].
-   * {Ruby on \Rails Guides}[https://guides.rubyonrails.org].
-   * {The API Documentation}[https://api.rubyonrails.org].
-
-== Contributing
-
-We encourage you to contribute to Ruby on \Rails! Please check out the
-{Contributing to Ruby on \Rails guide}[https://guides.rubyonrails.org/contributing_to_ruby_on_rails.html] for guidelines about how to proceed. {Join us!}[http://contributors.rubyonrails.org]
-
-Trying to report a possible security vulnerability in \Rails? Please
-check out our {security policy}[https://rubyonrails.org/security/] for
-guidelines about how to proceed.
-
-Everyone interacting in \Rails and its sub-projects' codebases, issue trackers, chat rooms, and mailing lists is expected to follow the \Rails {code of conduct}[http://rubyonrails.org/conduct/].
-
-== License
-
-Ruby on \Rails is released under the {MIT License}[https://opensource.org/licenses/MIT].