nice_http 1.7.2 → 1.7.3

data/lib/nice_http.rb

@@ -1,411 +1,414 @@
-require "logger"
-require "nice_hash"
-require_relative "nice_http/utils"
-require_relative "nice_http/manage_request"
-require_relative "nice_http/manage_response"
-require_relative "nice_http/http_methods"
-
-######################################################
-# Attributes you can access using NiceHttp.the_attribute:
-#   :host, :port, :ssl, :headers, :debug, :log, :proxy_host, :proxy_port,
-#   :last_request, :last_response, :request_id, :use_mocks, :connections,
-#   :active, :auto_redirect, :values_for, :create_stats, :stats
-#
-# @attr [String] host The host to be accessed
-# @attr [Integer] port The port number
-# @attr [Boolean] ssl If you use ssl or not
-# @attr [Hash] headers Contains the headers you will be using on your connection
-# @attr [Boolean] debug In case true shows all the details of the communication with the host
-# @attr [String, Symbol] log :fix_file, :no, :screen, :file, "path and file name".
-#   :fix_file, will log the communication on nice_http.log. (default).
-#   :no, will not generate any logs.
-#   :screen, will print the logs on the screen.
-#   :file, will be generated a log file with name: nice_http_YY-mm-dd-HHMMSS.log.
-#   :file_run, will generate a log file with the name where the object was created and extension .log, fex: myfile.rb.log
-#   String the path and file name where the logs will be stored.
-# @attr [String] proxy_host the proxy host to be used
-# @attr [Integer] proxy_port the proxy port to be used
-# @attr [String] last_request The last request with all the content sent
-# @attr [String] last_response Only in case :debug is true, the last response with all the content
-# @attr [String] request_id If the response includes a requestId, will be stored here
-# @attr [Boolean] use_mocks If true, in case the request hash includes a :mock_response key, it will be used as the response instead
-# @attr [Array] connections It will include all the active connections (NiceHttp instances)
-# @attr [Integer] active Number of active connections
-# @attr [Boolean] auto_redirect If true, NiceHttp will take care of the auto redirections when required by the responses
-# @attr [Hash] response Contains the full response hash
-# @attr [Integer] num_redirects Number of consecutive redirections managed
-# @attr [Hash] headers The updated headers of the communication
-# @attr [Hash] cookies Cookies set. The key is the path (String) where cookies are set and the value a Hash with pairs of cookie keys and values, example:
-#   { '/' => { "cfid" => "d95adfas2550255", "amddom.settings" => "doom" } }
-# @attr [Logger] logger An instance of the Logger class where logs will be stored. You can access on anytime to store specific data, for example:
-#   my_http.logger.info "add this to the log file"
-#   @see https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html
-# @attr [Hash] values_for The default values to set on the data in case not specified others
-# @attr [Boolean] create_stats If true, NiceHttp will create stats of the http communication and store them on NiceHttp.stats hash
-# @attr [Hash] stats It contains detailed stats of the http communication
-######################################################
-class NiceHttp
-  include NiceHttpManageRequest
-  include NiceHttpManageResponse
-  include NiceHttpHttpMethods
-
-  Error = Class.new StandardError
-
-  InfoMissing = Class.new Error do
-    attr_reader :attribute
-
-    def initialize(attribute)
-      @attribute = attribute
-      message = "It was not possible to create the http connection!!!\n"
-      message += "Wrong #{attribute}, remember to supply http:// or https:// in case you specify an url to create the http connection, for example:\n"
-      message += "http = NiceHttp.new('http://example.com')"
-      super message
-    end
-  end
-
-  class << self
-    attr_accessor :host, :port, :ssl, :headers, :debug, :log, :proxy_host, :proxy_port,
-                  :last_request, :last_response, :request_id, :use_mocks, :connections,
-                  :active, :auto_redirect, :log_files, :values_for, :create_stats, :stats
-  end
-
-  at_exit do
-    if self.create_stats
-      require 'yaml'
-      self.stats.keys.each do |key|
-          File.open("./nice_http_stats_#{key}.yaml", "w") { |file| file.write(self.stats[key].to_yaml) }
-      end
-    end
-  end
-
-  ######################################################
-  # to reset to the original defaults
-  ######################################################
-  def self.reset!
-    @host = nil
-    @port = 80
-    @ssl = false
-    @headers = {}
-    @values_for = {}
-    @debug = false
-    @log = :fix_file
-    @proxy_host = nil
-    @proxy_port = nil
-    @last_request = nil
-    @last_response = nil
-    @request_id = ""
-    @use_mocks = false
-    @connections = []
-    @active = 0
-    @auto_redirect = true
-    @log_files = {}
-    @create_stats = false
-    @stats = {
-      all: {
-        num_requests: 0,
-        time_elapsed: {
-          total: 0,
-          maximum: 0,
-          minimum: 100000,
-          average: 0,
-        },
-        method: {},
-      },
-      path: {},
-      name: {},
-    }
-  end
-  reset!
-
-  ######################################################
-  # If inheriting from NiceHttp class
-  ######################################################
-  def self.inherited(subclass)
-    subclass.reset!
-  end
-
-  attr_reader :host, :port, :ssl, :debug, :log, :proxy_host, :proxy_port, :response, :num_redirects
-  attr_accessor :headers, :cookies, :use_mocks, :auto_redirect, :logger, :values_for
-
-  ######################################################
-  # Change the default values for NiceHttp supplying a Hash
-  #
-  # @param par [Hash] keys: :host, :port, :ssl, :headers, :debug, :log, :proxy_host, :proxy_port, :use_mocks, :auto_redirect, :values_for, :create_stats
-  ######################################################
-  def self.defaults=(par = {})
-    @host = par[:host] if par.key?(:host)
-    @port = par[:port] if par.key?(:port)
-    @ssl = par[:ssl] if par.key?(:ssl)
-    @headers = par[:headers].dup if par.key?(:headers)
-    @values_for = par[:values_for].dup if par.key?(:values_for)
-    @debug = par[:debug] if par.key?(:debug)
-    @log = par[:log] if par.key?(:log)
-    @proxy_host = par[:proxy_host] if par.key?(:proxy_host)
-    @proxy_port = par[:proxy_port] if par.key?(:proxy_port)
-    @use_mocks = par[:use_mocks] if par.key?(:use_mocks)
-    @auto_redirect = par[:auto_redirect] if par.key?(:auto_redirect)
-    @create_stats = par[:create_stats] if par.key?(:create_stats)
-  end
-
-  ######################################################
-  # To add specific stats
-  # The stats will be added to NiceHttp.stats[:specific]
-  #
-  # @param name [Symbol] name to group your specific stats
-  # @param state [Symbol] state of the name supplied to group your specific stats
-  # @param started [Time] when the process you want the stats started
-  # @param finished [Time] when the process you want the stats finished
-  #
-  # @example
-  #   started = Time.now
-  #   @http.send_request Requests::Customer.add_customer
-  #   30.times do
-  #      resp = @http.get(Requests::Customer.get_customer)
-  #      break if resp.code == 200
-  #      sleep 0.5
-  #   end
-  #   NiceHttp.add_stats(:customer, :create, started, Time.now)
-  ######################################################
-  def self.add_stats(name, state, started, finished)
-    self.stats[:specific] ||= {}
-    self.stats[:specific][name] ||= {num: 0, time_elapsed: {total:0, maximum:0, minimum:1000, average: 0}}
-    self.stats[:specific][name][:num] += 1
-    time_elapsed = self.stats[:specific][name][:time_elapsed]
-    time_elapsed[:total] += finished - started
-    time_elapsed[:maximum] = (finished - started) if time_elapsed[:maximum]<(finished-started)
-    time_elapsed[:minimum] = (finished - started) if time_elapsed[:minimum]>(finished-started)
-    time_elapsed[:average] = time_elapsed[:total]/self.stats[:specific][name][:num]
-
-    self.stats[:specific][name][state] ||= {num: 0, time_elapsed: {total:0, maximum:0, minimum:1000, average: 0}}
-    self.stats[:specific][name][state][:num] += 1
-    time_elapsed = self.stats[:specific][name][state][:time_elapsed]
-    time_elapsed[:total] += finished - started
-    time_elapsed[:maximum] = (finished - started) if time_elapsed[:maximum]<(finished-started)
-    time_elapsed[:minimum] = (finished - started) if time_elapsed[:minimum]>(finished-started)
-    time_elapsed[:average] = time_elapsed[:total]/self.stats[:specific][name][state][:num]
-  end
-
-
-  ######################################################
-  # Creates a new http connection.
-  #
-  # @param args [] If no parameter supplied, by default will access how is setup on defaults
-  # @example
-  #   http = NiceHttp.new()
-  # @param args [String]. The url to create the connection.
-  # @example
-  #   http = NiceHttp.new("https://www.example.com")
-  # @example
-  #   http = NiceHttp.new("example.com:8999")
-  # @example
-  #   http = NiceHttp.new("localhost:8322")
-  # @param args [Hash] containing these possible keys:
-  #
-  #             host -- example.com. (default blank screen)
-  #
-  #             port -- port for the connection. 80 (default)
-  #
-  #             ssl -- true, false (default)
-  #
-  #             headers -- hash with the headers
-  #
-  #             values_for -- hash with the values_for
-  #
-  #             debug -- true, false (default)
-  #
-  #             log -- :no, :screen, :file, :fix_file (default).
-  #
-  #                 A string with a path can be supplied.
-  #
-  #                 If :fix_file: nice_http.log
-  #
-  #                 In case :file it will be generated a log file with name: nice_http_YY-mm-dd-HHMMSS.log
-  #
-  #             proxy_host
-  #
-  #             proxy_port
-  # @example
-  #   http2 = NiceHttp.new( host: "reqres.in", port: 443, ssl: true )
-  # @example
-  #   my_server = {host: "example.com",
-  #                port: 80,
-  #                headers: {"api-key": "zdDDdjkck"}
-  #               }
-  #   http3 = NiceHttp.new my_server
-  ######################################################
-  def initialize(args = {})
-    require "net/http"
-    require "net/https"
-    @host = self.class.host
-    @port = self.class.port
-    @prepath = ""
-    @ssl = self.class.ssl
-    @headers = self.class.headers.dup
-    @values_for = self.class.values_for.dup
-    @debug = self.class.debug
-    @log = self.class.log
-    @proxy_host = self.class.proxy_host
-    @proxy_port = self.class.proxy_port
-    @use_mocks = self.class.use_mocks
-    @auto_redirect = false #set it up at the end of initialize
-    auto_redirect = self.class.auto_redirect
-    @num_redirects = 0
-    @create_stats = self.class.create_stats
-
-    #todo: set only the cookies for the current domain
-    #key: path, value: hash with key is the name of the cookie and value the value
-    # we set the default value for non existing keys to empty Hash {} so in case of merge there is no problem
-    @cookies = Hash.new { |h, k| h[k] = {} }
-
-    if args.is_a?(String)
-      uri = URI.parse(args)
-      @host = uri.host unless uri.host.nil?
-      @port = uri.port unless uri.port.nil?
-      @ssl = true if !uri.scheme.nil? && (uri.scheme == "https")
-      @prepath = uri.path unless uri.path == "/"
-    elsif args.is_a?(Hash) && !args.keys.empty?
-      @host = args[:host] if args.keys.include?(:host)
-      @port = args[:port] if args.keys.include?(:port)
-      @ssl = args[:ssl] if args.keys.include?(:ssl)
-      @headers = args[:headers].dup if args.keys.include?(:headers)
-      @values_for = args[:values_for].dup if args.keys.include?(:values_for)
-      @debug = args[:debug] if args.keys.include?(:debug)
-      @log = args[:log] if args.keys.include?(:log)
-      @proxy_host = args[:proxy_host] if args.keys.include?(:proxy_host)
-      @proxy_port = args[:proxy_port] if args.keys.include?(:proxy_port)
-      @use_mocks = args[:use_mocks] if args.keys.include?(:use_mocks)
-      auto_redirect = args[:auto_redirect] if args.keys.include?(:auto_redirect)
-    end
-
-    begin
-      log_filename = ""
-      if @log.kind_of?(String) or @log == :fix_file or @log == :file or @log == :file_run
-        if @log.kind_of?(String)
-          log_filename = @log
-        elsif @log == :fix_file
-          log_filename = "nice_http.log"
-        elsif @log == :file
-          log_filename = "nice_http_#{Time.now.strftime("%Y-%m-%d-%H%M%S")}.log"
-        elsif @log == :file_run
-          log_filename = "#{caller.first[/[^:]+/]}.log"
-        end
-        if self.class.log_files.key?(log_filename)
-          @logger = self.class.log_files[log_filename]
-        else
-          f = File.new(log_filename, "w")
-          f.sync = true
-          @logger = Logger.new f
-          self.class.log_files[log_filename] = @logger
-        end
-      elsif @log == :screen
-        @logger = Logger.new STDOUT
-      elsif @log == :no
-        @logger = Logger.new nil
-      else
-        raise InfoMissing, :log
-      end
-      @logger.level = Logger::INFO
-    rescue Exception => stack
-      @logger = Logger.new nil
-      raise InfoMissing, :log
-    end
-
-    if @host.to_s != "" and (@host.start_with?("http:") or @host.start_with?("https:"))
-      uri = URI.parse(@host)
-      @host = uri.host unless uri.host.nil?
-      @port = uri.port unless uri.port.nil?
-      @ssl = true if !uri.scheme.nil? && (uri.scheme == "https")
-      @prepath = uri.path unless uri.path == "/"
-    end
-
-    raise InfoMissing, :port if @port.to_s == ""
-    raise InfoMissing, :host if @host.to_s == ""
-    raise InfoMissing, :ssl unless @ssl.is_a?(TrueClass) or @ssl.is_a?(FalseClass)
-    raise InfoMissing, :debug unless @debug.is_a?(TrueClass) or @debug.is_a?(FalseClass)
-    raise InfoMissing, :auto_redirect unless auto_redirect.is_a?(TrueClass) or auto_redirect.is_a?(FalseClass)
-    raise InfoMissing, :use_mocks unless @use_mocks.is_a?(TrueClass) or @use_mocks.is_a?(FalseClass)
-    raise InfoMissing, :headers unless @headers.is_a?(Hash)
-    raise InfoMissing, :values_for unless @values_for.is_a?(Hash)
-
-    begin
-      if !@proxy_host.nil? && !@proxy_port.nil?
-        @http = Net::HTTP::Proxy(@proxy_host, @proxy_port).new(@host, @port)
-        @http.use_ssl = @ssl
-        @http.set_debug_output $stderr if @debug
-        @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-        @http.start
-      else
-        @http = Net::HTTP.new(@host, @port)
-        @http.use_ssl = @ssl
-        @http.set_debug_output $stderr if @debug
-        @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-        @http.start
-      end
-
-      @message_server = "(#{self.object_id}):"
-
-      log_message = "(#{self.object_id}): Http connection created. host:#{@host},  port:#{@port},  ssl:#{@ssl}, mode:#{@mode}, proxy_host: #{@proxy_host.to_s()}, proxy_port: #{@proxy_port.to_s()} "
-
-      @logger.info(log_message)
-      @message_server += " Http connection: "
-      if @ssl
-        @message_server += "https://"
-      else
-        @message_server += "http://"
-      end
-      @message_server += "#{@host}:#{@port}"
-      if @proxy_host.to_s != ""
-        @message_server += " proxy:#{@proxy_host}:#{@proxy_port}"
-      end
-      @auto_redirect = auto_redirect
-      # for the case we have headers following nice_hash implementation
-      @headers = @headers.generate
-
-      self.class.active += 1
-      self.class.connections.push(self)
-    rescue Exception => stack
-      puts stack
-      @logger.fatal stack
-    end
-  end
-
-  ######################################################
-  # Close HTTP connection
-  ######################################################
-  def close
-    begin
-      pos = 0
-      found = false
-      self.class.connections.each { |conn|
-        if conn.object_id == self.object_id
-          found = true
-          break
-        else
-          pos += 1
-        end
-      }
-      if found
-        self.class.connections.delete_at(pos)
-      end
-
-      unless @closed
-        if !@http.nil?
-          @http.finish()
-          @http = nil
-          @logger.info "the HTTP connection was closed: #{@message_server}"
-        else
-          @http = nil
-          @logger.fatal "It was not possible to close the HTTP connection: #{@message_server}"
-        end
-        @closed = true
-      else
-        @logger.warn "It was not possible to close the HTTP connection, already closed: #{@message_server}"
-      end
-    rescue Exception => stack
-      @logger.fatal stack
-    end
-    self.class.active -= 1
-  end
-
-  private :manage_request, :manage_response
-end
+require "logger"
+require "nice_hash"
+require_relative "nice_http/utils"
+require_relative "nice_http/manage_request"
+require_relative "nice_http/manage_response"
+require_relative "nice_http/http_methods"
+
+######################################################
+# Attributes you can access using NiceHttp.the_attribute:
+#   :host, :port, :ssl, :headers, :debug, :log, :proxy_host, :proxy_port,
+#   :last_request, :last_response, :request_id, :use_mocks, :connections,
+#   :active, :auto_redirect, :values_for, :create_stats, :stats
+#
+# @attr [String] host The host to be accessed
+# @attr [Integer] port The port number
+# @attr [Boolean] ssl If you use ssl or not
+# @attr [Hash] headers Contains the headers you will be using on your connection
+# @attr [Boolean] debug In case true shows all the details of the communication with the host
+# @attr [String, Symbol] log :fix_file, :no, :screen, :file, "path and file name".
+#   :fix_file, will log the communication on nice_http.log. (default).
+#   :no, will not generate any logs.
+#   :screen, will print the logs on the screen.
+#   :file, will be generated a log file with name: nice_http_YY-mm-dd-HHMMSS.log.
+#   :file_run, will generate a log file with the name where the object was created and extension .log, fex: myfile.rb.log
+#   String the path and file name where the logs will be stored.
+# @attr [String] proxy_host the proxy host to be used
+# @attr [Integer] proxy_port the proxy port to be used
+# @attr [String] last_request The last request with all the content sent
+# @attr [String] last_response Only in case :debug is true, the last response with all the content
+# @attr [String] request_id If the response includes a requestId, will be stored here
+# @attr [Boolean] use_mocks If true, in case the request hash includes a :mock_response key, it will be used as the response instead
+# @attr [Array] connections It will include all the active connections (NiceHttp instances)
+# @attr [Integer] active Number of active connections
+# @attr [Boolean] auto_redirect If true, NiceHttp will take care of the auto redirections when required by the responses
+# @attr [Hash] response Contains the full response hash
+# @attr [Integer] num_redirects Number of consecutive redirections managed
+# @attr [Hash] headers The updated headers of the communication
+# @attr [Hash] cookies Cookies set. The key is the path (String) where cookies are set and the value a Hash with pairs of cookie keys and values, example:
+#   { '/' => { "cfid" => "d95adfas2550255", "amddom.settings" => "doom" } }
+# @attr [Logger] logger An instance of the Logger class where logs will be stored. You can access on anytime to store specific data, for example:
+#   my_http.logger.info "add this to the log file"
+#   @see https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html
+# @attr [Hash] values_for The default values to set on the data in case not specified others
+# @attr [Boolean] create_stats If true, NiceHttp will create stats of the http communication and store them on NiceHttp.stats hash
+# @attr [Hash] stats It contains detailed stats of the http communication
+######################################################
+class NiceHttp
+  include NiceHttpManageRequest
+  include NiceHttpManageResponse
+  include NiceHttpHttpMethods
+
+  Error = Class.new StandardError
+
+  InfoMissing = Class.new Error do
+    attr_reader :attribute
+
+    def initialize(attribute)
+      @attribute = attribute
+      message = "It was not possible to create the http connection!!!\n"
+      message += "Wrong #{attribute}, remember to supply http:// or https:// in case you specify an url to create the http connection, for example:\n"
+      message += "http = NiceHttp.new('http://example.com')"
+      super message
+    end
+  end
+
+  class << self
+    attr_accessor :host, :port, :ssl, :headers, :debug, :log, :proxy_host, :proxy_port,
+                  :last_request, :last_response, :request_id, :use_mocks, :connections,
+                  :active, :auto_redirect, :log_files, :values_for, :create_stats, :stats
+  end
+
+  at_exit do
+    if self.create_stats
+      require 'yaml'
+      self.stats.keys.each do |key|
+          File.open("./nice_http_stats_#{key}.yaml", "w") { |file| file.write(self.stats[key].to_yaml) }
+      end
+    end
+  end
+
+  ######################################################
+  # to reset to the original defaults
+  ######################################################
+  def self.reset!
+    @host = nil
+    @port = 80
+    @ssl = false
+    @headers = {}
+    @values_for = {}
+    @debug = false
+    @log = :fix_file
+    @proxy_host = nil
+    @proxy_port = nil
+    @last_request = nil
+    @last_response = nil
+    @request_id = ""
+    @use_mocks = false
+    @connections = []
+    @active = 0
+    @auto_redirect = true
+    @log_files = {}
+    @create_stats = false
+    @stats = {
+      all: {
+        num_requests: 0,
+        time_elapsed: {
+          total: 0,
+          maximum: 0,
+          minimum: 100000,
+          average: 0,
+        },
+        method: {},
+      },
+      path: {},
+      name: {},
+    }
+  end
+  reset!
+
+  ######################################################
+  # If inheriting from NiceHttp class
+  ######################################################
+  def self.inherited(subclass)
+    subclass.reset!
+  end
+
+  attr_reader :host, :port, :ssl, :debug, :log, :proxy_host, :proxy_port, :response, :num_redirects
+  attr_accessor :headers, :cookies, :use_mocks, :auto_redirect, :logger, :values_for
+
+  ######################################################
+  # Change the default values for NiceHttp supplying a Hash
+  #
+  # @param par [Hash] keys: :host, :port, :ssl, :headers, :debug, :log, :proxy_host, :proxy_port, :use_mocks, :auto_redirect, :values_for, :create_stats
+  ######################################################
+  def self.defaults=(par = {})
+    @host = par[:host] if par.key?(:host)
+    @port = par[:port] if par.key?(:port)
+    @ssl = par[:ssl] if par.key?(:ssl)
+    @headers = par[:headers].dup if par.key?(:headers)
+    @values_for = par[:values_for].dup if par.key?(:values_for)
+    @debug = par[:debug] if par.key?(:debug)
+    @log = par[:log] if par.key?(:log)
+    @proxy_host = par[:proxy_host] if par.key?(:proxy_host)
+    @proxy_port = par[:proxy_port] if par.key?(:proxy_port)
+    @use_mocks = par[:use_mocks] if par.key?(:use_mocks)
+    @auto_redirect = par[:auto_redirect] if par.key?(:auto_redirect)
+    @create_stats = par[:create_stats] if par.key?(:create_stats)
+  end
+
+  ######################################################
+  # To add specific stats
+  # The stats will be added to NiceHttp.stats[:specific]
+  #
+  # @param name [Symbol] name to group your specific stats
+  # @param state [Symbol] state of the name supplied to group your specific stats
+  # @param started [Time] when the process you want the stats started
+  # @param finished [Time] when the process you want the stats finished
+  #
+  # @example
+  #   started = Time.now
+  #   @http.send_request Requests::Customer.add_customer
+  #   30.times do
+  #      resp = @http.get(Requests::Customer.get_customer)
+  #      break if resp.code == 200
+  #      sleep 0.5
+  #   end
+  #   NiceHttp.add_stats(:customer, :create, started, Time.now)
+  ######################################################
+  def self.add_stats(name, state, started, finished)
+    self.stats[:specific] ||= {}
+    self.stats[:specific][name] ||= {num: 0, time_elapsed: {total:0, maximum:0, minimum:1000, average: 0}}
+    self.stats[:specific][name][:num] += 1
+    time_elapsed = self.stats[:specific][name][:time_elapsed]
+    time_elapsed[:total] += finished - started
+    time_elapsed[:maximum] = (finished - started) if time_elapsed[:maximum]<(finished-started)
+    time_elapsed[:minimum] = (finished - started) if time_elapsed[:minimum]>(finished-started)
+    time_elapsed[:average] = time_elapsed[:total]/self.stats[:specific][name][:num]
+
+    self.stats[:specific][name][state] ||= {num: 0, time_elapsed: {total:0, maximum:0, minimum:1000, average: 0}}
+    self.stats[:specific][name][state][:num] += 1
+    time_elapsed = self.stats[:specific][name][state][:time_elapsed]
+    time_elapsed[:total] += finished - started
+    time_elapsed[:maximum] = (finished - started) if time_elapsed[:maximum]<(finished-started)
+    time_elapsed[:minimum] = (finished - started) if time_elapsed[:minimum]>(finished-started)
+    time_elapsed[:average] = time_elapsed[:total]/self.stats[:specific][name][state][:num]
+  end
+
+
+  ######################################################
+  # Creates a new http connection.
+  #
+  # @param args [] If no parameter supplied, by default will access how is setup on defaults
+  # @example
+  #   http = NiceHttp.new()
+  # @param args [String]. The url to create the connection.
+  # @example
+  #   http = NiceHttp.new("https://www.example.com")
+  # @example
+  #   http = NiceHttp.new("example.com:8999")
+  # @example
+  #   http = NiceHttp.new("localhost:8322")
+  # @param args [Hash] containing these possible keys:
+  #
+  #             host -- example.com. (default blank screen)
+  #
+  #             port -- port for the connection. 80 (default)
+  #
+  #             ssl -- true, false (default)
+  #
+  #             headers -- hash with the headers
+  #
+  #             values_for -- hash with the values_for
+  #
+  #             debug -- true, false (default)
+  #
+  #             log -- :no, :screen, :file, :fix_file (default).
+  #
+  #                 A string with a path can be supplied.
+  #
+  #                 If :fix_file: nice_http.log
+  #
+  #                 In case :file it will be generated a log file with name: nice_http_YY-mm-dd-HHMMSS.log
+  #
+  #             proxy_host
+  #
+  #             proxy_port
+  # @example
+  #   http2 = NiceHttp.new( host: "reqres.in", port: 443, ssl: true )
+  # @example
+  #   my_server = {host: "example.com",
+  #                port: 80,
+  #                headers: {"api-key": "zdDDdjkck"}
+  #               }
+  #   http3 = NiceHttp.new my_server
+  ######################################################
+  def initialize(args = {})
+    require "net/http"
+    require "net/https"
+    @host = self.class.host
+    @port = self.class.port
+    @prepath = ""
+    @ssl = self.class.ssl
+    @headers = self.class.headers.dup
+    @values_for = self.class.values_for.dup
+    @debug = self.class.debug
+    @log = self.class.log
+    @proxy_host = self.class.proxy_host
+    @proxy_port = self.class.proxy_port
+    @use_mocks = self.class.use_mocks
+    @auto_redirect = false #set it up at the end of initialize
+    auto_redirect = self.class.auto_redirect
+    @num_redirects = 0
+    @create_stats = self.class.create_stats
+
+    #todo: set only the cookies for the current domain
+    #key: path, value: hash with key is the name of the cookie and value the value
+    # we set the default value for non existing keys to empty Hash {} so in case of merge there is no problem
+    @cookies = Hash.new { |h, k| h[k] = {} }
+
+    if args.is_a?(String)
+      uri = URI.parse(args)
+      @host = uri.host unless uri.host.nil?
+      @port = uri.port unless uri.port.nil?
+      @ssl = true if !uri.scheme.nil? && (uri.scheme == "https")
+      @prepath = uri.path unless uri.path == "/"
+    elsif args.is_a?(Hash) && !args.keys.empty?
+      @host = args[:host] if args.keys.include?(:host)
+      @port = args[:port] if args.keys.include?(:port)
+      @ssl = args[:ssl] if args.keys.include?(:ssl)
+      @headers = args[:headers].dup if args.keys.include?(:headers)
+      @values_for = args[:values_for].dup if args.keys.include?(:values_for)
+      @debug = args[:debug] if args.keys.include?(:debug)
+      @log = args[:log] if args.keys.include?(:log)
+      @proxy_host = args[:proxy_host] if args.keys.include?(:proxy_host)
+      @proxy_port = args[:proxy_port] if args.keys.include?(:proxy_port)
+      @use_mocks = args[:use_mocks] if args.keys.include?(:use_mocks)
+      auto_redirect = args[:auto_redirect] if args.keys.include?(:auto_redirect)
+    end
+
+    begin
+      log_filename = ""
+      if @log.kind_of?(String) or @log == :fix_file or @log == :file or @log == :file_run
+        if @log.kind_of?(String)
+          log_filename = @log.dup
+        elsif @log == :fix_file
+          log_filename = "nice_http.log"
+        elsif @log == :file
+          log_filename = "nice_http_#{Time.now.strftime("%Y-%m-%d-%H%M%S")}.log"
+        elsif @log == :file_run
+          log_filename = "#{caller.first[/[^:]+/]}.log"
+        end
+        if Thread.current.name.to_s!=''
+          log_filename.gsub!(/\.log$/, "_#{Thread.current.name}.log")
+        end
+        if self.class.log_files.key?(log_filename)
+          @logger = self.class.log_files[log_filename]
+        else
+          f = File.new(log_filename, "w")
+          f.sync = true
+          @logger = Logger.new f
+          self.class.log_files[log_filename] = @logger
+        end
+      elsif @log == :screen
+        @logger = Logger.new STDOUT
+      elsif @log == :no
+        @logger = Logger.new nil
+      else
+        raise InfoMissing, :log
+      end
+      @logger.level = Logger::INFO
+    rescue Exception => stack
+      @logger = Logger.new nil
+      raise InfoMissing, :log
+    end
+
+    if @host.to_s != "" and (@host.start_with?("http:") or @host.start_with?("https:"))
+      uri = URI.parse(@host)
+      @host = uri.host unless uri.host.nil?
+      @port = uri.port unless uri.port.nil?
+      @ssl = true if !uri.scheme.nil? && (uri.scheme == "https")
+      @prepath = uri.path unless uri.path == "/"
+    end
+
+    raise InfoMissing, :port if @port.to_s == ""
+    raise InfoMissing, :host if @host.to_s == ""
+    raise InfoMissing, :ssl unless @ssl.is_a?(TrueClass) or @ssl.is_a?(FalseClass)
+    raise InfoMissing, :debug unless @debug.is_a?(TrueClass) or @debug.is_a?(FalseClass)
+    raise InfoMissing, :auto_redirect unless auto_redirect.is_a?(TrueClass) or auto_redirect.is_a?(FalseClass)
+    raise InfoMissing, :use_mocks unless @use_mocks.is_a?(TrueClass) or @use_mocks.is_a?(FalseClass)
+    raise InfoMissing, :headers unless @headers.is_a?(Hash)
+    raise InfoMissing, :values_for unless @values_for.is_a?(Hash)
+
+    begin
+      if !@proxy_host.nil? && !@proxy_port.nil?
+        @http = Net::HTTP::Proxy(@proxy_host, @proxy_port).new(@host, @port)
+        @http.use_ssl = @ssl
+        @http.set_debug_output $stderr if @debug
+        @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        @http.start
+      else
+        @http = Net::HTTP.new(@host, @port)
+        @http.use_ssl = @ssl
+        @http.set_debug_output $stderr if @debug
+        @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        @http.start
+      end
+
+      @message_server = "(#{self.object_id}):"
+
+      log_message = "(#{self.object_id}): Http connection created. host:#{@host},  port:#{@port},  ssl:#{@ssl}, mode:#{@mode}, proxy_host: #{@proxy_host.to_s()}, proxy_port: #{@proxy_port.to_s()} "
+
+      @logger.info(log_message)
+      @message_server += " Http connection: "
+      if @ssl
+        @message_server += "https://"
+      else
+        @message_server += "http://"
+      end
+      @message_server += "#{@host}:#{@port}"
+      if @proxy_host.to_s != ""
+        @message_server += " proxy:#{@proxy_host}:#{@proxy_port}"
+      end
+      @auto_redirect = auto_redirect
+      # for the case we have headers following nice_hash implementation
+      @headers = @headers.generate
+
+      self.class.active += 1
+      self.class.connections.push(self)
+    rescue Exception => stack
+      puts stack
+      @logger.fatal stack
+    end
+  end
+
+  ######################################################
+  # Close HTTP connection
+  ######################################################
+  def close
+    begin
+      pos = 0
+      found = false
+      self.class.connections.each { |conn|
+        if conn.object_id == self.object_id
+          found = true
+          break
+        else
+          pos += 1
+        end
+      }
+      if found
+        self.class.connections.delete_at(pos)
+      end
+
+      unless @closed
+        if !@http.nil?
+          @http.finish()
+          @http = nil
+          @logger.info "the HTTP connection was closed: #{@message_server}"
+        else
+          @http = nil
+          @logger.fatal "It was not possible to close the HTTP connection: #{@message_server}"
+        end
+        @closed = true
+      else
+        @logger.warn "It was not possible to close the HTTP connection, already closed: #{@message_server}"
+      end
+    rescue Exception => stack
+      @logger.fatal stack
+    end
+    self.class.active -= 1
+  end
+
+  private :manage_request, :manage_response
+end