templet_rails 0.1.0

data/lib/generators/templet/shared/grand_parent_option.rb

@@ -0,0 +1,20 @@
+
+module Shared
+  module GrandParentOption
+    def self.included(base)
+      desc = "The parent's dependent - the record type the parent belongs to"
+
+      base.class_eval do
+        class_option 'grand-parent', type: :string, aliases: "-g",
+                                     banner: 'singular name',
+                                     default: '', desc: desc
+      end
+    end
+
+    private
+
+    def grand_parent
+      options['grand-parent'].present? ? options['grand-parent'] : nil
+    end
+  end
+end

data/lib/generators/templet/shared/model_fields.rb

@@ -0,0 +1,55 @@
+
+module Shared
+  module ModelFields
+    private
+
+    def model_fields(model_name)
+      if klass = model_class(model_name)
+        klass.column_names.reject do |name|
+          %w(id created_at updated_at).include? name
+        end
+      else
+        []
+      end
+    end
+
+    def textual_field_with_tag(model_name)
+      name, type = field_with_type(model_name, %i(string text))
+
+      return name, (type == :text ? 'textarea' : 'input')
+    end
+
+    #
+
+    def field_with_type(model_name, types)
+      names_to_types = model_types(model_fields model_name)
+
+      types.each do |wanted_type|
+        names_to_types.each do |(name, type)|
+          return name, type if type == wanted_type
+        end
+      end
+      nil
+    end
+
+    def model_types(model_fields)
+      model_fields.map do |name|
+        type = model_field_type(model_name, name)
+
+        [ name.to_sym, type.to_sym ]
+      end
+    end
+
+    def model_field_type(model_name, field_name)
+      if klass = model_class(model_name)
+        column = klass.columns.detect {|column| column.name == field_name.to_s }
+
+        column&.type
+      end
+    end
+
+    def model_class(name)
+      name.classify.constantize rescue nil
+    end
+  end
+end

data/lib/generators/templet/shared/model_option.rb

@@ -0,0 +1,25 @@
+
+module Shared
+  # Passed as model, but becomes model_name
+  module ModelOption
+    def self.included(base)
+      desc = "The model to use inside the controller (instance variable and class)"
+
+      base.class_eval do
+        class_option :model, type: :string, aliases: "-m",
+                             banner: 'singular name',
+                             default: '', desc: desc
+      end
+    end
+
+    private
+
+    def model_name
+      model_name? ? options['model'] : singular_name
+    end
+
+    def model_name?
+      options['model'].present?
+    end
+  end
+end

data/lib/generators/templet/shared/parent_option.rb

@@ -0,0 +1,20 @@
+
+module Shared
+  module ParentOption
+    def self.included(base)
+      desc = "The model's dependent - the record type the model belongs_to"
+
+      base.class_eval do
+        class_option :parent, type: :string, aliases: "-p",
+                              banner: 'singular name',
+                              default: '', desc: desc
+      end
+    end
+
+    private
+
+    def parent
+      options['parent'].present? ? options['parent'] : nil
+    end
+  end
+end

data/lib/generators/templet/templates/controller.rb.erb

@@ -0,0 +1,108 @@
+
+class <%= class_name.pluralize %>Controller < ApplicationController
+  include Templet::ViewerResponders
+<%= before_action parent -%>
+<%= before_action model_name, set_model_actions if set_model? -%>
+
+<% if include_action? :index -%>
+  # GET /<%= path_controller %>
+  # GET /<%= path_controller %>.json
+  def index
+    @<%= model_plural %> = <%= receiver %>.all
+
+    respond_to_index
+  end
+
+<% end -%>
+<% if include_action? :show -%>
+  # GET /<%= path_controller '1' %>
+  # GET /<%= path_controller '1' %>.json
+  def show
+    respond_to_show
+  end
+
+<% end -%>
+<% if include_action? :new -%>
+  # GET /<%= path_controller 'new' %>
+  def new
+    @<%= model_name %> = <%= receiver %>.new
+
+    respond_to_new
+  end
+
+<% end -%>
+<% if include_action? :edit -%>
+  # GET /<%= path_controller %w(1 edit) %>
+  def edit
+    respond_to_edit
+  end
+
+<% end -%>
+<% if include_action? :create -%>
+  # POST /<%= path_controller '1' %>
+  # POST /<%= path_controller '1' %>.json
+  def create
+    @<%= model_name %> = <%= receiver %>.new(<%= model_name %>_params)
+
+    if @<%= model_name %>.save
+      respond_to_save_success(@<%= model_name %>, <%= redirect_path %>)
+    else
+      respond_to_save_failure(:new, @<%= model_name %>)
+    end
+  end
+
+<% end -%>
+<% if include_action? :update -%>
+  # PATCH/PUT /<%= path_controller '1' %>
+  # PATCH/PUT /<%= path_controller '1' %>.json
+  def update
+    if @<%= model_name %>.update(<%= model_name %>_params)
+      respond_to_save_success(@<%= model_name %>, <%= redirect_path %>)
+    else
+      respond_to_save_failure(:edit, @<%= model_name %>)
+    end
+  end
+
+<% end -%>
+<% if include_action?(:delete) or include_action?(:destroy) -%>
+  # DELETE /<%= path_controller '1' %>
+  # DELETE /<%= path_controller '1' %>.json
+  def destroy
+    @<%= model_name %>.destroy
+
+    respond_to_destroy(@<%= model_name %>, <%= redirect_path(false) %>)
+  end
+
+<% end -%>
+  private
+<% if parent -%>
+
+  def set_<%= parent %>
+    @<%= parent %> = <%= parent.classify %>.find(params[:<%= parent %>_id])
+  end
+<% end -%>
+<% if set_model? -%>
+
+  def set_<%= model_name %>
+    @<%= model_name %> = <%= receiver %>.find(params[:id])
+  end
+
+  def <%= model_name %>_params
+    params.require(:<%= model_name %>).permit(*<%= model_name %>_fields)
+  end
+
+  def <%= model_name %>_fields
+    %i(<%= model_fields(model_name).join ' ' %>)
+  end
+<% end -%>
+<% if model_name? -%>
+
+  def model_name
+    :<%= model_name %>
+  end
+<% end -%>
+
+  def viewer_options
+    super.merge({ <%= to_option :parent, parent %><%= to_option :grand_parent, grand_parent, ', ' %> })
+  end
+end

data/lib/generators/templet/templates/core/app/base_viewer.rb

@@ -0,0 +1,7 @@
+
+module App
+  class BaseViewer < Templet::ViewerRest
+    include Panel::OptionsConfig
+  end
+end
+

data/lib/generators/templet/templates/core/app/link_sets/navbar.rb

@@ -0,0 +1,12 @@
+
+module App
+  module LinkSets
+    class Navbar < Templet::Links::BsLinkSetCollection
+      def call(action=nil)
+        super.tap do |links|
+        end
+      end
+    end
+  end
+end
+

data/lib/generators/templet/templates/core/app/panel/flash_messages.rb

@@ -0,0 +1,33 @@
+
+module App
+  module Panel
+    # Shows flash messages in a Bootstrap alert - inside a Bootstrap grid
+    class FlashMessages < Templet::Component::Partial
+      include Templet::Mixins::Bs::Grid
+
+      BUTTON_ATTS = { class: "close",
+                      data_dismiss: "alert",
+                      aria_hidden: "true" }
+
+      def call(**column_opts)
+        super() do
+          if flash.any?
+            in_rows renderer, **column_opts do
+              flash.map do |name, message|
+                if message.is_a?(String)
+                  alert_name = name.to_s == 'notice' ? 'success' : 'danger'
+
+                  div "alert alert-dismissible alert-#{alert_name}" do
+                    [ button('&times;', BUTTON_ATTS),
+                      div(message, id: "flash_#{name}") ]
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/generators/templet/templates/core/app/panel/layout_base.rb

@@ -0,0 +1,40 @@
+
+module App
+  module Panel
+    # Renders a navbar, flash messages and yielded content in Bootstrap grid
+    class LayoutBase < Templet::Component::Partial
+      include Templet::Mixins::Bs::Grid
+
+      def call(action, **options)
+        super() do
+          js_target_div :outer,
+                        navbar(*options[:nav_args]),
+                        messages,
+                        in_rows(renderer, yield(renderer), **bs_column_opts)
+        end
+      end
+
+      private
+
+      # Adds a surrounding div tag, whose content is replaced in JS requests
+      def js_target_div(suffix, *content)
+        renderer.call do
+          div(id: "panel-#{suffix}") { content }
+        end
+      end
+
+      def bs_column_opts
+        { cols: 10, offset: 1 }
+      end
+
+      def messages
+        FlashMessages.new(renderer).(**bs_column_opts)
+      end
+
+      def navbar(*args)
+        Nav.new(renderer).(*args)
+      end
+    end
+  end
+end
+

data/lib/generators/templet/templates/core/app/panel/layout_header.rb

@@ -0,0 +1,22 @@
+
+module App
+  module Panel
+    # Renders a heading with a title, subtitle and perhaps something on right
+    class LayoutHeader < LayoutBase
+      def call(action, **options)
+        args = options.values_at :title, :subtitle, :header_right
+
+        super { [ header(*args), yield(renderer) ] }
+      end
+
+      def header(title, subtitle, on_right)
+        renderer.call do
+          div :page_header do
+            [ div(on_right, :pull_right), h1([title, small(subtitle)]) ]
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/generators/templet/templates/core/app/panel/layout_header_sidebar.rb

@@ -0,0 +1,18 @@
+
+module App
+  module Panel
+    # Renders a given sidebar
+    class LayoutHeaderSidebar < LayoutHeader
+      def call(action, **options)
+        side_cols = options[:sidebar_cols] || 2
+        main_cols = 12 - side_cols
+
+        super do
+          in_cols renderer, side_cols => options[:sidebar_content],
+                            main_cols => js_target_div(:inner, *yield(renderer))
+        end
+      end
+    end
+  end
+end
+

data/lib/generators/templet/templates/core/app/panel/nav.rb

@@ -0,0 +1,55 @@
+
+module App
+  module Panel
+    # Renders a Bootstrap navbar, with a title and some links on right
+    class Nav < Templet::Component::Partial
+      NAVBAR_CLASS = "navbar navbar-default"
+      BUTTON_ID = "bs-navbar-collapse-1"
+
+      def call(title, links, before: nil, after: nil)
+        super() do
+          nav role: "navigation", class: NAVBAR_CLASS do
+            div "container-fluid"  do
+              [ nav_header(title),
+                before,
+                nav_collapse(links),
+                after ]
+            end
+          end
+        end
+      end
+
+      private
+
+      def nav_header(title)
+        brand_atts = { class: 'navbar-brand', style: 'font-size: large' }
+
+        renderer.call do
+          div "navbar-header page-scroll" do
+            [ button(button_spans, button_atts),
+              link_to(title, root_path, brand_atts) ]
+          end
+        end
+      end
+      def button_spans
+        "<span class='sr-only'>Toggle navigation</span>\n" +
+          "<span class='icon-bar'></span>\n" * 3
+      end
+      def button_atts
+        { type: 'button',  class: "navbar-toggle",
+          data_toggle: "collapse", data_target: "##{BUTTON_ID}" }
+      end
+
+      def nav_collapse(links)
+        if links
+          renderer.call do
+            div "collapse navbar-collapse", id: BUTTON_ID do
+              ul links, "nav navbar-nav navbar-right"
+            end
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/generators/templet/templates/core/app/panel/nav_args_option.rb

@@ -0,0 +1,30 @@
+
+module App
+  module Panel
+    module NavArgsOption
+      private
+
+      def panel_options(renderer=nil, **options)
+        super renderer, options.merge(nav_args: nav_args(renderer))
+      end
+
+      def nav_args(renderer)
+        return page_title, navbar_links(renderer)
+      end
+
+      def navbar_links(renderer)
+        Templet::Utils::LinkSetFactory
+          .new(renderer, action, navbar_links_class, navbar_links_options)
+      end
+
+      def navbar_links_class
+        App::LinkSets::Navbar
+      end
+
+      def navbar_links_options
+        { html_class: '', remote: nil, wrapper: :li }
+      end
+    end
+  end
+end
+