railties 3.0.0.beta

data/lib/generators/erb.rb

@@ -0,0 +1,8 @@
+require 'rails/generators/named_base'
+
+module Erb
+  module Generators
+    class Base < Rails::Generators::NamedBase #:nodoc:
+    end
+  end
+end

data/lib/generators/erb/controller/controller_generator.rb

@@ -0,0 +1,21 @@
+require 'generators/erb'
+
+module Erb
+  module Generators
+    class ControllerGenerator < Base
+      argument :actions, :type => :array, :default => [], :banner => "action action"
+
+      def create_view_files
+        base_path = File.join("app/views", class_path, file_name)
+        empty_directory base_path
+
+        actions.each do |action|
+          @action = action
+          @path   = File.join(base_path, "#{action}.html.erb")
+
+          template 'view.html.erb', @path
+        end
+      end
+    end
+  end
+end

data/lib/generators/erb/controller/templates/view.html.erb

@@ -0,0 +1,2 @@
+<h1><%= class_name %>#<%= @action %></h1>
+<p>Find me in <%= @path %></p>

data/lib/generators/erb/mailer/mailer_generator.rb

@@ -0,0 +1,20 @@
+require 'generators/erb'
+
+module Erb
+  module Generators
+    class MailerGenerator < Base
+      argument :actions, :type => :array, :default => [], :banner => "method method"
+
+      def create_view_folder
+        empty_directory File.join("app/views", file_path)
+      end
+
+      def create_view_files
+        actions.each do |action|
+          @action, @path = action, File.join(file_path, action)
+          template "view.text.erb", File.join("app/views", "#{@path}.text.erb")
+        end
+      end
+    end
+  end
+end

data/lib/generators/erb/mailer/templates/view.text.erb

@@ -0,0 +1,3 @@
+<%= class_name %>#<%= @action %>
+
+<%%= @greeting %>, find me in app/views/<%= @path %>

data/lib/generators/erb/scaffold/scaffold_generator.rb

@@ -0,0 +1,53 @@
+require 'generators/erb'
+require 'rails/generators/resource_helpers'
+
+module Erb
+  module Generators
+    class ScaffoldGenerator < Base
+      include Rails::Generators::ResourceHelpers
+
+      argument :attributes, :type => :array, :default => [], :banner => "field:type field:type"
+
+      class_option :layout,    :type => :boolean
+      class_option :singleton, :type => :boolean, :desc => "Supply to skip index view"
+
+      def create_root_folder
+        empty_directory File.join("app/views", controller_file_path)
+      end
+
+      def copy_index_file
+        return if options[:singleton]
+        copy_view :index
+      end
+
+      def copy_edit_file
+        copy_view :edit
+      end
+
+      def copy_show_file
+        copy_view :show
+      end
+
+      def copy_new_file
+        copy_view :new
+      end
+
+      def copy_form_file
+        copy_view :_form
+      end
+
+      def copy_layout_file
+        return unless options[:layout]
+        template "layout.html.erb",
+                 File.join("app/views/layouts", controller_class_path, "#{controller_file_name}.html.erb")
+      end
+
+      protected
+
+        def copy_view(view)
+          template "#{view}.html.erb", File.join("app/views", controller_file_path, "#{view}.html.erb")
+        end
+
+    end
+  end
+end

data/lib/generators/erb/scaffold/templates/_form.html.erb

@@ -0,0 +1,13 @@
+<%% form_for(@<%= singular_name %>) do |f| %>
+  <%%= f.error_messages %>
+
+<% for attribute in attributes -%>
+  <div class="field">
+    <%%= f.label :<%= attribute.name %> %><br />
+    <%%= f.<%= attribute.field_type %> :<%= attribute.name %> %>
+  </div>
+<% end -%>
+  <div class="actions">
+    <%%= f.submit %>
+  </div>
+<%% end %>

data/lib/generators/erb/scaffold/templates/edit.html.erb

@@ -0,0 +1,6 @@
+<h1>Editing <%= singular_name %></h1>
+
+<%%= render 'form' %>
+
+<%%= link_to 'Show', @<%= singular_name %> %> |
+<%%= link_to 'Back', <%= plural_name %>_path %>

data/lib/generators/erb/scaffold/templates/index.html.erb

@@ -0,0 +1,27 @@
+<h1>Listing <%= plural_name %></h1>
+
+<table>
+  <tr>
+<% for attribute in attributes -%>
+    <th><%= attribute.human_name %></th>
+<% end -%>
+    <th></th>
+    <th></th>
+    <th></th>
+  </tr>
+
+<%% @<%= plural_name %>.each do |<%= singular_name %>| %>
+  <tr>
+<% for attribute in attributes -%>
+    <td><%%= <%= singular_name %>.<%= attribute.name %> %></td>
+<% end -%>
+    <td><%%= link_to 'Show', <%= singular_name %> %></td>
+    <td><%%= link_to 'Edit', edit_<%= singular_name %>_path(<%= singular_name %>) %></td>
+    <td><%%= link_to 'Destroy', <%= singular_name %>, :confirm => 'Are you sure?', :method => :delete %></td>
+  </tr>
+<%% end %>
+</table>
+
+<br />
+
+<%%= link_to 'New <%= singular_name %>', new_<%= singular_name %>_path %>

data/lib/generators/erb/scaffold/templates/layout.html.erb

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title><%= controller_class_name %>: <%%= controller.action_name %></title>
+  <%%= stylesheet_link_tag 'scaffold' %>
+  <%%= javascript_include_tag :defaults %>
+  <%%= csrf_meta_tag %>
+</head>
+<body>
+
+<p class="notice"><%%= notice %></p>
+
+<%%= yield %>
+
+</body>
+</html>

data/lib/generators/erb/scaffold/templates/new.html.erb

@@ -0,0 +1,5 @@
+<h1>New <%= singular_name %></h1>
+
+<%%= render 'form' %>
+
+<%%= link_to 'Back', <%= plural_name %>_path %>

data/lib/generators/erb/scaffold/templates/show.html.erb

@@ -0,0 +1,10 @@
+<% for attribute in attributes -%>
+<p>
+  <b><%= attribute.human_name %>:</b>
+  <%%= @<%= singular_name %>.<%= attribute.name %> %>
+</p>
+
+<% end -%>
+
+<%%= link_to 'Edit', edit_<%= singular_name %>_path(@<%= singular_name %>) %> |
+<%%= link_to 'Back', <%= plural_name %>_path %>

data/lib/generators/rails/app/USAGE

@@ -0,0 +1,9 @@
+Description:
+    The 'rails' command creates a new Rails application with a default
+    directory structure and configuration at the path you specify.
+
+Example:
+    rails ~/Code/Ruby/weblog
+
+    This generates a skeletal Rails installation in ~/Code/Ruby/weblog.
+    See the README in the newly created application to get going.

data/lib/generators/rails/app/app_generator.rb

@@ -0,0 +1,262 @@
+require 'digest/md5'
+require 'active_support/secure_random'
+require 'rails/version' unless defined?(Rails::VERSION)
+
+module Rails::Generators
+  # We need to store the RAILS_DEV_PATH in a constant, otherwise the path
+  # can change in Ruby 1.8.7 when we FileUtils.cd.
+  RAILS_DEV_PATH = File.expand_path("../../../../..", File.dirname(__FILE__))
+
+  class AppGenerator < Base
+    DATABASES = %w( mysql oracle postgresql sqlite3 frontbase ibm_db )
+
+    attr_accessor :rails_template
+    add_shebang_option!
+
+    argument :app_path, :type => :string
+
+    class_option :database, :type => :string, :aliases => "-d", :default => "sqlite3",
+                            :desc => "Preconfigure for selected database (options: #{DATABASES.join('/')})"
+
+    class_option :template, :type => :string, :aliases => "-m",
+                            :desc => "Path to an application template (can be a filesystem path or URL)."
+
+    class_option :dev, :type => :boolean, :default => false,
+                       :desc => "Setup the application with Gemfile pointing to your Rails checkout"
+
+    class_option :edge, :type => :boolean, :default => false,
+                        :desc => "Setup the application with Gemfile pointing to Rails repository"
+
+    class_option :skip_activerecord, :type => :boolean, :aliases => "-O", :default => false,
+                                     :desc => "Skip ActiveRecord files"
+
+    class_option :skip_testunit, :type => :boolean, :aliases => "-T", :default => false,
+                                 :desc => "Skip TestUnit files"
+
+    class_option :skip_prototype, :type => :boolean, :aliases => "-J", :default => false,
+                                  :desc => "Skip Prototype files"
+
+    class_option :skip_git, :type => :boolean, :aliases => "-G", :default => false,
+                            :desc => "Skip Git ignores and keeps"
+
+    # Add bin/rails options
+    class_option :version, :type => :boolean, :aliases => "-v", :group => :rails,
+                           :desc => "Show Rails version number and quit"
+
+    class_option :help, :type => :boolean, :aliases => "-h", :group => :rails,
+                        :desc => "Show this help message and quit"
+
+    def initialize(*args)
+      super
+      if !options[:skip_activerecord] && !DATABASES.include?(options[:database])
+        raise Error, "Invalid value for --database option. Supported for preconfiguration are: #{DATABASES.join(", ")}."
+      end
+    end
+
+    def create_root
+      self.destination_root = File.expand_path(app_path, destination_root)
+      valid_app_const?
+
+      empty_directory '.'
+      set_default_accessors!
+      FileUtils.cd(destination_root)
+    end
+
+    def create_root_files
+      copy_file "README"
+      copy_file "gitignore", ".gitignore" unless options[:skip_git]
+      template "Rakefile"
+      template "config.ru"
+      template "Gemfile"
+    end
+
+    def create_app_files
+      directory "app"
+    end
+
+    def create_config_files
+      empty_directory "config"
+
+      inside "config" do
+        template "routes.rb"
+        template "application.rb"
+        template "environment.rb"
+
+        directory "environments"
+        directory "initializers"
+        directory "locales"
+      end
+    end
+
+    def create_boot_file
+      template "config/boot.rb"
+    end
+
+    def create_activerecord_files
+      return if options[:skip_activerecord]
+      template "config/databases/#{options[:database]}.yml", "config/database.yml"
+    end
+
+    def create_db_files
+      directory "db"
+    end
+
+    def create_doc_files
+      directory "doc"
+    end
+
+    def create_lib_files
+      empty_directory "lib"
+      empty_directory_with_gitkeep "lib/tasks"
+    end
+
+    def create_log_files
+      empty_directory "log"
+
+      inside "log" do
+        %w( server production development test ).each do |file|
+          create_file "#{file}.log"
+          chmod "#{file}.log", 0666, :verbose => false
+        end
+      end
+    end
+
+    def create_public_files
+      directory "public", "public", :recursive => false # Do small steps, so anyone can overwrite it.
+    end
+
+    def create_public_image_files
+      directory "public/images"
+    end
+
+    def create_public_stylesheets_files
+      empty_directory_with_gitkeep "public/stylesheets"
+    end
+
+    def create_prototype_files
+      return if options[:skip_prototype]
+      directory "public/javascripts"
+    end
+
+    def create_script_files
+      directory "script" do |content|
+        "#{shebang}\n" + content
+      end
+      chmod "script", 0755, :verbose => false
+    end
+
+    def create_test_files
+      return if options[:skip_testunit]
+      directory "test"
+    end
+
+    def create_tmp_files
+      empty_directory "tmp"
+
+      inside "tmp" do
+        %w(sessions sockets cache pids).each do |dir|
+          empty_directory(dir)
+        end
+      end
+    end
+
+    def create_vendor_files
+      empty_directory_with_gitkeep "vendor/plugins"
+    end
+
+    def apply_rails_template
+      apply rails_template if rails_template
+    rescue Thor::Error, LoadError, Errno::ENOENT => e
+      raise Error, "The template [#{rails_template}] could not be loaded. Error: #{e}"
+    end
+
+    def bundle_if_dev_or_edge
+      run "bundle install" if dev_or_edge?
+    end
+
+    protected
+
+      def self.banner
+        "rails #{self.arguments.map(&:usage).join(' ')} [options]"
+      end
+
+      def set_default_accessors!
+        self.rails_template = case options[:template]
+          when /^http:\/\//
+            options[:template]
+          when String
+            File.expand_path(options[:template], Dir.pwd)
+          else
+            options[:template]
+        end
+      end
+
+      # Define file as an alias to create_file for backwards compatibility.
+      def file(*args, &block)
+        create_file(*args, &block)
+      end
+
+      def app_name
+        @app_name ||= File.basename(destination_root)
+      end
+
+      def app_const_base
+        @app_const_base ||= app_name.gsub(/\W/, '_').squeeze('_').camelize
+      end
+
+      def app_const
+        @app_const ||= "#{app_const_base}::Application"
+      end
+
+      def valid_app_const?
+        case app_const
+        when /^\d/
+          raise Error, "Invalid application name #{app_name}. Please give a name which does not start with numbers."
+        end
+      end
+
+      def app_secret
+        ActiveSupport::SecureRandom.hex(64)
+      end
+
+      def dev_or_edge?
+        options.dev? || options.edge?
+      end
+
+      def gem_for_database
+        # %w( mysql oracle postgresql sqlite3 frontbase ibm_db )
+        case options[:database]
+        when "oracle"     then "ruby-oci8"
+        when "postgresql" then "pg"
+        when "sqlite3"    then "sqlite3-ruby"
+        when "frontbase"  then "ruby-frontbase"
+        else options[:database]
+        end
+      end
+
+      def require_for_database
+        case options[:database]
+        when "sqlite3" then "sqlite3"
+        end
+      end
+
+      def mysql_socket
+        @mysql_socket ||= [
+          "/tmp/mysql.sock",                        # default
+          "/var/run/mysqld/mysqld.sock",            # debian/gentoo
+          "/var/tmp/mysql.sock",                    # freebsd
+          "/var/lib/mysql/mysql.sock",              # fedora
+          "/opt/local/lib/mysql/mysql.sock",        # fedora
+          "/opt/local/var/run/mysqld/mysqld.sock",  # mac + darwinports + mysql
+          "/opt/local/var/run/mysql4/mysqld.sock",  # mac + darwinports + mysql4
+          "/opt/local/var/run/mysql5/mysqld.sock",  # mac + darwinports + mysql5
+          "/opt/lampp/var/mysql/mysql.sock"         # xampp for linux
+        ].find { |f| File.exist?(f) } unless RUBY_PLATFORM =~ /(:?mswin|mingw)/
+      end
+
+      def empty_directory_with_gitkeep(destination, config = {})
+        empty_directory(destination, config)
+        create_file("#{destination}/.gitkeep") unless options[:skip_git]
+      end
+  end
+end