tramway 1.0.1.2 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06d72139ce4ef1d004a083a2d357eff4eff402e4a2af7a11a39458865e6f974b
-  data.tar.gz: 8179263c08e93124cb3d70aa1aa3071cc9e84970dc5d53dfbd07be33fdfba4a8
+  metadata.gz: f347c8016c4bf4a0098ad6075235e573194ad4a1f06c99646d82686187d47524
+  data.tar.gz: 9cde483c80bdba5a855780d93c169b9b6c9b74739b029f476a0356243e1396fd
 SHA512:
-  metadata.gz: 9c46d6168bff31a3e03687654e6a0ef5c1f5120988913f29cec1f93886277e654dfbfbe01aaedf066c100975383975c32407263dd527ddd532c0c7c25d358741
-  data.tar.gz: e13043a072b1572757e91e3beea6ca2c4dec3fa497096f6e4319ce65471703f51570315ba9d0037b489a6c6b32a88de994f1be7c2d95b5bd898b225562cde35c
+  metadata.gz: 2acee51cfa114f2324809a506d276d482e166e520d40a68d7ca3f5b49cad17a6441f04e097ab20ead0bf1c4e42c2e042cf335aa6fc3889c8f265fe52e11c7ea8
+  data.tar.gz: 443e3cc99f4e3777f9090e6c23a4b575086d58237a948e7d2b19e6cfff602941c0c9f1fa0907ceb33251d7732c8050450ff2cb1f016e42534ccffae3379eff41

data/README.md

@@ -299,6 +299,13 @@ end
 With this configuration in place, the index page will render the `Create`
 button component above the table of projects.
 
+#### Add header content to show pages
+
+To inject custom content above a record's details, define an
+object-level `show_header_content` method on its decorator. The method
+can return any rendered content and has full access to the decorated
+object's helpers and attributes.
+
 #### Decorate a single object
 
 You can use the same method to decorate a single object either
@@ -567,6 +574,10 @@ Read [behave_as_ar](https://github.com/Purple-Magic/tramway#behave_as_ar) sectio
 
 ### Tramway Navbar
 
+#### Running tramway_navbar without arguments
+
+When you call `tramway_navbar` without passing any arguments, it renders a navbar that lists buttons linking to all entities configured with a page index in `config/initializers/tramway.rb`.
+
 Tramway provides DSL for rendering Tailwind Navgiation bar.
 
 ```ruby

data/app/views/tramway/entities/show.html.haml

@@ -1,12 +1,23 @@
+- @show_header_content = @entity.show_header_content
+
 = tramway_container do
-  %h1.text-4xl.font-bold.mb-4
-    = @entity.title
+
+  .flex.justify-between.items-center
+    %h1.text-4xl.font-bold.mb-4
+      = @entity.title
+
+  .flex.justify-end.mt-2
+    - if @show_header_content.present?
+      - if @show_header_content.respond_to?(:call)
+        = @show_header_content.call(@entity)
+      - else
+        = @show_header_content
 
   - if @entity.show_attributes.empty?
     %p.text-center.mt-10
       You should fill object-level method `show_attributes` inside your
       = @entity.class.name
-  = tramway_table do
+  = tramway_table class: 'mt-4' do
     - @entity.show_attributes.each do |attribute|
       = tramway_row do
         = tramway_cell do

data/config/routes.rb

@@ -12,10 +12,15 @@ Tramway::Engine.routes.draw do
     resource_name = segments.pop
 
     define_resource = proc do
-      resources resource_name.pluralize.to_sym,
-                only: entity.pages.map(&:action),
-                controller: '/tramway/entities',
-                defaults: { entity: entity }
+      entity.pages.each do |page|
+        case page.action
+        when 'index'
+          get resource_name.pluralize, to: '/tramway/entities#index', defaults: { entity: }, as: resource_name.pluralize
+        when 'show'
+          get "#{resource_name.pluralize}/:id", to: '/tramway/entities#show', defaults: { entity: },
+                                                as: resource_name.singularize
+        end
+      end
     end
 
     if segments.empty?

data/lib/tramway/base_decorator.rb

@@ -71,6 +71,10 @@ module Tramway
       []
     end
 
+    def show_header_content
+      nil
+    end
+
     # :reek:ManualDispatch { enabled: false } because there is the idea to manual dispatch
     def method_missing(method_name, *, &)
       url_helpers = Rails.application.routes.url_helpers

data/lib/tramway/configs/entity.rb

@@ -13,7 +13,8 @@ module Tramway
       attribute? :namespace, Types::Coercible::String
 
       # Route Struct contains implemented in Tramway CRUD and helpful routes for the entity
-      RouteStruct = Struct.new(:index, :show)
+      ACTIONS = %i[index show].freeze
+      RouteStruct = Struct.new(*ACTIONS)
 
       # HumanName Struct contains human names forms for the entity
       HumanNameStruct = Struct.new(:single, :plural)
@@ -53,9 +54,9 @@ module Tramway
       end
 
       def route_helper_methods
-        %i[index show].map do |action|
+        ACTIONS.map do |action|
           page(action).present? ? send("#{action}_helper_method") : nil
-        end.compact
+        end
       end
 
       def build_helper_method(base_name, route: nil, namespace: nil, plural: false)

data/lib/tramway/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tramway
-  VERSION = '1.0.1.2'
+  VERSION = '1.0.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 1.0.1.2
+  version: 1.0.2
 platform: ruby
 authors:
 - kalashnikovisme