app_kit 0.0.1

data/app/assets/stylesheets/app_kit/tables.scss

@@ -0,0 +1,59 @@
+table {
+    margin: ($base-line-height / 2) 0;
+    table-layout: fixed;
+    width: 100%;
+    border-collapse: collapse;
+
+    th {
+      border-bottom: 1px solid darken($base-border-color, 15%);
+      font-weight: bold;
+      padding: ($base-line-height / 2) 0;
+      text-align: left;
+    }
+
+    td {
+      border-bottom: 1px solid $base-border-color;
+      padding: ($base-line-height / 2) 0;
+    }
+
+    td, th {
+      vertical-align: middle;
+      font-family: $base-font-family;
+      color: $base-font-color;
+      font-size: $base-font-size;
+    }
+    td.actions {
+        text-align:right;
+        a {
+            color: #666;
+        }
+        a:hover {
+            color: #000;
+        }
+    }
+}
+
+div.keyval {
+    div.kv-row {
+        span.kv-key, span.kv-value {
+            font-family: $base-font-family;
+            font-size: $base-font-size;
+        }
+        span.kv-key {
+            display: inline-block;
+            width: 250px;
+            color: $property-header-color;
+        }
+        span.kv-value {
+            display: inline-block;
+            width: 150px;
+            color: $property-value-color;
+            a:after {
+                padding-left: 5px;
+                font-family: FontAwesome;
+                content: "\f0da";
+            }
+        }
+
+    }
+}

data/app/assets/stylesheets/app_kit/versions.css.scss

@@ -0,0 +1,41 @@
+.version-list {
+  width: 500px;
+  margin: auto auto;
+  .version {
+    @include transition(all, 0.5s);
+    display: block;
+    padding: 10px 15px;
+    border-radius: 4px;
+    background: white;
+    border: 1px solid #eee;
+    color: #555;
+    padding-bottom: 10px;
+    .glyph {
+      display: inline-block;
+      margin-right: 10px;
+      color: #ccc;
+    }
+    .title {
+      display: inline-block;
+      font-weight: 500;
+    }
+    .detail {
+      display: inline-block;
+      font-size: 0.8em;
+      color: #888;
+      padding: 0px 10px;
+    }
+  }
+  a.version:hover {
+    background: #FEFAE5;
+    border-color: darken(#FEFAE5,10);
+  }
+}
+.version-arrow {
+  width: 64px;
+  height: 48px;
+  margin: auto auto;
+  background-image: url(asset-path('app_kit/history-arrow.png'));
+  background-repeat: no-repeat;
+  background-size: cover;
+}

data/app/assets/stylesheets/simple.css.scss

@@ -0,0 +1,82 @@
+body.simple {
+  .flash-notice {
+    margin-bottom: 20px;
+  }
+  h1 {
+    text-align:left;
+    font-weight: bold;
+    font-size: 1.8em;
+    padding-left: 15px;
+    color: #444;
+    margin-bottom: 5px;
+  }
+  background: #eee;
+  padding-top: 50px;
+  .simple-container {
+    @include outer-container;
+    margin-bottom: 20px;
+  }
+  .empty-panel {
+    @include span-columns(4);
+    @include shift(4);
+    text-align: center;
+    a {
+      @include transition(all, 0.5s);
+      color: #999;
+      display: block;
+      text-align: center;
+      padding: 5px 15px;
+      border: 1px solid #ccc;
+      border-radius: 4px;
+      &:hover {
+        background: #e0e0e0;
+      }
+    }
+  }
+  .simple-panel {
+    @include span-columns(4);
+    @include shift(4);
+    @include pad;
+    background: #fff;
+    margin-bottom: 30px;
+    font-family: $base-font-family;
+    box-shadow: 1px 1px 1px darken($base-background-color, 10);
+    border-bottom: 1px solid #ccc;
+    border-radius: 10px;
+    background: #fefefe;
+    font-size: $base-font-size;
+    line-height: auto;
+    a {
+      margin-top: 10px;
+      color: #888;
+      display: block;
+      text-align: center;
+    }
+    a:hover {
+      color: #121212;
+    }
+    h2 {
+      font-size: 1.0em;
+      text-transform:uppercase;
+      color: #ccc;
+      text-align: right;
+    }
+    form {
+      margin-top: 20px;
+      label {
+        color: #888;
+        font-size: 0.8em;
+        margin-bottom: 0px;
+        display: inline;
+      }
+      input {
+        margin-top: 0px;
+      }
+      input[type=submit] {
+        width: 100%;
+        margin-top: 20px;
+        margin-bottom: 20px;
+      }
+    }
+  }
+}

data/app/controllers/app_kit/application_controller.rb

@@ -0,0 +1,4 @@
+module AppKit
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/controllers/app_kit/dashboard_controller.rb

@@ -0,0 +1,9 @@
+require_dependency "app_kit/application_controller"
+
+module AppKit
+  class DashboardController < ApplicationController
+    def show
+      @dashboard = AppKit.application.dashboard_view
+    end
+  end
+end

data/app/controllers/app_kit/resources_controller.rb

@@ -0,0 +1,207 @@
+module AppKit
+  # The base resource controller. This controller contains all the
+  # functionality for REST actions for all resources. Resource specific
+  # controllers are generated that inherit from this class. It should not
+  # be nessicary to use this class directly.
+  class ResourcesController < ApplicationController
+    # Stores the resource object this controller manages.
+    class_attribute :resource
+    layout 'app_kit/application'
+
+    # respond to html and json for api calls.
+    respond_to :html, :json, :xml, :csv
+
+    # Setup a instance variable for the model
+    before_action :find_record, only: [:show, :edit, :update, :history,
+                                       :destroy, :perform_action]
+
+    # GET /resource
+    # Lists all records for an invoice.
+    def index
+      filter_params = params["#{model.name.underscore}_filter"].try(:first)
+      @records = process_filters(model, filter_params)
+      # page resources if the request is for html. For JSON and XML we will
+      # return the entire recordset
+      @records = @records.page(get_page)
+      respond_with(@records)
+    end
+
+    # GET /resource/new
+    # Renders new form for a given resource.
+    def new
+      @record = model.new
+      # call before actions created in the DSL
+      if resource.before_actions[:new]
+        resource.before_actions[:new].call(@record)
+      end
+    end
+
+    # POST /resource
+    # Creates a new resource record if valid, renders new form if not.
+    def create
+      @record = model.new(record_params)
+      # call before actions created in the DSL
+      if resource.before_actions[:create]
+        resource.before_actions[:create].call(@record)
+      end
+      if @record.save
+        redirect_to polymorphic_path([app_kit, @record])
+      else
+        puts @record.errors.full_messages.inspect
+        render 'new'
+      end
+    end
+
+    # GET /resource/:id
+    # Shows the details of a given resource.
+    def show
+      instance_exec(&resource.before_actions[:show]) if resource.before_actions[:show]
+    end
+
+
+    # GET /resource/:id/edit
+    # Shows the edit form for a given resource.
+    def edit
+      resource.before_actions[:edit].call(@record) if resource.before_actions[:edit]
+    end
+
+    # PATCH /resource/:id
+    # Updates a given resource if valid, renders the edit form if not.
+    def update
+      flash[:success] = "Record updated successfully."
+      # call before actions created in the DSL
+      if resource.before_actions[:update]
+        resource.before_actions[:update].call(@record)
+      end
+      if @record.update(record_params)
+        redirect_to polymorphic_path([app_kit, @record])
+      else
+        render 'edit'
+      end
+    end
+
+
+    # DELETE /resource/:id
+    # Deletes a given resource and redirects to index.
+    def destroy
+      if @record.destroy
+        flash[:success] = "Record deleted successfully."
+        redirect_to polymorphic_path([app_kit, model])
+      end
+    end
+
+    def history; end
+
+    def version
+      version_index = params[:version_id].to_i
+      @record =  model.find_by_id(params[:id]).versions[version_index].reify(dup:true)
+      render 'show'
+    end
+
+    def show_version
+      version = PaperTrail::Version.find(params[:version_id])
+      @record = version.reify
+      render 'show'
+    end
+
+    # GET /resource/:id/:action_name
+    # A catchall action for any custom actions defined in the DSL.
+    # The action name is passed by the route as a param and a block
+    # given in the DSL is called (with the record instance).
+    #
+    # Actions can be defined using blocks are a symbol name of a method
+    # in the model.
+    def perform_action
+      action_name = params[:action_name].to_sym
+      action = resource.member_actions[action_name]
+      if action.is_method_action?
+        @record.send(action.method_name)
+      end
+      if action.is_block_action?
+        action.block.call(@record)
+      end
+      return redirect_to([app_kit, @record])
+    end
+
+    private
+
+    def get_page
+      params[:page] || 1
+    end
+
+    # Whitelisting for all fields marked as +editable+ in the dsl.
+    def record_params
+      fields = resource.editable_fields.map(&:name)
+      params.require(model.model_name.param_key.underscore.to_sym).permit(fields)
+    end
+
+    # A generic before_action method to set an instance variable for the
+    # current record.
+    def find_record
+      @record ||= model.find_by_id(params[:id])
+    end
+
+    # A helper method that returns the AppKit::Resource object tied to the
+    # current controller.
+    def resource
+      self.class.resource
+    end
+    helper_method :resource
+
+    # A helper method to retrieve the model classs based on the current
+    # controller's class name.
+    def model
+      @model ||= resource.model
+    end
+    helper_method :model
+
+    def has_namespace?
+      model.name.deconstantize != ""
+    end
+
+    # helper method to resolve the url for forms, between edit and new
+    def form_url(record)
+      if has_namespace?
+        [app_kit, model.name.deconstantize.underscore.to_sym, record]
+      else
+        [app_kit, record]
+      end
+    end
+    helper_method :form_url
+
+    # A helper method to display the current resource name.
+    def resource_name
+      controller_name.humanize
+    end
+    helper_method :resource_name
+
+
+    # handles record filtering passed by the filter panel
+    def process_filters(records,filter_params)
+      return records unless filter_params
+      filter_params.each do |field,filter_param|
+        if filter_param.has_key?("value")
+          value = filter_param["value"]
+          next unless value.present?
+          condition = filter_param["condition"] || 'eq'
+          case condition
+          when "eq"
+            value = true if value == 'true'
+            value = [false, nil] if value == 'false'
+            records = records.where(field.to_sym => value)
+          when "cont"
+            records = records.where("#{field} LIKE '%#{value}%'")
+          when "ncont"
+            records = records.where("#{field} NOT LIKE '%#{value}%'")
+          when "gt"
+            records = records.where("#{field} > ?", value)
+          when "lt"
+            records = records.where("#{field} < ?", value)
+          end
+        end
+      end
+      return records
+    end
+
+  end
+end

data/app/helpers/app_kit/application_helper.rb

@@ -0,0 +1,4 @@
+module AppKit
+  module ApplicationHelper
+  end
+end

data/app/helpers/app_kit/attribute_helper.rb

@@ -0,0 +1,71 @@
+module AppKit
+    module AttributeHelper
+        include FontAwesome::Sass::Rails::ViewHelpers
+
+        # General helpers for dealing with field columns
+
+        def format_string(record, attribute, val)
+            val
+        end
+
+        def format_currency(record,attribute,val)
+          number_to_currency(val) || "$0.00"
+        end
+
+        def format_date(record,attribute,val)
+            val.strftime('%m/%d/%y')
+        end
+
+        def format_boolean(record, attribute, val)
+            (val ? icon('toggle-on') : icon('toggle-off'))
+        end
+
+        def format_phone(record, attribute, val)
+            number_to_phone(val)
+        end
+
+        def format_email(record, attribute, val)
+            mail_to val
+        end
+
+        def format_integer(record, attribute, val)
+            number_with_delimiter val
+        end
+
+        def format_decimal(record,attribute, val)
+            number_with_delimiter val
+        end
+
+        def format_datetime(record,attribute, val)
+            val.strftime('%m/%d/%y %l:%m %p')
+        end
+
+        def format_attribute(record,field)
+            if field.is_foreign_key?
+                associated_record = record.send(field.association.name)
+                return link_to associated_record, [app_kit, associated_record]
+            end
+            if field.enum
+              return field.enum[record.send(field.name).to_sym]
+            end
+            formatter = field.formatter
+            format_method = "format_#{formatter}"
+            if self.respond_to?(format_method)
+              return send(format_method, record,
+                          field.name,
+                          field.value_for_record(record))
+            end
+            return record.send(field.name)
+
+        end
+
+        def detect_attribute_type(record,attribute)
+            record.class.columns_hash[attribute.to_s].type ||
+              resource.formatters.has_key(attribute.to_sym)
+        end
+
+        def get_editor_for_attribute(attribute)
+            resource.editors[attribute.to_sym]
+        end
+    end
+end

data/app/helpers/app_kit/dashboard_helper.rb

@@ -0,0 +1,4 @@
+module AppKit
+  module DashboardHelper
+  end
+end

data/app/helpers/app_kit/filter_helper.rb

@@ -0,0 +1,109 @@
+module AppKit::FilterHelper
+
+  # create form fields for side bar filtering.
+  # @param search_form [Ransack::SearchForm] The search form object.
+  # @param field [AppKit::Field] The field to create filters for.
+  # @param The search instance from ransack (usually %q)
+  def filter_field(search_form, field, search_instance)
+    case field.data_type
+    when :boolean
+      search_form.select "#{field.name}_eq",
+        boolean_select_options, prompt: 'Any'
+    when :datetime
+      content_tag :div, class: 'range-filter date-range' do
+        concat search_form.search_field("#{field.name}_gteq", placeholder: 'from')
+        concat search_form.search_field("#{field.name}_lt", placeholder: 'to')
+      end
+    when :string
+      predicate = get_field_predicate(search_instance,field,'cont')
+      options = string_predicate_options(search_instance, field)
+      predicate_select = select_tag("#{field.name}_predicate",options)
+      search_field = filter_search_field(search_form, field, predicate)
+      content_tag :div, class: 'predicate-filter' do
+        concat content_tag(:div, predicate_select, class: 'predicate-select')
+        concat content_tag(:div, search_field, class: 'value')
+      end
+    when :integer, :decimal
+      if field.is_foreign_key?
+        search_form.collection_select field.name,
+          field.association.klass.all, :id, :to_s,
+          prompt: 'Any'
+      else
+        predicate = get_field_predicate(search_instance, field, 'eq')
+        options = number_predicate_options(search_instance, field)
+        predicate_select = select_tag("#{field.name}_predicate",options)
+        search_field = filter_search_field(search_form, field, predicate)
+        content_tag :div, class: 'predicate-filter' do
+          concat content_tag(:div, predicate_select, class: 'predicate-select')
+          concat content_tag(:div, search_field, class: 'value')
+        end
+      end
+    else
+      predicate = get_field_predicate(search_instance,field,'cont')
+      options = string_predicate_options(search_instance, field)
+      predicate_select = select_tag("#{field.name}_predicate",options)
+      search_field = filter_search_field(search_form, field, predicate)
+      content_tag :div, class: 'predicate-filter' do
+        concat content_tag(:div, predicate_select, class: 'predicate-select')
+        concat content_tag(:div, search_field, class: 'value')
+      end
+    end
+  end
+
+  # Returns select options for boolean filters
+  def boolean_select_options(val=nil)
+    options_for_select([['Yes', 1], ['No', 0]], val)
+  end
+
+  # Get current search instance predicate or return default value.
+  # @param search_instance [Ransack Search Instance] usually %q.
+  # @param field [AppKit::Field] field to check.
+  # @param default [String] the default value if none is found.
+  def get_field_predicate(search_instance,field,default)
+    search_instance.conditions.find {|i|
+      i.attributes.first.name == field.name.to_s
+    }.try(:predicate).try(:name) || default
+  end
+
+  # Condition select options for string based fields.
+  # @param search_instance [Ransack Search Instance] usually %q
+  # @param field [AppKit::Field] the field to generate a filter for.
+  def string_predicate_options(search_instance, field)
+    predicate = get_field_predicate(search_instance,field,'cont')
+    options = [['contains', 'cont'],["doesn't contain", 'not_cont']]
+    options_for_select(options,predicate)
+  end
+
+  # Condition select options for number based fields.
+  # @param search_instance [Ransack Search Instance] usually %q
+  # @param field [AppKit::Field] the field to generate a filter for.
+  def number_predicate_options(search_instance,field)
+    predicate = get_field_predicate(search_instance,field,'eq')
+    options = [
+      ['equals', 'eq'],["not equal", 'not_eq'],
+      ['greater than', 'gt'], ['less than', 'lt']
+    ]
+    options_for_select(options,predicate)
+  end
+
+  # Creates the search field for filters.
+  # @params search_form ransack form builder
+  # @param field [AppKit::Field] the field to generate a filter for.
+  # @param predicate [String] the predicate condition.
+  def filter_search_field(search_form, field, predicate)
+    search_method = "#{field.name}_#{predicate}"
+    css = ""
+    css = "datepicker" if field.data_type == :date || field.data_type == :datetime
+    search_form.search_field  search_method.to_sym,
+      "data-field" => field.name.to_s
+  end
+
+  def filter_form_for(resource, *args, &block)
+    options = args.extract_options!
+    options.update(:builder => AppKit::FilterFormBuilder)
+    options.update(:url => ak_path(resource.model))
+    options.update(:method => 'get')
+    form_for(resource.model.name, options, &block)
+  end
+
+end

data/app/helpers/app_kit/history_helper.rb

@@ -0,0 +1,20 @@
+module AppKit::HistoryHelper
+  def version_url(version)
+    unless version.event == "destroy" || version.item == nil
+      if version.index == version.item.versions.length - 1
+        ak_path(version.item)
+      else
+        polymorphic_path([app_kit, :version, version.item],
+                         version_id: version.index + 1)
+      end
+    end
+  end
+  def show_version_path(record, version, count)
+    if version.index == record.versions.length - 1
+      ak_path(record)
+    else
+      polymorphic_path([app_kit, :version, @record],
+                       version_id: version.index + 1)
+    end
+  end
+end

data/app/helpers/app_kit/navigation_helper.rb

@@ -0,0 +1,29 @@
+module AppKit::NavigationHelper
+  def resource_navigation_link(resource)
+    cls = ""
+    if params[:controller] == "app_kit/#{resource.controller_name}"
+      cls << "active "
+    end
+    link_to ak_path(resource.model), class: cls do
+      if resource.navigation_icon
+        concat icon(resource.navigation_icon, nil, class: 'fa-fw')
+      end
+      concat resource.plural_display_name
+    end
+  end
+
+  def custom_navigation_link(item)
+    cls = ""
+    cls = "active" if params[:controller].to_s == item.controller.to_s
+    link_to icon(item.icon,item.title), main_app.send("#{item.path_helper}_path"), class: cls
+  end
+
+  def navigation_link(item)
+    if item.has_resource?
+      resource_navigation_link(item.resource)
+    else
+      custom_navigation_link(item)
+    end
+  end
+
+end

data/app/helpers/app_kit/path_helper.rb

@@ -0,0 +1,13 @@
+module AppKit::PathHelper
+  # Convienence method for using AppKit path helpers. This method uses
+  # polymorphic_paths and prepends the AppKit route object.
+  # @params path [Array,Object] a polymorphic path option.
+  def ak_path(path, options={})
+    if path.is_a? Array
+      path.prepend app_kit
+    else
+      path = [app_kit, path]
+    end
+    polymorphic_path(path, options)
+  end
+end

data/app/helpers/app_kit/resource_helper.rb

@@ -0,0 +1,5 @@
+module AppKit::ResourceHelper
+  def get_page
+    params[:page] || 1
+  end
+end

data/app/helpers/app_kit/table_helper.rb

@@ -0,0 +1,13 @@
+module AppKit::TableHelper
+  def data_download_link(item, format)
+    filter_label = "#{item.resource.model.name.underscore}_filter"
+    link_to format.to_s.upcase,
+      ak_path(item.resource.model,
+              :format => format, filter_label.to_sym => params[filter_label])
+  end
+
+  def resource_table(resource, records, page)
+    table = AppKit::Views::Table.new(resource, records: records, page: page)
+    render 'app_kit/table', item: table
+  end
+end

data/app/inputs/boolean_input.rb

@@ -0,0 +1,5 @@
+class BooleanInput < SimpleForm::Inputs::CollectionSelectInput
+     def skip_include_blank?
+         true
+     end
+end