feature_pack 0.6.3 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3320e77e931453c8b0aa6557b56f71752dc31bf74894bbd6e3d43219338ce0b2
-  data.tar.gz: 66a8cffdcb05e69903bded94b3a634fa1bfab66a37e5192ce9f3627704cd1a5f
+  metadata.gz: f70a5116de8367b0eecf7c72cbab4762b6c28ded77c2cfd7b0df4369e4d82431
+  data.tar.gz: ca02d7cc7f78755908a3adec71641b8740f423cf7eab65d5b2f92c0b1755e861
 SHA512:
-  metadata.gz: 0aae33cb5796721c39ee8ed02951592ff754581f0d40f481835f8fc1d98fa7bcc8296478b9dce8107335ecd4653d9d1ead0d19ad6805f024fcd659056f8686ef
-  data.tar.gz: 07002ee9863ed1db06875d1ff79916367c291dc61419c6bd6605f7b6bcebe6865dc8f2c96c91a5925fc9bbc4d0f214daddfee613b573c5eb6688a5a9ac248e18
+  metadata.gz: 8b9ea87e71245fc6d56827d933b4ca32ebd6e1e1a8c144b1ba62ca4a005fce36244414a6c278b4f0ff5e263e73ebc0b71617b09f9fba16816804c4cad7ea3d79
+  data.tar.gz: d135218c290abdd63c24c13f5e8944854e4bb186bb1db9982164ac7f52fe19a93e6c6f67e0d07f58d95baeeaf553a32fa021d9053f9513e0a0f40526ac43050c

data/README.md

@@ -1,94 +1,91 @@
-# Feature Pack
-Organizes and sets up the architecture of micro-applications within a Rails application, enabling the segregation of code, management, and isolation of functionalities, which can be developed, tested, and maintained independently of each other.
+# Feature Pack Gem
+Organizes and sets up the architecture of micro-applications within a Ruby On Rails application, enabling the segregation of code, management, and isolation of functionalities, which can be developed, tested, and maintained independently of each other.
 
+## Code and Folder Structure
 
-## Javascript
-`Javascript` must be on the FeaturePack root dir, not inside views dir.
+### Group
+A group is a collection of related features. Groups are represented as directories in the `app/feature_packs` folder. Each group contains a `_group_space` directory that holds group-level views and JavaScript files. Group directories follow this naming pattern:
 
-## Installation
-Meanwhile installer isn't done, follow the steps below to install FeaturePack GEM:
+#### Naming Convention
+Sample: `group_departments-100100_human_resources`
 
-```ruby
-# Add feature_pack to Gemfile
-gem 'feature_pack'
-```
+`group_` prefix is followed by the group identification (required)
+`departments-100100` between `group_` and class name, exists only for organization purposes. The bounds are `group_` and next underscore `_`
+`human_resources` class name of the group (required)
 
-```bash
-bundle install
-```
+#### Note worthy
+Group name is the same as the class name. Its used internally in the backend code.
+The 'Name' within the manifest file (Group.manifest[:name]) is the name to be shown in the user interface.
 
-Setup loading 
-```ruby
-# config/application.rb
+The `_group_space` directory contains:
 
-  feature_packs_path = Rails.root.join('app/feature_packs')
-  FeaturePack.setup(features_path: feature_packs_path)
+- `views/` - Views of the group
+#### Common Files in _group_space/views
 
-  FeaturePack.ignored_paths.each { |path| Rails.autoloaders.main.ignore(Rails.root.join(path)) }
+The `_group_space/views` directory typically contains these common files:
 
-  config.eager_load_paths << FeaturePack.features_path
-  config.paths['app/views'] << FeaturePack.features_path
+```
+_group_space/views/
+├── index.html.slim    # Default view for the group
+└── partials/
+    └── _header.html.slim # Base header template for the group
+    └── _footer.html.slim # Base footer template for the group
+```
+Can have more views and partials, depending on the defined on `controller.rb` but these are the most common ones.
 
-  config.paths['config/routes'] << (FeaturePack.path.to_s << '/feature_pack')
-  config.paths['config/routes'] << FeaturePack.features_path
-  config.assets.paths << FeaturePack.features_path.to_s
+- `javascript/` - Group-level JavaScript modules shared across features
+- `controller.rb` - Base controller class for the group's features
+- `routes.rb` - The routes files come with the default `index` action/view.
 
-  Zeitwerk::Loader.eager_load_all
+#### How implement a new Group
+```
+rails generate feature_pack:add_gruop <group_name>
+```
 
-  config.after_initialize do
-    load FeaturePack.path.join('feature_pack/group_controller.rb')
-    load FeaturePack.path.join('feature_pack/controller.rb')
+### Feature
+A feature is a single feature that can be added to a group. Feature naming patter is the same of group, but without the `group_` prefix.
 
-    FeaturePack.groups_controllers_paths.each { |group_controller_path| load group_controller_path }
-    FeaturePack.features_controllers_paths.each { |controller_path| load controller_path }
-  end
-```
+#### Feature Routes
+Every feature has a default route, which is the `index` action/view. If the feature has more than the default `index` action/view, the routes are defined in the `routes.rb` file.
 
-```ruby
-# initializers/feature_pack.rb
-
-FeaturePack.groups.each do |group|
-  group_module = FeaturePack.const_set(group.name.name.camelize, Module.new)
-
-  %w[Lib AI Jobs].each do |submodule_name|
-    submodule_path = File.join(group.relative_path, '_group_space', submodule_name.downcase)
-    if Dir.exist?(submodule_path)
-      submodule = group_module.const_set(submodule_name, Module.new)
-      Rails.autoloaders.main.push_dir(submodule_path, namespace: submodule)
-    end
-  end
-
-  group.features.each do |feature|
-    feature_module = group_module.const_set(feature.name.name.camelize, Module.new)
-    Rails.autoloaders.main.push_dir(feature.relative_path, namespace: feature_module)
-  end
-end
+#### How implement a new feature
 ```
+rails generate feature_pack:add_feature <group_name>/<feature_name>
+```
+
+#### Helpers
 
 ```ruby
-# app/helpers/application_helper.rb
-  def feature_pack_group_path(group, *params) = send("feature_pack_#{group.name}_path".to_sym, *params)
-  def feature_pack_path(group, feature, *params) = send("feature_pack_#{group.name}_#{feature.name}_path".to_sym, *params)
+# Application Helper
+def feature_pack_group_path(group_name, *params) = send("feature_pack_#{group_name}_path".to_sym, *params)
+def feature_pack_path(group_name, feature_name, *params) = send("feature_pack_#{group_name}_#{feature_name}_path".to_sym, *params)
 ```
 
-```ruby
-# config/initializers/assets.rb
+## Helpers
 
-Rails.application.config.assets.precompile += FeaturePack.javascript_files_paths
-```
+### Using the `feature_pack_group_path` and `feature_pack_path` Helpers
 
-```ruby
-# config/importmap.rb
+The `feature_pack_group_path` and `feature_pack_path` helpers are used to generate URLs for specific groups and features within the feature package system.
 
-FeaturePack.javascript_files_paths.each do |js_file_path|
-  extensionless_js_file_path = js_file_path.delete_suffix('.js')
-  pin extensionless_js_file_path, to: extensionless_js_file_path, preload: false
-end
-```
+- `feature_pack_group_path(group, *params)`: Generates the path for a specific group. The `group` parameter should be an object representing the desired group. Additional parameters can be passed to specify more details in the URL.
+  
+  **Usage example:**
+  ```ruby
+  # Assuming `group` is a valid group name in symbol
+  group_url = feature_pack_group_path(:group_name)
+  ```
 
-```ruby
-# config/routes.rb
-namespace :feature_pack, path: nil do
-  draw :feature_pack_routes
-end
-```
+- `feature_pack_path(group, feature, *params)`: Generates the path for a specific feature within a group. The `group` and `feature` parameters should be symbols of group and feature name, respectively. Additional parameters can be passed to specify more details in the URL.
+  
+  **Usage example:**
+  ```ruby
+  # Assuming `group` and `feature` are valid objects
+  feature_url = feature_pack_path(:my_group, :my_feature)
+  ```
+
+These helpers are useful for maintaining consistency and clarity when generating URLs within the application, ensuring that routes are correctly constructed based on the provided group and feature names.
+
+## Variables
+Current group and feature are available in the controller (so as in the views too) as `@group` and `@feature` variables.
+@feature variable is not available in the group controller.
+@group variable is available in the group controller and in the its features controllers.

data/doc/changelog.md

@@ -0,0 +1,2 @@
+## [0.8.0] - 2025-02-09
+- Melhoria no gemspec: uso de variável 'spec', resumo aprimorado, descrição formatada com HEREDOC, substituição de Dir[] por Dir.glob e adição de metadata. 

data/lib/feature_pack/controller.rb

@@ -1,12 +1,16 @@
 class FeaturePack::Controller < ApplicationController
-  before_action :set_group_and_feature
-  before_action :set_view_lookup_context_prefix
-  before_action :set_layout_paths
+  prepend_before_action :setup_feature
 
   def index; end
 
   private
 
+  def setup_feature
+    set_group_and_feature
+    set_view_lookup_context_prefix
+    set_layout_paths
+  end
+
   def set_group_and_feature
     group_name, feature_name = params['controller'].delete_prefix('feature_pack/').split('/').map(&:to_sym)
     @group = FeaturePack.group group_name
@@ -14,19 +18,17 @@ class FeaturePack::Controller < ApplicationController
   end
 
   def set_view_lookup_context_prefix
-    unless lookup_context.prefixes.include?(@feature.views_relative_path)
-      lookup_context.prefixes.prepend(@feature.views_relative_path)
-    end
+    return if lookup_context.prefixes.include?(@feature.views_relative_path)
+
+    lookup_context.prefixes.prepend(@feature.views_relative_path)
   end
 
   def set_layout_paths
-=begin
-    Header/Footer Lookup order
-
-    - Feature dir/_partials, if not exists
-      - Fallback to Group, if not exists
-        - Fallback to Application's default header/footer
-=end
+    #     Header/Footer Lookup order
+    #
+    #     - Feature dir/_partials, if not exists
+    #       - Fallback to Group, if not exists
+    #         - Fallback to Application's default header/footer
 
     feature_partials_path = @feature.views_relative_path.join('partials')
     group_partials_path = @feature.group.views_path.concat('/partials')

data/lib/feature_pack/feature_pack_routes.rb

@@ -1,20 +1,15 @@
 FeaturePack.groups.each do |group|
-  unless group.manifest[:namespace_only]
-    # Default 'index' route every group has to have.
-    get group.manifest[:url],
-        to: "#{group.name.name}#index",
-        as: group.name.name
+  scope group.manifest[:url], as: group.name do
+    raise "Group '#{group.name}' routes file not found in #{group.metadata_path}" if group.routes_file.nil?
 
-    unless group.routes_file.nil?
-      scope group.manifest[:url] do
-        draw(group.routes_file)
-      end
-    end
+    draw(group.routes_file)
   end
 
   namespace group.name, path: group.manifest[:url] do
     group.features.each do |feature|
-      scope feature.manifest[:url], as: feature.name.name.pluralize do
+      scope feature.manifest[:url], as: feature.name do
+        raise "Feature '#{feature.name}' routes file not found in #{feature.routes_file}" if feature.routes_file.nil?
+
         draw(feature.routes_file)
       end
     end

data/lib/feature_pack/group_controller.rb

@@ -1,32 +1,33 @@
 class FeaturePack::GroupController < ApplicationController
-  before_action :set_group
-  before_action :set_view_lookup_context_prefix
-  before_action :set_layout_paths
-
+  prepend_before_action :setup_group
   def index; end
 
   private
 
+  def setup_group
+    set_group
+    set_view_lookup_context_prefix
+    set_layout_paths
+  end
+
   def set_group
     group_name = params[:controller].split('/')[1].to_sym
     @group = FeaturePack.group(group_name)
   end
 
   def set_view_lookup_context_prefix
-    unless lookup_context.prefixes.include?(@group.views_path)
-      lookup_context.prefixes.prepend(@group.views_path)
-    end
+    return if lookup_context.prefixes.include?(@group.views_path)
+
+    lookup_context.prefixes.prepend(@group.views_path)
   end
 
   def set_layout_paths
     patials_path = @group.views_path.concat('/partials')
 
-    if template_exists?('header', patials_path, true)
-      @header_layout_path = @group.view('partials/header')
-    end
+    @header_layout_path = @group.view('partials/header') if template_exists?('header', patials_path, true)
+
+    return unless template_exists?('footer', patials_path, true)
 
-    if template_exists?('footer', patials_path, true)
-      @footer_layout_path = @group.view('partials/footer')
-    end
+    @footer_layout_path = @group.view('partials/footer')
   end
 end

data/lib/generators/feature_pack/add_group/add_group_generator.rb

@@ -2,7 +2,6 @@ require 'rails/generators/base'
 require 'rails/generators/named_base'
 
 class FeaturePack::AddGroupGenerator < Rails::Generators::NamedBase
-
   desc 'Adds a new Feature Group'
   source_root File.expand_path('templates', __dir__)
 
@@ -20,9 +19,11 @@ class FeaturePack::AddGroupGenerator < Rails::Generators::NamedBase
 
     template './_group_space/controller.rb.tt', group_dir.join('_group_space', 'controller.rb')
     template './_group_space/manifest.yaml.tt', group_dir.join('_group_space', 'manifest.yaml')
-    template './_group_space/routes.rb.disabled.tt', group_dir.join('_group_space', 'routes.rb.disabled')
+    template './_group_space/routes.rb.tt', group_dir.join('_group_space', 'routes.rb')
     template './_group_space/views/index.html.slim.tt', group_dir.join('_group_space', 'views/index.html.slim')
-    template './_group_space/views/partials/_header.html.slim.tt', group_dir.join('_group_space', 'views/partials/_header.html.slim')
-    template './_group_space/views/partials/_footer.html.slim.tt', group_dir.join('_group_space', 'views/partials/_footer.html.slim')
+    template './_group_space/views/partials/_header.html.slim.tt',
+             group_dir.join('_group_space', 'views/partials/_header.html.slim')
+    template './_group_space/views/partials/_footer.html.slim.tt',
+             group_dir.join('_group_space', 'views/partials/_footer.html.slim')
   end
 end

data/lib/generators/feature_pack/add_group/templates/_group_space/manifest.yaml.tt

@@ -1,3 +1,2 @@
 name: Group Friendly Name Here
 url: <%= name.gsub('_', '-') %>
-namespace_only: false

data/lib/generators/feature_pack/add_group/templates/_group_space/routes.rb.tt

@@ -0,0 +1 @@
+get '/', to: '<%= name %>#index'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: feature_pack
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.8.0
 platform: ruby
 authors:
 - Gedean Dias
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-06 00:00:00.000000000 Z
+date: 2025-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -30,16 +29,17 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
-description: Organizes and sets up the architecture of micro-applications within a
-  Rails application, enabling the segregation of code, management, and isolation of
-  functionalities, which can be developed, tested, and maintained independently of
-  each other.
+description: |
+  Organizes and sets up the architecture of micro-applications within a Rails application,
+  enabling segregation, management, and isolation of functionalities, thereby supporting
+  independent development, testing, and maintenance.
 email: gedean.dias@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- doc/changelog.md
 - doc/feature_pack.md
 - lib/feature_pack.rb
 - lib/feature_pack/api/controller.rb
@@ -60,15 +60,18 @@ files:
 - lib/generators/feature_pack/add_group/add_group_generator.rb
 - lib/generators/feature_pack/add_group/templates/_group_space/controller.rb.tt
 - lib/generators/feature_pack/add_group/templates/_group_space/manifest.yaml.tt
-- lib/generators/feature_pack/add_group/templates/_group_space/routes.rb.disabled.tt
+- lib/generators/feature_pack/add_group/templates/_group_space/routes.rb.tt
 - lib/generators/feature_pack/add_group/templates/_group_space/views/index.html.slim.tt
 - lib/generators/feature_pack/add_group/templates/_group_space/views/partials/_footer.html.slim.tt
 - lib/generators/feature_pack/add_group/templates/_group_space/views/partials/_header.html.slim.tt
 homepage: https://github.com/gedean/feature_pack
 licenses:
 - MIT
-metadata: {}
-post_install_message: Please check readme file for use instructions.
+metadata:
+  bug_tracker_uri: https://github.com/gedean/feature_pack/issues
+  source_code_uri: https://github.com/gedean/feature_pack
+  changelog_uri: https://github.com/gedean/feature_pack/blob/main/CHANGELOG.MD
+post_install_message: Please check the README file for use instructions.
 rdoc_options: []
 require_paths:
 - lib
@@ -83,8 +86,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key: 
+rubygems_version: 3.6.3
 specification_version: 4
-summary: A different way to organize app features in Rails.
+summary: A different approach to organizing Rails app features.
 test_files: []

data/lib/generators/feature_pack/add_group/templates/_group_space/routes.rb.disabled.tt

@@ -1,3 +0,0 @@
-# You don't need enable this file if the only action is 'index'
-
-get '/action-name-url', to: '<%= name %>#action_name'