aboutsummaryrefslogblamecommitdiffstats
path: root/railties/lib/rails/generators/app_base.rb
blob: 815894144a03862c7d49a01705448e3d6a11163e (plain) (tree)
1
2
3
4
5
6
7
8
9
10
                    
                                              
                                                       

                  
                          
                                                       


                   
                                  
                                                                                  
                                                                      
                                      
 
                                   
                                 

                         
                                       
 



                                   
                                           
                                                                       
                                                                                                                 
 


                                                                                                                 

                                                                         
 
                                                                                        
                                                                          
 

                                                                                        
 

                                                                                 
 

                                                                                        
 


                                                                                        

                                                                                        
 


                                                                                            

                                                                                                                      
 

                                                                                              
 

                                                                                        
 

                                                                                                                
 

                                                                                                             
 


                                                                                        


                                                                                                                       


                                                                                                                

                                                                                       

         
                           


                                              
             
                                         



             





                                       









                                                               
                         
                              



                                   
                             
                                           
                               
                                                        


                              
                                                   

                                                 

         



                                                       

                          










                                                              




                                                               
 





                                                                  


                                                                                                    











                                                           



                                                 














                                                     
                              

                                             

                                                              


                                                                                        






















                                                                                          

                                
                                                                            











                                                                  

           
 
                                
                                                 

                                                                                         

         
                               
                                                                                                                              


                           
                                  

         

                                                                                          
               

           
                                                    
                                                 

           
                                                      
                                     


                                                
                                             

           




                                             

                             

                                                                         
                           

                                                       
            


                                                                                             



                          
                                                                                                               
                               




                                                                   



                                                                        


                               
 










                                                                            
                              
                                             
 
                 
                                        
                                                                                 
                                                                          
                                                                       
                                                               
            
                                                    
                                                
                                                                

           
                                                

                                                                                      
 
            

         







                                                     

                                                                                           
                                                           

         

                                                                               
                                                                  

         
                              
                                                                    
                                        
                                                                           
            
                                                                  


           
                                  



                                                                         
                                                                            

                                                                                         
                                                         
                                                                                                                              
              
           

         
                                          
                                                                                                
                                  
                                                           
            
                                                                                   


           

                                        
                                                                                                                                                  


                                                                     
                                 
                                            
 
                                                                                  







                                                                                   

                                                                                  
                                                                          

                                                           
                         
                                 

                                                                  
           

         







                                                                               
                    






                                                     

         
                                                                  
                                            
                              
         
 

                                                                       
         

       
   
require 'digest/md5'
require 'active_support/core_ext/string/strip'
require 'rails/version' unless defined?(Rails::VERSION)
require 'open-uri'
require 'uri'
require 'rails/generators'
require 'active_support/core_ext/array/extract_options'

module Rails
  module Generators
    class AppBase < Base # :nodoc:
      DATABASES = %w( mysql oracle postgresql sqlite3 frontbase ibm_db sqlserver )
      JDBC_DATABASES = %w( jdbcmysql jdbcsqlite3 jdbcpostgresql jdbc )
      DATABASES.concat(JDBC_DATABASES)

      attr_accessor :rails_template
      attr_accessor :app_template
      add_shebang_option!

      argument :app_path, type: :string

      def self.strict_args_position
        false
      end

      def self.add_shared_options_for(name)
        class_option :template,           type: :string, aliases: '-m',
                                          desc: "Path to some #{name} template (can be a filesystem path or URL)"

        class_option :app_template,       type: :string, aliases: '-n',
                                          desc: "Path to some #{name} template (can be a filesystem path or URL)"

        class_option :skip_gemfile,       type: :boolean, default: false,
                                          desc: "Don't create a Gemfile"

        class_option :skip_bundle,        type: :boolean, aliases: '-B', default: false,
                                          desc: "Don't run bundle install"

        class_option :skip_git,           type: :boolean, aliases: '-G', default: false,
                                          desc: 'Skip .gitignore file'

        class_option :skip_keeps,         type: :boolean, default: false,
                                          desc: 'Skip source control .keep files'

        class_option :skip_active_record, type: :boolean, aliases: '-O', default: false,
                                          desc: 'Skip Active Record files'

        class_option :skip_action_view,   type: :boolean, aliases: '-V', default: false,
                                          desc: 'Skip Action View files'

        class_option :skip_sprockets,     type: :boolean, aliases: '-S', default: false,
                                          desc: 'Skip Sprockets files'

        class_option :skip_spring,        type: :boolean, default: false,
                                          desc: "Don't install Spring application preloader"

        class_option :database,           type: :string, aliases: '-d', default: 'sqlite3',
                                          desc: "Preconfigure for selected database (options: #{DATABASES.join('/')})"

        class_option :javascript,         type: :string, aliases: '-j', default: 'jquery',
                                          desc: 'Preconfigure for selected JavaScript library'

        class_option :skip_javascript,    type: :boolean, aliases: '-J', default: false,
                                          desc: 'Skip JavaScript files'

        class_option :dev,                type: :boolean, default: false,
                                          desc: "Setup the #{name} with Gemfile pointing to your Rails checkout"

        class_option :edge,               type: :boolean, default: false,
                                          desc: "Setup the #{name} with Gemfile pointing to Rails repository"

        class_option :skip_test_unit,     type: :boolean, aliases: '-T', default: false,
                                          desc: 'Skip Test::Unit files'

        class_option :rc,                 type: :string, default: false,
                                          desc: "Path to file containing extra configuration options for rails command"

        class_option :no_rc,              type: :boolean, default: false,
                                          desc: 'Skip loading of extra configuration options from .railsrc file'

        class_option :help,               type: :boolean, aliases: '-h', group: :rails,
                                          desc: 'Show this help message and quit'
      end

      def initialize(*args)
        @original_wd   = Dir.pwd
        @gem_filter    = lambda { |gem| true }
        @extra_entries = []
        super
        convert_database_option_for_jruby
      end

    protected

      def gemfile_entry(name, *args)
        options = args.extract_options!
        version = args.first
        github = options[:github]
        path   = options[:path]

        if github
          @extra_entries << GemfileEntry.github(name, github)
        elsif path
          @extra_entries << GemfileEntry.path(name, path)
        else
          @extra_entries << GemfileEntry.version(name, version)
        end
        self
      end

      def gemfile_entries
        [ rails_gemfile_entry,
          database_gemfile_entry,
          assets_gemfile_entry,
          javascript_gemfile_entry,
          jbuilder_gemfile_entry,
          sdoc_gemfile_entry,
          platform_dependent_gemfile_entry,
          spring_gemfile_entry,
          @extra_entries].flatten.find_all(&@gem_filter)
      end

      def add_gem_entry_filter
        @gem_filter = lambda { |next_filter, entry|
          yield(entry) && next_filter.call(entry)
        }.curry[@gem_filter]
      end

      def remove_gem(name)
        add_gem_entry_filter { |gem| gem.name != name }
      end

      def builder
        @builder ||= begin
          builder_class = get_builder_class
          builder_class.send(:include, ActionMethods)
          builder_class.new(self)
        end
      end

      def build(meth, *args)
        builder.send(meth, *args) if builder.respond_to?(meth)
      end

      def create_root
        valid_const?

        empty_directory '.'
        FileUtils.cd(destination_root) unless options[:pretend]
      end

      class TemplateRecorder < ::BasicObject # :nodoc:
        attr_reader :gems

        def initialize(target)
          @target         = target
          # unfortunately, instance eval has access to these ivars
          @app_const      = target.send :app_const if target.respond_to?(:app_const, true)
          @app_const_base = target.send :app_const_base if target.respond_to?(:app_const_base, true)
          @app_name       = target.send :app_name if target.respond_to?(:app_name, true)
          @commands       = []
          @gems           = []
        end

        def gemfile_entry(*args)
          @target.send :gemfile_entry, *args
        end

        def add_gem_entry_filter(*args, &block)
          @target.send :add_gem_entry_filter, *args, &block
        end

        def remove_gem(*args, &block)
          @target.send :remove_gem, *args, &block
        end

        def method_missing(name, *args, &block)
          @commands << [name, args, block]
        end

        def respond_to_missing?(method, priv = false)
          super || @target.respond_to?(method, priv)
        end

        def replay!
          @commands.each do |name, args, block|
            @target.send name, *args, &block
          end
        end
      end

      def apply_rails_template
        @recorder = TemplateRecorder.new self

        apply(rails_template, target: self) if rails_template
        apply(app_template, target: @recorder) if app_template
      rescue Thor::Error, LoadError, Errno::ENOENT => e
        raise Error, "The template [#{rails_template}] could not be loaded. Error: #{e}"
      end

      def replay_template
        @recorder.replay! if @recorder
      end

      def apply(path, config={})
        verbose = config.fetch(:verbose, true)
        target  = config.fetch(:target, self)
        is_uri  = path =~ /^https?\:\/\//
        path    = find_in_source_paths(path) unless is_uri

        say_status :apply, path, verbose
        shell.padding += 1 if verbose

        if is_uri
          contents = open(path, "Accept" => "application/x-thor-template") {|io| io.read }
        else
          contents = open(path) {|io| io.read }
        end

        target.instance_eval(contents, path)
        shell.padding -= 1 if verbose
      end

      def set_default_accessors!
        self.destination_root = File.expand_path(app_path, destination_root)
        self.rails_template = expand_template options[:template]
        self.app_template = expand_template options[:app_template]
      end

      def expand_template(name)
        case name
        when /^https?:\/\//
          name
        when String
          File.expand_path(name, Dir.pwd)
        else
          name
        end
      end

      def database_gemfile_entry
        return [] if options[:skip_active_record]
        GemfileEntry.version gem_for_database, nil,
                            "Use #{options[:database]} as the database for Active Record"
      end

      def include_all_railties?
        !options[:skip_active_record] && !options[:skip_action_view] && !options[:skip_test_unit] && !options[:skip_sprockets]
      end

      def comment_if(value)
        options[value] ? '# ' : ''
      end

      class GemfileEntry < Struct.new(:name, :version, :comment, :options, :commented_out)
        def initialize(name, version, comment, options = {}, commented_out = false)
          super
        end

        def self.github(name, github, comment = nil)
          new(name, nil, comment, github: github)
        end

        def self.version(name, version, comment = nil)
          new(name, version, comment)
        end

        def self.path(name, path, comment = nil)
          new(name, nil, comment, path: path)
        end

        def padding(max_width)
          ' ' * (max_width - name.length + 2)
        end
      end

      def rails_gemfile_entry
        if options.dev?
          [GemfileEntry.path('rails', Rails::Generators::RAILS_DEV_PATH),
           GemfileEntry.github('arel', 'rails/arel')]
        elsif options.edge?
          [GemfileEntry.github('rails', 'rails/rails'),
           GemfileEntry.github('arel', 'rails/arel')]
        else
          [GemfileEntry.version('rails',
                            Rails::VERSION::STRING,
                            "Bundle edge Rails instead: gem 'rails', github: 'rails/rails'")]
        end
      end

      def gem_for_database
        # %w( mysql oracle postgresql sqlite3 frontbase ibm_db sqlserver jdbcmysql jdbcsqlite3 jdbcpostgresql )
        case options[:database]
        when "oracle"         then "ruby-oci8"
        when "postgresql"     then "pg"
        when "frontbase"      then "ruby-frontbase"
        when "mysql"          then "mysql2"
        when "sqlserver"      then "activerecord-sqlserver-adapter"
        when "jdbcmysql"      then "activerecord-jdbcmysql-adapter"
        when "jdbcsqlite3"    then "activerecord-jdbcsqlite3-adapter"
        when "jdbcpostgresql" then "activerecord-jdbcpostgresql-adapter"
        when "jdbc"           then "activerecord-jdbc-adapter"
        else options[:database]
        end
      end

      def convert_database_option_for_jruby
        if defined?(JRUBY_VERSION)
          case options[:database]
          when "oracle"     then options[:database].replace "jdbc"
          when "postgresql" then options[:database].replace "jdbcpostgresql"
          when "mysql"      then options[:database].replace "jdbcmysql"
          when "sqlite3"    then options[:database].replace "jdbcsqlite3"
          end
        end
      end

      def assets_gemfile_entry
        return [] if options[:skip_sprockets]

        gems = []
        if options.dev? || options.edge?
          gems << GemfileEntry.github('sprockets-rails', 'rails/sprockets-rails',
                                    'Use edge version of sprockets-rails')
          gems << GemfileEntry.github('sass-rails', 'rails/sass-rails',
                                    'Use SCSS for stylesheets')
        else
          gems << GemfileEntry.version('sass-rails',
                                     '~> 4.0.1',
                                     'Use SCSS for stylesheets')
        end

        gems << GemfileEntry.version('uglifier',
                                   '>= 1.3.0',
                                   'Use Uglifier as compressor for JavaScript assets')

        gems
      end

      def platform_dependent_gemfile_entry
        gems = []
        if RUBY_ENGINE == 'rbx'
          gems << GemfileEntry.version('rubysl', nil)
        end
        gems
      end

      def jbuilder_gemfile_entry
        comment = 'Build JSON APIs with ease. Read more: https://github.com/rails/jbuilder'
        GemfileEntry.version('jbuilder', '~> 2.0', comment)
      end

      def sdoc_gemfile_entry
        comment = 'bundle exec rake doc:rails generates the API under doc/api.'
        GemfileEntry.new('sdoc', '~> 0.4.0', comment, group: :doc)
      end

      def coffee_gemfile_entry
        comment = 'Use CoffeeScript for .js.coffee assets and views'
        if options.dev? || options.edge?
          GemfileEntry.github 'coffee-rails', 'rails/coffee-rails', comment
        else
          GemfileEntry.version 'coffee-rails', '~> 4.0.0', comment
        end
      end

      def javascript_gemfile_entry
        if options[:skip_javascript]
          []
        else
          gems = [coffee_gemfile_entry, javascript_runtime_gemfile_entry]
          gems << GemfileEntry.version("#{options[:javascript]}-rails", nil,
                                 "Use #{options[:javascript]} as the JavaScript library")

          gems << GemfileEntry.version("turbolinks", nil,
            "Turbolinks makes following links in your web application faster. Read more: https://github.com/rails/turbolinks")
          gems
        end
      end

      def javascript_runtime_gemfile_entry
        comment = 'See https://github.com/sstephenson/execjs#readme for more supported runtimes'
        if defined?(JRUBY_VERSION)
          GemfileEntry.version 'therubyrhino', nil, comment
        else
          GemfileEntry.new 'therubyracer', nil, comment, { platforms: :ruby }, true
        end
      end

      def spring_gemfile_entry
        return [] unless spring_install?
        comment = 'Spring speeds up development by keeping your application running in the background. Read more: https://github.com/rails/spring'
        GemfileEntry.new('spring', nil, comment, group: :development)
      end

      def bundle_command(command)
        say_status :run, "bundle #{command}"

        # We are going to shell out rather than invoking Bundler::CLI.new(command)
        # because `rails new` loads the Thor gem and on the other hand bundler uses
        # its own vendored Thor, which could be a different version. Running both
        # things in the same process is a recipe for a night with paracetamol.
        #
        # We use backticks and #print here instead of vanilla #system because it
        # is easier to silence stdout in the existing test suite this way. The
        # end-user gets the bundler commands called anyway, so no big deal.
        #
        # We unset temporary bundler variables to load proper bundler and Gemfile.
        #
        # Thanks to James Tucker for the Gem tricks involved in this call.
        _bundle_command = Gem.bin_path('bundler', 'bundle')

        require 'bundler'
        Bundler.with_clean_env do
          output = `"#{Gem.ruby}" "#{_bundle_command}" #{command}`
          print output unless options[:quiet]
        end
      end

      def bundle_install?
        !(options[:skip_gemfile] || options[:skip_bundle] || options[:pretend])
      end

      def spring_install?
        !options[:skip_spring] && Process.respond_to?(:fork)
      end

      def run_bundle
        bundle_command('install') if bundle_install?
      end

      def generate_spring_binstubs
        if bundle_install? && spring_install?
          bundle_command("exec spring binstub --all")
        end
      end

      def empty_directory_with_keep_file(destination, config = {})
        empty_directory(destination, config)
        keep_file(destination)
      end

      def keep_file(destination)
        create_file("#{destination}/.keep") unless options[:skip_keeps]
      end
    end
  end
end