functionator 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a60f63f5b13bd75c67507ee3326b6db811411036f5df352f3987ab464891dbd8
+  data.tar.gz: 5f11f90e991f592ddb9c54d522d7ca57188ca75b71cd63b68dded9fc314e7a54
+SHA512:
+  metadata.gz: '09d242b6e2c17e859bc843f61e0212bddcfa132fbb845a26c474c19b4049beb34fb60c8678d7ff8aa41ae444aca010c7f5e52250181f83fa26215d4f1585c00f'
+  data.tar.gz: 3a6983b3ae5705389621e2d60f24f1344fa0efc59f131017badbe1cd1c44f95ad2d3c6654f06e6364fcdc7dd041bd740273e45b24ba12826a53fe71413841fc0

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'dotenv', '~> 2.8'

data/README.md

@@ -0,0 +1,129 @@
+# Functionator
+
+Uma gem Ruby multi-funcional que fornece diversas funcionalidades organizadas em módulos, incluindo um cliente MongoDB com padrão Singleton e operações comuns de banco de dados.
+
+## Instalação
+
+Adicione esta linha ao seu Gemfile:
+
+```ruby
+gem 'functionator'
+```
+
+E execute:
+
+```bash
+$ bundle install
+```
+
+Ou instale diretamente:
+
+```bash
+$ gem install functionator
+```
+
+## Configuração
+
+Configure as variáveis de ambiente para conexão com MongoDB:
+
+```bash
+# Opção 1: Variáveis padrão
+export USER=seu_usuario_mongodb
+export PASSWORD=sua_senha_mongodb
+export HOST=seu_host_mongodb
+export DATABASE=seu_database_mongodb
+
+# Opção 2: Variáveis específicas do MongoDB
+export MONGODB_USER=seu_usuario_mongodb
+export MONGODB_PASSWORD=sua_senha_mongodb
+export MONGODB_HOST=seu_host_mongodb
+export MONGODB_DATABASE=seu_database_mongodb
+```
+
+## Uso
+
+### Básico
+
+```ruby
+require 'functionator'
+
+# Usando o módulo MongoDB com padrão Singleton
+client = Functionator.mongodb
+
+# Ou acessando diretamente
+client = Functionator::MongoDB::Client.instance
+
+# Ou criando uma nova instância com string de conexão customizada
+client = Functionator::MongoDB::Client.new("mongodb://localhost:27017/meu_database")
+```
+
+### Operações CRUD
+
+```ruby
+# Inserir múltiplos documentos
+data = [
+  { name: "João", age: 30 },
+  { name: "Maria", age: 25 }
+]
+client.insert_many("users", data)
+
+# Buscar documentos
+users = client.find("users", { age: { "$gte" => 25 } })
+
+# Buscar com ordenação e limite
+recent_users = client.find_sort("users", {}, { created_at: -1 }, 10)
+
+# Atualizar documento
+client.update("users", { name: "João" }, { "$set" => { age: 31 } })
+```
+
+### Operações Especializadas
+
+```ruby
+# Contar status de requests (método específico do domínio)
+status_counts = client.count_status_requests("requests")
+
+# Upsert de logs
+document = { ms: 1234567890, message: "Log entry", created_at: Time.now }
+client.upsert_log_to_mongo("logs", document)
+
+# Buscar grupos de log
+log_groups = client.fetch_log_groups_from_mongo
+
+# Obter última execução
+last_run = client.get_last_run_from_mongo("executions", 1234567890)
+```
+
+## Métodos Disponíveis
+
+- `insert_many(collection_name, data)` - Insere múltiplos documentos
+- `find(collection_name, query)` - Busca documentos
+- `find_sort(collection_name, query, sort, limit)` - Busca com ordenação e limite
+- `update(collection_name, query, update_query)` - Atualiza documento
+- `update_log_group(collection_name, query, update_query, upsert: false)` - Atualiza com opção de upsert
+- `count_status_requests(collection_name)` - Conta status de requests por domínio
+- `upsert_log_to_mongo(collection_name, document)` - Upsert de logs
+- `upsert_log_to_mongo_log_group(collection_name, document)` - Upsert de grupos de log
+- `fetch_log_groups_from_mongo` - Busca grupos de log
+- `get_last_run_from_mongo(collection_name, ms)` - Obtém última execução
+
+## Desenvolvimento
+
+Após clonar o repositório:
+
+```bash
+$ bundle install
+$ rake spec  # Para executar os testes
+```
+
+## Contribuição
+
+1. Faça um Fork do projeto
+2. Crie uma branch para sua feature (`git checkout -b my-new-feature`)
+3. Commit suas mudanças (`git commit -am 'Add some feature'`)
+4. Push para a branch (`git push origin my-new-feature`)
+5. Crie um Pull Request
+
+## Licença
+
+Esta gem está disponível como código aberto sob os termos da [Licença MIT](https://opensource.org/licenses/MIT).

data/functionator.gemspec

@@ -0,0 +1,22 @@
+require_relative 'lib/functionator/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "functionator"
+  spec.version       = Functionator::VERSION
+  spec.authors       = ["Kaique Leonardo"]
+  spec.email         = ["kaique.silva@terceiros-sky.com"]
+
+  spec.summary       = %q{A MongoDB client factory with common operations}
+  spec.description   = %q{Functionator - A Ruby gem that provides a MongoDB client factory with singleton pattern and common database operations like insert, find, update, and aggregation queries.}
+  spec.homepage      = "https://github.com/seuusuario/functionator"
+  spec.license       = "MIT"
+
+  spec.files         = Dir["lib/**/*", "README.md", "Gemfile", "functionator.gemspec"]
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "mongo", "~> 2.18"
+  
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/functionator/mongodb/client.rb

@@ -0,0 +1,169 @@
+require 'mongo'
+
+module Functionator
+  module MongoDB
+    class Client
+      @instance = nil
+
+      def self.instance
+        @instance ||= new
+      end
+
+      def initialize(connection_string = nil)
+        @connection_string = connection_string || build_connection_string
+        @client = Mongo::Client.new(@connection_string)
+      end
+
+      def client
+        @client
+      end
+
+      def insert_many(collection_name, data)
+        client[collection_name.to_sym].insert_many(data)
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+      end
+
+      def find(collection_name, query)
+        client[collection_name.to_sym].find(query).to_a
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+        []
+      end
+
+      def find_sort(collection_name, query, sort, limit)
+        client[collection_name.to_sym].find(query).sort(sort).limit(limit).to_a
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+        []
+      end
+
+      def update(collection_name, query, query_up)
+        client[collection_name.to_sym].update_one(query, query_up)
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+      end
+
+      def update_log_group(collection_name, query, query_up, upsert: false)
+        client[collection_name.to_sym].update_one(query, query_up, upsert: upsert)
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+      end  
+
+      def count_status_requests(collection_name)
+        begin
+          pipeline = [
+            { '$match' => { 'status' => { '$regex' => '^(Success|Failure)', '$options' => 'i' } } },
+            { '$project' => {
+                'domain' => 1,
+                'status_code' => {
+                  '$let' => {
+                    'vars' => {
+                      'regex_result' => {
+                        '$regexFind' => {
+                          'input' => '$status',
+                          'regex' => 'HTTP Status Code (\d{3})',
+                          'options' => 'i'
+                        }
+                      }
+                    },
+                    'in' => { '$ifNull' => ['$$regex_result.match', 'N/A'] }
+                  }
+                },
+                'status' => 1
+              }
+            },
+            { '$group' => {
+                '_id' => '$domain',
+                'total' => { '$sum' => 1 },
+                'status_success' => { '$sum' => { '$cond' => [{ '$regexMatch' => { 'input' => '$status', 'regex' => '^Success', 'options' => 'i' } }, 1, 0] } },
+                'status_failure' => { '$sum' => { '$cond' => [{ '$regexMatch' => { 'input' => '$status', 'regex' => '^Failure', 'options' => 'i' } }, 1, 0] } },
+                'status_codes' => { '$push' => '$status_code' }
+              }
+            },
+            { '$project' => {
+                'domain' => '$_id',
+                'total_requests' => '$total',
+                'status_success' => 1,
+                'status_failure' => 1,
+                'status_codes' => 1,
+                '_id' => 0
+              }
+            }
+          ]
+
+          result = client[collection_name.to_sym].aggregate(pipeline).to_a
+          result.map do |client_data|
+            status_codes_count = client_data['status_codes'].tally
+            {
+              domain: client_data['domain'],
+              total_requests: client_data['total_requests'] || 0,
+              status_success: client_data['status_success'] || 0,
+              status_failure: client_data['status_failure'] || 0,
+              status_codes_count: status_codes_count
+            }
+          end
+        rescue StandardError => e
+          puts "Error: #{e.message}"
+          []
+        end
+      end
+
+      def upsert_log_to_mongo(collection_name, document)
+        existing_document = find(collection_name, { ms: document[:ms] }).first
+        document.delete(:created_at) if existing_document
+        result = update(collection_name, { ms: document[:ms] }, { '$set' => document })
+
+        if result&.upserted_count&.positive?
+          puts "Inserted new document for ms: #{document[:ms]}"
+        else
+          puts "Updated document for ms: #{document[:ms]}"
+        end
+      rescue StandardError => e
+        puts "Error upserting into MongoDB: #{e.message}"
+      end
+
+      def upsert_log_to_mongo_log_group(collection_name, document)
+          existing_document = find(collection_name, { ms: document[:ms] }).first
+          document.delete(:created_at) if existing_document
+          result = update_log_group(collection_name, { ms: document[:ms] }, { '$set' => document }, upsert: true)
+
+          if result&.upserted_count&.positive?
+            puts "Inserted new document for ms: #{document[:ms]}"
+          else
+            puts "Updated document for ms: #{document[:ms]}"
+          end
+        rescue StandardError => e
+          puts "Error upserting into MongoDB: #{e.message}"
+      end  
+
+      def fetch_log_groups_from_mongo
+        log_groups = {}
+        find('log_group_lambda', {}).each do |doc|
+          next unless doc['ms'] && doc['log_groups'].is_a?(Array)
+          log_groups[doc['ms']] = doc['log_groups']
+        end
+        log_groups
+      end
+
+      def get_last_run_from_mongo(collection_name, ms)
+        collection = find_sort(collection_name, { ms: ms }, { last_run: -1 }, 1).first
+        collection ? collection[:last_run] : nil
+      rescue StandardError => e
+        puts "Error fetching last_run: #{e.message}"
+        nil
+      end
+
+      private
+
+      def build_connection_string
+        user = ENV['USER'] || ENV['MONGODB_USER']
+        password = ENV['PASSWORD'] || ENV['MONGODB_PASSWORD'] 
+        host = ENV['HOST'] || ENV['MONGODB_HOST']
+        database = ENV['DATABASE'] || ENV['MONGODB_DATABASE']
+        
+        "mongodb+srv://#{user}:#{password}@#{host}/#{database}?retryWrites=true&w=majority&readPreference=primaryPreferred"
+      end
+    end
+  end
+end

data/lib/functionator/version.rb

@@ -0,0 +1,3 @@
+module Functionator
+  VERSION = "0.1.0"
+end

data/lib/functionator.rb

@@ -0,0 +1,12 @@
+require_relative 'functionator/version'
+require_relative 'functionator/mongodb/client'
+
+module Functionator
+  # Entry point for the Functionator gem
+  # A multi-purpose library with various functionalities
+  
+  # MongoDB functionality
+  def self.mongodb
+    Functionator::MongoDB::Client.instance
+  end
+end

data/lib/mongodb_factory/client.rb

@@ -0,0 +1,167 @@
+require 'mongo'
+
+module MongodbFactory
+  class Client
+    @instance = nil
+
+    def self.instance
+      @instance ||= new
+    end
+
+    def initialize(connection_string = nil)
+      @connection_string = connection_string || build_connection_string
+      @client = Mongo::Client.new(@connection_string)
+    end
+
+    def client
+      @client
+    end
+
+    def insert_many(collection_name, data)
+      client[collection_name.to_sym].insert_many(data)
+    rescue StandardError => e
+      puts "Error: #{e.message}"
+    end
+
+    def find(collection_name, query)
+      client[collection_name.to_sym].find(query).to_a
+    rescue StandardError => e
+      puts "Error: #{e.message}"
+      []
+    end
+
+    def find_sort(collection_name, query, sort, limit)
+      client[collection_name.to_sym].find(query).sort(sort).limit(limit).to_a
+    rescue StandardError => e
+      puts "Error: #{e.message}"
+      []
+    end
+
+    def update(collection_name, query, query_up)
+      client[collection_name.to_sym].update_one(query, query_up)
+    rescue StandardError => e
+      puts "Error: #{e.message}"
+    end
+
+    def update_log_group(collection_name, query, query_up, upsert: false)
+      client[collection_name.to_sym].update_one(query, query_up, upsert: upsert)
+    rescue StandardError => e
+      puts "Error: #{e.message}"
+    end  
+
+    def count_status_requests(collection_name)
+      begin
+        pipeline = [
+          { '$match' => { 'status' => { '$regex' => '^(Success|Failure)', '$options' => 'i' } } },
+          { '$project' => {
+              'domain' => 1,
+              'status_code' => {
+                '$let' => {
+                  'vars' => {
+                    'regex_result' => {
+                      '$regexFind' => {
+                        'input' => '$status',
+                        'regex' => 'HTTP Status Code (\d{3})',
+                        'options' => 'i'
+                      }
+                    }
+                  },
+                  'in' => { '$ifNull' => ['$$regex_result.match', 'N/A'] }
+                }
+              },
+              'status' => 1
+            }
+          },
+          { '$group' => {
+              '_id' => '$domain',
+              'total' => { '$sum' => 1 },
+              'status_success' => { '$sum' => { '$cond' => [{ '$regexMatch' => { 'input' => '$status', 'regex' => '^Success', 'options' => 'i' } }, 1, 0] } },
+              'status_failure' => { '$sum' => { '$cond' => [{ '$regexMatch' => { 'input' => '$status', 'regex' => '^Failure', 'options' => 'i' } }, 1, 0] } },
+              'status_codes' => { '$push' => '$status_code' }
+            }
+          },
+          { '$project' => {
+              'domain' => '$_id',
+              'total_requests' => '$total',
+              'status_success' => 1,
+              'status_failure' => 1,
+              'status_codes' => 1,
+              '_id' => 0
+            }
+          }
+        ]
+
+        result = client[collection_name.to_sym].aggregate(pipeline).to_a
+        result.map do |client_data|
+          status_codes_count = client_data['status_codes'].tally
+          {
+            domain: client_data['domain'],
+            total_requests: client_data['total_requests'] || 0,
+            status_success: client_data['status_success'] || 0,
+            status_failure: client_data['status_failure'] || 0,
+            status_codes_count: status_codes_count
+          }
+        end
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+        []
+      end
+    end
+
+    def upsert_log_to_mongo(collection_name, document)
+      existing_document = find(collection_name, { ms: document[:ms] }).first
+      document.delete(:created_at) if existing_document
+      result = update(collection_name, { ms: document[:ms] }, { '$set' => document })
+
+      if result&.upserted_count&.positive?
+        puts "Inserted new document for ms: #{document[:ms]}"
+      else
+        puts "Updated document for ms: #{document[:ms]}"
+      end
+    rescue StandardError => e
+      puts "Error upserting into MongoDB: #{e.message}"
+    end
+
+    def upsert_log_to_mongo_log_group(collection_name, document)
+        existing_document = find(collection_name, { ms: document[:ms] }).first
+        document.delete(:created_at) if existing_document
+        result = update_log_group(collection_name, { ms: document[:ms] }, { '$set' => document }, upsert: true)
+
+        if result&.upserted_count&.positive?
+          puts "Inserted new document for ms: #{document[:ms]}"
+        else
+          puts "Updated document for ms: #{document[:ms]}"
+        end
+      rescue StandardError => e
+        puts "Error upserting into MongoDB: #{e.message}"
+    end  
+
+    def fetch_log_groups_from_mongo
+      log_groups = {}
+      find('log_group_lambda', {}).each do |doc|
+        next unless doc['ms'] && doc['log_groups'].is_a?(Array)
+        log_groups[doc['ms']] = doc['log_groups']
+      end
+      log_groups
+    end
+
+    def get_last_run_from_mongo(collection_name, ms)
+      collection = find_sort(collection_name, { ms: ms }, { last_run: -1 }, 1).first
+      collection ? collection[:last_run] : nil
+    rescue StandardError => e
+      puts "Error fetching last_run: #{e.message}"
+      nil
+    end
+
+    private
+
+    def build_connection_string
+      user = ENV['USER'] || ENV['MONGODB_USER']
+      password = ENV['PASSWORD'] || ENV['MONGODB_PASSWORD'] 
+      host = ENV['HOST'] || ENV['MONGODB_HOST']
+      database = ENV['DATABASE'] || ENV['MONGODB_DATABASE']
+      
+      "mongodb+srv://#{user}:#{password}@#{host}/#{database}?retryWrites=true&w=majority&readPreference=primaryPreferred"
+    end
+  end
+end

data/lib/mongodb_factory/version.rb

@@ -0,0 +1,3 @@
+module Functionator
+  VERSION = "0.1.0"
+end

data/lib/mongodb_factory.rb

@@ -0,0 +1,12 @@
+require_relative 'functionator/version'
+require_relative 'functionator/mongodb/client'
+
+module Functionator
+  # Entry point for the Functionator gem
+  # A multi-purpose library with various functionalities
+  
+  # MongoDB functionality
+  def self.mongodb
+    Functionator::MongoDB::Client.instance
+  end
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: functionator
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kaique Leonardo
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-07-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mongo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.18'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Functionator - A Ruby gem that provides a MongoDB client factory with
+  singleton pattern and common database operations like insert, find, update, and
+  aggregation queries.
+email:
+- kaique.silva@terceiros-sky.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- README.md
+- functionator.gemspec
+- lib/functionator.rb
+- lib/functionator/mongodb/client.rb
+- lib/functionator/version.rb
+- lib/mongodb_factory.rb
+- lib/mongodb_factory/client.rb
+- lib/mongodb_factory/version.rb
+homepage: https://github.com/seuusuario/functionator
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: A MongoDB client factory with common operations
+test_files: []