merb-admin 0.4.3

data/lib/datamapper_support.rb

@@ -0,0 +1,157 @@
+module MerbAdmin
+  class AbstractModel
+    module DatamapperSupport
+      def count(options = {})
+        model.count(options)
+      end
+
+      def get(id)
+        model.get(id).extend(InstanceMethods)
+      end
+
+      def first(options = {})
+        model.first(options).extend(InstanceMethods)
+      end
+
+      def all(options = {})
+        model.all(options)
+      end
+
+      def all_in(ids, options = {})
+        options[:id] = ids
+        model.all(options)
+      end
+
+      def paginated(options = {})
+        page = options.delete(:page) || 1
+        per_page = options.delete(:per_page) || MerbAdmin[:per_page]
+
+        page_count = (count(options).to_f / per_page).ceil
+
+        options.merge!({
+          :limit => per_page,
+          :offset => (page - 1) * per_page
+        })
+
+        [page_count, all(options)]
+      end
+
+      def create(params = {})
+        model.create(params)
+      end
+
+      def new(params = {})
+        model.new(params).extend(InstanceMethods)
+      end
+
+      def destroy_all!
+        model.all.destroy!
+      end
+
+      def has_many_associations
+        associations.select do |association|
+          association[:type] == :has_many
+        end
+      end
+
+      def has_one_associations
+        associations.select do |association|
+          association[:type] == :has_one
+        end
+      end
+
+      def belongs_to_associations
+        associations.select do |association|
+          association[:type] == :belongs_to
+        end
+      end
+
+      def associations
+        model.relationships.to_a.map do |name, association|
+          {
+            :name => name,
+            :pretty_name => name.to_s.gsub('_', ' ').capitalize,
+            :type => association_type_lookup(association),
+            :parent_model => association.parent_model,
+            :parent_key => association.parent_key.map{|r| r.name},
+            :child_model => association.child_model,
+            :child_key => association.child_key.map{|r| r.name},
+          }
+        end
+      end
+
+      def properties
+        model.properties.map do |property|
+          {
+            :name => property.name,
+            :pretty_name => property.name.to_s.gsub('_', ' ').capitalize,
+            :type => type_lookup(property),
+            :length => property.length,
+            :nullable? => property.nullable?,
+            :serial? => property.serial?,
+            :key? => property.key?,
+            :flag_map => property.type.respond_to?(:flag_map) ? property.type.flag_map : nil,
+          }
+        end
+      end
+
+      private
+
+      def association_type_lookup(association)
+        if self.model == association.parent_model
+          association.options[:max] > 1 ? :has_many : :has_one
+        elsif self.model == association.child_model
+          :belongs_to
+        else
+          raise "Unknown association type"
+        end
+      end
+
+      def type_lookup(property)
+        type = {
+          BigDecimal => :big_decimal,
+          DataMapper::Types::Boolean => :boolean,
+          DataMapper::Types::ParanoidBoolean => :boolean,
+          DataMapper::Types::ParanoidDateTime => :datetime,
+          DataMapper::Types::Serial => :integer,
+          DataMapper::Types::Text => :text,
+          Date => :date,
+          DateTime => :datetime,
+          Fixnum => :integer,
+          Float => :float,
+          Integer => :integer,
+          String => :string,
+          Time => :time,
+        }
+        type[property.type] || type[property.primitive]
+      end
+
+      module InstanceMethods
+        def id
+          super
+        end
+
+        def save
+          super
+        end
+
+        def destroy
+          super
+        end
+
+        def update_attributes(attributes)
+          super
+        end
+
+        def errors
+          super
+        end
+
+        def clear_association(association)
+          association.clear
+        end
+      end
+
+    end
+  end
+end

data/lib/generic_support.rb

@@ -0,0 +1,17 @@
+module MerbAdmin
+  class AbstractModel
+    module GenericSupport
+      def singular_name
+        model.to_s.snake_case.to_sym
+      end
+
+      def plural_name
+        model.to_s.snake_case.pluralize.to_sym
+      end
+
+      def pretty_name
+        model.to_s.snake_case.gsub('_', ' ').capitalize
+      end
+    end
+  end
+end

data/lib/merb-admin/merbtasks.rb

@@ -0,0 +1,103 @@
+namespace :slices do
+  namespace :"merb-admin" do
+  
+    desc "Install MerbAdmin"
+    task :install => [:preflight, :setup_directories, :copy_assets, :migrate]
+    
+    desc "Test for any dependencies"
+    task :preflight do # see slicetasks.rb
+    end
+  
+    desc "Setup directories"
+    task :setup_directories do
+      puts "Creating directories for host application"
+      MerbAdmin.mirrored_components.each do |type|
+        if File.directory?(MerbAdmin.dir_for(type))
+          if !File.directory?(dst_path = MerbAdmin.app_dir_for(type))
+            relative_path = dst_path.relative_path_from(Merb.root)
+            puts "- creating directory :#{type} #{File.basename(Merb.root) / relative_path}"
+            mkdir_p(dst_path)
+          end
+        end
+      end
+    end
+    
+    # desc "Copy stub files to host application"
+    # task :stubs do
+    #   puts "Copying stubs for MerbAdmin - resolves any collisions"
+    #   copied, preserved = MerbAdmin.mirror_stubs!
+    #   puts "- no files to copy" if copied.empty? && preserved.empty?
+    #   copied.each { |f| puts "- copied #{f}" }
+    #   preserved.each { |f| puts "! preserved override as #{f}" }
+    # end
+    
+    # desc "Copy stub files and views to host application"
+    # task :patch => [ "stubs", "freeze:views" ]
+  
+    desc "Copy public assets to host application"
+    task :copy_assets do
+      puts "Copying assets for MerbAdmin - resolves any collisions"
+      copied, preserved = MerbAdmin.mirror_public!
+      puts "- no files to copy" if copied.empty? && preserved.empty?
+      copied.each { |f| puts "- copied #{f}" }
+      preserved.each { |f| puts "! preserved override as #{f}" }
+    end
+    
+    desc "Migrate the database"
+    task :migrate do # see slicetasks.rb
+    end
+    
+    desc "Freeze MerbAdmin into your app (only merb-admin/app)" 
+    task :freeze => [ "freeze:app" ]
+
+    namespace :freeze do
+      
+      # desc "Freezes MerbAdmin by installing the gem into application/gems"
+      # task :gem do
+      #   ENV["GEM"] ||= "merb-admin"
+      #   Rake::Task['slices:install_as_gem'].invoke
+      # end
+      
+      desc "Freezes MerbAdmin by copying all files from merb-admin/app to your application"
+      task :app do
+        puts "Copying all merb-admin/app files to your application - resolves any collisions"
+        copied, preserved = MerbAdmin.mirror_app!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freeze all views into your application for easy modification" 
+      task :views do
+        puts "Copying all view templates to your application - resolves any collisions"
+        copied, preserved = MerbAdmin.mirror_files_for :view
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freeze all models into your application for easy modification" 
+      task :models do
+        puts "Copying all models to your application - resolves any collisions"
+        copied, preserved = MerbAdmin.mirror_files_for :model
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freezes MerbAdmin as a gem and copies over merb-admin/app"
+      task :app_with_gem => [:gem, :app]
+      
+      desc "Freezes MerbAdmin by unpacking all files into your application"
+      task :unpack do
+        puts "Unpacking MerbAdmin files to your application - resolves any collisions"
+        copied, preserved = MerbAdmin.unpack_slice!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+    end
+    
+  end
+end

data/lib/merb-admin/slicetasks.rb

@@ -0,0 +1,20 @@
+namespace :slices do
+  namespace :"merb-admin" do 
+    
+    # add your own merb-admin tasks here
+    
+    # # Uncomment the following lines and edit the pre defined tasks
+    #
+    # # implement this to test for structural/code dependencies
+    # # like certain directories or availability of other files
+    # desc "Test for any dependencies"
+    # task :preflight do
+    # end
+    # 
+    # # implement this to perform any database related setup steps
+    # desc "Migrate the database"
+    # task :migrate do
+    # end
+    
+  end
+end

data/lib/merb-admin/spectasks.rb

@@ -0,0 +1,53 @@
+namespace :slices do
+  namespace :"merb-admin" do
+      
+    desc "Run slice specs within the host application context"
+    task :spec => [ "spec:explain", "spec:default" ]
+    
+    namespace :spec do
+      
+      slice_root = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
+      
+      task :explain do
+        puts "\nNote: By running MerbAdmin specs inside the application context any\n" +
+             "overrides could break existing specs. This isn't always a problem,\n" +
+             "especially in the case of views. Use these spec tasks to check how\n" +
+             "well your application conforms to the original slice implementation."
+      end
+      
+      Spec::Rake::SpecTask.new('default') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+
+      desc "Run all model specs, run a spec for a specific Model with MODEL=MyModel"
+      Spec::Rake::SpecTask.new('model') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['MODEL'])
+          t.spec_files = Dir["#{slice_root}/spec/models/**/#{ENV['MODEL']}_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/models/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all request specs, run a spec for a specific request with REQUEST=MyRequest"
+      Spec::Rake::SpecTask.new('request') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['REQUEST'])
+          t.spec_files = Dir["#{slice_root}/spec/requests/**/#{ENV['REQUEST']}_spec.rb"].sort
+        else    
+          t.spec_files = Dir["#{slice_root}/spec/requests/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all specs and output the result in html"
+      Spec::Rake::SpecTask.new('html') do |t|
+        t.spec_opts = ["--format", "html"]
+        t.libs = ['lib', 'server/lib' ]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+      
+    end
+    
+  end
+end

data/lib/merb-admin.rb

@@ -0,0 +1,99 @@
+if defined?(Merb::Plugins)
+
+  $:.unshift File.dirname(__FILE__)
+
+  dependency 'merb-slices', :immediate => true
+  Merb::Plugins.add_rakefiles "merb-admin/merbtasks", "merb-admin/slicetasks", "merb-admin/spectasks"
+
+  # Register the Slice for the current host application
+  Merb::Slices::register(__FILE__)
+
+  # Slice configuration - set this in a before_app_loads callback.
+  # By default a Slice uses its own layout, so you can swicht to 
+  # the main application layout or no layout at all if needed.
+  # 
+  # Configuration options:
+  # :layout - the layout to use; defaults to :merb-admin
+  # :mirror - which path component types to use on copy operations; defaults to all
+  Merb::Slices::config[:merb_admin][:layout] ||= :merb_admin
+  Merb::Slices::config[:merb_admin][:per_page] ||= 100
+  
+  # All Slice code is expected to be namespaced inside a module
+  module MerbAdmin
+
+    # Slice metadata
+    self.description = "MerbAdmin is a Merb plugin that provides an easy-to-use interface for managing your data."
+    self.version = "0.4.3"
+    self.author = "Erik Michaels-Ober"
+
+    # Stub classes loaded hook - runs before LoadClasses BootLoader
+    # right after a slice's classes have been loaded internally.
+    def self.loaded
+    end
+
+    # Initialization hook - runs before AfterAppLoads BootLoader
+    def self.init
+    end
+
+    # Activation hook - runs after AfterAppLoads BootLoader
+    def self.activate
+    end
+
+    # Deactivation hook - triggered by Merb::Slices.deactivate(MerbAdmin)
+    def self.deactivate
+    end
+
+    def self.setup_router(scope)
+      scope.match("/", :method => :get).
+        to(:controller => "main", :action => "index").
+        name(:admin_dashboard)
+
+      scope.match("/:model_name", :method => :get).
+        to(:controller => "main", :action => "list").
+        name(:admin_list)
+
+      scope.match("/:model_name/new", :method => :get).
+        to(:controller => "main", :action => "new").
+        name(:admin_new)
+
+      scope.match("/:model_name/:id/edit", :method => :get).
+        to(:controller => "main", :action => "edit").
+        name(:admin_edit)
+
+      scope.match("/:model_name", :method => :post).
+        to(:controller => "main", :action => "create").
+        name(:admin_create)
+
+      scope.match("/:model_name/:id", :method => :put).
+        to(:controller => "main", :action => "update").
+        name(:admin_update)
+
+      scope.match("/:model_name/:id/delete", :method => :get).
+        to(:controller => "main", :action => "delete").
+        name(:admin_delete)
+
+      scope.match("/:model_name/:id(.:format)", :method => :delete).
+        to(:controller => "main", :action => "destroy").
+        name(:admin_destroy)
+    end
+
+  end
+
+  # Setup the slice layout for MerbAdmin
+  #
+  # Use MerbAdmin.push_path and MerbAdmin.push_app_path
+  # to set paths to merb-admin-level and app-level paths. Example:
+  #
+  # MerbAdmin.push_path(:application, MerbAdmin.root)
+  # MerbAdmin.push_app_path(:application, Merb.root / 'slices' / 'merb-admin')
+  # ...
+  #
+  # Any component path that hasn't been set will default to MerbAdmin.root
+  #
+  # Or just call setup_default_structure! to setup a basic Merb MVC structure.
+  MerbAdmin.setup_default_structure!
+
+  # Add dependencies for other MerbAdmin classes below. Example:
+  # dependency "merb-admin/other"
+
+end

data/public/javascripts/CollapsedFieldsets.js

@@ -0,0 +1,85 @@
+// Finds all fieldsets with class="collapse", collapses them, and gives each
+// one a "Show" link that uncollapses it. The "Show" link becomes a "Hide"
+// link when the fieldset is visible.
+
+function findForm(node) {
+    // returns the node of the form containing the given node
+    if (node.tagName.toLowerCase() != 'form') {
+        return findForm(node.parentNode);
+    }
+    return node;
+}
+
+var CollapsedFieldsets = {
+    collapse_re: /\bcollapse\b/,   // Class of fieldsets that should be dealt with.
+    collapsed_re: /\bcollapsed\b/, // Class that fieldsets get when they're hidden.
+    collapsed_class: 'collapsed',
+    init: function() {
+        var fieldsets = document.getElementsByTagName('fieldset');
+        var collapsed_seen = false;
+        for (var i = 0, fs; fs = fieldsets[i]; i++) {
+            // Collapse this fieldset if it has the correct class, and if it
+            // doesn't have any errors. (Collapsing shouldn't apply in the case
+            // of error messages.)
+            if (fs.className.match(CollapsedFieldsets.collapse_re) && !CollapsedFieldsets.fieldset_has_errors(fs)) {
+                collapsed_seen = true;
+                // Give it an additional class, used by CSS to hide it.
+                fs.className += ' ' + CollapsedFieldsets.collapsed_class;
+                // (<a id="fieldsetcollapser3" class="collapse-toggle" href="#">Show</a>)
+                var collapse_link = document.createElement('a');
+                collapse_link.className = 'collapse-toggle';
+                collapse_link.id = 'fieldsetcollapser' + i;
+                collapse_link.onclick = new Function('CollapsedFieldsets.show('+i+'); return false;');
+                collapse_link.href = '#';
+                collapse_link.innerHTML = gettext('Show');
+                var h2 = fs.getElementsByTagName('h2')[0];
+                h2.appendChild(document.createTextNode(' ('));
+                h2.appendChild(collapse_link);
+                h2.appendChild(document.createTextNode(')'));
+            }
+        }
+        if (collapsed_seen) {
+            // Expand all collapsed fieldsets when form is submitted.
+            addEvent(findForm(document.getElementsByTagName('fieldset')[0]), 'submit', function() { CollapsedFieldsets.uncollapse_all(); });
+        }
+    },
+    fieldset_has_errors: function(fs) {
+        // Returns true if any fields in the fieldset have validation errors.
+        var divs = fs.getElementsByTagName('div');
+        for (var i=0; i<divs.length; i++) {
+            if (divs[i].className.match(/\berrors\b/)) {
+                return true;
+            }
+        }
+        return false;
+    },
+    show: function(fieldset_index) {
+        var fs = document.getElementsByTagName('fieldset')[fieldset_index];
+        // Remove the class name that causes the "display: none".
+        fs.className = fs.className.replace(CollapsedFieldsets.collapsed_re, '');
+        // Toggle the "Show" link to a "Hide" link
+        var collapse_link = document.getElementById('fieldsetcollapser' + fieldset_index);
+        collapse_link.onclick = new Function('CollapsedFieldsets.hide('+fieldset_index+'); return false;');
+        collapse_link.innerHTML = gettext('Hide');
+    },
+    hide: function(fieldset_index) {
+        var fs = document.getElementsByTagName('fieldset')[fieldset_index];
+        // Add the class name that causes the "display: none".
+        fs.className += ' ' + CollapsedFieldsets.collapsed_class;
+        // Toggle the "Hide" link to a "Show" link
+        var collapse_link = document.getElementById('fieldsetcollapser' + fieldset_index);
+        collapse_link.onclick = new Function('CollapsedFieldsets.show('+fieldset_index+'); return false;');
+        collapse_link.innerHTML = gettext('Show');
+    },
+
+    uncollapse_all: function() {
+        var fieldsets = document.getElementsByTagName('fieldset');
+        for (var i=0; i<fieldsets.length; i++) {
+            if (fieldsets[i].className.match(CollapsedFieldsets.collapsed_re)) {
+                CollapsedFieldsets.show(i);
+            }
+        }
+    }
+}
+
+addEvent(window, 'load', CollapsedFieldsets.init);