docker-swarm 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b43832405fbf723559703102c4d84a42c27c677d601625de43c81ceb2db804d0
-  data.tar.gz: 57d9349d4ce67bc9e157c6d235e5cf4925b0af05df53ce0f29fffd2bd888fbb7
+  metadata.gz: b46f33638fb88f8c9fca4a85747f67e266525933e4b22d38bb47e2ce1556a552
+  data.tar.gz: b080b742324d91eb1570af605b05539da67284fb76631faae04583f2577edad3
 SHA512:
-  metadata.gz: 72c9fa985935caac2386f9b782ac3728f4c5ffbd121db6f5b36a6e1291eafed9bc5500bd0841385caad69ad5430152b5d11d10261c4ad73fbda86bd9cc7053b3
-  data.tar.gz: e841eaa3cad32138f809a40556a2c798fb97e7c92bf40975d2076adbd6650a699eb5635880f6c50d598de2c1017045d61771ff88f7a794f8482a71bdb32b7fe3
+  metadata.gz: 17f03f903b19273e822feb4a389ff9b862d034607f032c3b6112838b1ddf5f38927dabad4001214f6ad9ce6a06f8661939b38fb2fa3dda8a0b1975246da199fa
+  data.tar.gz: 44edbe59ffa431b2cf78735ca138c2fd4c41d0d57dda543509d9de8a417343c525d1a3493d549fa4e2ebfc63948491a2994917df493683c25f8c33e2f795eadf

data/README.md

@@ -3,7 +3,7 @@
 [![Gem Version](https://badge.fury.io/rb/docker-swarm.svg)](https://badge.fury.io/rb/docker-swarm)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-`docker-swarm` es un ORM ligero y cliente API robusto para interactuar con Docker Swarm desde Ruby. Diseñado para sentirse familiar a los desarrolladores de Rails, utiliza `ActiveModel` para ofrecer una interfaz limpia y potente.
+`docker-swarm` es un ORM ligero y cliente API robusto para interactuar con Docker Swarm desde Ruby. Diseñado para sentirse familiar a los desarrolladores de Rails, utiliza `ActiveModel` para ofrecer una interfaz limpia y potente con estándares de observabilidad de Wispro.
 
 ## 🚀 Inicio Rápido
 
@@ -13,42 +13,37 @@ require 'docker_swarm'
 # Configurar (opcional, usa defaults)
 DockerSwarm.configure do |config|
   config.socket_path = "unix:///var/run/docker.sock"
+  config.log_level = Logger::INFO
+  config.read_timeout = 30
+  config.max_retries = 3
 end
 
-# Listar servicios
+# Listar servicios (con soporte para Indifferent Access en arrays)
 services = DockerSwarm::Service.all
-services.each { |s| puts "#{s.ID}: #{s.Spec['Name']}" }
+services.each { |s| puts "#{s.ID}: #{s.Spec[:Name]}" }
 
 # Crear un nuevo servicio
 service = DockerSwarm::Service.create(
+  Name: "my-webapp",
   Spec: {
-    Name: "my-webapp",
     TaskTemplate: {
       ContainerSpec: { Image: "nginx:latest" }
     }
   }
 )
 
-# Obtener logs
+# Obtener logs (stdout y stderr habilitados por defecto)
 puts service.logs
 ```
 
-## 📖 Documentación Completa
-
-Para profundizar en el uso de la gema, consulta las siguientes guías:
-
-1.  **[Guía de Configuración](docs/configuration.md)**: Cómo configurar el socket, logger y opciones globales.
-2.  **[Uso del ORM (Modelos)](docs/models.md)**: Todo sobre el ciclo de vida de los recursos (`Service`, `Node`, `Task`, etc.).
-3.  **[Cliente de API (Bajo Nivel)](docs/api.md)**: Cómo realizar peticiones personalizadas directamente a la API de Docker.
-4.  **[Manejo de Errores](docs/errors.md)**: Jerarquía de excepciones y mapeo de errores de Docker.
-5.  **[Pruebas y Mocking](docs/testing.md)**: Guía para testear tu aplicación sin depender de un socket de Docker real.
-
 ## 🛠 Características Clave
 
+- **Observabilidad Wispro**: Logging estructurado (KV) con `component`, `event`, `source` y `duration_ms` usando reloj monotónico.
+- **Seguridad**: Enmascaramiento automático de secretos (`password`, `token`, etc.) en los logs.
+- **Deep Indifferent Access**: Acceso a atributos mediante símbolos o strings, incluso en resultados de listados (`.all`).
+- **Resiliencia**: Gestión inteligente de timeouts (`read`, `write`, `connect`) y reintentos automáticos para errores de red.
 - **Mapeo PascalCase**: Mantiene la fidelidad con los atributos de Docker (e.g., `s.ID`, `s.Spec`) evitando transformaciones costosas.
 - **ActiveModel Ready**: Soporta validaciones, serialización JSON y comportamientos estándar de modelos Ruby.
-- **Surgical Updates**: Actualizaciones precisas enviando solo el índice de versión y el payload necesario.
-- **Excon Stack**: Basado en `Excon` con middlewares para encoding de peticiones, parseo de respuestas y gestión de errores.
 
 ## 🤝 Contribuir
 

data/lib/docker_swarm/configuration.rb

@@ -4,12 +4,18 @@ require "logger"
 
 module DockerSwarm
   class Configuration
-    attr_accessor :socket_path, :logger, :log_level
+    attr_accessor :socket_path, :logger, :log_level,
+                  :read_timeout, :write_timeout, :connect_timeout,
+                  :max_retries
 
     def initialize
       @socket_path = "unix:///var/run/docker.sock"
       @logger = Logger.new($stdout)
       @log_level = Logger::INFO
+      @read_timeout = 60
+      @write_timeout = 60
+      @connect_timeout = 10
+      @max_retries = 3
     end
   end
 end

data/lib/docker_swarm/connection.rb

@@ -16,12 +16,22 @@ module DockerSwarm
                 level: :debug,
                 data: { method: options[:method], path: options[:path] })
 
-      response = client.request(options)
+      # Combinar opciones por defecto de la gema con las de la petición
+      request_options = {
+        idempotent: true,
+        retry_errors: [Excon::Error::Socket, Excon::Error::Timeout],
+        read_timeout: DockerSwarm.configuration.read_timeout,
+        write_timeout: DockerSwarm.configuration.write_timeout,
+        connect_timeout: DockerSwarm.configuration.connect_timeout,
+        retries: DockerSwarm.configuration.max_retries
+      }.merge(options)
+
+      response = client.request(request_options)
       
       log_event("request_success", 
                 data: { 
-                  method: options[:method], 
-                  path: options[:path], 
+                  method: request_options[:method], 
+                  path: request_options[:path], 
                   status: response.status, 
                   duration_ms: calculate_duration(start_time) 
                 })

data/lib/docker_swarm/middleware/request_encoder.rb

@@ -4,12 +4,28 @@ module DockerSwarm
   module Middleware
     class RequestEncoder < Excon::Middleware::Base
       def request_call(env)
-        if env[:body] && env[:body].is_a?(Hash)
-          env[:body] = env[:body].to_json
-          env[:headers]["Content-Type"] ||= "application/json"
+        if env[:body] && !env[:body].is_a?(String)
+          content_type = (env[:headers]["Content-Type"] || env[:headers][:content_type]).to_s
+          env[:body] = serialize_body(env[:body], content_type)
+          
+          if content_type.blank? || content_type.include?("application/json")
+            env[:headers]["Content-Type"] ||= "application/json"
+          end
         end
         @stack.request_call(env)
       end
+
+      private
+
+      def serialize_body(body, content_type)
+        if content_type.include?("application/x-www-form-urlencoded")
+          URI.encode_www_form(body)
+        elsif content_type.include?("multipart/form-data")
+          body
+        else
+          body.to_json
+        end
+      end
     end
   end
 end

data/lib/docker_swarm/middleware/response_json_parser.rb

@@ -9,17 +9,29 @@ module DockerSwarm
           headers = env[:response][:headers] || {}
 
           if body && !body.empty? && headers["Content-Type"]&.include?("application/json")
-            begin
-              parsed = JSON.parse(body)
-              env[:response][:body] = parsed.is_a?(Hash) ? parsed.with_indifferent_access : parsed
-            rescue JSON::ParserError
-              # Keep original body if parsing fails
-            end
+            env[:response][:body] = parse_json(body)
           end
         end
         
         @stack.response_call(env)
       end
+
+      private
+
+      def parse_json(body)
+        result = body.is_a?(String) ? JSON.parse(body) : body
+
+        case result
+        when Hash
+          result.with_indifferent_access
+        when Array
+          result.map { |item| item.is_a?(Hash) ? item.with_indifferent_access : item }
+        else
+          result
+        end
+      rescue JSON::ParserError
+        body
+      end
     end
   end
 end

data/lib/docker_swarm/models/service.rb

@@ -8,20 +8,11 @@ module DockerSwarm
     include Concerns::Updatable
     include Concerns::Deletable
 
-    validate :validate_name_presence
-
     # Fetches logs for the service
     # @param query_params [Hash] Query parameters for the logs endpoint (stdout, stderr, follow, etc.)
     # @return [String] The raw log stream
     def logs(query_params = { stdout: 1, stderr: 1 })
       Api.request(action: self.class.routes[:logs], arguments: { id: self.ID }, query_params: query_params)
     end
-
-    private
-
-    def validate_name_presence
-      name = attributes["Name"] || (respond_to?(:Name) ? Name : nil)
-      errors.add(:Name, "can't be blank") if name.blank?
-    end
   end
 end

data/lib/docker_swarm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DockerSwarm
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docker-swarm
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Gabriel