rear 0.2.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MzMxZTgzYTI0ODY4ZjExZmVhZWJkNWU2NWJhYWE4YTc2ODc5ZGM5Yg==
+  data.tar.gz: !binary |-
+    ZmEzZmE4ZGE1NjMxNjAxZjQyNjdlNTE4ZmRkODFlYjIxMTY5OTY5Ng==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZWJhZmZmMWQ3N2IzMDRjZWVlODAzMmIzZjQ2ZjUyNmU5NDI2ZTYzY2I4MzZl
+    YzlmOGNhYjJjOGZlOThlZDZlYjU0NTViYzRlMDdmY2JjNTFhMzFkYzhhNWRm
+    NzQ4NmU1NDUwYzIyZjJkZGFlMzZhMTE4ZGYzNjcxNDY5ODlmNzc=
+  data.tar.gz: !binary |-
+    MDNlY2NmNjViOTk1ZTU3MDYxYjEwYjg1YTQwZDM1MmRkZDQyMDg1NDQyYmY1
+    ZWY4MzNlNzQ3MmMwNjNiY2VlZmFiOTI5MThhODEzMTgyZGIzYmZiZDUyYWNm
+    NDRhMmU5NWUzNjE1YTdjMGNjZjkyZDgyMGE5YjQyNWNhNzY2NTM=

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.3
+  # - 2.0.0
+  # Tilt is mostly broken on 2.0.0 p0, should be fixed on next patch release
+  # https://bugs.ruby-lang.org/issues/8100
+  - rbx-19mode

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+
++ 0.0.9 [May 25, 2013]
+  - Sequel support
+  - Bulk editor
+  - `internal_filter` helper
+
+<hr>

data/Gemfile

@@ -0,0 +1,20 @@
+source 'http://rubygems.org'
+gemspec
+
+if ENV['E_DEV']
+  %w[e el rear].each do |g|
+    gem g, path: File.expand_path('../../' + g, __FILE__)
+  end
+else
+  gem 'el'
+end
+
+gem 'rake',         '~> 10'
+gem 'specular',     '>= 0.2.1'
+gem 'sonar',        '>= 0.1.5'
+gem 'nokogiri',     '~> 1.5'
+gem 'activerecord', '~> 3.2', require: 'active_record'
+gem 'sqlite3',      '~> 1.3'
+gem 'data_mapper',  '~> 1.2'
+gem 'dm-sqlite-adapter', '~> 1.2'
+gem 'sequel'

data/LICENSE

@@ -0,0 +1,19 @@
+
+Copyright (c) 2013 Silviu Rusu <slivuz@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy 
+of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,101 @@
+
+# Rear
+
+<a href="https://travis-ci.org/espresso/rear">
+<img align="right" src="https://travis-ci.org/espresso/rear.png"></a>
+
+### ORM-agnostic CRUDifier for Espresso Framework ([DEMO](http://rear.rbho.me/))
+
+## Highlights
+
+  - `ActiveRecord`, `DataMapper`, `Sequel` support
+  - Associations of any type supported
+  - Fully dynamic interface, no scaffolding
+  - Custom templates when needed
+  - Minimal dependencies - `Espresso` and `Slim`
+  - Tested on all 1.9+ Rubies
+
+
+## Quick Start
+
+```ruby
+require 'rear' # or add "gem 'rear'" to Gemfile
+
+# model
+class Page < ActiveRecord::Base
+  # ...
+end
+
+# controller
+Rear.register Page do
+  # setups goes here, if any
+end
+```
+
+**Run**
+
+```ruby
+Rear.run
+
+# or
+E.new do
+  mount Rear.controllers
+  run
+end
+```
+
+## Tutorial
+
+### [Setup](https://github.com/espresso/rear/blob/master/docs/Setup.md)
+
+
+[Primary key](https://github.com/espresso/rear/blob/master/docs/Setup.md#primary-key) |
+[Ordering](https://github.com/espresso/rear/blob/master/docs/Setup.md#ordering) |
+[Items per page](https://github.com/espresso/rear/blob/master/docs/Setup.md#items-per-page) |
+[Menu Label](https://github.com/espresso/rear/blob/master/docs/Setup.md#menu-label) |
+[Menu Positioning](https://github.com/espresso/rear/blob/master/docs/Setup.md#menu-positioning) |
+[Menu Grouping](https://github.com/espresso/rear/blob/master/docs/Setup.md#menu-grouping) |
+[ReadOnly Mode](https://github.com/espresso/rear/blob/master/docs/Setup.md#readonly-mode)
+
+
+### [Columns](https://github.com/espresso/rear/blob/master/docs/Columns.md)
+
+[Type](https://github.com/espresso/rear/blob/master/docs/Columns.md#column-types) |
+[Label](https://github.com/espresso/rear/blob/master/docs/Columns.md#columns-label) |
+[Radio/Checkbox/Select](https://github.com/espresso/rear/blob/master/docs/Columns.md#radiocheckboxselect-columns) |
+[Readonly/Disabled](https://github.com/espresso/rear/blob/master/docs/Columns.md#readonlydisabled-columns) |
+[Rows](https://github.com/espresso/rear/blob/master/docs/Columns.md#organizing-columns-by-rows) |
+[HTML Attributes](https://github.com/espresso/rear/blob/master/docs/Columns.md#html-attributes) |
+[Loading Data](https://github.com/espresso/rear/blob/master/docs/Columns.md#loading-data)<br>
+[Hiding Columns](https://github.com/espresso/rear/blob/master/docs/Columns.md#hiding-columns) |
+[Resetting Columns](https://github.com/espresso/rear/blob/master/docs/Columns.md#resetting-columns)
+
+
+### [Associations](https://github.com/espresso/rear/blob/master/docs/Assocs.md)
+
+[Columns List](https://github.com/espresso/rear/blob/master/docs/Assocs.md#columns-list) |
+[Ignored Associations](https://github.com/espresso/rear/blob/master/docs/Assocs.md#ignored-associations) |
+[Readonly Associations](https://github.com/espresso/rear/blob/master/docs/Assocs.md#readonly-associations)
+
+
+### [Filters](https://github.com/espresso/rear/blob/master/docs/Filters.md)
+
+[Type](https://github.com/espresso/rear/blob/master/docs/Filters.md#filter-types) |
+[Comparison Functions](https://github.com/espresso/rear/blob/master/docs/Filters.md#comparison-functions) |
+[Optioned Filters](https://github.com/espresso/rear/blob/master/docs/Filters.md#optioned-filters) |
+[Decorative Filters](https://github.com/espresso/rear/blob/master/docs/Filters.md#decorative-filters) |
+[Quick Filters](https://github.com/espresso/rear/blob/master/docs/Filters.md#quick-filters)
+
+### More
+
+[FileManager](https://github.com/espresso/rear/blob/master/docs/FileManager.md) |
+[Deploy](https://github.com/espresso/rear/blob/master/docs/Deploy.md) |
+[Demo](http://rear.rbho.me/)
+
+## Contributing
+
+  - Fork Rear repository
+  - Make your changes
+  - Submit a pull request
+
+### Author - [Silviu Rusu](https://github.com/slivu).  License - [MIT](https://github.com/espresso/rear/blob/master/LICENSE).

data/Rakefile

@@ -0,0 +1,79 @@
+require 'rake'
+require 'bundler/gem_helper'
+require './test/helpers'
+require './test/setup'
+
+def run orm, message = nil
+  
+  require './test/models/%s' % orm
+  Dir['./test/test__*.rb'].each { |f| require f }
+  Rear.mount! # initializing Rear controllers
+  puts message
+
+  session = Specular.new
+  session.boot { include Sonar }
+  session.before do |app|
+    include EASpecHelpers
+    if app && EUtils.is_app?(app)
+      app.mount
+      app(app)
+      map(app.base_url)
+      app.ipp(1000) if app.respond_to?(:ipp)
+    end
+  end
+  session.run /RearTest/
+  puts session.failures if session.failed?
+  puts session.summary
+  exit session.exit_code
+end
+
+def run_ar
+  run :ar, "\n***\n  Running ActiveRecord tests ..."
+end
+
+def run_dm
+  run :dm, "\n***\n  Running DataMapper tests ..."
+end
+
+def run_sq
+  run :sq, "\n***\n  Running Sequel tests ..."
+end
+
+desc 'Run ActiveRecord tests'
+task('test:ar') { run_ar }
+
+desc 'Run DataMapper tests'
+task('test:dm') { run_dm }
+
+desc 'Run Sequel tests'
+task('test:sq') { run_sq }
+
+desc 'Run All tests'
+task :test do
+  exitcode = 0
+  (pid = fork { run_ar }) && Process.wait(pid); exitcode += $?.exitstatus
+  (pid = fork { run_dm }) && Process.wait(pid); exitcode += $?.exitstatus
+  (pid = fork { run_sq }) && Process.wait(pid); exitcode += $?.exitstatus
+  exitcode == 0 || fail
+end
+
+namespace :assets do
+  desc 'Update css files to correctly load background images'
+  task :css do
+    puts "Looking for css files containing background(-image)?:url ..."
+    src = /background(\-image)?[\s+]?\:(.*?)url\((\W+)?([^\.]*)\.(\w+)(\W+)?\)/
+    dst = 'background\1:\2url(\3\4.\5%s\6)' % RearConstants::ASSETS__SUFFIX
+    Dir[File.expand_path('../assets/**/*.css', __FILE__)].each do |file|
+      css = File.read(file)
+      if css =~ src
+        puts "Updating #{file}"
+        File.open(file, 'w') {|f| f << css.gsub(src, dst)}
+      end
+    end
+    puts "Done"
+  end
+end
+
+task default: :test
+
+Bundler::GemHelper.install_tasks

data/assets/api.js

@@ -0,0 +1,307 @@
+RearAPI = function() {
+
+  var errorInstance;
+
+  this.switch_page = function(domSelector, url) {
+    $.ajax({
+      url:  url,
+      type: 'GET'
+    }).done(function(response) {
+      $(domSelector).html(response);
+    });
+  }
+
+  this.check_multiple = function(domSelector, sourceElement, isControlElement) {
+    var status = sourceElement.checked;
+
+    if(isControlElement)
+      return $(domSelector).prop('checked', status);
+    
+    if (event.shiftKey) { // if holding Shift, toggle elements before clicked one
+      $(domSelector).each(function(i,e) {
+        // break iteration when arriving at checked element
+        if(e == sourceElement) return false;
+        $(e).prop('checked', status);
+      });
+    } else if (event.altKey) { // if holding Alt, toggle elements after clicked one
+      var sourceElementFound = false;
+      $(domSelector).each(function(i,e) {
+        // moving to next element until arriving to checked one
+        if(e == sourceElement) return sourceElementFound = true;
+        if(sourceElementFound) $(e).prop('checked', status);
+      });
+    }
+  }
+
+  this.trigger_selectable = function(domSelector) {
+    // using select.selectable instead of just .selectable
+    // to avoid Select2 to apply twice when pages loaded by XHR.
+    // that's it, Select2 converts .selectable elements into divs,
+    // so select.selectable wont match converted elements anymore.
+    $(domSelector || 'select.selectable').each(function(i,e) {
+      if($(e).select2 == 'undefined') return false;
+      $(e).select2({width: 'resolve'});
+    });
+  }
+
+  this.trigger_hoverable = function(domSelector) {
+    $(domSelector || ".hoverable").hover(
+      function () { $(this).addClass("hoverable-hover") },
+      function () { $(this).removeClass("hoverable-hover") }
+    );
+  }
+
+  this.CRUD = function(objectID, baseURL, redirectURL, readonly) {
+    var objectID = objectID,
+      baseURL = baseURL,
+      redirectURL = redirectURL;
+
+    this.save = function() {
+      if(readonly) {
+        Rear.warn('ReadOnly Mode! Item Not Saved');
+        return false;
+      }
+      if (objectID > 0) {
+        var requestMethod = 'PUT',
+          url   = [baseURL, objectID].join('/'),
+          alert = "Item Successfully Updated";
+      } else {
+        var requestMethod = 'POST',
+          url   = baseURL,
+          alert = "Item Successfully Created";
+      }
+
+      $.ajax({
+        url:  url,
+        type: requestMethod,
+        data: $('#editor-main_form').serialize(),
+        complete: function(xhr) {
+          if(xhr.statusText == "OK") {
+            if (objectID > 0) {
+              if(errorInstance) errorInstance.close();
+              Rear.alert(alert);
+            } else {
+              localStorage['flash'] = alert;
+              window.location = [redirectURL, xhr.responseText].join('/');
+            }
+          } else Rear.error(xhr.responseText);
+        }
+      });
+    }
+
+    this.delete = function(redirectURL) {
+      if(readonly) {
+        Rear.warn('ReadOnly Mode! Item Not Deleted');
+        return false;
+      }
+      $.ajax({
+        url:  [baseURL, objectID].join('/'),
+        type: 'DELETE',
+        complete: function(xhr) {
+          if(xhr.statusText == "OK") {
+            localStorage['flash'] = "Item Successfully Deleted";
+            window.location = redirectURL;
+          } else Rear.error(xhr.responseText);
+        }
+      });
+    }
+
+    this.delete_selected = function(baseURL, redirectURL, readonly) {
+      if(readonly) {
+        Rear.warn('ReadOnly Mode! No Items Deleted');
+        return false;
+      }
+      var items = []
+      $('.pane-selected_item:checked').each(function(i,e) {
+        items.push($(e).val());
+      });
+      $.ajax({
+        url:  baseURL,
+        type: 'DELETE',
+        data: {items: items.join(' ')},
+        complete: function(xhr) {
+          if(xhr.statusText == "OK") {
+            localStorage['flash'] = "Selected Items Successfully Deleted";
+            window.location = redirectURL;
+          } else Rear.error(xhr.responseText);
+        }
+      });
+    }
+  }
+
+  this.BulkCRUD = function(baseURL) {
+
+    this.invoke = function(){
+      var form  = $('#bulk_editor-main_form');
+      if(!form) {
+        Rear.error('No form found for bulk editing');
+        return false;
+      }
+      
+      $.ajax({
+        url:  baseURL,
+        type: 'POST',
+        data: form.serialize(),
+        complete: function(xhr) {
+          if(xhr.statusText == 'OK') {
+            if(errorInstance) errorInstance.close();
+            Rear.sticky_alert(xhr.responseText);
+          } else
+            Rear.error(xhr.responseText);
+        }
+      });
+    }
+  }
+
+  this.Assoc = function(baseURL, domSelector, readonly) {
+    var urlArray = baseURL.split('?');
+    var     baseURL = urlArray[0],
+        queryString = urlArray[1],
+        domSelector = domSelector,
+           readonly = readonly;
+
+    this.load = function() {
+      this.load_attached();
+      this.load_detached();
+    }
+    this.load_attached = function(attacher) {
+      // queryString are used here only to pass assoc filters
+      // and it makes sense to apply assoc filters only on detached items
+      $.get(baseURL + '/true', function(response) {
+        $(domSelector.replace(/_detached$/, '')).html(response);
+        $('.pane-assoc-attacher').each(function(i,e) {
+          $(e).attr('checked', e == attacher);
+        });
+      });
+    }
+    this.load_detached = function(callback) {
+      $.get(baseURL, queryString, function(response) {
+        $(domSelector + '_detached').html(response);
+        callback && typeof(callback) === "function" && callback();
+      });
+    }
+
+    this.create = function(remoteID) {
+      if(readonly) {
+        Rear.warn('ReadOnly Relation! Any updates discarded');
+        return false;
+      }
+      invoke('POST', remoteID);
+    }
+    this.delete = function(remoteID) {
+      if(readonly) {
+        Rear.warn('ReadOnly Relation! Any updates discarded');
+        return false;
+      }
+      invoke('DELETE', remoteID);
+    }
+
+    var invoke = function(requestMethod, remoteID) {
+      $.ajax({
+        type: requestMethod,
+        url:  baseURL,
+        data: {target_item_id: remoteID},
+        complete: function(xhr, txtResponse) {
+          if(txtResponse == 'success') {
+            Rear.alert('Relation Updated');
+          } else {
+            if(xhr.status == 400)
+              Rear.warn(xhr.responseText);
+            else if(xhr.status == 500)
+              Rear.error(xhr.responseText);
+          }
+        }
+      });
+    }
+
+  }
+
+  this.Filters = function(domID, url) {
+    var domID = domID, url = url;
+
+    this.apply = function() {
+      invoke(
+        '#' + domID,
+        $('#pane-filters-form-' + domID).serialize()
+      );
+    }
+
+    this.reset = function() {
+      invoke('#' + domID, {});
+    }
+
+    this.update = function() {
+      invoke(
+        '#pane-filters-input-' + domID,
+        $('#pane-filters-form-' + domID).serialize()
+      );
+    }
+
+    var invoke = function(domSelector, data) {
+      $.ajax({
+        url:  url, type: 'GET', data: data
+      }).done(function(response) {
+        $(domSelector).html(response);
+      });
+    }
+  }
+
+  this.alert = function(msg, timeout) {
+    noty({
+      text:    msg,
+      type:    'information',
+      layout:  'topRight',
+      timeout: timeout || 2000
+    });
+  }
+
+  this.sticky_alert = function(msg) {
+    noty({
+      text:    msg,
+      type:    'information',
+      layout:  'topRight'
+    });
+  }
+
+  this.warn = function(msg, timeout) {
+    noty({
+      text:    msg,
+      type:    'warning',
+      layout:  'topRight',
+      timeout: timeout || 3000
+    });
+  }
+
+  this.sticky_warn = function(msg) {
+    noty({
+      text:    msg,
+      type:    'warning',
+      layout:  'topRight'
+    });
+  }
+
+  this.error = function(msg) {
+    msg = msg.replace(/</gm, '&lt;').replace(/>/gm, '&gt;').
+      replace(/\n|\r/gm, '<br>').replace(/\t/gm, '&nbsp;&nbsp;');
+    errorInstance = noty({
+      text: '<div style="text-align: left; max-height: 280px; overflow: auto;">' + msg + '</div>',
+      type: 'warning', layout:  'top', modal:   true, closeWith: ['button'],
+      buttons: [
+        {addClass: 'btn btn-primary', text: 'Close', onClick: function($noty) {
+            $noty.close();
+          }
+        }
+      ]
+    });
+  }
+
+}
+
+Rear = new RearAPI();
+
+$(function(){
+  if(localStorage['flash']) {
+    Rear.alert(localStorage['flash']);
+    localStorage.removeItem('flash');
+  }
+});