rspec-nagios-formatter 0.0.3 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8b72496752c108b2f355a8f5368425e3eb2cbc48
-  data.tar.gz: fd03b3be2958a68fe30797d394f42b9d8a45fb1c
+  metadata.gz: 4240c25f93392c262ce1fb69d05cfb483b1b6075
+  data.tar.gz: 4ce8435fc6d4de3424de10c1e680175900fa5bea
 SHA512:
-  metadata.gz: 68e4276d41375c06a5bec19e0f4a821c6dd63962524a195bdd02a19424373dfc98e064ccde41284e2201cc1e06d3183f62679aad20331a8f3d7b0f9aceac290b
-  data.tar.gz: ffe8f0b808867c264b8e3d82043768129b0c0f2c8ea2e59d84d9d7e1d48c9a0c153b7b62aee4d1348a2555568418b3e94f161037755f5fcc486ac179ec5676bc
+  metadata.gz: 6f95fe8a95ab32fa17e5dbeb562ed5693e69fc537c02e3c7d9f23c07c53c1c78164e50c57da095dcbe0415101dbc54afea752cf061e65f3b75abbe66a27b69c6
+  data.tar.gz: f547a3190089bba1938f4ad834c82ddc442a1a592137a742ff86fc5cd35c834cf23bd1126ae04c1abc41030323d13d5a67692b4004d8d945c916a4a50ecbe19c

data/.gitignore

@@ -4,3 +4,4 @@ Gemfile.lock
 *.orig
 *.rej
 *.patch
+tmp/aruba/

data/.travis.yml

@@ -3,5 +3,6 @@ rvm:
   - 1.9.2
   - 1.9.3
   - 2.0.0
+script: "rake spec features"
 notifications:
   email: false

data/README.md

@@ -25,6 +25,24 @@ Install
 Usage
 -----
 
+The formatter may be used by either passing the `-f|--format` flag to `rspec` or with the included `check_rspec` script.  The later sets the appropriate exit status for a failing Nagios/Icinga plugin.
+
+### `check_rspec`
+
+    Usage: check_rspec [options] [--] [passed to rspec]
+
+    Specific options:
+        -t, --timeout TIMEOUT            default: 30.0 (seconds)
+        -h, --help                       Show this message
+
+Any options to `check_rspec` not prefixed with `-` or `--` are passed directly
+on to the `rspec` utility.  If you need to pass an option flag you may
+terminated `check_rspec`'s option parsing with a bare `--`. 
+
+    check_rspec -- -e 'foo' trivial_spec.rb
+
+### `rspec`
+
     rspec -f RSpec::Nagios::Formatter
 
 See the documentation on [rspec --format](https://www.relishapp.com/rspec/rspec-core/v/2-6/docs/command-line/format-option)
@@ -55,3 +73,10 @@ Support
 -------
 
 Please log tickets and issues at [github](https://github.com/jhoblitt/rspec-nagios-formatter)
+
+See Also
+--------
+
+* [cucumber-nagios](http://auxesis.github.io/cucumber-nagios/)
+* [RSpec](https://github.com/rspec/rspec)
+* [Icinga Plugins](http://docs.icinga.org/latest/en/plugins.html)

data/Rakefile

@@ -6,3 +6,10 @@ RSpec::Core::RakeTask.new(:spec)
 task :default => [
   :spec,
 ]
+
+require 'cucumber'
+require 'cucumber/rake/task'
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format pretty -x"
+  t.fork = false
+end

data/bin/check_rspec

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'open3'
+require 'timeout'
+
+EXIT_CRITICAL = 2
+
+options = { :timeout => 30.0 }
+option_parser = OptionParser.new do |opts|
+  opts.banner = "Usage: check_rspec [options] [--] [passed to rspec]"
+  opts.separator ""
+  opts.separator "Specific options:"
+
+  opts.on("-t", "--timeout TIMEOUT", "default: 30.0 (seconds)", Float) do |t|
+    options[:timeout] = t
+  end
+
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+end
+
+option_parser.parse!
+
+cmd  = ['rspec', '--format', 'RSpec::Nagios::Formatter', ARGV]
+cmd_stdout, cmd_stderr, cmd_status = nil
+
+begin
+  Timeout::timeout(options[:timeout]) {
+    cmd_stdout, cmd_stderr, cmd_status = Open3.capture3(cmd.join(' '))
+  }
+rescue Timeout::Error
+  puts "RSPEC Critical - timeout after #{options[:timeout]} seconds"
+  exit EXIT_CRITICAL
+end
+
+puts cmd_stdout
+unless cmd_status.exitstatus == 0
+  exit EXIT_CRITICAL
+end

data/features/check_rspec/options.feature

@@ -0,0 +1,96 @@
+Feature: command line options
+  In order to modifiy the behavior of check_rspec
+  As an Icinga administrator
+  I want to be able to set command line options
+
+Scenario: run a passing rspec test
+  Given a file named "trivial_spec.rb" with:
+    """
+    describe do
+      it { true.should == true }
+    end
+    """
+  When I successfully run `check_rspec trivial_spec.rb`
+  Then the stdout should contain:
+    """
+    RSPEC OK
+    """
+
+Scenario: run a failing rspec test
+  Given a file named "trivial_spec.rb" with:
+    """
+    describe do
+      it { true.should == false }
+    end
+    """
+  When I run `check_rspec trivial_spec.rb`
+  Then the exit status should be 2
+  And the stdout should contain:
+    """
+    RSPEC Critical
+    """
+
+Scenario: run a test with --timeout
+  Given a file named "trivial_spec.rb" with:
+    """
+    describe do
+      it { true.should == true }
+    end
+    """
+  When I successfully run `check_rspec --timeout 1 trivial_spec.rb`
+  Then the stdout should contain:
+    """
+    RSPEC OK
+    """
+
+Scenario: run a test with --timeout that times out
+  Given a file named "trivial_spec.rb" with:
+    """
+    describe do
+      it { sleep(1) }
+    end
+    """
+  When I run `check_rspec --timeout 0.5 trivial_spec.rb`
+  Then the exit status should be 2
+  And the stdout should contain:
+    """
+    RSPEC Critical - timeout after 0.5 seconds
+    """
+
+Scenario: view usage with -h
+  When I successfully run `check_rspec -h`
+  And the stdout should contain:
+    """
+    Usage: check_rspec [options] [--] [passed to rspec]
+
+    Specific options:
+        -t, --timeout TIMEOUT            default: 30.0 (seconds)
+        -h, --help                       Show this message
+    """
+
+Scenario: view usage with --help
+  When I successfully run `check_rspec --help`
+  And the stdout should contain:
+    """
+    Usage: check_rspec [options] [--] [passed to rspec]
+
+    Specific options:
+        -t, --timeout TIMEOUT            default: 30.0 (seconds)
+        -h, --help                       Show this message
+    """
+
+Scenario: pass options to rspec
+  Given a file named "trivial_spec.rb" with:
+    """
+    describe 'foo' do
+      it { true.should == true }
+    end
+    describe 'bar' do
+      it { true.should == true }
+    end
+    """
+  When I successfully run `check_rspec -- -e 'foo' trivial_spec.rb`
+  Then the stdout should contain:
+    """
+    RSPEC OK - 1 example
+    """

data/features/check_rspec/run.feature

@@ -0,0 +1,31 @@
+Feature: run rspec tests
+  In order to monitor the enviroment
+  As an Icinga administrator
+  I want to get RSpec test results in Icinga plugin format
+
+Scenario: run a passing rspec test
+  Given a file named "trivial_spec.rb" with:
+    """
+    describe do
+      it { true.should == true }
+    end
+    """
+  When I successfully run `check_rspec trivial_spec.rb`
+  Then it should pass with regexp:
+    """
+    ^RSPEC OK - 1 example, 0 failures, finished in 0.\d+ seconds | examples=1 passing=1 failures=0 pending=0 conformance=100% time=0.\d+s$
+    """
+
+Scenario: run a failing rspec test
+  Given a file named "trivial_spec.rb" with:
+    """
+    describe do
+      it { true.should == false }
+    end
+    """
+  When I run `check_rspec trivial_spec.rb`
+  Then the exit status should be 2
+  And it should fail with regexp:
+    """
+    ^RSPEC Critical - 1 example, 1 failures, finished in 0.\d+ seconds | examples=1 passing=0 failures=1 pending=0 conformance=0% time=0.\d+s$
+    """

data/features/support/env.rb

@@ -0,0 +1 @@
+require 'aruba/cucumber'

data/lib/rspec/nagios/formatter.rb

@@ -14,17 +14,16 @@ class RSpec::Nagios::Formatter < RSpec::Core::Formatters::BaseFormatter
   def summary_line(duration, example_count, failure_count, pending_count)
     passing_count = example_count - failure_count
     # conformance is expressed as a percentage
-    # if example_count is zero we need to aviod div by 0
+    # if example_count is zero we need to avoid div by 0
     if example_count > 0
       conformance  = passing_count / example_count.to_f
       conformance *= 100
-      #conformance   = "%.2f" % conformance
       conformance  = conformance.round(0)
     else
       conformance  = 0
     end
     # limit duration precision to microseconds
-    time          = duration.round(6)
+    time = duration.round(6)
 
     summary = 'RSPEC'
     if failure_count == 0

data/lib/rspec/nagios/version.rb

@@ -1,5 +1,5 @@
 module RSpec
   module Nagios
-    VERSION = '0.0.3'
+    VERSION = '0.1.0'
   end
 end

data/rspec-nagios-formatter.gemspec

@@ -18,10 +18,11 @@ Gem::Specification.new do |s|
   s.add_development_dependency("rspec-expectations", ">= 2.0.0")
   s.add_development_dependency("rspec-mocks", ">= 2.0.0")
   s.add_development_dependency("rake", ">= 10.0.0")
+  s.add_development_dependency('aruba', '~> 0.4.6')
 
   s.rubygems_version = ">= 1.6.1"
   s.files            = `git ls-files`.split("\n")
   s.test_files       = `git ls-files -- {spec,features}/*`.split("\n")
-#  s.executables      = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.executables      = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_path     = "lib"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspec-nagios-formatter
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.1.0
 platform: ruby
 authors:
 - Joshua Hoblitt
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-07 00:00:00.000000000 Z
+date: 2013-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-core
@@ -80,10 +80,25 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: 10.0.0
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.6
 description: A RSpec formatter for the Nagios/Icinga plugin format
 email:
 - jhoblitt@cpan.org
-executables: []
+executables:
+- check_rspec
 extensions: []
 extra_rdoc_files: []
 files:
@@ -93,6 +108,10 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- bin/check_rspec
+- features/check_rspec/options.feature
+- features/check_rspec/run.feature
+- features/support/env.rb
 - lib/rspec/nagios.rb
 - lib/rspec/nagios/formatter.rb
 - lib/rspec/nagios/version.rb
@@ -126,6 +145,9 @@ signing_key:
 specification_version: 4
 summary: A RSpec formatter for the Nagios/Icinga plugin format
 test_files:
+- features/check_rspec/options.feature
+- features/check_rspec/run.feature
+- features/support/env.rb
 - spec/rspec_nagios_formatter_spec.rb
 - spec/shim_spec.rb
 - spec/spec_helper.rb