railties 3.0.0.beta

data/lib/generators/rails/app/templates/public/javascripts/rails.js

@@ -0,0 +1,110 @@
+document.observe("dom:loaded", function() {
+  var authToken = $$('meta[name=csrf-token]').first().readAttribute('content'),
+    authParam = $$('meta[name=csrf-param]').first().readAttribute('content'),
+    formTemplate = '<form method="#{method}" action="#{action}">\
+      #{realmethod}<input name="#{param}" value="#{token}" type="hidden">\
+      </form>',
+    realmethodTemplate = '<input name="_method" value="#{method}" type="hidden">';
+
+  function handleRemote(element) {
+    var method, url, params;
+
+    if (element.tagName.toLowerCase() == 'form') {
+      method = element.readAttribute('method') || 'post';
+      url    = element.readAttribute('action');
+      params = element.serialize(true);
+    } else {
+      method = element.readAttribute('data-method') || 'get';
+      // TODO: data-url support is going away, just use href
+      url    = element.readAttribute('data-url') || element.readAttribute('href');
+      params = {};
+    }
+
+    var event = element.fire("ajax:before");
+    if (event.stopped) return false;
+
+    new Ajax.Request(url, {
+      method: method,
+      parameters: params,
+      asynchronous: true,
+      evalScripts: true,
+
+      onLoading:     function(request) { element.fire("ajax:loading", {request: request}); },
+      onLoaded:      function(request) { element.fire("ajax:loaded", {request: request}); },
+      onInteractive: function(request) { element.fire("ajax:interactive", {request: request}); },
+      onComplete:    function(request) { element.fire("ajax:complete", {request: request}); },
+      onSuccess:     function(request) { element.fire("ajax:success", {request: request}); },
+      onFailure:     function(request) { element.fire("ajax:failure", {request: request}); }
+    });
+
+    element.fire("ajax:after");
+  }
+
+  $(document.body).observe("click", function(event) {
+    var message = event.element().readAttribute('data-confirm');
+    if (message && !confirm(message)) {
+      event.stop();
+      return false;
+    }
+
+    var element = event.findElement("a[data-remote=true]");
+    if (element) {
+      handleRemote(element);
+      event.stop();
+    }
+
+    var element = event.findElement("a[data-method]");
+    if (element && element.readAttribute('data-remote') != 'true') {
+      var method = element.readAttribute('data-method'),
+        piggyback = method.toLowerCase() != 'post',
+        formHTML = formTemplate.interpolate({
+          method: 'POST',
+          realmethod: piggyback ? realmethodTemplate.interpolate({ method: method }) : '',
+          action: element.readAttribute('href'),
+          token: authToken,
+          param: authParam
+        });
+
+      var form = new Element('div').update(formHTML).down().hide();
+      this.insert({ bottom: form });
+
+      form.submit();
+      event.stop();
+    }
+  });
+
+  // TODO: I don't think submit bubbles in IE
+  $(document.body).observe("submit", function(event) {
+    var message = event.element().readAttribute('data-confirm');
+    if (message && !confirm(message)) {
+      event.stop();
+      return false;
+    }
+
+    var inputs = event.element().select("input[type=submit][data-disable-with]");
+    inputs.each(function(input) {
+      input.disabled = true;
+      input.writeAttribute('data-original-value', input.value);
+      input.value = input.readAttribute('data-disable-with');
+    });
+
+    var element = event.findElement("form[data-remote=true]");
+    if (element) {
+      handleRemote(element);
+      event.stop();
+    }
+  });
+
+  $(document.body).observe("ajax:complete", function(event) {
+    var element = event.element();
+
+    if (element.tagName.toLowerCase() == 'form') {
+      var inputs = element.select("input[type=submit][disabled=true][data-disable-with]");
+      inputs.each(function(input) {
+        input.value = input.readAttribute('data-original-value');
+        input.writeAttribute('data-original-value', null);
+        input.disabled = false;
+      });
+    }
+  });
+});

data/lib/generators/rails/app/templates/public/robots.txt

@@ -0,0 +1,5 @@
+# See http://www.robotstxt.org/wc/norobots.html for documentation on how to use the robots.txt file
+#
+# To ban all spiders from the entire site uncomment the next two lines:
+# User-Agent: *
+# Disallow: /

data/lib/generators/rails/app/templates/script/rails

@@ -0,0 +1,9 @@
+# This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
+
+ENV_PATH  = File.expand_path('../../config/environment',  __FILE__)
+BOOT_PATH = File.expand_path('../../config/boot',  __FILE__)
+APP_PATH  = File.expand_path('../../config/application',  __FILE__)
+ROOT_PATH = File.expand_path('../..',  __FILE__)
+
+require BOOT_PATH
+require 'rails/commands'

data/lib/generators/rails/app/templates/test/performance/browsing_test.rb

@@ -0,0 +1,9 @@
+require 'test_helper'
+require 'rails/performance_test_help'
+
+# Profiling results for each test method are written to tmp/performance.
+class BrowsingTest < ActionController::PerformanceTest
+  def test_homepage
+    get '/'
+  end
+end

data/lib/generators/rails/app/templates/test/test_helper.rb

@@ -0,0 +1,13 @@
+ENV["RAILS_ENV"] = "test"
+require File.expand_path(File.dirname(__FILE__) + "/../config/environment")
+require 'rails/test_help'
+
+class ActiveSupport::TestCase
+  # Setup all fixtures in test/fixtures/*.(yml|csv) for all tests in alphabetical order.
+  #
+  # Note: You'll currently still have to declare fixtures explicitly in integration tests
+  # -- they do not yet inherit this setting
+  fixtures :all
+
+  # Add more helper methods to be used by all tests here...
+end

data/lib/generators/rails/controller/USAGE

@@ -0,0 +1,18 @@
+Description:
+    Stubs out a new controller and its views. Pass the controller name, either
+    CamelCased or under_scored, and a list of views as arguments.
+
+    To create a controller within a module, specify the controller name as a
+    path like 'parent_module/controller_name'.
+
+    This generates a controller class in app/controllers and invokes helper,
+    template engine and test framework generators.
+
+Example:
+    `./script/generate controller CreditCard open debit credit close`
+
+    Credit card controller with URLs like /credit_card/debit.
+        Controller:      app/controllers/credit_card_controller.rb
+        Functional Test: test/functional/credit_card_controller_test.rb
+        Views:           app/views/credit_card/debit.html.erb [...]
+        Helper:          app/helpers/credit_card_helper.rb

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

@@ -0,0 +1,14 @@
+module Rails
+  module Generators
+    class ControllerGenerator < NamedBase
+      argument :actions, :type => :array, :default => [], :banner => "action action"
+      check_class_collision :suffix => "Controller"
+
+      def create_controller_files
+        template 'controller.rb', File.join('app/controllers', class_path, "#{file_name}_controller.rb")
+      end
+
+      hook_for :template_engine, :test_framework, :helper
+    end
+  end
+end

data/lib/generators/rails/controller/templates/controller.rb

@@ -0,0 +1,7 @@
+class <%= class_name %>Controller < ApplicationController
+<% for action in actions -%>
+  def <%= action %>
+  end
+
+<% end -%>
+end

data/lib/generators/rails/generator/USAGE

@@ -0,0 +1,11 @@
+Description:
+    Stubs out a new generator at lib/generators. Pass the generator name, either
+    CamelCased or under_scored, as an argument. 
+
+Example:
+    `./script/generate generator Awesome`
+
+    creates a standard awesome generator:
+        lib/generators/awesome/
+        lib/generators/awesome/awesome_generator.rb
+        lib/generators/awesome/templates/

data/lib/generators/rails/generator/generator_generator.rb

@@ -0,0 +1,25 @@
+module Rails
+  module Generators
+    class GeneratorGenerator < NamedBase
+      check_class_collision :suffix => "Generator"
+
+      class_option :namespace, :type => :boolean, :default => true,
+                               :desc => "Namespace generator under lib/generators/name"
+
+      def create_generator_files
+        directory '.', generator_dir
+      end
+
+      protected
+
+        def generator_dir
+          if options[:namespace]
+            File.join("lib", "generators", file_name)
+          else
+            File.join("lib", "generators")
+          end
+        end
+
+    end
+  end
+end

data/lib/generators/rails/generator/templates/%file_name%_generator.rb.tt

@@ -0,0 +1,5 @@
+class <%= class_name %>Generator < Rails::Generators::NamedBase
+  def self.source_root
+    @source_root ||= File.expand_path('../templates', __FILE__)
+  end
+end

data/lib/generators/rails/generator/templates/USAGE.tt

@@ -0,0 +1,8 @@
+Description:
+    Explain the generator
+
+Example:
+    ./script/generate <%= file_name %> Thing
+
+    This will create:
+        what/will/it/create

data/lib/generators/rails/helper/USAGE

@@ -0,0 +1,17 @@
+Description:
+    Stubs out a new helper. Pass the helper name, either CamelCased
+    or under_scored.
+
+    To create a helper within a module, specify the helper name as a
+    path like 'parent_module/helper_name'.
+
+    This generates a helper class in app/helpers and invokes the configured
+    test framework.
+
+Example:
+    `./script/generate helper CreditCard`
+
+    Credit card helper.
+        Helper:     app/helpers/credit_card_helper.rb
+        Test:       test/unit/helpers/credit_card_helper_test.rb
+

data/lib/generators/rails/helper/helper_generator.rb

@@ -0,0 +1,13 @@
+module Rails
+  module Generators
+    class HelperGenerator < NamedBase
+      check_class_collision :suffix => "Helper"
+
+      def create_helper_files
+        template 'helper.rb', File.join('app/helpers', class_path, "#{file_name}_helper.rb")
+      end
+
+      hook_for :test_framework
+    end
+  end
+end

data/lib/generators/rails/helper/templates/helper.rb

@@ -0,0 +1,2 @@
+module <%= class_name %>Helper
+end

data/lib/generators/rails/integration_test/USAGE

@@ -0,0 +1,10 @@
+Description:
+    Stubs out a new integration test. Pass the name of the test, either
+    CamelCased or under_scored, as an argument.
+
+    This generator invokes the current integration tool, which defaults to
+    TestUnit.
+
+Example:
+    `./script/generate integration_test GeneralStories` creates a GeneralStories
+    integration test in test/integration/general_stories_test.rb

data/lib/generators/rails/integration_test/integration_test_generator.rb

@@ -0,0 +1,7 @@
+module Rails
+  module Generators
+    class IntegrationTestGenerator < NamedBase
+      hook_for :integration_tool, :as => :integration
+    end
+  end
+end

data/lib/generators/rails/mailer/USAGE

@@ -0,0 +1,15 @@
+Description:
+    Stubs out a new mailer and its views. Pass the mailer name, either
+    CamelCased or under_scored, and an optional list of emails as arguments.
+
+    This generates a mailer class in app/mailers and invokes your template
+    engine and test framework generators.
+
+Example:
+    `./script/generate mailer Notifications signup forgot_password invoice`
+
+    creates a Notifications mailer class, views, test, and fixtures:
+        Mailer:     app/mailers/notifications.rb
+        Views:      app/views/notifications/signup.erb [...]
+        Test:       test/functional/notifications_test.rb
+        Fixtures:   test/fixtures/notifications/signup [...]

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

@@ -0,0 +1,14 @@
+module Rails
+  module Generators
+    class MailerGenerator < NamedBase
+      argument :actions, :type => :array, :default => [], :banner => "method method"
+      check_class_collision
+
+      def create_mailer_file
+        template "mailer.rb", File.join('app/mailers', class_path, "#{file_name}.rb")
+      end
+
+      hook_for :template_engine, :test_framework
+    end
+  end
+end

data/lib/generators/rails/mailer/templates/mailer.rb

@@ -0,0 +1,16 @@
+class <%= class_name %> < ActionMailer::Base
+  default :from => "from@example.com"
+<% for action in actions -%>
+
+  # Subject can be set in your I18n file at config/locales/en.yml
+  # with the following lookup:
+  #
+  #   en.actionmailer.<%= file_name %>.<%= action %>.subject
+  #
+  def <%= action %>
+    @greeting = "Hi"
+
+    mail :to => "to@example.org"
+  end
+<% end -%>
+end

data/lib/generators/rails/metal/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Cast some metal!
+
+Examples:
+    `./script/generate metal poller`
+
+        This will create:
+            Metal: app/metal/poller.rb

data/lib/generators/rails/metal/metal_generator.rb

@@ -0,0 +1,11 @@
+module Rails
+  module Generators
+    class MetalGenerator < NamedBase
+      check_class_collision
+
+      def create_metal_file
+        template "metal.rb", "app/metal/#{file_name}.rb"
+      end
+    end
+  end
+end

data/lib/generators/rails/metal/templates/metal.rb

@@ -0,0 +1,12 @@
+# Allow the metal piece to run in isolation
+require File.expand_path('../../../config/environment',  __FILE__) unless defined?(Rails)
+
+class <%= class_name %>
+  def self.call(env)
+    if env["PATH_INFO"] =~ /^\/<%= file_name %>/
+      [200, {"Content-Type" => "text/html"}, ["Hello, World!"]]
+    else
+      [404, {"Content-Type" => "text/html", "X-Cascade" => "pass"}, ["Not Found"]]
+    end
+  end
+end

data/lib/generators/rails/migration/USAGE

@@ -0,0 +1,29 @@
+Description:
+    Stubs out a new database migration. Pass the migration name, either
+    CamelCased or under_scored, and an optional list of attribute pairs as arguments.
+
+    A migration class is generated in db/migrate prefixed by a timestamp of the current date and time.
+
+    You can name your migration in either of these formats to generate add/remove
+    column lines from supplied attributes: AddColumnsToTable or RemoveColumnsFromTable
+
+Example:
+    `./script/generate migration AddSslFlag`
+
+    If the current date is May 14, 2008 and the current time 09:09:12, this creates the AddSslFlag migration
+    db/migrate/20080514090912_add_ssl_flag.rb
+
+    `./script/generate migration AddTitleBodyToPost title:string body:text published:boolean`
+
+    This will create the AddTitleBodyToPost in db/migrate/20080514090912_add_title_body_to_post.rb with
+    this in the Up migration:
+
+      add_column :posts, :title, :string  
+      add_column :posts, :body, :text  
+      add_column :posts, :published, :boolean
+
+    And this in the Down migration:
+
+      remove_column :posts, :published  
+      remove_column :posts, :body  
+      remove_column :posts, :title

data/lib/generators/rails/migration/migration_generator.rb

@@ -0,0 +1,8 @@
+module Rails
+  module Generators
+    class MigrationGenerator < NamedBase #metagenerator
+      argument :attributes, :type => :array, :default => [], :banner => "field:type field:type"
+      hook_for :orm, :required => true
+    end
+  end
+end