Class: Rails::Generators::AppGenerator

Inherits:
AppBase
  • Object
show all
Defined in:
lib/rails/generators/rails/app/app_generator.rb,
lib/rails/commands/application/application_command.rb

Overview

:nodoc:

Constant Summary

Constants inherited from AppBase

Rails::Generators::AppBase::DATABASES, Rails::Generators::AppBase::JDBC_DATABASES, Rails::Generators::AppBase::WEBPACKS

Instance Attribute Summary

Attributes inherited from AppBase

#rails_template

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from AppBase

add_shared_options_for, strict_args_position

Methods inherited from Base

base_root, class_option, default_source_root, desc, hide!, hook_for, inherited, namespace, remove_hook_for, source_root

Methods included from Actions

#add_source, #after_bundle, #capify!, #environment, #gem, #gem_group, #generate, #git, #initializer, #lib, #rails_command, #rake, #rakefile, #readme, #route, #vendor

Constructor Details

#initialize(*args) ⇒ AppGenerator

Returns a new instance of AppGenerator.



227
228
229
230
231
232
233
234
235
236
237
238
239
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 227

def initialize(*args)
  super

  if !options[:skip_active_record] && !DATABASES.include?(options[:database])
    raise Error, "Invalid value for --database option. Supported for preconfiguration are: #{DATABASES.join(", ")}."
  end

  # Force sprockets and yarn to be skipped when generating API only apps.
  # Can't modify options hash as it's frozen by default.
  if options[:api]
    self.options = options.merge(skip_sprockets: true, skip_javascript: true, skip_yarn: true).freeze
  end
end

Class Method Details



426
427
428
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 426

def self.banner
  "rails new #{arguments.map(&:usage).join(' ')} [options]"
end

.exit_on_failure? ⇒ Boolean

We want to exit on failure to be kind to other libraries This is only when accessing via CLI

Returns:

  • (Boolean) 


9
10
11
 
# File 'lib/rails/commands/application/application_command.rb', line 9

def self.exit_on_failure?
  true
end

Instance Method Details

#create_active_record_files ⇒ Object 



284
285
286
287
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 284

def create_active_record_files
  return if options[:skip_active_record]
  build(:database_yml)
end

#create_app_files ⇒ Object 



253
254
255
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 253

def create_app_files
  build(:app)
end

#create_bin_files ⇒ Object 



257
258
259
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 257

def create_bin_files
  build(:bin)
end

#create_boot_file ⇒ Object 



280
281
282
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 280

def create_boot_file
  template "config/boot.rb"
end

#create_config_files ⇒ Object 



266
267
268
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 266

def create_config_files
  build(:config)
end

#create_db_files ⇒ Object 



289
290
291
292
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 289

def create_db_files
  return if options[:skip_active_record]
  build(:db)
end

#create_lib_files ⇒ Object 



294
295
296
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 294

def create_lib_files
  build(:lib)
end

#create_log_files ⇒ Object 



298
299
300
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 298

def create_log_files
  build(:log)
end

#create_public_files ⇒ Object 



302
303
304
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 302

def create_public_files
  build(:public_directory)
end

#create_root_files ⇒ Object 



244
245
246
247
248
249
250
251
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 244

def create_root_files
  build(:readme)
  build(:rakefile)
  build(:configru)
  build(:gitignore)   unless options[:skip_git]
  build(:gemfile)     unless options[:skip_gemfile]
  build(:version_control)
end

#create_system_test_files ⇒ Object 



310
311
312
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 310

def create_system_test_files
  build(:system_test) if depends_on_system_test?
end

#create_test_files ⇒ Object 



306
307
308
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 306

def create_test_files
  build(:test) unless options[:skip_test]
end

#create_tmp_files ⇒ Object 



314
315
316
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 314

def create_tmp_files
  build(:tmp)
end

#create_vendor_files ⇒ Object 



318
319
320
321
322
323
324
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 318

def create_vendor_files
  build(:vendor)

  if options[:skip_yarn]
    remove_file "package.json"
  end
end

#delete_action_cable_files_skipping_action_cable ⇒ Object 



385
386
387
388
389
390
391
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 385

def delete_action_cable_files_skipping_action_cable
  if options[:skip_action_cable]
    remove_file "config/cable.yml"
    remove_file "app/assets/javascripts/cable.js"
    remove_dir "app/channels"
  end
end

#delete_action_mailer_files_skipping_action_mailer ⇒ Object 



376
377
378
379
380
381
382
383
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 376

def delete_action_mailer_files_skipping_action_mailer
  if options[:skip_action_mailer]
    remove_file "app/views/layouts/mailer.html.erb"
    remove_file "app/views/layouts/mailer.text.erb"
    remove_dir "app/mailers"
    remove_dir "test/mailers"
  end
end

#delete_api_initializers ⇒ Object 



399
400
401
402
403
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 399

def delete_api_initializers
  unless options[:api]
    remove_file "config/initializers/cors.rb"
  end
end

#delete_app_assets_if_api_option ⇒ Object 



326
327
328
329
330
331
332
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 326

def delete_app_assets_if_api_option
  if options[:api]
    remove_dir "app/assets"
    remove_dir "lib/assets"
    remove_dir "tmp/cache/assets"
  end
end

#delete_app_helpers_if_api_option ⇒ Object 



334
335
336
337
338
339
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 334

def delete_app_helpers_if_api_option
  if options[:api]
    remove_dir "app/helpers"
    remove_dir "test/helpers"
  end
end

#delete_application_layout_file_if_api_option ⇒ Object 



341
342
343
344
345
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 341

def delete_application_layout_file_if_api_option
  if options[:api]
    remove_file "app/views/layouts/application.html.erb"
  end
end

#delete_application_record_skipping_active_record ⇒ Object 



370
371
372
373
374
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 370

def delete_application_record_skipping_active_record
  if options[:skip_active_record]
    remove_file "app/models/application_record.rb"
  end
end

#delete_assets_initializer_skipping_sprockets ⇒ Object 



364
365
366
367
368
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 364

def delete_assets_initializer_skipping_sprockets
  if options[:skip_sprockets]
    remove_file "config/initializers/assets.rb"
  end
end

#delete_bin_yarn_if_skip_yarn_option ⇒ Object 



411
412
413
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 411

def delete_bin_yarn_if_skip_yarn_option
  remove_file "bin/yarn" if options[:skip_yarn]
end

#delete_js_folder_skipping_javascript ⇒ Object 



358
359
360
361
362
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 358

def delete_js_folder_skipping_javascript
  if options[:skip_javascript]
    remove_dir "app/assets/javascripts"
  end
end

#delete_new_framework_defaults ⇒ Object 



405
406
407
408
409
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 405

def delete_new_framework_defaults
  unless options[:update]
    remove_file "config/initializers/new_framework_defaults_5_1.rb"
  end
end

#delete_non_api_initializers_if_api_option ⇒ Object 



393
394
395
396
397
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 393

def delete_non_api_initializers_if_api_option
  if options[:api]
    remove_file "config/initializers/cookies_serializer.rb"
  end
end

#delete_public_files_if_api_option ⇒ Object 



347
348
349
350
351
352
353
354
355
356
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 347

def delete_public_files_if_api_option
  if options[:api]
    remove_file "public/404.html"
    remove_file "public/422.html"
    remove_file "public/500.html"
    remove_file "public/apple-touch-icon-precomposed.png"
    remove_file "public/apple-touch-icon.png"
    remove_file "public/favicon.ico"
  end
end

#display_upgrade_guide_info ⇒ Object 



275
276
277
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 275

def display_upgrade_guide_info
  say "\nAfter this, check Rails upgrade guide at http://guides.rubyonrails.org/upgrading_ruby_on_rails.html for more details about upgrading your app."
end

#finish_template ⇒ Object 



415
416
417
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 415

def finish_template
  build(:leftovers)
end

#run_after_bundle_callbacks ⇒ Object 



422
423
424
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 422

def run_after_bundle_callbacks
  @after_bundle_callbacks.each(&:call)
end

#update_bin_files ⇒ Object 



261
262
263
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 261

def update_bin_files
  build(:bin_when_updating)
end

#update_config_files ⇒ Object 



270
271
272
 
# File 'lib/rails/generators/rails/app/app_generator.rb', line 270

def update_config_files
  build(:config_when_updating)
end