railties 6.1.6 → 7.1.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +626 -259
- data/MIT-LICENSE +1 -1
- data/RDOC_MAIN.md +99 -0
- data/README.rdoc +5 -6
- data/lib/minitest/rails_plugin.rb +64 -1
- data/lib/rails/all.rb +0 -1
- data/lib/rails/api/task.rb +35 -4
- data/lib/rails/app_updater.rb +9 -6
- data/lib/rails/application/bootstrap.rb +41 -7
- data/lib/rails/application/configuration.rb +262 -88
- data/lib/rails/application/default_middleware_stack.rb +29 -4
- data/lib/rails/application/dummy_config.rb +19 -0
- data/lib/rails/application/finisher.rb +89 -124
- data/lib/rails/application/routes_reloader.rb +8 -0
- data/lib/rails/application.rb +200 -125
- data/lib/rails/application_controller.rb +3 -3
- data/lib/rails/autoloaders/inflector.rb +21 -0
- data/lib/rails/autoloaders.rb +42 -42
- data/lib/rails/backtrace_cleaner.rb +1 -1
- data/lib/rails/cli.rb +5 -2
- data/lib/rails/code_statistics.rb +2 -2
- data/lib/rails/code_statistics_calculator.rb +10 -1
- data/lib/rails/command/actions.rb +10 -12
- data/lib/rails/command/base.rb +61 -45
- data/lib/rails/command/behavior.rb +1 -1
- data/lib/rails/command/environment_argument.rb +33 -17
- data/lib/rails/command/helpers/editor.rb +17 -12
- data/lib/rails/command.rb +90 -36
- data/lib/rails/commands/about/about_command.rb +14 -0
- data/lib/rails/commands/application/application_command.rb +2 -0
- data/lib/rails/commands/console/console_command.rb +17 -13
- data/lib/rails/commands/credentials/USAGE +53 -53
- data/lib/rails/commands/credentials/credentials_command/diffing.rb +31 -19
- data/lib/rails/commands/credentials/credentials_command.rb +67 -69
- data/lib/rails/commands/db/system/change/change_command.rb +2 -1
- data/lib/rails/commands/dbconsole/dbconsole_command.rb +26 -117
- data/lib/rails/commands/destroy/destroy_command.rb +3 -2
- data/lib/rails/commands/dev/dev_command.rb +1 -6
- data/lib/rails/commands/encrypted/USAGE +15 -20
- data/lib/rails/commands/encrypted/encrypted_command.rb +46 -35
- data/lib/rails/commands/gem_help/USAGE +16 -0
- data/lib/rails/commands/gem_help/gem_help_command.rb +13 -0
- data/lib/rails/commands/generate/generate_command.rb +2 -2
- data/lib/rails/commands/help/USAGE +15 -14
- data/lib/rails/commands/help/help_command.rb +21 -2
- data/lib/rails/commands/initializers/initializers_command.rb +1 -4
- data/lib/rails/commands/middleware/middleware_command.rb +17 -0
- data/lib/rails/commands/new/new_command.rb +2 -0
- data/lib/rails/commands/notes/notes_command.rb +2 -1
- data/lib/rails/commands/plugin/plugin_command.rb +2 -0
- data/lib/rails/commands/rake/rake_command.rb +25 -22
- data/lib/rails/commands/restart/restart_command.rb +14 -0
- data/lib/rails/commands/routes/routes_command.rb +13 -1
- data/lib/rails/commands/runner/USAGE +14 -12
- data/lib/rails/commands/runner/runner_command.rb +34 -21
- data/lib/rails/commands/secret/secret_command.rb +13 -0
- data/lib/rails/commands/secrets/USAGE +44 -49
- data/lib/rails/commands/secrets/secrets_command.rb +20 -38
- data/lib/rails/commands/server/server_command.rb +33 -30
- data/lib/rails/commands/test/USAGE +14 -0
- data/lib/rails/commands/test/test_command.rb +56 -14
- data/lib/rails/commands/unused_routes/unused_routes_command.rb +75 -0
- data/lib/rails/commands/version/version_command.rb +1 -0
- data/lib/rails/configuration.rb +23 -28
- data/lib/rails/console/app.rb +1 -4
- data/lib/rails/console/helpers.rb +2 -2
- data/lib/rails/deprecator.rb +7 -0
- data/lib/rails/engine/configuration.rb +53 -9
- data/lib/rails/engine.rb +63 -48
- data/lib/rails/gem_version.rb +3 -3
- data/lib/rails/generators/actions/create_migration.rb +2 -4
- data/lib/rails/generators/actions.rb +231 -73
- data/lib/rails/generators/active_model.rb +28 -14
- data/lib/rails/generators/app_base.rb +476 -176
- data/lib/rails/generators/app_name.rb +3 -14
- data/lib/rails/generators/base.rb +24 -20
- data/lib/rails/generators/database.rb +39 -1
- data/lib/rails/generators/erb/mailer/templates/layout.html.erb.tt +1 -1
- data/lib/rails/generators/erb/scaffold/scaffold_generator.rb +2 -0
- data/lib/rails/generators/erb/scaffold/templates/_form.html.erb.tt +8 -8
- data/lib/rails/generators/erb/scaffold/templates/edit.html.erb.tt +8 -4
- data/lib/rails/generators/erb/scaffold/templates/index.html.erb.tt +11 -28
- data/lib/rails/generators/erb/scaffold/templates/new.html.erb.tt +7 -3
- data/lib/rails/generators/erb/scaffold/templates/partial.html.erb.tt +17 -0
- data/lib/rails/generators/erb/scaffold/templates/show.html.erb.tt +8 -17
- data/lib/rails/generators/erb.rb +1 -1
- data/lib/rails/generators/generated_attribute.rb +57 -9
- data/lib/rails/generators/migration.rb +2 -7
- data/lib/rails/generators/model_helpers.rb +3 -2
- data/lib/rails/generators/named_base.rb +13 -13
- data/lib/rails/generators/rails/app/USAGE +22 -6
- data/lib/rails/generators/rails/app/app_generator.rb +113 -114
- data/lib/rails/generators/rails/app/templates/Dockerfile.tt +103 -0
- data/lib/rails/generators/rails/app/templates/Gemfile.tt +43 -53
- data/lib/rails/generators/rails/app/templates/app/assets/stylesheets/application.css.tt +2 -2
- data/lib/rails/generators/rails/app/templates/app/mailers/application_mailer.rb.tt +2 -2
- data/lib/rails/generators/rails/app/templates/app/models/application_record.rb.tt +1 -1
- data/lib/rails/generators/rails/app/templates/app/views/layouts/application.html.erb.tt +3 -9
- data/lib/rails/generators/rails/app/templates/app/views/layouts/mailer.html.erb.tt +1 -1
- data/lib/rails/generators/rails/app/templates/bin/rails.tt +1 -4
- data/lib/rails/generators/rails/app/templates/bin/rake.tt +0 -3
- data/lib/rails/generators/rails/app/templates/bin/setup.tt +16 -12
- data/lib/rails/generators/rails/app/templates/config/application.rb.tt +6 -18
- data/lib/rails/generators/rails/app/templates/config/boot.rb.tt +1 -1
- data/lib/rails/generators/rails/app/templates/config/databases/jdbc.yml.tt +2 -2
- data/lib/rails/generators/rails/app/templates/config/databases/jdbcmysql.yml.tt +3 -3
- data/lib/rails/generators/rails/app/templates/config/databases/jdbcpostgresql.yml.tt +7 -7
- data/lib/rails/generators/rails/app/templates/config/databases/jdbcsqlite3.yml.tt +5 -5
- data/lib/rails/generators/rails/app/templates/config/databases/mysql.yml.tt +3 -3
- data/lib/rails/generators/rails/app/templates/config/databases/oracle.yml.tt +2 -2
- data/lib/rails/generators/rails/app/templates/config/databases/postgresql.yml.tt +7 -9
- data/lib/rails/generators/rails/app/templates/config/databases/sqlite3.yml.tt +4 -4
- data/lib/rails/generators/rails/app/templates/config/databases/sqlserver.yml.tt +5 -5
- data/lib/rails/generators/rails/app/templates/config/databases/trilogy.yml.tt +59 -0
- data/lib/rails/generators/rails/app/templates/config/environments/development.rb.tt +16 -12
- data/lib/rails/generators/rails/app/templates/config/environments/production.rb.tt +38 -61
- data/lib/rails/generators/rails/app/templates/config/environments/test.rb.tt +14 -15
- data/lib/rails/generators/rails/app/templates/config/initializers/assets.rb.tt +3 -5
- data/lib/rails/generators/rails/app/templates/config/initializers/content_security_policy.rb.tt +21 -28
- data/lib/rails/generators/rails/app/templates/config/initializers/cors.rb.tt +3 -3
- data/lib/rails/generators/rails/app/templates/config/initializers/filter_parameter_logging.rb.tt +3 -1
- data/lib/rails/generators/rails/app/templates/config/initializers/inflections.rb.tt +4 -4
- data/lib/rails/generators/rails/app/templates/config/initializers/new_framework_defaults_7_1.rb.tt +283 -0
- data/lib/rails/generators/rails/app/templates/config/initializers/permissions_policy.rb.tt +11 -9
- data/lib/rails/generators/rails/app/templates/config/locales/en.yml +13 -15
- data/lib/rails/generators/rails/app/templates/config/puma.rb.tt +12 -20
- data/lib/rails/generators/rails/app/templates/config/routes.rb.tt +8 -1
- data/lib/rails/generators/rails/app/templates/config/storage.yml.tt +5 -5
- data/lib/rails/generators/rails/app/templates/db/seeds.rb.tt +6 -4
- data/lib/rails/generators/rails/app/templates/docker-entrypoint.tt +10 -0
- data/lib/rails/generators/rails/app/templates/dockerignore.tt +43 -0
- data/lib/rails/generators/rails/app/templates/gitattributes.tt +0 -5
- data/lib/rails/generators/rails/app/templates/gitignore.tt +7 -9
- data/lib/rails/generators/rails/app/templates/node-version.tt +1 -0
- data/lib/rails/generators/rails/app/templates/test/channels/application_cable/connection_test.rb.tt +10 -8
- data/lib/rails/generators/rails/app/templates/test/test_helper.rb.tt +10 -8
- data/lib/rails/generators/rails/application_record/application_record_generator.rb +4 -0
- data/lib/rails/generators/rails/benchmark/benchmark_generator.rb +2 -1
- data/lib/rails/generators/rails/controller/USAGE +12 -4
- data/lib/rails/generators/rails/controller/controller_generator.rb +6 -2
- data/lib/rails/generators/rails/controller/templates/controller.rb.tt +1 -5
- data/lib/rails/generators/rails/credentials/credentials_generator.rb +29 -24
- data/lib/rails/generators/rails/credentials/templates/credentials.yml.tt +8 -0
- data/lib/rails/generators/rails/db/system/change/change_generator.rb +31 -1
- data/lib/rails/generators/rails/encryption_key_file/encryption_key_file_generator.rb +1 -2
- data/lib/rails/generators/rails/generator/templates/%file_name%_generator.rb.tt +1 -1
- data/lib/rails/generators/rails/migration/USAGE +21 -11
- data/lib/rails/generators/rails/model/model_generator.rb +4 -0
- data/lib/rails/generators/rails/plugin/USAGE +17 -6
- data/lib/rails/generators/rails/plugin/plugin_generator.rb +69 -30
- data/lib/rails/generators/rails/plugin/templates/%name%.gemspec.tt +7 -3
- data/lib/rails/generators/rails/plugin/templates/Gemfile.tt +9 -31
- data/lib/rails/generators/rails/plugin/templates/MIT-LICENSE.tt +1 -1
- data/lib/rails/generators/rails/plugin/templates/README.md.tt +1 -1
- data/lib/rails/generators/rails/plugin/templates/app/mailers/%namespaced_name%/application_mailer.rb.tt +2 -2
- data/lib/rails/generators/rails/plugin/templates/app/views/layouts/%namespaced_name%/application.html.erb.tt +0 -3
- data/lib/rails/generators/rails/plugin/templates/bin/rails.tt +5 -20
- data/lib/rails/generators/rails/plugin/templates/gitignore.tt +0 -7
- data/lib/rails/generators/rails/plugin/templates/lib/%namespaced_name%/engine.rb.tt +2 -2
- data/lib/rails/generators/rails/plugin/templates/lib/%namespaced_name%/version.rb.tt +1 -1
- data/lib/rails/generators/rails/plugin/templates/rails/boot.rb.tt +2 -2
- data/lib/rails/generators/rails/plugin/templates/test/test_helper.rb.tt +6 -11
- data/lib/rails/generators/rails/resource/resource_generator.rb +6 -0
- data/lib/rails/generators/rails/scaffold/scaffold_generator.rb +2 -20
- data/lib/rails/generators/rails/scaffold_controller/scaffold_controller_generator.rb +1 -1
- data/lib/rails/generators/rails/scaffold_controller/templates/api_controller.rb.tt +1 -5
- data/lib/rails/generators/rails/scaffold_controller/templates/controller.rb.tt +6 -10
- data/lib/rails/generators/resource_helpers.rb +2 -2
- data/lib/rails/generators/test_case.rb +2 -2
- data/lib/rails/generators/test_unit/generator/templates/generator_test.rb.tt +1 -1
- data/lib/rails/generators/test_unit/model/templates/fixtures.yml.tt +2 -2
- data/lib/rails/generators/test_unit/scaffold/scaffold_generator.rb +4 -4
- data/lib/rails/generators/test_unit/scaffold/templates/api_functional_test.rb.tt +5 -5
- data/lib/rails/generators/test_unit/scaffold/templates/functional_test.rb.tt +7 -7
- data/lib/rails/generators/test_unit/scaffold/templates/system_test.rb.tt +9 -11
- data/lib/rails/generators/testing/{behaviour.rb → behavior.rb} +7 -5
- data/lib/rails/generators.rb +14 -29
- data/lib/rails/health_controller.rb +55 -0
- data/lib/rails/info.rb +2 -2
- data/lib/rails/info_controller.rb +31 -13
- data/lib/rails/initializable.rb +1 -1
- data/lib/rails/mailers_controller.rb +17 -9
- data/lib/rails/paths.rb +14 -11
- data/lib/rails/rack/logger.rb +16 -15
- data/lib/rails/rackup/server.rb +15 -0
- data/lib/rails/railtie/configuration.rb +15 -3
- data/lib/rails/railtie.rb +54 -31
- data/lib/rails/ruby_version_check.rb +5 -3
- data/lib/rails/secrets.rb +10 -8
- data/lib/rails/source_annotation_extractor.rb +68 -19
- data/lib/rails/tasks/engine.rake +8 -8
- data/lib/rails/tasks/framework.rake +4 -12
- data/lib/rails/tasks/log.rake +1 -1
- data/lib/rails/tasks/misc.rake +3 -14
- data/lib/rails/tasks/statistics.rake +8 -5
- data/lib/rails/tasks/tmp.rake +13 -6
- data/lib/rails/tasks/yarn.rake +8 -9
- data/lib/rails/tasks/zeitwerk.rake +14 -42
- data/lib/rails/tasks.rb +0 -2
- data/lib/rails/templates/layouts/application.html.erb +15 -0
- data/lib/rails/templates/rails/mailers/email.html.erb +45 -11
- data/lib/rails/templates/rails/mailers/index.html.erb +14 -7
- data/lib/rails/templates/rails/mailers/mailer.html.erb +11 -5
- data/lib/rails/templates/rails/welcome/index.html.erb +65 -48
- data/lib/rails/test_help.rb +13 -14
- data/lib/rails/test_unit/line_filtering.rb +1 -1
- data/lib/rails/test_unit/railtie.rb +0 -4
- data/lib/rails/test_unit/reporter.rb +6 -2
- data/lib/rails/test_unit/runner.rb +45 -20
- data/lib/rails/test_unit/test_parser.rb +88 -0
- data/lib/rails/test_unit/testing.rake +18 -43
- data/lib/rails/testing/maintain_test_schema.rb +16 -0
- data/lib/rails/version.rb +1 -1
- data/lib/rails/welcome_controller.rb +1 -0
- data/lib/rails/zeitwerk_checker.rb +15 -0
- data/lib/rails.rb +26 -15
- metadata +74 -42
- data/RDOC_MAIN.rdoc +0 -97
- data/lib/rails/.DS_Store +0 -0
- data/lib/rails/application/dummy_erb_compiler.rb +0 -18
- data/lib/rails/command/spellchecker.rb +0 -57
- data/lib/rails/generators/css/assets/assets_generator.rb +0 -15
- data/lib/rails/generators/css/assets/templates/stylesheet.css +0 -4
- data/lib/rails/generators/css/scaffold/scaffold_generator.rb +0 -18
- data/lib/rails/generators/rails/app/templates/app/javascript/channels/consumer.js +0 -6
- data/lib/rails/generators/rails/app/templates/app/javascript/channels/index.js +0 -5
- data/lib/rails/generators/rails/app/templates/app/javascript/packs/application.js.tt +0 -23
- data/lib/rails/generators/rails/app/templates/bin/spring.tt +0 -13
- data/lib/rails/generators/rails/app/templates/bin/yarn.tt +0 -16
- data/lib/rails/generators/rails/app/templates/config/initializers/application_controller_renderer.rb.tt +0 -8
- data/lib/rails/generators/rails/app/templates/config/initializers/backtrace_silencers.rb.tt +0 -8
- data/lib/rails/generators/rails/app/templates/config/initializers/cookies_serializer.rb.tt +0 -5
- data/lib/rails/generators/rails/app/templates/config/initializers/mime_types.rb.tt +0 -4
- data/lib/rails/generators/rails/app/templates/config/initializers/new_framework_defaults_6_1.rb.tt +0 -67
- data/lib/rails/generators/rails/app/templates/config/initializers/wrap_parameters.rb.tt +0 -16
- data/lib/rails/generators/rails/app/templates/config/spring.rb.tt +0 -6
- data/lib/rails/generators/rails/app/templates/package.json.tt +0 -11
- data/lib/rails/generators/rails/assets/USAGE +0 -16
- data/lib/rails/generators/rails/assets/assets_generator.rb +0 -26
- data/lib/rails/generators/rails/assets/templates/stylesheet.css +0 -4
- data/lib/rails/generators/rails/model/USAGE +0 -113
- data/lib/rails/generators/rails/scaffold/templates/scaffold.css +0 -80
- data/lib/rails/tasks/middleware.rake +0 -9
- data/lib/rails/tasks/restart.rake +0 -9
@@ -1,7 +1,6 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
3
|
require "rails/configuration"
|
4
|
-
require "active_support/core_ext/symbol/starts_ends_with"
|
5
4
|
|
6
5
|
module Rails
|
7
6
|
class Railtie
|
@@ -11,7 +10,7 @@ module Rails
|
|
11
10
|
end
|
12
11
|
|
13
12
|
# Expose the eager_load_namespaces at "module" level for convenience.
|
14
|
-
def self.eager_load_namespaces
|
13
|
+
def self.eager_load_namespaces # :nodoc:
|
15
14
|
@@eager_load_namespaces ||= []
|
16
15
|
end
|
17
16
|
|
@@ -72,6 +71,11 @@ module Rails
|
|
72
71
|
ActiveSupport.on_load(:after_initialize, yield: true, &block)
|
73
72
|
end
|
74
73
|
|
74
|
+
# Called after application routes have been loaded.
|
75
|
+
def after_routes_loaded(&block)
|
76
|
+
ActiveSupport.on_load(:after_routes_loaded, yield: true, &block)
|
77
|
+
end
|
78
|
+
|
75
79
|
# Array of callbacks defined by #to_prepare.
|
76
80
|
def to_prepare_blocks
|
77
81
|
@@to_prepare_blocks ||= []
|
@@ -88,9 +92,17 @@ module Rails
|
|
88
92
|
end
|
89
93
|
|
90
94
|
private
|
95
|
+
def actual_method?(key)
|
96
|
+
!@@options.key?(key) && respond_to?(key)
|
97
|
+
end
|
98
|
+
|
91
99
|
def method_missing(name, *args, &blk)
|
92
100
|
if name.end_with?("=")
|
93
|
-
|
101
|
+
key = name[0..-2].to_sym
|
102
|
+
if actual_method?(key)
|
103
|
+
raise NoMethodError.new("Cannot assign to `#{key}`, it is a configuration method")
|
104
|
+
end
|
105
|
+
@@options[key] = args.first
|
94
106
|
elsif @@options.key?(name)
|
95
107
|
@@options[name]
|
96
108
|
else
|
data/lib/rails/railtie.rb
CHANGED
@@ -7,34 +7,34 @@ require "active_support/core_ext/module/introspection"
|
|
7
7
|
require "active_support/core_ext/module/delegation"
|
8
8
|
|
9
9
|
module Rails
|
10
|
-
#
|
11
|
-
# several hooks to extend Rails and/or modify the initialization process.
|
10
|
+
# +Rails::Railtie+ is the core of the \Rails framework and provides
|
11
|
+
# several hooks to extend \Rails and/or modify the initialization process.
|
12
12
|
#
|
13
|
-
# Every major component of Rails (Action Mailer, Action Controller, Active
|
13
|
+
# Every major component of \Rails (Action Mailer, Action Controller, Active
|
14
14
|
# Record, etc.) implements a railtie. Each of them is responsible for their
|
15
|
-
# own initialization. This makes Rails itself absent of any component hooks,
|
16
|
-
# allowing other components to be used in place of any of the Rails defaults.
|
15
|
+
# own initialization. This makes \Rails itself absent of any component hooks,
|
16
|
+
# allowing other components to be used in place of any of the \Rails defaults.
|
17
17
|
#
|
18
|
-
# Developing a Rails extension does _not_ require implementing a railtie, but
|
19
|
-
# if you need to interact with the Rails framework during or after boot, then
|
18
|
+
# Developing a \Rails extension does _not_ require implementing a railtie, but
|
19
|
+
# if you need to interact with the \Rails framework during or after boot, then
|
20
20
|
# a railtie is needed.
|
21
21
|
#
|
22
22
|
# For example, an extension doing any of the following would need a railtie:
|
23
23
|
#
|
24
24
|
# * creating initializers
|
25
|
-
# * configuring a Rails framework for the application, like setting a generator
|
25
|
+
# * configuring a \Rails framework for the application, like setting a generator
|
26
26
|
# * adding <tt>config.*</tt> keys to the environment
|
27
|
-
# * setting up a subscriber with
|
27
|
+
# * setting up a subscriber with ActiveSupport::Notifications
|
28
28
|
# * adding Rake tasks
|
29
29
|
#
|
30
30
|
# == Creating a Railtie
|
31
31
|
#
|
32
|
-
# To extend Rails using a railtie, create a subclass of
|
33
|
-
# This class must be loaded during the Rails boot process, and is conventionally
|
34
|
-
# called
|
32
|
+
# To extend \Rails using a railtie, create a subclass of +Rails::Railtie+.
|
33
|
+
# This class must be loaded during the \Rails boot process, and is conventionally
|
34
|
+
# called +MyNamespace::Railtie+.
|
35
35
|
#
|
36
36
|
# The following example demonstrates an extension which can be used with or
|
37
|
-
# without Rails.
|
37
|
+
# without \Rails.
|
38
38
|
#
|
39
39
|
# # lib/my_gem/railtie.rb
|
40
40
|
# module MyGem
|
@@ -47,7 +47,7 @@ module Rails
|
|
47
47
|
#
|
48
48
|
# == Initializers
|
49
49
|
#
|
50
|
-
# To add an initialization step to the Rails boot process from your railtie, just
|
50
|
+
# To add an initialization step to the \Rails boot process from your railtie, just
|
51
51
|
# define the initialization code with the +initializer+ macro:
|
52
52
|
#
|
53
53
|
# class MyRailtie < Rails::Railtie
|
@@ -87,7 +87,7 @@ module Rails
|
|
87
87
|
#
|
88
88
|
# == Loading Rake Tasks and Generators
|
89
89
|
#
|
90
|
-
# If your railtie has Rake tasks, you can tell Rails to load them through the method
|
90
|
+
# If your railtie has Rake tasks, you can tell \Rails to load them through the method
|
91
91
|
# +rake_tasks+:
|
92
92
|
#
|
93
93
|
# class MyRailtie < Rails::Railtie
|
@@ -96,7 +96,7 @@ module Rails
|
|
96
96
|
# end
|
97
97
|
# end
|
98
98
|
#
|
99
|
-
# By default, Rails loads generators from your load path. However, if you want to place
|
99
|
+
# By default, \Rails loads generators from your load path. However, if you want to place
|
100
100
|
# your generators at a different location, you can specify in your railtie a block which
|
101
101
|
# will load them during normal generators lookup:
|
102
102
|
#
|
@@ -109,13 +109,13 @@ module Rails
|
|
109
109
|
# Since filenames on the load path are shared across gems, be sure that files you load
|
110
110
|
# through a railtie have unique names.
|
111
111
|
#
|
112
|
-
# == Run another program when the Rails server starts
|
112
|
+
# == Run another program when the \Rails server starts
|
113
113
|
#
|
114
|
-
# In development, it's very usual to have to run another process next to the Rails Server. In example
|
114
|
+
# In development, it's very usual to have to run another process next to the \Rails Server. In example
|
115
115
|
# you might want to start the Webpack or React server. Or maybe you need to run your job scheduler process
|
116
116
|
# like Sidekiq. This is usually done by opening a new shell and running the program from here.
|
117
117
|
#
|
118
|
-
# Rails allow you to specify a +server+ block which will get called when a Rails server starts.
|
118
|
+
# \Rails allow you to specify a +server+ block which will get called when a \Rails server starts.
|
119
119
|
# This way, your users don't need to remember to have to open a new shell and run another program, making
|
120
120
|
# this less confusing for everyone.
|
121
121
|
# It can be used like this:
|
@@ -129,7 +129,7 @@ module Rails
|
|
129
129
|
# == Application and Engine
|
130
130
|
#
|
131
131
|
# An engine is nothing more than a railtie with some initializers already set. And since
|
132
|
-
#
|
132
|
+
# Rails::Application is an engine, the same configuration described here can be
|
133
133
|
# used in both.
|
134
134
|
#
|
135
135
|
# Be sure to look at the documentation of those specific classes for more information.
|
@@ -146,7 +146,7 @@ module Rails
|
|
146
146
|
delegate :config, to: :instance
|
147
147
|
|
148
148
|
def subclasses
|
149
|
-
super.reject(&:abstract_railtie?)
|
149
|
+
super.reject(&:abstract_railtie?).sort
|
150
150
|
end
|
151
151
|
|
152
152
|
def rake_tasks(&blk)
|
@@ -191,25 +191,44 @@ module Rails
|
|
191
191
|
instance.configure(&block)
|
192
192
|
end
|
193
193
|
|
194
|
+
def <=>(other) # :nodoc:
|
195
|
+
load_index <=> other.load_index
|
196
|
+
end
|
197
|
+
|
198
|
+
def inherited(subclass)
|
199
|
+
subclass.increment_load_index
|
200
|
+
super
|
201
|
+
end
|
202
|
+
|
203
|
+
protected
|
204
|
+
attr_reader :load_index
|
205
|
+
|
206
|
+
def increment_load_index
|
207
|
+
@@load_counter ||= 0
|
208
|
+
@load_index = (@@load_counter += 1)
|
209
|
+
end
|
210
|
+
|
194
211
|
private
|
195
212
|
def generate_railtie_name(string)
|
196
213
|
ActiveSupport::Inflector.underscore(string).tr("/", "_")
|
197
214
|
end
|
198
215
|
|
199
216
|
def respond_to_missing?(name, _)
|
217
|
+
return super if abstract_railtie?
|
218
|
+
|
200
219
|
instance.respond_to?(name) || super
|
201
220
|
end
|
202
221
|
|
203
222
|
# If the class method does not have a method, then send the method call
|
204
223
|
# to the Railtie instance.
|
205
224
|
def method_missing(name, *args, &block)
|
206
|
-
if instance.respond_to?(name)
|
225
|
+
if !abstract_railtie? && instance.respond_to?(name)
|
207
226
|
instance.public_send(name, *args, &block)
|
208
227
|
else
|
209
228
|
super
|
210
229
|
end
|
211
230
|
end
|
212
|
-
ruby2_keywords(:method_missing)
|
231
|
+
ruby2_keywords(:method_missing)
|
213
232
|
|
214
233
|
# receives an instance variable identifier, set the variable value if is
|
215
234
|
# blank and append given block to value, which will be used later in
|
@@ -224,13 +243,17 @@ module Rails
|
|
224
243
|
|
225
244
|
delegate :railtie_name, to: :class
|
226
245
|
|
227
|
-
def initialize
|
246
|
+
def initialize # :nodoc:
|
228
247
|
if self.class.abstract_railtie?
|
229
248
|
raise "#{self.class.name} is abstract, you cannot instantiate it directly."
|
230
249
|
end
|
231
250
|
end
|
232
251
|
|
233
|
-
def
|
252
|
+
def inspect # :nodoc:
|
253
|
+
"#<#{self.class.name}>"
|
254
|
+
end
|
255
|
+
|
256
|
+
def configure(&block) # :nodoc:
|
234
257
|
instance_eval(&block)
|
235
258
|
end
|
236
259
|
|
@@ -241,29 +264,29 @@ module Rails
|
|
241
264
|
@config ||= Railtie::Configuration.new
|
242
265
|
end
|
243
266
|
|
244
|
-
def railtie_namespace
|
267
|
+
def railtie_namespace # :nodoc:
|
245
268
|
@railtie_namespace ||= self.class.module_parents.detect { |n| n.respond_to?(:railtie_namespace) }
|
246
269
|
end
|
247
270
|
|
248
271
|
protected
|
249
|
-
def run_console_blocks(app)
|
272
|
+
def run_console_blocks(app) # :nodoc:
|
250
273
|
each_registered_block(:console) { |block| block.call(app) }
|
251
274
|
end
|
252
275
|
|
253
|
-
def run_generators_blocks(app)
|
276
|
+
def run_generators_blocks(app) # :nodoc:
|
254
277
|
each_registered_block(:generators) { |block| block.call(app) }
|
255
278
|
end
|
256
279
|
|
257
|
-
def run_runner_blocks(app)
|
280
|
+
def run_runner_blocks(app) # :nodoc:
|
258
281
|
each_registered_block(:runner) { |block| block.call(app) }
|
259
282
|
end
|
260
283
|
|
261
|
-
def run_tasks_blocks(app)
|
284
|
+
def run_tasks_blocks(app) # :nodoc:
|
262
285
|
extend Rake::DSL
|
263
286
|
each_registered_block(:rake_tasks) { |block| instance_exec(app, &block) }
|
264
287
|
end
|
265
288
|
|
266
|
-
def run_server_blocks(app)
|
289
|
+
def run_server_blocks(app) # :nodoc:
|
267
290
|
each_registered_block(:server) { |block| block.call(app) }
|
268
291
|
end
|
269
292
|
|
@@ -1,15 +1,17 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
|
3
|
+
# :stopdoc:
|
4
|
+
|
5
|
+
if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("2.7.0") && RUBY_ENGINE == "ruby"
|
4
6
|
desc = defined?(RUBY_DESCRIPTION) ? RUBY_DESCRIPTION : "ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE})"
|
5
7
|
abort <<-end_message
|
6
8
|
|
7
|
-
Rails
|
9
|
+
Rails 7 requires Ruby 2.7.0 or newer.
|
8
10
|
|
9
11
|
You're running
|
10
12
|
#{desc}
|
11
13
|
|
12
|
-
Please upgrade to Ruby 2.
|
14
|
+
Please upgrade to Ruby 2.7.0 or newer to continue.
|
13
15
|
|
14
16
|
end_message
|
15
17
|
end
|
data/lib/rails/secrets.rb
CHANGED
@@ -1,6 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
3
|
require "yaml"
|
4
|
+
require "tempfile"
|
4
5
|
require "active_support/message_encryptor"
|
5
6
|
|
6
7
|
module Rails
|
@@ -87,17 +88,18 @@ module Rails
|
|
87
88
|
end
|
88
89
|
|
89
90
|
def writing(contents)
|
90
|
-
|
91
|
-
tmp_path = File.join(Dir.tmpdir, tmp_file)
|
92
|
-
IO.binwrite(tmp_path, contents)
|
91
|
+
file_name = "#{File.basename(path)}.#{Process.pid}"
|
93
92
|
|
94
|
-
|
93
|
+
Tempfile.create(["", "-" + file_name]) do |tmp_file|
|
94
|
+
tmp_path = Pathname.new(tmp_file)
|
95
|
+
tmp_path.binwrite contents
|
95
96
|
|
96
|
-
|
97
|
+
yield tmp_path
|
97
98
|
|
98
|
-
|
99
|
-
|
100
|
-
|
99
|
+
updated_contents = tmp_path.binread
|
100
|
+
|
101
|
+
write(updated_contents) if updated_contents != contents
|
102
|
+
end
|
101
103
|
end
|
102
104
|
|
103
105
|
def encryptor
|
@@ -1,7 +1,9 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
+
require "ripper"
|
4
|
+
|
3
5
|
module Rails
|
4
|
-
# Implements the logic behind
|
6
|
+
# Implements the logic behind +Rails::Command::NotesCommand+. See <tt>rails notes --help</tt> for usage information.
|
5
7
|
#
|
6
8
|
# Annotation objects are triplets <tt>:line</tt>, <tt>:tag</tt>, <tt>:text</tt> that
|
7
9
|
# represent the line where the annotation lives, its tag, and its text. Note
|
@@ -11,6 +13,44 @@ module Rails
|
|
11
13
|
# start with the tag optionally followed by a colon. Everything up to the end
|
12
14
|
# of the line (or closing ERB comment tag) is considered to be their text.
|
13
15
|
class SourceAnnotationExtractor
|
16
|
+
# Wraps a regular expression that will be tested against each of the source
|
17
|
+
# file's comments.
|
18
|
+
class ParserExtractor < Struct.new(:pattern)
|
19
|
+
class Parser < Ripper
|
20
|
+
attr_reader :comments, :pattern
|
21
|
+
|
22
|
+
def initialize(source, pattern:)
|
23
|
+
super(source)
|
24
|
+
@pattern = pattern
|
25
|
+
@comments = []
|
26
|
+
end
|
27
|
+
|
28
|
+
def on_comment(value)
|
29
|
+
@comments << Annotation.new(lineno, $1, $2) if value =~ pattern
|
30
|
+
end
|
31
|
+
end
|
32
|
+
|
33
|
+
def annotations(file)
|
34
|
+
contents = File.read(file, encoding: Encoding::BINARY)
|
35
|
+
parser = Parser.new(contents, pattern: pattern).tap(&:parse)
|
36
|
+
parser.error? ? [] : parser.comments
|
37
|
+
end
|
38
|
+
end
|
39
|
+
|
40
|
+
# Wraps a regular expression that will iterate through a file's lines and
|
41
|
+
# test each one for the given pattern.
|
42
|
+
class PatternExtractor < Struct.new(:pattern)
|
43
|
+
def annotations(file)
|
44
|
+
lineno = 0
|
45
|
+
|
46
|
+
File.readlines(file, encoding: Encoding::BINARY).inject([]) do |list, line|
|
47
|
+
lineno += 1
|
48
|
+
next list unless line =~ pattern
|
49
|
+
list << Annotation.new(lineno, $1, $2)
|
50
|
+
end
|
51
|
+
end
|
52
|
+
end
|
53
|
+
|
14
54
|
class Annotation < Struct.new(:line, :tag, :text)
|
15
55
|
def self.directories
|
16
56
|
@@directories ||= %w(app config db lib test)
|
@@ -42,9 +82,21 @@ module Rails
|
|
42
82
|
extensions[/\.(#{exts.join("|")})$/] = block
|
43
83
|
end
|
44
84
|
|
45
|
-
register_extensions("builder", "rb", "rake", "
|
46
|
-
|
47
|
-
|
85
|
+
register_extensions("builder", "rb", "rake", "ruby") do |tag|
|
86
|
+
ParserExtractor.new(/#\s*(#{tag}):?\s*(.*)$/)
|
87
|
+
end
|
88
|
+
|
89
|
+
register_extensions("yml", "yaml") do |tag|
|
90
|
+
PatternExtractor.new(/#\s*(#{tag}):?\s*(.*)$/)
|
91
|
+
end
|
92
|
+
|
93
|
+
register_extensions("css", "js") do |tag|
|
94
|
+
PatternExtractor.new(/\/\/\s*(#{tag}):?\s*(.*)$/)
|
95
|
+
end
|
96
|
+
|
97
|
+
register_extensions("erb") do |tag|
|
98
|
+
PatternExtractor.new(/<%\s*#\s*(#{tag}):?\s*(.*?)\s*%>/)
|
99
|
+
end
|
48
100
|
|
49
101
|
# Returns a representation of the annotation that looks like this:
|
50
102
|
#
|
@@ -70,7 +122,7 @@ module Rails
|
|
70
122
|
#
|
71
123
|
# If +options+ has a <tt>:tag</tt> flag, it will be passed to each annotation's +to_s+.
|
72
124
|
#
|
73
|
-
# See
|
125
|
+
# See SourceAnnotationExtractor#find_in for a list of file extensions that will be taken into account.
|
74
126
|
#
|
75
127
|
# This class method is the single entry point for the <tt>rails notes</tt> command.
|
76
128
|
def self.enumerate(tag = nil, options = {})
|
@@ -111,7 +163,17 @@ module Rails
|
|
111
163
|
|
112
164
|
if extension
|
113
165
|
pattern = extension.last.call(tag)
|
114
|
-
|
166
|
+
|
167
|
+
# In case a user-defined pattern returns nothing for the given set
|
168
|
+
# of tags, we exit early.
|
169
|
+
next unless pattern
|
170
|
+
|
171
|
+
# If a user-defined pattern returns a regular expression, we will
|
172
|
+
# wrap it in a PatternExtractor to keep the same API.
|
173
|
+
pattern = PatternExtractor.new(pattern) if pattern.is_a?(Regexp)
|
174
|
+
|
175
|
+
annotations = pattern.annotations(item)
|
176
|
+
results.update(item => annotations) if annotations.any?
|
115
177
|
end
|
116
178
|
end
|
117
179
|
end
|
@@ -119,19 +181,6 @@ module Rails
|
|
119
181
|
results
|
120
182
|
end
|
121
183
|
|
122
|
-
# If +file+ is the filename of a file that contains annotations this method returns
|
123
|
-
# a hash with a single entry that maps +file+ to an array of its annotations.
|
124
|
-
# Otherwise it returns an empty hash.
|
125
|
-
def extract_annotations_from(file, pattern)
|
126
|
-
lineno = 0
|
127
|
-
result = File.readlines(file, encoding: Encoding::BINARY).inject([]) do |list, line|
|
128
|
-
lineno += 1
|
129
|
-
next list unless line =~ pattern
|
130
|
-
list << Annotation.new(lineno, $1, $2)
|
131
|
-
end
|
132
|
-
result.empty? ? {} : { file => result }
|
133
|
-
end
|
134
|
-
|
135
184
|
# Prints the mapping from filenames to annotations in +results+ ordered by filename.
|
136
185
|
# The +options+ hash is passed to each annotation's +to_s+.
|
137
186
|
def display(results, options = {})
|
data/lib/rails/tasks/engine.rake
CHANGED
@@ -18,7 +18,7 @@ task "load_app" do
|
|
18
18
|
task environment: "app:environment"
|
19
19
|
|
20
20
|
if !defined?(ENGINE_ROOT) || !ENGINE_ROOT
|
21
|
-
ENGINE_ROOT = find_engine_path(APP_RAKEFILE)
|
21
|
+
ENGINE_ROOT = find_engine_path(Pathname.new(APP_RAKEFILE))
|
22
22
|
end
|
23
23
|
end
|
24
24
|
|
@@ -43,17 +43,17 @@ namespace :db do
|
|
43
43
|
app_task "create"
|
44
44
|
app_task "create:all"
|
45
45
|
|
46
|
-
desc "
|
46
|
+
desc "Drop the database for the current Rails.env (use db:drop:all to drop all databases)"
|
47
47
|
app_task "drop"
|
48
48
|
app_task "drop:all"
|
49
49
|
|
50
50
|
desc "Load fixtures into the current environment's database."
|
51
51
|
app_task "fixtures:load"
|
52
52
|
|
53
|
-
desc "
|
53
|
+
desc "Roll the schema back to the previous version (specify steps w/ STEP=n)."
|
54
54
|
app_task "rollback"
|
55
55
|
|
56
|
-
desc "
|
56
|
+
desc "Create a database schema file (either db/schema.rb or db/structure.sql, depending on `config.active_record.schema_format`)"
|
57
57
|
app_task "schema:dump"
|
58
58
|
|
59
59
|
desc "Load a schema.rb file into the database"
|
@@ -65,7 +65,7 @@ namespace :db do
|
|
65
65
|
desc "Create the database, load the schema, and initialize with the seed data (use db:reset to also drop the database first)"
|
66
66
|
app_task "setup"
|
67
67
|
|
68
|
-
desc "
|
68
|
+
desc "Retrieve the current schema version number"
|
69
69
|
app_task "version"
|
70
70
|
|
71
71
|
# desc 'Load the test schema'
|
@@ -73,12 +73,12 @@ namespace :db do
|
|
73
73
|
end
|
74
74
|
|
75
75
|
def find_engine_path(path)
|
76
|
-
return File.expand_path(Dir.pwd) if path
|
76
|
+
return File.expand_path(Dir.pwd) if path.root?
|
77
77
|
|
78
78
|
if Rails::Engine.find(path)
|
79
|
-
path
|
79
|
+
path.to_s
|
80
80
|
else
|
81
|
-
find_engine_path(
|
81
|
+
find_engine_path(path.join(".."))
|
82
82
|
end
|
83
83
|
end
|
84
84
|
|
@@ -4,15 +4,13 @@ namespace :app do
|
|
4
4
|
desc "Update configs and some other initially generated files (or use just update:configs or update:bin)"
|
5
5
|
task update: [ "update:configs", "update:bin", "update:active_storage", "update:upgrade_guide_info" ]
|
6
6
|
|
7
|
-
desc "
|
7
|
+
desc "Apply the template supplied by LOCATION=(/path/to/template) or URL"
|
8
8
|
task template: :environment do
|
9
9
|
template = ENV["LOCATION"]
|
10
10
|
raise "No LOCATION value given. Please set LOCATION either as path to a file or a URL" if template.blank?
|
11
|
-
template = File.expand_path(template) unless %r{\A[A-Za-z][A-Za-z0-9+\-\.]*://}.match?(template)
|
12
11
|
require "rails/generators"
|
13
12
|
require "rails/generators/rails/app/app_generator"
|
14
|
-
|
15
|
-
generator.apply template, verbose: false
|
13
|
+
Rails::Generators::AppGenerator.apply_rails_template(template, Rails.root)
|
16
14
|
end
|
17
15
|
|
18
16
|
namespace :templates do
|
@@ -22,7 +20,7 @@ namespace :app do
|
|
22
20
|
project_templates = "#{Rails.root}/lib/templates"
|
23
21
|
|
24
22
|
default_templates = { "erb" => %w{controller mailer scaffold},
|
25
|
-
"rails" => %w{controller helper scaffold_controller
|
23
|
+
"rails" => %w{controller helper scaffold_controller} }
|
26
24
|
|
27
25
|
default_templates.each do |type, names|
|
28
26
|
local_template_type_dir = File.join(project_templates, type)
|
@@ -46,7 +44,7 @@ namespace :app do
|
|
46
44
|
Rails::AppUpdater.invoke_from_app_generator :update_config_files
|
47
45
|
end
|
48
46
|
|
49
|
-
# desc "
|
47
|
+
# desc "Add new executables to the application bin/ directory"
|
50
48
|
task :bin do
|
51
49
|
Rails::AppUpdater.invoke_from_app_generator :update_bin_files
|
52
50
|
end
|
@@ -59,10 +57,4 @@ namespace :app do
|
|
59
57
|
Rails::AppUpdater.invoke_from_app_generator :display_upgrade_guide_info
|
60
58
|
end
|
61
59
|
end
|
62
|
-
|
63
|
-
namespace :binstub do
|
64
|
-
task :yarn do
|
65
|
-
Rails::AppUpdater.invoke_from_app_generator :update_bin_yarn
|
66
|
-
end
|
67
|
-
end
|
68
60
|
end
|
data/lib/rails/tasks/log.rake
CHANGED
@@ -7,7 +7,7 @@ namespace :log do
|
|
7
7
|
# - defaults to all environments log files i.e. 'development,test,production'
|
8
8
|
# - ENV['LOGS']=all truncates all files i.e. log/*.log
|
9
9
|
# - ENV['LOGS']='test,development' truncates only specified files
|
10
|
-
desc "
|
10
|
+
desc "Truncate all/specified *.log files in log/ to zero bytes (specify which logs with LOGS=test,development)"
|
11
11
|
task :clear do
|
12
12
|
log_files.each do |file|
|
13
13
|
clear_log_file(file)
|
data/lib/rails/tasks/misc.rake
CHANGED
@@ -1,16 +1,5 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
-
desc "Generate a cryptographically secure secret key (this is typically used to generate a secret for cookie sessions)."
|
4
|
-
task :secret do
|
5
|
-
require "securerandom"
|
6
|
-
puts SecureRandom.hex(64)
|
7
|
-
end
|
8
|
-
|
9
|
-
desc "List versions of all Rails frameworks and the environment"
|
10
|
-
task about: :environment do
|
11
|
-
puts Rails::Info
|
12
|
-
end
|
13
|
-
|
14
3
|
namespace :time do
|
15
4
|
desc "List all time zones, list by two-letter country code (`bin/rails time:zones[US]`), or list by UTC offset (`bin/rails time:zones[-8]`)"
|
16
5
|
task :zones, :country_or_offset do |t, args|
|
@@ -28,17 +17,17 @@ namespace :time do
|
|
28
17
|
end
|
29
18
|
|
30
19
|
namespace :zones do
|
31
|
-
# desc '
|
20
|
+
# desc 'Display all time zones, also available: time:zones:us, time:zones:local -- filter with OFFSET parameter, e.g., OFFSET=-6'
|
32
21
|
task :all do
|
33
22
|
build_time_zone_list ActiveSupport::TimeZone.all
|
34
23
|
end
|
35
24
|
|
36
|
-
# desc '
|
25
|
+
# desc 'Display names of US time zones recognized by the Rails TimeZone class, grouped by offset. Results can be filtered with optional OFFSET parameter, e.g., OFFSET=-6'
|
37
26
|
task :us do
|
38
27
|
build_time_zone_list ActiveSupport::TimeZone.us_zones
|
39
28
|
end
|
40
29
|
|
41
|
-
# desc '
|
30
|
+
# desc 'Display names of time zones recognized by the Rails TimeZone class with the same offset as the system local time'
|
42
31
|
task :local do
|
43
32
|
require "active_support"
|
44
33
|
require "active_support/time"
|
@@ -11,25 +11,28 @@ STATS_DIRECTORIES ||= [
|
|
11
11
|
%w(Mailers app/mailers),
|
12
12
|
%w(Mailboxes app/mailboxes),
|
13
13
|
%w(Channels app/channels),
|
14
|
+
%w(Views app/views),
|
14
15
|
%w(JavaScripts app/assets/javascripts),
|
16
|
+
%w(Stylesheets app/assets/stylesheets),
|
15
17
|
%w(JavaScript app/javascript),
|
16
18
|
%w(Libraries lib/),
|
17
19
|
%w(APIs app/apis),
|
18
20
|
%w(Controller\ tests test/controllers),
|
19
21
|
%w(Helper\ tests test/helpers),
|
22
|
+
%w(Job\ tests test/jobs),
|
20
23
|
%w(Model\ tests test/models),
|
21
24
|
%w(Mailer\ tests test/mailers),
|
22
25
|
%w(Mailbox\ tests test/mailboxes),
|
23
26
|
%w(Channel\ tests test/channels),
|
24
|
-
%w(Job\ tests test/jobs),
|
25
27
|
%w(Integration\ tests test/integration),
|
26
28
|
%w(System\ tests test/system),
|
27
|
-
]
|
28
|
-
[ name, "#{File.dirname(Rake.application.rakefile_location)}/#{dir}" ]
|
29
|
-
end.select { |name, dir| File.directory?(dir) }
|
29
|
+
]
|
30
30
|
|
31
31
|
desc "Report code statistics (KLOCs, etc) from the application or engine"
|
32
32
|
task :stats do
|
33
33
|
require "rails/code_statistics"
|
34
|
-
|
34
|
+
stat_directories = STATS_DIRECTORIES.collect do |name, dir|
|
35
|
+
[ name, "#{File.dirname(Rake.application.rakefile_location)}/#{dir}" ]
|
36
|
+
end.select { |name, dir| File.directory?(dir) }
|
37
|
+
CodeStatistics.new(*stat_directories).to_s
|
35
38
|
end
|