spectre-core 1.14.2 → 1.14.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1d19a96bd18baeb678abc3670c744bbd8855b4680db1e05bd57dcd99dfc3f21
-  data.tar.gz: db9f3efd3faf3bf571845b1ae340a133ee9a95065cec2b8469d28b0a76985996
+  metadata.gz: 95442cbc13e78bd7fee6da1512708a07feb44846579ccede48c5c0e78bdbf3a5
+  data.tar.gz: 27297fba1be0eff1cebca38f37624483a5f52b1bf94a6f89a1ec4f0142294772
 SHA512:
-  metadata.gz: dcfa21488bfce34984bac2efa1bc7fa73d703eb84d730497edef928fd9eea35be33abe9774d3becf38a1424d2e347728b5627ec1d053ac69e19b82b8b937decb
-  data.tar.gz: af9018490eb268a7820419e597ea2eb5d8887ed7606c28bb7180e28245347f8d4fe630e26028113a39fd8ad7b54744b20687376fa1c386102ded67bb4ee38874
+  metadata.gz: 6a4ff3fd06c3c83349936ac1daec3002c7b36634cdef74e02aee89a1ee7bf87a13047079f86bfa7b9c389307b6cebe59d32a8cd4eac2e55bb734b35f00c990be
+  data.tar.gz: 4e57aafb0e340f308ed339c0ea56d695fd7546dfd6c7dce2d20540bdcd1e595b29b0ee308d2f07d2c66e221e96c2d605fff5e3cc713d30190132128598ddfd4f

data/exe/spectre

@@ -23,13 +23,6 @@ DEFAULT_CONFIG = {
   'tags' => [],
   'colored' => true,
   'verbose' => false,
-  'reporters' => [
-    'Spectre::Reporter::Console',
-  ],
-  'loggers' => [
-    'Spectre::Logging::Console',
-    'Spectre::Logging::File',
-  ],
   'log_file' => './logs/spectre_<date>.log',
   'log_format' => {
     'console' => {
@@ -55,8 +48,8 @@ DEFAULT_CONFIG = {
   'modules' => [
     'spectre/helpers',
     'spectre/reporter/console',
-    'spectre/logger/console',
-    'spectre/logger/file',
+    'spectre/logging/console',
+    'spectre/logging/file',
     'spectre/assertion',
     'spectre/diagnostic',
     'spectre/environment',
@@ -135,10 +128,6 @@ OptionParser.new do |opts|
     cmd_options['out_path'] = File.absolute_path(path)
   end
 
-  opts.on('-r NAME,NAME', '--reporters NAME,NAME', Array, "A list of reporters to use") do |reporters|
-    cmd_options['reporters'] = reporters
-  end
-
   opts.on('-m MODULE,MODULE', '--modules MODULE,MODULE', Array, "Load the given modules") do |modules|
     modules.each do |mod|
       require mod
@@ -195,6 +184,7 @@ action = ARGV[0] || 'run'
 cfg = {}
 cfg.deep_merge! DEFAULT_CONFIG
 
+# Load global config file first
 global_config_file = File.join File.expand_path('~'), '.spectre'
 
 if File.exists? global_config_file
@@ -202,6 +192,7 @@ if File.exists? global_config_file
   cfg.deep_merge! global_options if global_options
 end
 
+# Then load local config file
 config_file = cmd_options['config_file'] || cfg['config_file']
 
 if File.exists? config_file
@@ -216,6 +207,7 @@ cfg['debug'] = DEFAULT_CONFIG['debug']
 # Set project name
 cfg['project'] = File.basename(Dir.pwd) unless cfg['project']
 
+# And merge the command line arguments last
 cfg.deep_merge! cmd_options
 
 
@@ -336,24 +328,24 @@ if ['list', 'run'].include? action
       .concat(cfg['include'])
       .select { |mod| !cfg['exclude'].include? mod }
       .each do |mod|
-      begin
-        mod_file = mod + '.rb'
-        spectre_lib_mod = File.join(File.dirname(__dir__), 'lib', mod_file)
-
-        if File.exists? mod_file
-          require_relative mod_file
-
-        elsif File.exists? spectre_lib_mod
-          require_relative spectre_lib_mod
-
-        else
-          require mod
+        begin
+          mod_file = mod + '.rb'
+          spectre_lib_mod = File.join(File.dirname(__dir__), 'lib', mod_file)
+
+          if File.exists? mod_file
+            require_relative mod_file
+
+          elsif File.exists? spectre_lib_mod
+            require_relative spectre_lib_mod
+
+          else
+            require mod
+          end
+        rescue LoadError => e
+          puts "Unable to load module #{mod}. Check if the module exists or remove it from your spectre config:\n#{e.message}"
+          exit 1
         end
-      rescue LoadError => e
-        puts "Unable to load module #{mod}. Check if the module exists or remove it from your spectre config:\n#{e.message}"
-        exit 1
       end
-    end
 
     # Load mixins
 
@@ -367,11 +359,6 @@ if ['list', 'run'].include? action
 
     Spectre::Logging.debug! if cfg['debug']
 
-    cfg['loggers'].each do |logger_name|
-      logger = Kernel.const_get(logger_name).new(cfg)
-      Spectre::Logging.add(logger)
-    end if cfg['loggers']
-
     specs = Spectre.specs(cfg['specs'], cfg['tags'])
 
     unless specs.any?
@@ -381,12 +368,9 @@ if ['list', 'run'].include? action
 
     run_infos = Spectre::Runner.new.run(specs)
 
-    cfg['reporters'].each do |reporter|
-      reporter = Kernel.const_get(reporter).new(cfg)
-      reporter.report(run_infos)
-    end
+    Spectre::Reporter.report(run_infos)
 
-    errors = run_infos.select { |x| nil != x.error or nil != x.failure }
+    errors = run_infos.select { |x| x.error? or x.failed? }
 
     exit 0 if cfg['ignore_failure'] or not errors.any?
 
@@ -542,10 +526,13 @@ DEFAULT_GEMFILE = %[source 'https://rubygems.org'
 
 gem 'spectre-core', '>= #{Spectre::VERSION}'
 # gem 'spectre-mysql', '>= 1.0.0'
-# gem 'spectre-ssh', '>= 1.0.0'
+# gem 'spectre-ssh', '>= 1.0.2'
 # gem 'spectre-ftp', '>= 1.0.0'
 # gem 'spectre-curl', '>= 1.0.0'
-# gem 'spectre-git', '>= 0.1.0'
+# gem 'spectre-git', '>= 0.2.1'
+# gem 'spectre-reporter-junit', '>= 1.0.0'
+# gem 'spectre-reporter-vstest', '>= 1.0.1'
+# gem 'spectre-reporter-html', '>= 1.0.0'
 ]
 
 if 'init' == action

data/lib/spectre/assertion.rb

@@ -1,8 +1,8 @@
 require_relative '../spectre'
-require_relative '../spectre/helpers'
+require_relative 'helpers'
+require_relative 'logging'
 
 require 'ostruct'
-require_relative 'logger'
 
 
 module Spectre
@@ -249,20 +249,20 @@ module Spectre
         status = 'unknown'
 
         begin
-          Logging.log_process("expect #{desc}")
+          Spectre::Logging.log_process("expect #{desc}")
           yield
-          Logging.log_status(desc, Logging::Status::OK)
-          status = 'ok'
+          Spectre::Logging.log_status(desc, Logging::Status::OK)
+          status = :ok
         rescue Interrupt => e
-          status = 'skipped'
+          status = :skipped
           raise e
         rescue AssertionFailure => e
-          Logging.log_status(desc, Logging::Status::FAILED)
-          status = 'failed'
+          Spectre::Logging.log_status(desc, Logging::Status::FAILED)
+          status = :failed
           raise AssertionFailure.new(e.message, e.expected, e.actual, desc), cause: nil
         rescue Exception => e
-          Logging.log_status(desc, Logging::Status::ERROR)
-          status = 'error'
+          Spectre::Logging.log_status(desc, Logging::Status::ERROR)
+          status = :error
           raise AssertionFailure.new("An unexpected error occurred during expectation: #{e.message}", nil, nil, desc), cause: e
         ensure
           Spectre::Runner.current.expectations.append([desc, status])
@@ -274,7 +274,7 @@ module Spectre
         prefix += " '#{desc}'" if desc
 
         begin
-          Logging.log_info(prefix) if desc
+          Spectre::Logging.log_info(prefix) if desc
           yield
           @@success = true
           @@logger.info("#{prefix} finished with success")

data/lib/spectre/bag.rb

@@ -5,17 +5,13 @@ require 'ostruct'
 module Spectre
   module Bag
     class << self
-      @@bag
+      @@bag = OpenStruct.new
 
       def bag
         @@bag
       end
     end
 
-    Spectre.register do |_config|
-      @@bag = OpenStruct.new
-    end
-
     Spectre.delegate :bag, to: self
   end
 end

data/lib/spectre/curl.rb

@@ -279,7 +279,7 @@ module Spectre::Curl
         cmd.append('-d', '"\n"')
       end
 
-      # Add certificate path if one if given
+      # Add certificate path if one is given
       if req['cert']
         raise "Certificate '#{req['cert']}' does not exist" unless File.exists? req['cert']
 

data/lib/spectre/helpers.rb

@@ -130,6 +130,7 @@ end
 
 def uuid length = nil
   return SecureRandom.hex(length/2) if length
+
   SecureRandom.uuid
 end
 

data/lib/spectre/http.rb

@@ -1,4 +1,5 @@
 require_relative '../spectre'
+require_relative '../spectre/logging'
 
 require 'net/http'
 require 'openssl'

data/lib/spectre/{logger → logging}/console.rb

@@ -4,15 +4,18 @@ module Spectre
   module Logging
     class Console
       def initialize config
-        raise 'No log format section in config for console logger' unless config.key? 'log_format' and config['log_format'].key? 'console'
-
-        @config = config['log_format']['console']
-        @indent = @config['indent'] || 2
-        @width = @config['width'] || 80
-        @fmt_end_context = @config['end_context']
-        @fmt_sep = @config['separator']
-        @fmt_start_group = @config['start_group']
-        @fmt_end_group = @config['end_group']
+        @indent = 2
+        @width = 80
+
+        if config.key? 'log_format'
+          @config = config['log_format']['console'] || {}
+          @indent = @config['indent'] || @indent
+          @width = @config['width'] || @width
+          @fmt_end_context = @config['end_context']
+          @fmt_sep = @config['separator']
+          @fmt_start_group = @config['start_group']
+          @fmt_end_group = @config['end_group']
+        end
 
         @process = nil
         @level = 0
@@ -145,5 +148,9 @@ module Spectre
         end
       end
     end
+
+    Spectre.register do |config|
+      Spectre::Logging.add Console.new(config)
+    end
   end
 end

data/lib/spectre/{logger → logging}/file.rb

@@ -98,5 +98,9 @@ module Spectre
         @file_log.debug(msg)
       end
     end
+
+    Spectre.register do |config|
+      Spectre::Logging.add File.new(config)
+    end
   end
 end

data/lib/spectre/{logger.rb → logging.rb}

@@ -1,5 +1,6 @@
 require_relative '../spectre'
 require 'date'
+require 'logger'
 
 module Spectre
   module Logging
@@ -23,17 +24,24 @@ module Spectre
 
       def info message
         @logger.info(message)
-        Logging.add_log(message, :info, @name)
+        Spectre::Logging.add_log(message, :info, @name)
       end
 
       def debug message
+        return unless @debug
+
         @logger.debug(message)
-        Logging.add_log(message, :debug, @name) if @debug
+        Spectre::Logging.add_log(message, :debug, @name)
       end
 
       def warn message
         @logger.warn(message)
-        Logging.add_log(message, :warn, @name)
+        Spectre::Logging.add_log(message, :warn, @name)
+      end
+
+      def error message
+        @logger.error(message)
+        Spectre::Logging.add_log(message, :error, @name)
       end
     end
 
@@ -50,7 +58,7 @@ module Spectre
       end
 
       def add logger
-        @@logger.append logger
+        @@logger.append(logger)
       end
 
       def start_subject subject
@@ -143,9 +151,9 @@ module Spectre
       end
 
       def group desc
-        Logging.start_group desc
+        Spectre::Logging.start_group(desc)
         yield
-        Logging.end_group desc
+        Spectre::Logging.end_group(desc)
       end
 
       def add_log message, level, logger_name='spectre'
@@ -168,6 +176,6 @@ module Spectre
       end
     end
 
-    Spectre.delegate :log, :info, :debug, :group, :separate, to: self
+    Spectre.delegate(:log, :info, :debug, :group, :separate, to: self)
   end
 end

data/lib/spectre/mixin.rb

@@ -1,5 +1,5 @@
 require_relative '../spectre'
-require_relative 'logger'
+require_relative 'logging'
 
 require 'ostruct'
 

data/lib/spectre/reporter/console.rb

@@ -1,7 +1,9 @@
+require_relative '../reporter'
+
 module Spectre::Reporter
   class Console
     def initialize config
-      @config = config
+      @debug = config['debug']
     end
 
     def report run_infos
@@ -91,8 +93,12 @@ module Spectre::Reporter
       str += "       file.....: #{file}:#{line}\n"
       str += "       type.....: #{error.class}\n"
       str += "       message..: #{error.message}\n"
-      str += "       backtrace: \n         #{error.backtrace.join("\n         ")}\n" if @config['debug']
+      str += "       backtrace: \n         #{error.backtrace.join("\n         ")}\n" if @debug
       str
     end
+
+    Spectre.register do |config|
+      Spectre::Reporter.add Console.new(config)
+    end
   end
 end

data/lib/spectre/reporter.rb

@@ -0,0 +1,17 @@
+module Spectre
+  module Reporter
+    @@reporters = []
+
+    def self.add reporter
+      raise NotImplementedError.new("#{reporter} does not implement `report' method") unless reporter.respond_to? :report
+
+      @@reporters.append(reporter)
+    end
+
+    def self.report run_infos
+      @@reporters.each do |reporter|
+        reporter.report(run_infos)
+      end
+    end
+  end
+end

data/lib/spectre.rb

@@ -2,7 +2,7 @@ module Spectre
   module Version
     MAJOR = 1
     MINOR = 14
-    TINY  = 2
+    TINY  = 3
   end
 
   VERSION = [Version::MAJOR, Version::MINOR, Version::TINY].compact * '.'
@@ -13,10 +13,6 @@ module Spectre
       merger = proc { |_key, v1, v2| Hash === v1 && Hash === v2 ? v1.merge!(v2, &merger) : v2 }
       self.merge!(second, &merger)
     end
-
-    def deep_clone
-      Marshal.load(Marshal.dump(self))
-    end
   end
 
   class ::Object
@@ -25,6 +21,10 @@ module Spectre
         hash[var.to_s.delete("@")] = self.instance_variable_get(var)
       end
     end
+
+    def deep_clone
+      Marshal.load(Marshal.dump(self))
+    end
   end
 
 
@@ -84,16 +84,24 @@ module Spectre
       @name = desc.downcase.gsub(/[^a-z0-9]+/, '_')
     end
 
-    def add_spec desc, tags, data, block, context, file
+    def add_spec desc, tags, data, block, context, file, line
       name = @name + '-' + (@specs.length+1).to_s
-      @specs << Spec.new(name, self, desc, tags, data, block, context, file)
+      @specs << Spec.new(name, self, desc, tags, data, block, context, file, line)
+    end
+
+    def to_h
+      {
+        name: @name,
+        desc: @desc,
+        specs: @specs.map { |x| x.to_h },
+      }
     end
   end
 
   class Spec
-    attr_reader :name, :subject, :context, :desc, :tags, :data, :block, :file
+    attr_reader :id, :name, :subject, :context, :desc, :tags, :data, :block, :file, :line
 
-    def initialize name, subject, desc, tags, data, block, context, file
+    def initialize name, subject, desc, tags, data, block, context, file, line
       @name = name
       @context = context
       @data = data
@@ -102,11 +110,25 @@ module Spectre
       @tags = tags
       @block = block
       @file = file
+      @line = line
     end
 
     def full_desc
       @subject.desc + ' ' + desc
     end
+
+    def to_h
+      {
+        name: @name,
+        context: @context.__desc,
+        data: @data.map { |x| x.to_h },
+        subject: @subject.desc,
+        desc: @desc,
+        tags: @tags,
+        file: @file,
+        line: @line,
+      }
+    end
   end
 
   class RunInfo
@@ -149,22 +171,41 @@ module Spectre
 
       return :success
     end
+
+    def to_h
+      date_format = '%FT%T.%L%:z'
+
+      {
+        spec: @spec.name,
+        data: @data,
+        started: @started.strftime(date_format),
+        finished: @finished.strftime(date_format),
+        error: @error,
+        failure: @failure,
+        skipped: @skipped,
+        log: @log.map { |timestamp, message, level, name| [timestamp.strftime(date_format), message, level, name] },
+        expectations: @expectations,
+        properties: @properties,
+      }
+    end
   end
 
   class Runner
-    @@current = nil
-
     def self.current
-      @@current
+      Thread.current.thread_variable_get('current_run')
+    end
+
+    def self.current= run
+      Thread.current.thread_variable_set('current_run', run)
     end
 
     def run specs
       runs = []
 
       specs.group_by { |x| x.subject }.each do |subject, subject_specs|
-        Logging.log_subject subject do
+        Spectre::Logging.log_subject subject do
           subject_specs.group_by { |x| x.context }.each do |context, context_specs|
-            Logging.log_context(context) do
+            Spectre::Logging.log_context(context) do
               runs.concat run_context(context, context_specs)
             end
           end
@@ -193,12 +234,12 @@ module Spectre
             spec.data
               .map { |x| x.is_a?(Hash) ? OpenStruct.new(x) : x }
               .each do |data|
-                Logging.log_spec(spec, data) do
+                Spectre::Logging.log_spec(spec, data) do
                   runs << run_spec(spec, data)
                 end
               end
           else
-            Logging.log_spec(spec) do
+            Spectre::Logging.log_spec(spec) do
               runs << run_spec(spec)
             end
           end
@@ -215,11 +256,11 @@ module Spectre
     def run_setup spec
       run_info = RunInfo.new(spec)
 
-      @@current = run_info
+      Runner.current = run_info
 
       run_info.started = Time.now
 
-      Logging.log_context(spec.context) do
+      Spectre::Logging.log_context(spec.context) do
         begin
           spec.block.call()
 
@@ -228,13 +269,13 @@ module Spectre
           run_info.failure = e
         rescue Exception => e
           run_info.error = e
-          Logging.log_error(spec, e)
+          Spectre::Logging.log_error(spec, e)
         end
       end
 
       run_info.finished = Time.now
 
-      @@current = nil
+      Runner.current = nil
 
       run_info
     end
@@ -242,7 +283,7 @@ module Spectre
     def run_spec spec, data=nil
       run_info = RunInfo.new(spec, data)
 
-      @@current = run_info
+      Runner.current = run_info
 
       run_info.started = Time.now
 
@@ -250,7 +291,7 @@ module Spectre
         if spec.context.__before_blocks.count > 0
           before_ctx = SpecContext.new(spec.subject, 'before', spec.context)
 
-          Logging.log_context before_ctx do
+          Spectre::Logging.log_context before_ctx do
             spec.context.__before_blocks.each do |block|
               block.call(data)
             end
@@ -262,18 +303,18 @@ module Spectre
         run_info.failure = e
       rescue SpectreSkip => e
         run_info.skipped = true
-        Logging.log_skipped(spec, e.message)
+        Spectre::Logging.log_skipped(spec, e.message)
       rescue Interrupt
         run_info.skipped = true
-        Logging.log_skipped(spec, 'canceled by user')
+        Spectre::Logging.log_skipped(spec, 'canceled by user')
       rescue Exception => e
         run_info.error = e
-        Logging.log_error(spec, e)
+        Spectre::Logging.log_error(spec, e)
       ensure
         if spec.context.__after_blocks.count > 0
           after_ctx = SpecContext.new(spec.subject, 'after', spec.context)
 
-          Logging.log_context after_ctx do
+          Spectre::Logging.log_context after_ctx do
             begin
               spec.context.__after_blocks.each do |block|
                 block.call
@@ -284,7 +325,7 @@ module Spectre
               run_info.failure = e
             rescue Exception => e
               run_info.error = e
-              Logging.log_error(spec, e)
+              Spectre::Logging.log_error(spec, e)
             end
           end
         end
@@ -292,7 +333,7 @@ module Spectre
 
       run_info.finished = Time.now
 
-      @@current = nil
+      Runner.current = nil
 
       run_info
     end
@@ -319,9 +360,9 @@ module Spectre
     end
 
     def it desc, tags: [], with: [], &block
-      spec_file = get_file()
+      spec_file, line = get_call_location()
 
-      @__subject.add_spec(desc, tags, with, block, self, spec_file)
+      @__subject.add_spec(desc, tags, with, block, self, spec_file, line)
     end
 
     def before &block
@@ -333,19 +374,19 @@ module Spectre
     end
 
     def setup &block
-      name = "#{@__subject.name}-setup"
-      spec_file = get_file()
+      name = "#{@__subject.name}-setup-#{@__setup_blocks.count+1}"
+      spec_file, line = get_call_location()
 
       setup_ctx = SpecContext.new(@__subject, 'setup', self)
-      @__setup_blocks << Spec.new(name, @__subject, 'setup', [], nil, block, setup_ctx, spec_file)
+      @__setup_blocks << Spec.new(name, @__subject, 'setup', [], nil, block, setup_ctx, spec_file, line)
     end
 
     def teardown &block
-      name = "#{@__subject.name}-teardown"
-      spec_file = get_file()
+      name = "#{@__subject.name}-teardown-#{@__teardown_blocks.count+1}"
+      spec_file, line = get_call_location()
 
       teardown_ctx = SpecContext.new(@__subject, 'teardown', self)
-      @__teardown_blocks << Spec.new(name, @__subject, 'teardown', [], nil, block, teardown_ctx, spec_file)
+      @__teardown_blocks << Spec.new(name, @__subject, 'teardown', [], nil, block, teardown_ctx, spec_file, line)
     end
 
     def context desc=nil, &block
@@ -355,21 +396,11 @@ module Spectre
 
     private
 
-    def get_file
-      # Get the file, where the spec is defined.
-      # Nasty, but it works
-      # Maybe there is another way, but this works for now
-
-      begin
-        raise
-      rescue => e
-        return e.backtrace
-          .select { |file| !file.include? 'lib/spectre' }
-          .first
-          .match(/(.*\.rb):\d+/)
-          .captures
-          .first
-      end
+    def get_call_location
+      path_and_line = caller[1].split(':')
+      line = path_and_line[-2].to_i
+      file = path_and_line[0..-3].join(':')
+      [file, line]
     end
   end
 
@@ -409,8 +440,9 @@ module Spectre
     @@subjects = []
     @@modules = []
 
-    attr_reader :file_log, :logger
-
+    def subjects
+      @@subjects
+    end
 
     def specs spec_filter=[], tags=[]
       @@subjects
@@ -443,6 +475,11 @@ module Spectre
       end
     end
 
+    def purge
+      @@subjects = []
+      @@modules = []
+    end
+
 
     ###########################################
     # Global Functions
@@ -470,7 +507,7 @@ module Spectre
     end
   end
 
-  delegate :describe, :property, :skip, to: Spectre
+  delegate(:describe, :property, :skip, to: Spectre)
 end
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spectre-core
 version: !ruby/object:Gem::Version
-  version: 1.14.2
+  version: 1.14.3
 platform: ruby
 authors:
 - Christian Neubauer
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-09-08 00:00:00.000000000 Z
+date: 2023-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ectoplasm
@@ -58,10 +58,11 @@ files:
 - lib/spectre/http.rb
 - lib/spectre/http/basic_auth.rb
 - lib/spectre/http/keystone.rb
-- lib/spectre/logger.rb
-- lib/spectre/logger/console.rb
-- lib/spectre/logger/file.rb
+- lib/spectre/logging.rb
+- lib/spectre/logging/console.rb
+- lib/spectre/logging/file.rb
 - lib/spectre/mixin.rb
+- lib/spectre/reporter.rb
 - lib/spectre/reporter/console.rb
 - lib/spectre/resources.rb
 homepage: https://github.com/ionos-spectre/spectre-core
@@ -86,7 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.3.26
 signing_key: 
 specification_version: 4
 summary: Describe and run automated tests