active_scaffold 3.0.0

data/lib/extensions/array.rb

@@ -0,0 +1,7 @@
+class Array
+  # returns the value after the given value. wraps around. defaults to first element in array.
+  def after(value)
+    return nil unless include? value
+    self[(index(value).to_i + 1) % length]
+  end
+end

data/lib/extensions/localize.rb

@@ -0,0 +1,10 @@
+class Object
+  def as_(key, options = {})
+    unless key.blank?
+      text = I18n.translate "#{key}", {:scope => [:active_scaffold], :default => key.is_a?(String) ? key : key.to_s.titleize}.merge(options)
+      # text = nil if text.include?('translation missing:')
+    end
+    text ||= key 
+    text
+  end
+end

data/lib/extensions/name_option_for_datetime.rb

@@ -0,0 +1,12 @@
+module ActionView
+  module Helpers
+    class InstanceTag
+      private
+      def datetime_selector_with_name(options, html_options)
+        options.merge!(:prefix => options[:name].gsub(/\[[^\[]*\]$/,'')) if options[:name]
+        datetime_selector_without_name(options, html_options)        
+      end
+      alias_method_chain :datetime_selector, :name
+    end
+  end
+end

data/lib/extensions/nil_id_in_url_params.rb

@@ -0,0 +1,7 @@
+class ActionController::Routing::RouteSet
+  def generate_with_nil_id_awareness(*args)
+    args[0].delete(:id) if args[0][:id].nil?
+    generate_without_nil_id_awareness(*args)
+  end
+  alias_method_chain :generate, :nil_id_awareness
+end

data/lib/extensions/paginator_extensions.rb

@@ -0,0 +1,26 @@
+require 'paginator'
+
+class Paginator
+
+  # Total number of pages
+  def number_of_pages_with_infinite
+    number_of_pages_without_infinite unless infinite?
+  end
+  alias_method_chain :number_of_pages, :infinite
+  
+  # Is this an "infinite" paginator
+  def infinite?
+    @count.nil?
+  end
+  
+  class Page
+    # Checks to see if there's a page after this one
+    def next_with_infinite?
+      return true if @pager.infinite?
+      next_without_infinite?
+    end
+    alias_method_chain :next?, :infinite
+  end
+
+end
+

data/lib/extensions/reverse_associations.rb

@@ -0,0 +1,62 @@
+module ActiveRecord
+  module Reflection
+    class AssociationReflection #:nodoc:
+      def reverse_for?(klass)
+        reverse_matches_for(klass).empty? ? false : true
+      end
+
+      attr_writer :reverse
+      def reverse
+        if @reverse.nil? and not self.options[:polymorphic]
+          reverse_matches = reverse_matches_for(self.class_name.constantize) rescue nil
+          # grab first association, or make a wild guess
+          @reverse = reverse_matches.blank? ? false : reverse_matches.first.name
+        end
+        @reverse
+      end
+
+      protected
+
+        def reverse_matches_for(klass)
+          reverse_matches = []
+
+          # stage 1 filter: collect associations that point back to this model and use the same primary_key_name
+          klass.reflect_on_all_associations.each do |assoc|
+            if self.options[:through]
+              # only iterate has_many :through associations
+              next unless assoc.options[:through]
+              next unless assoc.through_reflection.klass == self.through_reflection.klass
+            else
+              # skip over has_many :through associations
+              next if assoc.options[:through]
+              next unless assoc.options[:polymorphic] or assoc.class_name.constantize == self.active_record
+
+              case [assoc.macro, self.macro].find_all{|m| m == :has_and_belongs_to_many}.length
+                # if both are a habtm, then match them based on the join table
+                when 2
+                next unless assoc.options[:join_table] == self.options[:join_table]
+
+                # if only one is a habtm, they do not match
+                when 1
+                next
+
+                # otherwise, match them based on the primary_key_name
+                when 0
+                next unless assoc.primary_key_name.to_sym == self.primary_key_name.to_sym
+              end
+            end
+
+            reverse_matches << assoc
+          end
+
+          # stage 2 filter: name-based matching (association name vs self.active_record.to_s)
+          reverse_matches.find_all do |assoc|
+            self.active_record.to_s.underscore.include? assoc.name.to_s.pluralize.singularize
+          end if reverse_matches.length > 1
+
+          reverse_matches
+        end
+
+    end
+  end
+end

data/lib/extensions/routing_mapper.rb

@@ -0,0 +1,34 @@
+module ActionDispatch
+  module Routing
+    ACTIVE_SCAFFOLD_CORE_ROUTING = {
+        :collection => {:show_search => :get, :render_field => :get},
+        :member => {:row => :get, :update_column => :post, :render_field => :get, :delete => :get}
+    }
+    ACTIVE_SCAFFOLD_ASSOCIATION_ROUTING = {
+        :collection => {:edit_associated => :get, :new_existing => :get, :add_existing => :post},
+        :member => {:edit_associated => :get, :add_association => :get, :destroy_existing => :delete}
+    }
+    class Mapper
+      module Base
+        def as_routes(options = {:association => true})
+          collection do
+            ActionDispatch::Routing::ACTIVE_SCAFFOLD_CORE_ROUTING[:collection].each {|name, type| send(type, name)}
+          end
+          member do
+            ActionDispatch::Routing::ACTIVE_SCAFFOLD_CORE_ROUTING[:member].each {|name, type| send(type, name)}
+          end
+          as_association_routes if options[:association]
+        end
+        
+        def as_association_routes
+          collection do 
+            ActionDispatch::Routing::ACTIVE_SCAFFOLD_ASSOCIATION_ROUTING[:collection].each {|name, type| send(type, name)}
+          end
+          member do
+            ActionDispatch::Routing::ACTIVE_SCAFFOLD_ASSOCIATION_ROUTING[:member].each {|name, type| send(type, name)}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/extensions/to_label.rb

@@ -0,0 +1,8 @@
+# the ever-useful to_label method
+class ActiveRecord::Base
+  def to_label
+    [:name, :label, :title, :to_s].each do |attribute|
+      return send(attribute).to_s if respond_to?(attribute)
+    end
+  end
+end

data/lib/extensions/unsaved_associated.rb

@@ -0,0 +1,61 @@
+# save and validation support for associations.
+class ActiveRecord::Base
+  def associated_valid?(path = [])
+    return true if path.include?(self) # prevent recursion (if associated and parent are new records)
+    path << self
+    # using [].all? syntax to avoid a short-circuit
+    with_unsaved_associated { |a| [a.valid?, a.associated_valid?(path)].all? {|v| v == true} }
+  end
+
+  def save_associated
+    with_unsaved_associated { |a| a.save and a.save_associated }
+  end
+
+  def save_associated!
+    save_associated or raise(ActiveRecord::RecordNotSaved)
+  end
+
+  def no_errors_in_associated?
+    with_unsaved_associated {|a| a.errors.count == 0 and a.no_errors_in_associated?}
+  end
+
+  protected
+
+  # Provide an override to allow the model to restrict which associations are considered
+  # by ActiveScaffolds update mechanism. This allows the model to restrict things like
+  # Acts-As-Versioned versions associations being traversed.
+  #
+  # By defining the method :scaffold_update_nofollow returning an array of associations
+  # these associations will not be traversed.
+  # By defining the method :scaffold_update_follow returning an array of associations,
+  # only those associations will be traversed.
+  #
+  # Otherwise the default behaviour of traversing all associations will be preserved.
+  def associations_for_update
+    if self.respond_to?( :scaffold_update_nofollow )
+      self.class.reflect_on_all_associations.reject { |association| self.scaffold_update_nofollow.include?( association.name ) }
+    elsif self.respond_to?( :scaffold_update_follow )
+      self.class.reflect_on_all_associations.select { |association| self.scaffold_update_follow.include?( association.name ) }
+    else
+      self.class.reflect_on_all_associations
+    end
+  end
+
+  private
+
+  # yields every associated object that has been instantiated and is flagged as unsaved.
+  # returns false if any yield returns false.
+  # returns true otherwise, even when none of the associations have been instantiated. build wrapper methods accordingly.
+  def with_unsaved_associated
+    associations_for_update.all? do |association|
+      association_proxy = instance_variable_get("@#{association.name}")
+      if association_proxy
+        records = association_proxy
+        records = [records] unless records.is_a? Array # convert singular associations into collections for ease of use
+        records.select {|r| r.unsaved? and not r.readonly?}.all? {|r| yield r} # must use select instead of find_all, which Rails overrides on association proxies for db access
+      else
+        true
+      end
+    end
+  end
+end

data/lib/extensions/unsaved_record.rb

@@ -0,0 +1,20 @@
+# a simple (manual) unsaved? flag and method. at least it automatically reverts after a save!
+class ActiveRecord::Base
+  # acts like a dirty? flag, manually thrown during update_record_from_params.
+  def unsaved=(val)
+    @unsaved = (val) ? true : false
+  end
+
+  # whether the unsaved? flag has been thrown
+  def unsaved?
+    @unsaved
+  end
+
+  # automatically unsets the unsaved flag
+  def save_with_unsaved_flag(*args)
+    result = save_without_unsaved_flag(*args)
+    self.unsaved = false
+    return result
+  end
+  alias_method_chain :save, :unsaved_flag
+end

data/lib/extensions/usa_state.rb

@@ -0,0 +1,46 @@
+module ActionView
+  module Helpers
+    module FormOptionsHelper
+
+      # Return a full select and option tags for the given object and method, using usa_state_options_for_select to generate the list of option <tags>.
+      def usa_state_select(object, method, priority_states = nil, options = {}, html_options = {})
+        InstanceTag.new(object, method, self, options.delete(:object)).to_usa_state_select_tag(priority_states, options, html_options)
+      end
+    
+
+      # Returns a string of option tags for the states in the United States. Supply a state name as +selected to
+      # have it marked as the selected option tag. Included also is the option to set a couple of +priority_states+ 
+      # in case you want to highligh a local area
+      # NOTE: Only the option tags are returned from this method, wrap it in a <select>
+      def usa_state_options_for_select(selected = nil, priority_states = nil)
+        state_options = ""
+        if priority_states
+          state_options += options_for_select(priority_states, selected)
+          state_options += "<option>-------------</option>\n"
+        end
+
+        if priority_states && priority_states.include?(selected)
+          state_options += options_for_select(USASTATES - priority_states, selected)
+        else
+          state_options += options_for_select(USASTATES, selected)
+        end
+
+        return state_options
+      end
+
+    	USASTATES = [["Alabama", "AL"], ["Alaska", "AK"], ["Arizona", "AZ"], ["Arkansas", "AR"], ["California", "CA"], ["Colorado", "CO"], ["Connecticut", "CT"], ["Delaware", "DE"], ["District of Columbia", "DC"], ["Florida", "FL"], ["Georgia", "GA"], ["Hawaii", "HI"], ["Idaho", "ID"], ["Illinois", "IL"], ["Indiana", "IN"], ["Iowa", "IA"], ["Kansas", "KS"], ["Kentucky", "KY"], ["Louisiana", "LA"], ["Maine", "ME"], ["Maryland", "MD"], ["Massachusetts", "MA"], ["Michigan", "MI"], ["Minnesota", "MN"], ["Mississippi", "MS"], ["Missouri", "MO"], ["Montana", "MT"], ["Nebraska", "NE"], ["Nevada", "NV"], ["New Hampshire", "NH"], ["New Jersey", "NJ"], ["New Mexico", "NM"], ["New York", "NY"], ["North Carolina", "NC"], ["North Dakota", "ND"], ["Ohio", "OH"], ["Oklahoma", "OK"], ["Oregon", "OR"], ["Pennsylvania", "PA"], ["Rhode Island", "RI"], ["South Carolina", "SC"], ["South Dakota", "SD"], ["Tennessee", "TN"], ["Texas", "TX"], ["Utah", "UT"], ["Vermont", "VT"], ["Virginia", "VA"], ["Washington", "WA"], ["Wisconsin", "WI"], ["West Virginia", "WV"], ["Wyoming", "WY"]] unless const_defined?("USASTATES")
+ 
+    end
+  
+    class InstanceTag #:nodoc:
+      include FormOptionsHelper
+ 
+      def to_usa_state_select_tag(priority_states, options, html_options)
+        html_options = html_options.stringify_keys
+        add_default_name_and_id(html_options)
+        value = value(object) if method(:value).arity > 0
+        content_tag("select", add_options(usa_state_options_for_select(value, priority_states), options, value), html_options)
+      end
+    end
+  end
+end

data/lib/generators/active_scaffold/USAGE

@@ -0,0 +1,29 @@
+Description:
+    Scaffolds an entire resource, from model and migration to controller, 
+    along with a full test suite and configured to use active_scaffold. 
+    The resource is ready to use as a starting point for your RESTful,
+    resource-oriented application.
+
+    Pass the name of the model (in singular form), either CamelCased or
+    under_scored, as the first argument, and an optional list of attribute
+    pairs.
+
+    Attribute pairs are field:type arguments specifying the
+    model's attributes. Timestamps are added by default, so you don't have to
+    specify them by hand as 'created_at:datetime updated_at:datetime'.
+
+    You don't have to think up every attribute up front, but it helps to
+    sketch out a few so you can start working with the resource immediately.
+
+    For example, 'active_scaffold post title:string body:text published:boolean'
+    gives you a model with those three attributes, a controller configured to use active_scaffold, 
+    as well as a resources :posts with additional active_scaffold routes
+    declaration in config/routes.rb.
+
+    If you want to remove all the generated files, run
+    'rails destroy active_scaffold ModelName'.
+
+Examples:
+    `rails generate active_scaffold post`
+    `rails generate active_scaffold post title:string body:text published:boolean`
+    `rails generate active_scaffold purchase order_id:integer amount:decimal` 

data/lib/generators/active_scaffold/active_scaffold_generator.rb

@@ -0,0 +1,20 @@
+require 'rails/generators/rails/resource/resource_generator'
+#require 'generators/active_scaffold_controller/active_scaffold_controller_generator'
+
+module Rails
+  module Generators
+    class ActiveScaffoldGenerator < ResourceGenerator #metagenerator
+      remove_hook_for :resource_controller
+      remove_class_option :actions
+      
+      def add_resource_route
+        route_config =  class_path.collect{|namespace| "namespace :#{namespace} do " }.join(" ") 
+        route_config << "resources :#{file_name.pluralize} do as_routes end"
+        route_config << " end" * class_path.size 
+        route route_config
+      end 
+     
+      invoke "active_scaffold_controller"
+    end
+  end
+end

data/lib/generators/active_scaffold_controller/USAGE

@@ -0,0 +1,19 @@
+Description:
+    Stubs out a active_scaffolded controller. Pass the model name,
+    either CamelCased or under_scored.
+    The controller name is retrieved as a pluralized version of the model
+    name.
+
+    To create a controller within a module, specify the model 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:
+    `rails generate active_scaffold_controller CreditCard`
+
+    Credit card controller with URLs like /credit_card/debit.
+        Controller:      app/controllers/credit_cards_controller.rb
+        Functional Test: test/functional/credit_cards_controller_test.rb
+        Helper:          app/helpers/credit_cards_helper.rb 

data/lib/generators/active_scaffold_controller/active_scaffold_controller_generator.rb

@@ -0,0 +1,28 @@
+#require 'rails/generators/rails/scaffold_controller/scaffold_controller_generator'
+
+module Rails
+  module Generators
+    class ActiveScaffoldControllerGenerator < NamedBase #metagenerator
+      include ResourceHelpers
+
+      def self.source_root
+         @source_root ||= File.join(File.dirname(__FILE__), 'templates')
+      end
+
+      check_class_collision :suffix => "Controller"
+
+      class_option :orm, :banner => "NAME", :type => :string, :required => true,
+                         :desc => "ORM to generate the controller for"
+
+      def create_controller_files
+        template 'controller.rb', File.join('app/controllers', class_path, "#{controller_file_name}_controller.rb")
+      end
+
+      hook_for :test_framework, :as => :scaffold
+
+      def create_view_root_folder
+        empty_directory File.join("app/views", controller_file_path)
+      end 
+    end
+  end
+end

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

@@ -0,0 +1,4 @@
+class <%= controller_class_name %>Controller < ApplicationController
+  active_scaffold :<%= class_name.demodulize.underscore %> do |conf|
+  end
+end 

data/lib/generators/active_scaffold_setup/USAGE

@@ -0,0 +1,10 @@
+Description:
+    Setup a new Rails 3 Application with active_scaffold.
+    Pass 'jquery' in case you would like to use it instead of prototype
+    
+    This installs required plugins and configures active_scaffold to use 
+    specified js lib and application layout file to include all required
+    assets
+
+Example:
+    `rails generate active_scaffold_setup jquery`

data/lib/generators/active_scaffold_setup/active_scaffold_setup_generator.rb

@@ -0,0 +1,53 @@
+module Rails
+  module Generators
+    class ActiveScaffoldSetupGenerator < Rails::Generators::Base #metagenerator
+      argument :js_lib, :type => :string, :default => 'prototype', :desc => 'js_lib for activescaffold (prototype|jquery)' 
+      
+      def self.source_root
+         @source_root ||= File.join(File.dirname(__FILE__), 'templates')
+      end
+
+      def install_plugins
+        plugin 'verification', :git => 'git://github.com/rails/verification.git'
+        plugin 'render_component', :git => 'git://github.com/vhochstein/render_component.git'
+        if js_lib == 'prototype'
+          get "https://github.com/vhochstein/prototype-ujs/raw/master/src/rails.js", "public/javascripts/rails.js"
+        elsif js_lib == 'jquery'
+          get "https://github.com/vhochstein/jquery-ujs/raw/master/src/rails.js", "public/javascripts/rails_jquery.js"
+          get "https://github.com/vhochstein/jQuery-Timepicker-Addon/raw/master/jquery-ui-timepicker-addon.js", "public/javascripts/jquery-ui-timepicker-addon.js"
+        end
+      end
+      
+      def configure_active_scaffold
+        if js_lib == 'jquery'
+          gsub_file 'vendor/plugins/active_scaffold/environment.rb', /#ActiveScaffold.js_framework = :jquery/, 'ActiveScaffold.js_framework = :jquery'
+        end
+      end
+      
+      def configure_application_layout
+        if js_lib == 'prototype'
+          inject_into_file "app/views/layouts/application.html.erb", 
+                    "  <%= active_scaffold_includes %>\n",
+                    :after => "<%= javascript_include_tag :defaults %>\n"
+        elsif js_lib == 'jquery'
+          inject_into_file "app/views/layouts/application.html.erb", 
+"  <%= stylesheet_link_tag 'http://ajax.googleapis.com/ajax/libs/jqueryui/1.8.4/themes/ui-lightness/jquery-ui.css' %>
+  <%= javascript_include_tag 'http://ajax.googleapis.com/ajax/libs/jquery/1.4.1/jquery.js' %>
+  <%= javascript_include_tag 'rails_jquery.js' %>
+  <%= javascript_include_tag 'http://ajax.googleapis.com/ajax/libs/jqueryui/1.8.4/jquery-ui.js' %>
+  <%= javascript_include_tag 'jquery-ui-timepicker-addon.js' %>
+  <%= javascript_include_tag 'application.js' %>
+  <%= active_scaffold_includes %>\n",
+                   :after => "<%= javascript_include_tag :defaults %>\n"
+           
+          inject_into_file "config/locales/en.yml",
+"  time:
+    formats:
+      default: \"%a, %d %b %Y %H:%M:%S\"",                  
+                   :after => "hello: \"Hello world\"\n"
+          gsub_file 'app/views/layouts/application.html.erb', /<%= javascript_include_tag :defaults/, '<%# javascript_include_tag :defaults'
+        end
+      end     
+    end
+  end
+end