feature_pack 0.10.0 → 0.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7451b49f9dda65ec4aa60a6bb26a976f09258c292221ac884f6a1f2db7dd769b
-  data.tar.gz: eccbe2c439b2810c149a174225f9a20821a28f16b0af5876bf9bc32ef22d3f04
+  metadata.gz: 3c48de284c1d9224798b073645f3a80e923d4e72445272641f644e8ed15bb6bf
+  data.tar.gz: 9c8c489303a5f0a878c756abbc6abb03b8c6073e3cb8a1beda43eeaba0705365
 SHA512:
-  metadata.gz: eedb788af59f03e15dbc7d54d4da52c40491f9374e32160c40779f8318b084566961005802261b34b87c6c2cf9134b68c6fc21c9c7ed26671894bbd5744bfa44
-  data.tar.gz: 9ea9c70925ed3293e7bb1348e7eb3276d0db1ff2129bf17380b1b43769f043b7c1a98cd566605cd8cdad723d0c0efb87d98b2f6536725f07e4c004fd57b07ac5
+  metadata.gz: 76ac5cdd3bcb0a241cbc40cd12ad11edbf94e267142e5d2a0e30e26a4b71462c9ae2cc58f0244034ec8d862d7ae8a67f70047273540eab4592e195e6085ca7fe
+  data.tar.gz: f021bce17beadad88f4501768d2021e65e2393db17cd625053ad51e0cfff334555041d055c867517317f52cf79f78b647fe1fa38620f0427c112f8184094e6c1

data/README.md

@@ -247,6 +247,68 @@ Access aliased constants:
 @feature.service       # => FeaturePack::HumanResources::Employees::EmployeeService
 ```
 
+## Hooks
+
+### after_initialize Hook
+
+O FeaturePack suporta hooks `after_initialize` que permitem executar código customizado após o carregamento de grupos e features.
+
+#### Como Funciona
+
+Durante o processo de setup do FeaturePack, após todos os grupos e features serem descobertos e configurados, o sistema procura e executa arquivos `__after_initialize.rb` específicos.
+
+#### Localização dos Arquivos
+
+- **Para grupos**: `app/feature_packs/[nome_do_grupo]/_group_space/__after_initialize.rb`
+- **Para features**: `app/feature_packs/[nome_do_grupo]/[nome_da_feature]/__after_initialize.rb`
+
+#### Contexto de Execução
+
+Os arquivos `__after_initialize.rb` são executados no contexto do objeto group ou feature, permitindo acesso direto a todas as suas propriedades através de `self`.
+
+#### Exemplos de Uso
+
+**Hook para grupo:**
+```ruby
+# app/feature_packs/group_241209_human_resources/_group_space/__after_initialize.rb
+
+# Registrar o grupo em um sistema de auditoria
+Rails.logger.info "Grupo #{name} carregado com #{features.size} features"
+
+# Configurar permissões globais do grupo
+features.each do |feature|
+  Rails.logger.info "  - Feature #{feature.name} disponível em #{feature.manifest[:url]}"
+end
+
+# Carregar configurações específicas do grupo
+config_file = File.join(absolute_path, '_group_space', 'config.yml')
+if File.exist?(config_file)
+  @config = YAML.load_file(config_file)
+end
+```
+
+**Hook para feature:**
+```ruby
+# app/feature_packs/group_241209_human_resources/feature_241209_employees/__after_initialize.rb
+
+# Registrar rotas dinâmicas
+Rails.logger.info "Feature #{name} inicializada no grupo #{group.name}"
+
+# Verificar dependências
+required_gems = %w[devise cancancan]
+required_gems.each do |gem_name|
+  unless Gem.loaded_specs.key?(gem_name)
+    Rails.logger.warn "Feature #{name} requer a gem #{gem_name}"
+  end
+end
+
+# Registrar a feature em um sistema de métricas
+StatsD.increment("features.#{group.name}.#{name}.loaded") if defined?(StatsD)
+
+# Configurar cache específico da feature
+Rails.cache.write("feature:#{group.name}:#{name}:loaded_at", Time.current)
+```
+
 ## Best Practices
 
 1. **Group Organization**: Group related features that share common functionality

data/lib/generators/feature_pack/add_feature/add_feature_generator.rb

@@ -36,8 +36,8 @@ module FeaturePack
     def parse_names
       @group_name, @feature_name = name.split('/')
       
-      unless @group_name.match?(/^[a-z_]+$/) && @feature_name.match?(/^[a-z_]+$/)
-        raise Thor::Error, "Group and feature names must be in snake_case format"
+      unless @group_name.match?(/^[a-z][a-z0-9_]*$/) && @feature_name.match?(/^[a-z][a-z0-9_]*$/)
+        raise Thor::Error, "Group and feature names must be in snake_case format (lowercase letters, numbers, and underscores, starting with a letter)"
       end
       
       @group_class_name = @group_name.camelcase

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: feature_pack
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.10.1
 platform: ruby
 authors:
 - Gedean Dias
 bindir: bin
 cert_chain: []
-date: 2025-08-03 00:00:00.000000000 Z
+date: 2025-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -88,7 +88,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 3.7.2
 specification_version: 4
 summary: A different approach to organizing Rails app features.
 test_files: []