tramway 0.2.1.2 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2dd99c95cb679606a69128eb290b9c35fee411dc626ed2f43a1b3cfcba36efa
-  data.tar.gz: 95ed3ccb11b51c8df14061aa9bc483257da99e05755f06935fd27bfabb3d1393
+  metadata.gz: 12b9bb73f91f5c694ee64efaa36d66a5ee68c6b41066a5e775b42e4ba81678d4
+  data.tar.gz: 79c240ff539d4762fb8a2c4b3fe29ff05805c2699e12225d53038fafb53c5a1d
 SHA512:
-  metadata.gz: d759138c8522fa61b234affae4547f403992ade47ff99413e5abb42cc52101137294dcef77e4f17528d1d6463d8668fa85ef71cd1b0bc6f5042522aa8254fd27
-  data.tar.gz: 2e63cf0b4fa9122c2f0e97aaad067a7b325c5644a4912c1636f4bc247e1f98dada96991ed231c1ab26d404dec0d719c406bacede57e21331576fbb005fdabf9d
+  metadata.gz: 5ccd8cdeb8bb8b9df08d4885ff473e68ef7a29f5980460050e52db4d7b7b758da170cabece248f78589dbc102d47f1ae4c3ee1410d50d8103cbb4ffc549d0a2e
+  data.tar.gz: 58c752011aa51d3c0afd9e074380411657a390b0a09568226de9d4c38b033d1b9b23f172b27af2a3ae137bc342185fad3736085412025d66cac4dab68e4ff994

data/README.md

@@ -11,11 +11,26 @@ gem "view_component"
 
 ## Usage
 
+### Tramway Entities
+
+Tramway is an entity-based framework. **Entity** is the class on whose objects actions be applied: _index, show, create, update, and destroy_. Tramway will support numerous classes as entities. For now, Entity could be only **ActiveRecord::Base** class.
+
+#### Define entity for Tramway
+
+*config/initializers/tramway.rb*
+```ruby
+Tramway.configure do |config|
+  config.entities = [ :user, :podcast, :episode ] # entities based on models User, Podcast and Episode are defined
+end
+```
+
+By default, links to the Tramway Entities index page are rendered in [Tramway Navbar](https://github.com/Purple-Magic/tramway#tramway-navbar).
+
 ### Tailwind components
 
 Tramway uses [Tailwind](https://tailwindcss.com/) by default. All UI helpers are implemented with [ViewComponent](https://github.com/viewcomponent/view_component).
 
-### Decorators
+### Tramway Decorators
 
 Tramway provides convenient decorators for your objects. **NOTE:** This is not the decorator pattern in its usual representation.
 
@@ -65,8 +80,7 @@ def show
 end
 ```
 
-
-### Navbar
+### Tramway Navbar
 
 Tramway provides DSL for rendering Tailwind Navgiation bar.
 
@@ -97,6 +111,8 @@ background:
   intensity: Color intensity. Range: **100..950**. Used by Tailwind. Not supported in case of using HEX color in the background.color
 ```
 
+**NOTE:** `tramway_navbar` method called without arguments and block of code will render only [Tramway Entities](https://github.com/Purple-Magic/tramway#tramway-entities) links on the left.
+
 #### nav.left and nav.right
 
 Tramway navbar provides `left` and `right` methods that puts items to left and right part of navbar.

data/lib/tramway/base_decorator.rb

@@ -1,34 +1,30 @@
 # frozen_string_literal: true
 
 require 'tramway/decorators/collection_decorator'
+require 'tramway/utils/render'
 
 module Tramway
   # Provides decorate function for Tramway projects
   #
   class BaseDecorator
     include Tramway::Decorators::CollectionDecorators
+    include Tramway::Utils::Render
 
-    attr_reader :object, :context
+    attr_reader :object
 
-    def initialize(object, context)
+    def initialize(object)
       @object = object
-      @context = context
-    end
-
-    def render(*args)
-      context.render(*args, layout: false)
     end
 
     class << self
-      def decorate(object_or_array, context)
+      def decorate(object_or_array)
         if Tramway::Decorators::CollectionDecorators.collection?(object_or_array)
           Tramway::Decorators::CollectionDecorators.decorate_collection(
             collection: object_or_array,
-            context:,
             decorator: self
           )
         else
-          new(object_or_array, context)
+          new(object_or_array)
         end
       end
 

data/lib/tramway/config.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'singleton'
+require 'tramway/configs/entity'
+
+module Tramway
+  # Basic configuration of Tramway
+  #
+  class Config
+    include Singleton
+
+    def initialize
+      @entities = []
+    end
+
+    def entities=(collection)
+      @entities = collection.map do |entity|
+        Tramway::Configs::Entity.new(name: entity)
+      end
+    end
+
+    attr_reader :entities
+  end
+end

data/lib/tramway/configs/entity.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Configs
+    # Tramway is entity based framework
+    #
+    class Entity
+      attr_reader :name
+
+      def initialize(name:)
+        @name = name.to_s
+      end
+
+      def routes
+        underscored_name = name.parameterize.pluralize.underscore
+
+        OpenStruct.new index: Rails.application.routes.url_helpers.public_send("#{underscored_name}_path")
+      end
+
+      def human_name
+        OpenStruct.new single: name.capitalize, plural: name.pluralize.capitalize
+      end
+    end
+  end
+end

data/lib/tramway/decorators/collection_decorator.rb

@@ -7,9 +7,9 @@ module Tramway
     module CollectionDecorators
       module_function
 
-      def decorate_collection(collection:, context:, decorator:)
+      def decorate_collection(collection:, decorator:)
         collection.map do |item|
-          decorator.decorate item, context
+          decorator.decorate item
         end
       end
 

data/lib/tramway/helpers/decorate_helper.rb

@@ -10,7 +10,7 @@ module Tramway
       def tramway_decorate(object_or_array, decorator: nil)
         return [] if Tramway::Decorators::CollectionDecorators.collection?(object_or_array) && object_or_array.empty?
 
-        Tramway::Decorators::ClassHelper.decorator_class(object_or_array, decorator).decorate object_or_array, self
+        Tramway::Decorators::ClassHelper.decorator_class(object_or_array, decorator).decorate object_or_array
       end
     end
   end

data/lib/tramway/helpers/navbar_helper.rb

@@ -7,13 +7,11 @@ module Tramway
     # Providing navbar helpers for ActionView
     module NavbarHelper
       def tramway_navbar(**options)
-        if block_given?
-          initialize_navbar
+        initialize_navbar
 
-          yield @navbar
+        yield @navbar if block_given?
 
-          assign_navbar_items(options)
-        end
+        assign_navbar_items(options)
 
         render_navbar_component(options)
       end
@@ -21,7 +19,7 @@ module Tramway
       private
 
       def initialize_navbar
-        @navbar = Tramway::Navbar.new(self)
+        @navbar = Tramway::Navbar.new self
       end
 
       def assign_navbar_items(options)

data/lib/tramway/navbar.rb

@@ -3,18 +3,23 @@
 module Tramway
   # Navbar object provides left and right elements
   class Navbar
-    attr_reader :items
+    attr_reader :items, :context
 
     def initialize(context)
-      @items = {}
       @context = context
+      @items = { left: [], right: [] }
       @filling = nil
+
+      entities = Tramway.config.entities
+
+      return unless entities.any?
+
+      preset_left entities
     end
 
     def left
       return unless block_given?
 
-      @items[:left] = []
       filling_side(:left)
       yield self
       reset_filling
@@ -23,7 +28,6 @@ module Tramway
     def right
       return unless block_given?
 
-      @items[:right] = []
       filling_side(:right)
       yield self
       reset_filling
@@ -43,6 +47,18 @@ module Tramway
 
     private
 
+    def preset_left(entities)
+      filling_side :left
+
+      entities.each do |entity|
+        entity.to_s.pluralize
+
+        item entity.human_name.plural, entity.routes.index
+      end
+
+      reset_filling
+    end
+
     def provided_url_and_block?(url)
       url.present? && block_given?
     end
@@ -57,12 +73,14 @@ module Tramway
 
     def render_ignoring_block(text_or_url, url, options)
       options.merge!(href: url)
-      @context.render(Tailwinds::Nav::ItemComponent.new(**options)) { text_or_url }
+
+      context.render(Tailwinds::Nav::ItemComponent.new(**options)) { text_or_url }
     end
 
     def render_using_block(text_or_url, options, &block)
       options.merge!(href: text_or_url)
-      @context.render(Tailwinds::Nav::ItemComponent.new(**options), &block)
+
+      context.render(Tailwinds::Nav::ItemComponent.new(**options), &block)
     end
   end
 end

data/lib/tramway/utils/render.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Utils
+    # Provides helper method render that depends on ActionController::Base.render method
+    #
+    module Render
+      def render(*args, &)
+        ActionController::Base.render(*args, &)
+      end
+    end
+  end
+end

data/lib/tramway/version.rb

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

data/lib/tramway.rb

@@ -3,9 +3,19 @@
 require 'tramway/version'
 require 'tramway/engine'
 require 'tramway/base_decorator'
+require 'tramway/config'
 require 'view_component/compiler'
 require 'view_component/engine'
 
 # Core module for the whole gem
 module Tramway
+  module_function
+
+  def configure(&)
+    yield config
+  end
+
+  def config
+    Tramway::Config.instance
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 0.2.1.2
+  version: 0.2.2
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-21 00:00:00.000000000 Z
+date: 2023-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: haml-rails
@@ -88,12 +88,15 @@ files:
 - lib/tasks/tramway_tasks.rake
 - lib/tramway.rb
 - lib/tramway/base_decorator.rb
+- lib/tramway/config.rb
+- lib/tramway/configs/entity.rb
 - lib/tramway/decorators/class_helper.rb
 - lib/tramway/decorators/collection_decorator.rb
 - lib/tramway/engine.rb
 - lib/tramway/helpers/decorate_helper.rb
 - lib/tramway/helpers/navbar_helper.rb
 - lib/tramway/navbar.rb
+- lib/tramway/utils/render.rb
 - lib/tramway/version.rb
 homepage: https://github.com/purple-magic/tramway
 licenses: