shoryuken-template 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a840c133e1ee880eaf5f787ddaf90d2032a2a8d84488cf03f4b3307c953a347c
+  data.tar.gz: '0358b4aa471be05f8dc68321781c8b0432049927ccc778a416aa71f232666363'
+SHA512:
+  metadata.gz: 5e18c4ee65d08756d988a70e7ef36682f55417dabfe6429063d9eb53c52542cd4fe141f6a3ca6c7425b44c9d36e5a876ec1e59819a959fec275dd9d597ba21fb
+  data.tar.gz: ad1f56ed6ca4810a8c5e36a5f70a1643b363b7691b7bfbc189fde835aa7aedb6d4a25a4a3426b765d7b5f90b0f4faf22f42a1926adca056416b4c3a0f61d64c3

data/.rubocop.yml

@@ -0,0 +1,60 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - 'vendor/**/*'
+    - 'bin/**/*'
+    - 'sig/**/*'
+    - 'node_modules/**/*'
+
+require:
+  - rubocop-rake
+  - rubocop-minitest
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/BlockLength:
+  Exclude:
+    - 'test/**/*'
+    - 'spec/**/*'
+    - 'examples/**/*'
+
+Metrics/ClassLength:
+  Max: 150
+
+Style/Documentation:
+  Enabled: false
+
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
+
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+
+Lint/RaiseException:
+  Enabled: true
+
+Lint/StructNewOverride:
+  Enabled: true
+
+Style/HashEachMethods:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+
+Style/HashTransformValues:
+  Enabled: true

data/CHANGELOG.md

@@ -0,0 +1,74 @@
+## [Unreleased]
+
+## [0.3.0] - 2026-01-16
+
+### Atualizado
+
+- 📦 **Ruby**: Versão mínima atualizada de 3.3.0 para **3.4.2**
+- 📦 **Shoryuken**: Dependência corrigida para ">= 6.0", "< 8.0" (compatível com versões atuais)
+- ⚡ **Performance**: Aproveita as melhorias de performance do Ruby 3.4
+- 🔧 **RuboCop**: Target atualizado para Ruby 3.4
+
+### Melhorias do Ruby 3.4
+
+Ruby 3.4 traz diversas melhorias de performance e novos recursos:
+- 🚀 **YJIT aprimorado**: ~20% mais rápido em média
+- 💾 **Garbage Collector otimizado**: Menor uso de memória
+- ⚡ **Prism Parser**: Novo parser padrão, mais rápido
+- 🔒 **Fiber Scheduler melhorado**: Melhor concorrência
+- 📊 **Improved Pattern Matching**: Sintaxe ainda mais poderosa
+
+## [0.2.0] - 2026-01-16
+
+### Atualizado
+
+- 📦 **Ruby**: Versão mínima atualizada de 3.1.0 para 3.3.0
+- 📦 **Shoryuken**: Atualizado de ~> 6.0 para ~> 7.0
+- 📦 **Concurrent-ruby**: Atualizado de ~> 1.2 para ~> 1.3
+- 📦 **Gems de desenvolvimento**: Todas atualizadas para versões mais recentes
+- 💎 **Sintaxe moderna do Ruby 3.3**:
+  - Uso de numbered parameters (`_1`)
+  - Hash shorthand syntax (`key:` em vez de `key: key`)
+  - Keyword arguments melhorados (`**context`)
+  - Pattern matching com `case/in`
+  - Uso de `dig` para navegação segura em hashes
+
+### Adicionado
+
+- 🔒 Thread-safety melhorada com Mutex na configuração
+- 📝 Licença MIT explícita
+- 📚 Badges no README
+- 🧪 Suporte a rubocop-rake e rubocop-minitest
+
+### Melhorado
+
+- ⚡ Performance: Shutdown de pools de threads otimizado
+- 🧹 Code cleanup: Métodos privados extraídos para melhor manutenção
+- 🔍 Type safety: Melhor validação de parâmetros
+
+## [0.1.0] - 2026-01-16
+
+### Adicionado
+
+- 🎉 Release inicial da gem Shoryuken Template
+- ✨ Worker Padrão (StandardWorker) para processamento simples de mensagens
+- ✨ Worker Paralelo (ParallelWorker) para processamento em batch com threads
+- ✨ Worker FIFO (FifoWorker) para processamento sequencial
+- ⚙️ Sistema de configuração flexível com suporte a variáveis de ambiente
+- ⚙️ Configuração de pool de threads e timeout específica por worker
+- 📝 Sistema de logging estruturado em formato JSON
+- 🔄 Tratamento de erros robusto com retry automático e backoff exponencial
+- ⏱️ Timeout configurável por thread (global ou por worker)
+- 🧵 Pool de threads configurável usando concurrent-ruby (global ou por worker)
+- 🚀 Otimizações específicas para deploy no Heroku
+- 📚 Documentação completa com exemplos de uso
+- 🧪 Exemplos práticos de cada tipo de worker
+- 🔧 Arquivos de configuração exemplo (shoryuken.yml, Procfile)
+
+### Funcionalidades
+
+- Graceful shutdown com limpeza de todos os pools de threads
+- Suporte a error handlers customizados
+- Logging contextualizado por worker e mensagem
+- Validação de configurações (global e por worker)
+- Pools de threads dedicados por worker quando necessário

data/CONTRIBUTING.md

@@ -0,0 +1,98 @@
+# Contribuindo para Shoryuken Template
+
+Obrigado por considerar contribuir para o Shoryuken Template! 🎉
+
+## Como Contribuir
+
+### Reportando Bugs
+
+Se você encontrou um bug, por favor abra uma issue incluindo:
+
+- Descrição clara do problema
+- Passos para reproduzir
+- Comportamento esperado vs atual
+- Versão da gem e Ruby
+- Stack trace (se aplicável)
+
+### Sugerindo Melhorias
+
+Para sugestões de novas funcionalidades ou melhorias:
+
+- Abra uma issue descrevendo a melhoria
+- Explique o caso de uso
+- Se possível, mostre exemplos de uso
+
+### Pull Requests
+
+1. Fork o repositório
+2. Crie uma branch para sua feature (`git checkout -b feature/minha-feature`)
+3. Faça suas alterações
+4. Adicione testes para novas funcionalidades
+5. Execute os testes: `bundle exec rake test`
+6. Execute o linter: `bundle exec rubocop`
+7. Commit suas mudanças (`git commit -am 'Adiciona minha feature'`)
+8. Push para a branch (`git push origin feature/minha-feature`)
+9. Abra um Pull Request
+
+## Diretrizes de Código
+
+### Style Guide
+
+- Seguimos o [Ruby Style Guide](https://rubystyle.guide/)
+- Use RuboCop para verificar o estilo: `bundle exec rubocop`
+- Mantenha métodos pequenos e focados
+- Documente código complexo
+
+### Testes
+
+- Adicione testes para todas as novas funcionalidades
+- Mantenha cobertura de testes alta
+- Use nomes descritivos para testes
+- Execute `bundle exec rake test` antes de commitar
+
+### Commits
+
+- Use mensagens de commit descritivas
+- Prefira múltiplos commits pequenos a um commit grande
+- Formato sugerido:
+  ```
+  [tipo] Resumo breve
+  
+  Descrição detalhada do que foi mudado e por quê.
+  ```
+
+Tipos: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
+
+## Configurando o Ambiente de Desenvolvimento
+
+```bash
+# Clone o repositório
+git clone https://github.com/sousmile/shoryuken-template.git
+cd shoryuken-template
+
+# Instale as dependências
+bundle install
+
+# Execute os testes
+bundle exec rake test
+
+# Execute o linter
+bundle exec rubocop
+```
+
+## Processo de Review
+
+1. Todos os PRs serão revisados por um mantenedor
+2. Mudanças podem ser solicitadas
+3. Uma vez aprovado, o PR será merged
+4. Releases seguem [Semantic Versioning](https://semver.org/)
+
+## Código de Conduta
+
+Este projeto segue um código de conduta. Ao participar, você concorda em manter um ambiente respeitoso e acolhedor para todos.
+
+## Dúvidas?
+
+Sinta-se livre para abrir uma issue ou entrar em contato através de andrade.rmn@gmail.com
+
+Obrigado pela contribuição! 🚀

data/INSTALLATION.md

@@ -0,0 +1,361 @@
+# 📦 Guia de Instalação
+
+Este guia mostra diferentes formas de instalar e usar a gem `shoryuken-template`.
+
+## 🌐 Instalação via Git (Recomendado) ⭐
+
+Esta é a forma recomendada atualmente:
+
+```ruby
+# Gemfile - Usando uma versão específica (tag)
+gem 'shoryuken-template', 
+    git: 'https://github.com/sousmile/shoryuken-template.git', 
+    tag: 'v0.3.0'
+
+# OU usando sempre a última versão
+gem 'shoryuken-template', 
+    git: 'https://github.com/sousmile/shoryuken-template.git', 
+    branch: 'master'
+```
+
+E execute:
+
+```bash
+bundle install
+```
+
+**Vantagens:**
+- ✅ Sempre atualizado
+- ✅ Funciona no Heroku e qualquer servidor
+- ✅ Não depende de publicação no RubyGems
+
+## 🌐 Instalação via RubyGems (Em breve)
+
+Quando a gem estiver publicada no RubyGems:
+
+```bash
+gem install shoryuken-template
+```
+
+Ou adicione ao seu `Gemfile`:
+
+```ruby
+gem 'shoryuken-template', '~> 0.3.0'
+```
+
+E execute:
+
+```bash
+bundle install
+```
+
+## 💻 Instalação Local (Desenvolvimento)
+
+### Método 1: Usando Rake Task (Recomendado)
+
+No diretório da gem:
+
+```bash
+# Instala a gem localmente
+rake install_local
+```
+
+Isso vai:
+1. ✅ Fazer build da gem
+2. ✅ Instalar localmente
+3. ✅ Limpar arquivos temporários
+
+Agora você pode usar em qualquer projeto:
+
+```ruby
+# Gemfile do seu projeto
+gem 'shoryuken-template'
+```
+
+### Método 2: Build e Install Manual
+
+```bash
+# 1. Build da gem
+gem build shoryuken-template.gemspec
+
+# 2. Install local
+gem install shoryuken-template-0.2.0.gem --local
+
+# 3. Cleanup (opcional)
+rm shoryuken-template-0.2.0.gem
+```
+
+### Método 3: Usando Path no Gemfile
+
+Se você está desenvolvendo a gem e quer testar mudanças em tempo real:
+
+```ruby
+# Gemfile do seu projeto
+gem 'shoryuken-template', path: '/caminho/para/shoryuken-template'
+```
+
+Ou usando path relativo:
+
+```ruby
+gem 'shoryuken-template', path: '../shoryuken-template'
+```
+
+**Vantagens:**
+- ✅ Mudanças na gem aparecem imediatamente
+- ✅ Não precisa reinstalar a cada mudança
+- ✅ Ideal para desenvolvimento
+
+**Desvantagens:**
+- ❌ Não funciona em produção
+- ❌ Path deve existir em todas as máquinas
+
+### Método 4: Usando Git no Gemfile
+
+Se a gem está em um repositório Git:
+
+```ruby
+# Gemfile do seu projeto
+gem 'shoryuken-template', git: 'https://github.com/sousmile/shoryuken-template.git'
+
+# Ou uma branch específica
+gem 'shoryuken-template', git: 'https://github.com/sousmile/shoryuken-template.git', branch: 'develop'
+
+# Ou um commit específico
+gem 'shoryuken-template', git: 'https://github.com/sousmile/shoryuken-template.git', ref: 'abc123'
+
+# Ou uma tag específica
+gem 'shoryuken-template', git: 'https://github.com/sousmile/shoryuken-template.git', tag: 'v0.2.0'
+```
+
+## 🔍 Verificando a Instalação
+
+Depois de instalar, verifique se está funcionando:
+
+```bash
+# Verifica se a gem está instalada
+gem list shoryuken-template
+
+# Abre o console Ruby e testa
+irb
+```
+
+```ruby
+require 'shoryuken/template'
+
+# Verifica a versão
+Shoryuken::Template::VERSION
+# => "0.2.0"
+
+# Testa a configuração
+Shoryuken::Template.configure do |config|
+  config.thread_pool_size = 10
+end
+
+puts "✅ Gem funcionando!"
+```
+
+## 🚀 Uso em um Novo Projeto
+
+### 1. Crie um novo projeto
+
+```bash
+mkdir meu-projeto-shoryuken
+cd meu-projeto-shoryuken
+```
+
+### 2. Crie um Gemfile
+
+```ruby
+# Gemfile
+source 'https://rubygems.org'
+
+ruby '3.4.2'
+
+gem 'shoryuken-template'
+
+# Ou usando path local para desenvolvimento
+# gem 'shoryuken-template', path: '../shoryuken-template'
+
+# Ou usando Git
+# gem 'shoryuken-template', git: 'https://github.com/sousmile/shoryuken-template.git'
+```
+
+### 3. Instale as dependências
+
+```bash
+bundle install
+```
+
+### 4. Crie um worker
+
+```ruby
+# app/workers/my_worker.rb
+require 'shoryuken/template'
+
+class MyWorker
+  include Shoryuken::Template::Workers::StandardWorker
+
+  worker_options queue: 'my-queue'
+
+  def process_message(body)
+    log_info("Processando mensagem", body:)
+    # Sua lógica aqui
+  end
+end
+```
+
+### 5. Configure
+
+```ruby
+# config/initializers/shoryuken_template.rb
+require 'shoryuken/template'
+
+Shoryuken::Template.configure do |config|
+  config.thread_pool_size = 10
+  config.thread_timeout = 300
+  config.logger_level = :info
+end
+```
+
+### 6. Execute
+
+```bash
+bundle exec shoryuken -r ./app/workers/my_worker.rb -q my-queue
+```
+
+## 🐳 Instalação com Docker
+
+### Dockerfile
+
+```dockerfile
+FROM ruby:3.4.2
+
+WORKDIR /app
+
+# Copia Gemfile
+COPY Gemfile Gemfile.lock ./
+
+# Instala dependências
+RUN bundle install
+
+# Copia código
+COPY . .
+
+CMD ["bundle", "exec", "shoryuken", "-R", "-C", "config/shoryuken.yml"]
+```
+
+### docker-compose.yml
+
+```yaml
+version: '3.8'
+
+services:
+  worker:
+    build: .
+    environment:
+      - AWS_REGION=us-east-1
+      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
+      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
+      - SHORYUKEN_THREAD_POOL_SIZE=10
+    volumes:
+      - .:/app
+```
+
+## 🔄 Atualizando a Gem
+
+### Atualizar versão instalada localmente
+
+```bash
+# No diretório da gem
+rake install_local
+```
+
+### Atualizar em um projeto
+
+```bash
+# Se instalada via RubyGems
+bundle update shoryuken-template
+
+# Se usando path local, apenas salve as mudanças na gem
+# Não precisa fazer nada, mudanças aparecem automaticamente
+
+# Se usando Git
+bundle update shoryuken-template
+```
+
+## 🗑️ Desinstalando
+
+### Remover gem instalada localmente
+
+```bash
+gem uninstall shoryuken-template
+```
+
+### Remover de um projeto
+
+```ruby
+# Remova do Gemfile
+# gem 'shoryuken-template'
+```
+
+```bash
+bundle install
+```
+
+## 🐛 Troubleshooting
+
+### Erro: "cannot load such file -- shoryuken/template"
+
+**Solução:**
+```bash
+# Verifique se a gem está instalada
+gem list shoryuken-template
+
+# Se não estiver, instale
+bundle install
+```
+
+### Erro: "Ruby version >= 3.4.0 required"
+
+**Solução:**
+```bash
+# Verifique sua versão do Ruby
+ruby --version
+
+# Atualize para 3.4.2
+rbenv install 3.4.2
+rbenv local 3.4.2
+```
+
+### Gem não atualiza com `bundle update`
+
+**Solução:**
+```bash
+# Remove o Gemfile.lock e reinstala
+rm Gemfile.lock
+bundle install
+```
+
+### Path local não funciona
+
+**Solução:**
+```bash
+# Verifique se o path está correto
+ls ../shoryuken-template
+
+# Use path absoluto se necessário
+gem 'shoryuken-template', path: '/Users/seu-usuario/projetos/shoryuken-template'
+```
+
+## 📚 Recursos Adicionais
+
+- [Bundler Documentation](https://bundler.io/)
+- [RubyGems Guides](https://guides.rubygems.org/)
+- [Shoryuken Documentation](https://github.com/ruby-shoryuken/shoryuken)
+
+## 💬 Suporte
+
+Problemas com instalação?
+
+- 📝 [Abra uma issue](https://github.com/sousmile/shoryuken-template/issues)
+- 📧 Email: andrade.rmn@gmail.com

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ramon Andrade
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.