tiny_admin 0.1.0

data/lib/tiny_admin/settings.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  class Settings
+    include Singleton
+    include Utils
+
+    attr_accessor :authentication,
+                  :components,
+                  :extra_styles,
+                  :navbar,
+                  :page_not_found,
+                  :record_not_found,
+                  :repository,
+                  :root,
+                  :root_path,
+                  :sections,
+                  :scripts,
+                  :style_links
+
+    attr_reader :pages, :resources
+
+    def load_settings
+      @authentication ||= {}
+      @authentication[:plugin] ||= Plugins::NoAuth
+      @authentication[:login] ||= Views::Pages::SimpleAuthLogin
+      @authentication[:plugin] = Object.const_get(authentication[:plugin]) if authentication[:plugin].is_a?(String)
+
+      @page_not_found ||= Views::Pages::PageNotFound
+      @page_not_found = Object.const_get(@page_not_found) if @page_not_found.is_a?(String)
+      @record_not_found ||= Views::Pages::RecordNotFound
+      @record_not_found = Object.const_get(@record_not_found) if @record_not_found.is_a?(String)
+
+      @pages ||= {}
+      @repository ||= Plugins::ActiveRecordRepository
+      @resources ||= {}
+      @root_path ||= '/admin'
+      @sections ||= []
+
+      @root ||= {}
+      @root[:title] ||= 'TinyAdmin'
+      @root[:path] ||= root_path
+      @root[:page] ||= Views::Pages::Root
+
+      if @authentication[:plugin] == Plugins::SimpleAuth
+        @authentication[:logout] ||= ['logout', "#{root_path}/auth/logout"]
+      end
+
+      @components ||= {}
+      @components[:flash] ||= Views::Components::Flash
+      @components[:head] ||= Views::Components::Head
+      @components[:navbar] ||= Views::Components::Navbar
+      @components[:pagination] ||= Views::Components::Pagination
+
+      @navbar = prepare_navbar(sections, root_path: root_path, logout: authentication[:logout])
+    end
+
+    def prepare_navbar(sections, root_path:, logout:)
+      items = sections.each_with_object({}) do |section, list|
+        slug = section[:slug]
+        case section[:type]&.to_sym
+        when :url
+          list[slug] = [section[:name], section[:url], section[:options]]
+        when :page
+          page = section[:page]
+          pages[slug] = page.is_a?(String) ? Object.const_get(page) : page
+          list[slug] = [section[:name], "#{root_path}/#{slug}"]
+        when :resource
+          repository = section[:repository] || settings.repository
+          resources[slug] = {
+            model: section[:model].is_a?(String) ? Object.const_get(section[:model]) : section[:model],
+            repository: repository.is_a?(String) ? Object.const_get(repository) : repository
+          }
+          resources[slug].merge! section.slice(:resource, :only, :index, :show, :collection_actions, :member_actions)
+          hidden = section[:options] && (section[:options].include?(:hidden) || section[:options].include?('hidden'))
+          list[slug] = [section[:name], "#{root_path}/#{slug}"] unless hidden
+        end
+      end
+      items['auth/logout'] = logout if logout
+      items
+    end
+  end
+end

data/lib/tiny_admin/utils.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Utils
+    def params_to_s(params)
+      list = params.each_with_object([]) do |(param, value), result|
+        if value.is_a?(Hash)
+          result.concat(value.map { |k, v| "#{param}[#{k}]=#{v}" })
+        else
+          result.push(["#{param}=#{value}"])
+        end
+      end
+      list.join('&')
+    end
+
+    def prepare_page(page_class, title: nil, context: nil, query_string: '', options: [])
+      page_class.new.tap do |page|
+        page.setup_page(title: title, query_string: query_string, settings: settings)
+        page.setup_options(
+          context: context,
+          compact_layout: options.include?(:compact_layout),
+          no_menu: options.include?(:no_menu)
+        )
+        yield(page) if block_given?
+      end
+    end
+
+    def route_for(section, reference: nil, action: nil)
+      [settings.root_path, section, reference, action].compact.join("/")
+    end
+
+    def context
+      TinyAdmin::Context.instance
+    end
+
+    def settings
+      TinyAdmin::Settings.instance
+    end
+  end
+end

data/lib/tiny_admin/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  VERSION = '0.1.0'
+end

data/lib/tiny_admin/views/actions/index.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Actions
+      class Index < DefaultLayout
+        attr_reader :current_page, :fields, :pages, :prepare_record, :records
+        attr_accessor :actions, :filters
+
+        def setup_pagination(current_page:, pages:)
+          @current_page = current_page
+          @pages = pages
+        end
+
+        def setup_records(records:, fields:, prepare_record:)
+          @records = records
+          @fields = fields.index_by(&:name)
+          @prepare_record = prepare_record
+        end
+
+        def template
+          @filters ||= {}
+
+          super do
+            div(class: 'index') {
+              div(class: 'row') {
+                div(class: 'col-4') {
+                  h1(class: 'title') { title }
+                }
+                div(class: 'col-8') {
+                  ul(class: 'nav justify-content-end') {
+                    (actions || []).each do |action|
+                      li(class: 'nav-item') {
+                        href = route_for(context.slug, action: action)
+                        a(href: href, class: 'nav-link btn btn-outline-secondary') { action }
+                      }
+                    end
+                  }
+                }
+              }
+
+              div(class: 'row') {
+                div_class = filters.any? ? 'col-9' : 'col-12'
+                div(class: div_class) {
+                  table(class: 'table') {
+                    table_header if fields.any?
+
+                    table_body
+                  }
+                }
+
+                if filters.any?
+                  div(class: 'col-3') {
+                    filters_form_attrs = { section_path: route_for(context.slug), filters: filters }
+                    render TinyAdmin::Views::Components::FiltersForm.new(**filters_form_attrs)
+                  }
+                end
+              }
+
+              if pages
+                render components[:pagination].new(current: current_page, pages: pages, query_string: query_string)
+              end
+            }
+          end
+        end
+
+        private
+
+        def table_header
+          thead {
+            tr {
+              fields.each_value do |field|
+                td(class: "field-header-#{field.name} field-header-type-#{field.type}") { field.title }
+              end
+              td { whitespace }
+            }
+          }
+        end
+
+        def table_body
+          tbody {
+            records.each_with_index do |record, index|
+              tr(class: "row_#{index + 1}") {
+                attributes = prepare_record.call(record)
+                attributes.each do |key, value|
+                  field = fields[key]
+                  td(class: "field-value-#{field.name} field-value-type-#{field.type}") {
+                    if field.options && field.options[:link_to]
+                      reference = record.send(field.options[:field])
+                      a(href: route_for(field.options[:link_to], reference: reference)) { value }
+                    else
+                      value
+                    end
+                  }
+                end
+                td(class: 'actions') {
+                  a(href: route_for(context.slug, reference: record.id)) { 'show' }
+                }
+              }
+            end
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/actions/show.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Actions
+      class Show < DefaultLayout
+        attr_reader :fields, :prepare_record, :record
+        attr_accessor :actions
+
+        def setup_record(record:, fields:, prepare_record:)
+          @record = record
+          @fields = fields
+          @prepare_record = prepare_record
+        end
+
+        def template
+          super do
+            div(class: 'show') {
+              div(class: 'row') {
+                div(class: 'col-4') {
+                  h1(class: 'title') { title }
+                }
+                div(class: 'col-8') {
+                  ul(class: 'nav justify-content-end') {
+                    (actions || []).each do |action|
+                      li(class: 'nav-item') {
+                        href = route_for(context.slug, reference: context.reference, action: action)
+                        a(href: href, class: 'nav-link btn btn-outline-secondary') { action }
+                      }
+                    end
+                  }
+                }
+              }
+
+              prepare_record.call(record).each_with_index do |(_key, value), index|
+                field = fields[index]
+                div(class: "field-#{field.name} row lh-lg") {
+                  if field
+                    div(class: 'field-header col-2') { field.title }
+                  end
+                  div(class: 'field-value col-10') {
+                    if field.options && field.options[:link_to]
+                      reference = record.send(field.options[:field])
+                      a(href: route_for(field.options[:link_to], reference: reference)) { value }
+                    else
+                      value
+                    end
+                  }
+                }
+              end
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/components/filters_form.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Components
+      class FiltersForm < Phlex::HTML
+        attr_reader :filters, :section_path
+
+        def initialize(section_path:, filters:)
+          @section_path = section_path
+          @filters = filters
+        end
+
+        def template
+          form(class: 'form_filters', method: 'get') {
+            filters.each do |field, filter|
+              name = field.name
+              filter_data = filter[:filter]
+              div(class: 'mb-3') {
+                label(for: "filter-#{name}", class: 'form-label') { field.title }
+                case filter_data[:type]&.to_sym || field.type
+                when :boolean
+                  select(class: 'form-select', id: "filter-#{name}", name: "q[#{name}]") {
+                    option(value: '') { '-' }
+                    option(value: '0', selected: filter[:value] == '0') { 'false' }
+                    option(value: '1', selected: filter[:value] == '1') { 'true' }
+                  }
+                when :date
+                  input(type: 'date', class: 'form-control', id: "filter-#{name}", name: "q[#{name}]", value: filter[:value])
+                when :datetime
+                  input(type: 'datetime-local', class: 'form-control', id: "filter-#{name}", name: "q[#{name}]", value: filter[:value])
+                when :integer
+                  input(type: 'number', class: 'form-control', id: "filter-#{name}", name: "q[#{name}]", value: filter[:value])
+                when :select
+                  select(class: 'form-select', id: "filter-#{name}", name: "q[#{name}]") {
+                    option(value: '') { '-' }
+                    filter_data[:values].each do |value|
+                      option(selected: filter[:value] == value) { value }
+                    end
+                  }
+                else
+                  input(type: 'text', class: 'form-control', id: "filter-#{name}", name: "q[#{name}]", value: filter[:value])
+                end
+              }
+            end
+
+            div(class: 'mt-3') {
+              a(href: section_path, class: 'button_clear btn btn-secondary text-white') { 'clear' }
+              whitespace
+              button(type: 'submit', class: 'button_filter btn btn-secondary') { 'filter' }
+            }
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/components/flash.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Components
+      class Flash < Phlex::HTML
+        attr_reader :errors, :notices, :warnings
+
+        def initialize(notices: [], warnings: [], errors: [])
+          @notices = notices
+          @warnings = warnings
+          @errors = errors
+        end
+
+        def template
+          div(class: 'flash') {
+            div(class: 'notices alert alert-success', role: 'alert') { notices.join(', ') } if notices&.any?
+            div(class: 'notices alert alert-warning', role: 'alert') { warnings.join(', ') } if warnings&.any?
+            div(class: 'notices alert alert-danger', role: 'alert') { errors.join(', ') } if errors&.any?
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/components/head.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Components
+      class Head < Phlex::HTML
+        attr_reader :extra_styles, :page_title, :style_links
+
+        def initialize(page_title, style_links: [], extra_styles: nil)
+          @page_title = page_title
+          @style_links = style_links
+          @extra_styles = extra_styles
+        end
+
+        def template
+          head {
+            meta charset: 'utf-8'
+            meta name: 'viewport', content: 'width=device-width, initial-scale=1'
+            title {
+              page_title
+            }
+            style_links.each do |style_link|
+              link(**style_link)
+            end
+            style { extra_styles } if extra_styles
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/components/navbar.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Components
+      class Navbar < Phlex::HTML
+        attr_reader :current_slug, :items, :root
+
+        def initialize(root:, items: [], current_slug: nil)
+          @root = root
+          @items = items || []
+          @current_slug = current_slug
+        end
+
+        def template
+          nav(class: 'navbar navbar-expand-lg') {
+            div(class: 'container') {
+              a(class: 'navbar-brand', href: root[:path]) { root[:title] }
+              button(class: 'navbar-toggler', type: 'button', 'data-bs-toggle' => 'collapse', 'data-bs-target' => '#navbarNav', 'aria-controls' => 'navbarNav', 'aria-expanded' => 'false', 'aria-label' => 'Toggle navigation') {
+                span(class: 'navbar-toggler-icon')
+              }
+              div(class: 'collapse navbar-collapse', id: 'navbarNav') {
+                ul(class: 'navbar-nav') {
+                  items.each do |slug, (name, path, options)|
+                    classes = %w[nav-link]
+                    classes << 'active' if slug == current_slug
+                    link_attributes = { class: classes.join(' '), href: path, 'aria-current' => 'page' }
+                    link_attributes.merge!(options) if options
+
+                    li(class: 'nav-item') {
+                      a(**link_attributes) { name }
+                    }
+                  end
+                }
+              }
+            }
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/components/pagination.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Components
+      class Pagination < Phlex::HTML
+        attr_reader :current, :pages, :query_string
+
+        def initialize(current:, pages:, query_string:)
+          @current = current
+          @pages = pages
+          @query_string = query_string
+        end
+
+        def template
+          div(class: 'pagination-div') {
+            nav('aria-label' => 'Pagination') {
+              ul(class: 'pagination justify-content-center') {
+                1.upto(pages) do |i|
+                  li_class = (i == current ? 'page-item active' : 'page-item')
+                  li(class: li_class) {
+                    href = query_string.empty? ? "?p=#{i}" : "?#{query_string}&p=#{i}"
+                    a(class: 'page-link', href: href) { i }
+                  }
+                end
+              }
+            }
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/default_layout.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    class DefaultLayout < Phlex::HTML
+      include Utils
+
+      attr_reader :compact_layout,
+                  :context,
+                  :errors,
+                  :no_menu,
+                  :notices,
+                  :query_string,
+                  :settings,
+                  :title,
+                  :warnings
+
+      def setup_page(title:, query_string:, settings:)
+        @title = title
+        @query_string = query_string
+        @settings = settings
+      end
+
+      def setup_options(context:, compact_layout:, no_menu:)
+        @context = context
+        @compact_layout = compact_layout
+        @no_menu = no_menu
+      end
+
+      def setup_flash_messages(notices: [], warnings: [], errors: [])
+        @notices = notices
+        @warnings = warnings
+        @errors = errors
+      end
+
+      def template(&block)
+        items = no_menu ? [] : settings.navbar
+
+        doctype
+        html {
+          render components[:head].new(title, style_links: style_links, extra_styles: settings.extra_styles)
+
+          body(class: body_class) {
+            render components[:navbar].new(current_slug: context&.slug, root: settings.root, items: items)
+
+            main_content {
+              render components[:flash].new(notices: notices, warnings: warnings, errors: errors)
+              yield_content(&block)
+            }
+
+            render_scripts
+          }
+        }
+      end
+
+      private
+
+      def components
+        settings.components
+      end
+
+      def style_links
+        settings.style_links || [
+          # Bootstrap CDN
+          {
+            href: 'https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/css/bootstrap.min.css',
+            rel: 'stylesheet',
+            integrity: 'sha384-rbsA2VBKQhggwzxH7pPCaAqO46MgnOM80zW1RWuH61DGLwZJEdK2Kadq2F9CUG65',
+            crossorigin: 'anonymous'
+          }
+        ]
+      end
+
+      def body_class
+        "module-#{self.class.to_s.split('::').last.downcase}"
+      end
+
+      def main_content
+        div(class: 'container main-content py-4') do
+          if compact_layout
+            div(class: 'row justify-content-center') {
+              div(class: 'col-6') {
+                yield
+              }
+            }
+          else
+            yield
+          end
+        end
+      end
+
+      def render_scripts
+        return unless settings.scripts
+
+        settings.scripts.each do |script_attrs|
+          script(**script_attrs)
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/pages/page_not_found.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Pages
+      class PageNotFound < DefaultLayout
+        def template
+          super do
+            div(class: 'page_not_found') {
+              h1(class: 'title') { title }
+            }
+          end
+        end
+
+        def title
+          'Page not found'
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/pages/record_not_found.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Pages
+      class RecordNotFound < DefaultLayout
+        def template
+          super do
+            div(class: 'record_not_found') {
+              h1(class: 'title') { title }
+            }
+          end
+        end
+
+        def title
+          'Record not found'
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/pages/root.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Pages
+      class Root < DefaultLayout
+        def template
+          super do
+            div(class: 'root') {
+              h1(class: 'title') { 'Tiny Admin' }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/pages/simple_auth_login.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Pages
+      class SimpleAuthLogin < DefaultLayout
+        def template
+          super do
+            div(class: 'simple_auth_login') {
+              h1(class: 'title') { title }
+
+              form(class: 'form_login', method: 'post') {
+                div(class: 'mt-3') {
+                  label(for: 'secret', class: 'form-label') { 'Password' }
+                  input(type: 'password', name: 'secret', class: 'form-control', id: 'secret')
+                }
+
+                div(class: 'mt-3') {
+                  button(type: 'submit', class: 'button_login btn btn-primary') { 'login' }
+                }
+              }
+            }
+          end
+        end
+
+        def title
+          'Login'
+        end
+      end
+    end
+  end
+end