brass 1.2.1 → 1.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c1aff0f1fb1eef83ed9e88118c9ad9905d7307bd4e4734f33cbc8f2e9b62db58
+  data.tar.gz: 9c66d0e7c03cb039a01d0db8a754266fafce40ac2cdf9c66f28d742bcd4c2ccb
+SHA512:
+  metadata.gz: 39e3b53191b8ca07d46d2bc550ab3a763a18c420079b2e3223119c2ae1896712bbe9f6fe3f06f99720bcfc34c397caffeb0a64b778839da61a5d463121c77ff7
+  data.tar.gz: 59e8313763da62429de70baeb3c9f8ed984587bbd78c808f40bce7b3c587aa1938233e12ebbf766921da5e9c0822666ec0e7356e590de587dd9a7bbddb879719

data/LICENSE.txt

@@ -0,0 +1,22 @@
+(BSD-2-Clause License)
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR  SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -1,26 +1,34 @@
 # BRASS
 
-[Website](http://rubyworks.github.com/brass) /
-[Report Issue](http://github.com/rubyworks/brass/issues) /
-[Development](http://github.com/rubyworks/brass)
+[Website](https://rubyworks.github.io/brass) |
+[Report Issue](https://github.com/rubyworks/brass/issues) |
+[Development](https://github.com/rubyworks/brass)
 
-[![Build Status](https://secure.travis-ci.org/rubyworks/brass.png)](http://travis-ci.org/rubyworks/brass)
+<b>BRASS is a standard assertions framework, framework's framework, or even
+a framework's framework's framework, depending on where you are staking
+out your assertions keister. In other words, BRASS provides a foundational
+assertions framework which all other assertion and test frameworks
+can use, or at least comply with, and then everyone gets on swimmingly.</b>
 
 
-# DESCRIPTION
+## Status
 
-BRASS is a standard assertions framework, framework's framework, or even
-a framework's framework's framework, depending on where you're staking
-out your assertions keister.
+[![Gem Version](https://img.shields.io/gem/v/brass.svg?style=flat)](https://rubygems.org/gems/brass)
+[![Build Status](https://github.com/rubyworks/brass/actions/workflows/test.yml/badge.svg)](https://github.com/rubyworks/brass/actions/workflows/test.yml)
+[![Report Issue](https://img.shields.io/github/issues/rubyworks/brass.svg?style=flat)](https://github.com/rubyworks/brass/issues)
 
-In other words, BRASS provides a standard rudimentary assertions framework
-that all other assertion and test frameworks can use, or at least comply
-with, and then everyone gets on swimingly.
+
+## Overview
+
+BRASS is a very basic assertions framework. It is designed to provide only
+the barest essentials for making assertions such that other assertion and
+test frameworks can use it, or at least comply with it, making all said
+frameworks interoperable.
 
 Now, you may be thinking, "No thanks, I do it my way." But when you see
 how stupid simple BRASS is, you'll realize that, "Yea, that actually 
 make sense." And then maybe feel a bit stupid yourself for doing exactly
-what this paragrah just said you would do. Yea, well, we've all been there.
+what this paragraph just said you would do. Yea, well, we've all been there.
 
 But enough with the fluff.
 
@@ -41,7 +49,7 @@ is either `RuntimeError` or the one specified by the `fail_arguments`.
 The global assertions counter is `$ASSERTION_COUNTS`. It is simply a Hash formally
 defined as:
 
-    $ASSERTIONS_COUNTS = Hash.new{|h,k| h[k] = 0}
+    $ASSERTION_COUNTS = Hash.new{|h,k| h[k] = 0}
 
 And though it is open to any key, the keys should be symbols. Three keys in 
 particular and standard: `:pass`, `:fail` and `:total`. Whenever an assertion
@@ -58,15 +66,22 @@ to the Exception class along with the `#assertion?` method which any
 test framework can use to distinguish an assertion error from an ordinarily
 error.
 
-And that's all there is to it. If you *capice* then consider yourself top brass.
+And that's all there is to it. If you *capisce* then consider yourself top brass.
 
 Love, Peace and Brass Knuckles
 
 
-## COPYING
+## Contributing
+
+This project is so basic it is unlikely anything will even change. But you
+never can tell! so if your have a brilliant idea, jump right in. Source
+code management is handled by ye ol'Github at https://github.com/rubyworks/brass.
+
+
+## Copyrights
 
 Copyright (c) 2010 Rubyworks. All rights reserved.
 
 Distribute in accordance with the **BSD-2-Clause** license.
 
-See COPYING.md file for details.
+See LICENSE.txt file for details.

data/{HISTORY.rdoc → VERSIONS.md}

@@ -1,6 +1,21 @@
-= HISTORY
+# HISTORY
 
-== 1.2.1 | 2012-02-09
+## 1.3.0 | 2026-03-30
+
+Maintenance release. Modernized project tooling and cleaned up documentation.
+
+Changes:
+
+* Replace custom Indexer system with standard gemspec.
+* Replace Travis CI with GitHub Actions.
+* Replace Assembly/detroit with Rakefile.
+* Fix typos in README and source code.
+* Update URLs to HTTPS.
+* Remove obsolete files (etc/, work/, MANIFEST).
+* Clean up .gitignore.
+
+
+## 1.2.1 | 2012-02-09
 
 This release adds framework adapters for MiniTest and TestUnit, which allows
 those frameworks to recognize BRASS assertions as "failures" rather than
@@ -11,7 +26,7 @@ Changes:
 * Add framework adapters for MiniTest and TestUnit.
 
 
-== 1.2.0 | 2012-01-26
+## 1.2.0 | 2012-01-26
 
 The default error is `RuntimeError` rather than `StandardError` to
 match Ruby's default exception when no arguments are passed to `raise`.
@@ -21,7 +36,7 @@ Changes:
 * Change default error to RuntimeError.
 
 
-== 1.1.0 | 2012-01-25
+## 1.1.0 | 2012-01-25
 
 Quick fix for issue with parsing arguments of #assert and #refute methods.
 Also added #fail! method to dry-up code.
@@ -32,7 +47,7 @@ Changes:
 * Add #fail! method to dry-up code.
 
 
-== 1.0.0 | 2012-01-24
+## 1.0.0 | 2012-01-24
 
 This is the initial release of BRASS. It is given a 1.0.0 version
 despite being such a new project because it is very simple and 

data/lib/brass/adapters/minitest.rb

@@ -1,26 +1,23 @@
-module MiniTest #:nodoc:
-  class Unit #:nodoc:
-    # To teach MiniTest to recognize the expanded concept of assertions
-    # we add in an extra capture clause to the it's #puke method.
-    def puke c, m, x
-      case x
-      when MiniTest::Skip
-        @skips = @skips + 1
-        x = "Skipped:\n#{m}(#{c}) [#{location x}]:\n#{x.message}\n"
-      when MiniTest::Assertion
-        @failures = @failures + 1
-        x = "Failure:\n#{m}(#{c}) [#{location x}]:\n#{x.message}\n"
-      when x.respond_to?(:assertion?) && x.assertion?
-        @failures = @failures + 1
-        x = "Failure:\n#{m}(#{c}) [#{location x}]:\n#{x.message}\n"
+module Minitest #:nodoc:
+  class Test #:nodoc:
+    # Override capture_exceptions to recognize BRASS assertion errors
+    # as test failures rather than errors.
+    alias_method :capture_exceptions_without_brass, :capture_exceptions
+
+    def capture_exceptions
+      yield
+    rescue *PASSTHROUGH_EXCEPTIONS
+      raise
+    rescue Assertion => e
+      self.failures << e
+    rescue Exception => e
+      if e.respond_to?(:assertion?) && e.assertion?
+        failure = Assertion.new(e.message)
+        failure.set_backtrace(e.backtrace)
+        self.failures << failure
       else
-        @errors = @errors + 1
-        b = MiniTest::filter_backtrace(x.backtrace).join("\n    ")
-        x = "Error:\n#{m}(#{c}):\n#{x.class}: #{x.message}\n    #{b}\n"
+        self.failures << UnexpectedError.new(sanitize_exception(e))
       end
-      @report << x
-      x[0, 1]
     end
   end
 end
-

data/lib/brass.rb

@@ -1,6 +1,6 @@
 class Exception
 
-  # Is the exception an assertion error?
+  # Is the exception an assertion?
   def assertion?
     @assertion
   end
@@ -18,19 +18,38 @@ class Exception
     @mesg = msg.to_str
   end
 
-  # TODO: Consider assertion parameters for future vresion.
+  # Set priority level.
+  #
+  # @param [Integer] level
+  #   The priority level of the exception.
+  #
+  def set_priority(level)
+    @priority = level.to_i
+  end
+
+  # Exceptions can have priority levels.
+  #
+  # Zero is a nominal error, the higher the priority the more severe the
+  # error is considered. Errors with priorities less than zero are taken
+  # be warnings, the lower the number the more trivial.
+  #
+  def priority
+    @priority ||= 0
+  end
+
+  # TODO: Consider assertion parameters for future version. If message
+  # does not have to be string, it might serve this purpose instead.
   ##
   #def parameters
   #  @parameters
   #end
   #
   ## Set exception parameters. These are used to store specific information
-  ## relavent to a particular exception or assertion. Unlike the message,
+  ## relevant to a particular exception or assertion. Unlike the message,
   ## which is a String, this is a Hash.
   #def set_parameters(parameters)
   #  @parameters = parameters.to_hash
   #end
-
 end
 
 module Kernel

metadata

@@ -1,98 +1,91 @@
 --- !ruby/object:Gem::Specification
 name: brass
 version: !ruby/object:Gem::Version
-  version: 1.2.1
-  prerelease: 
+  version: 1.3.0
 platform: ruby
 authors:
 - Thomas Sawyer
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: detroit
-  requirement: &16492980 !ruby/object:Gem::Requirement
-    none: false
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13'
   type: :development
   prerelease: false
-  version_requirements: *16492980
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13'
 - !ruby/object:Gem::Dependency
   name: lemon
-  requirement: &16492280 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.9'
   type: :development
   prerelease: false
-  version_requirements: *16492280
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: rubytest
-  requirement: &16491100 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.8'
   type: :development
   prerelease: false
-  version_requirements: *16491100
-description: ! 'BRASS stands for Bare-Metal Ruby Assertion System Standard. It is
-  a very basic
-
-  foundational assertions framework for other assertion and test frameworks
-
-  to make use so they can all work together harmoniously.'
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: BRASS stands for Bare-Metal Ruby Assertion System Standard. It is a very
+  basic foundational assertions framework for other assertion and test frameworks
+  to make use so they can all work together harmoniously.
 email:
 - transfire@gmail.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- HISTORY.rdoc
-- COPYING.rdoc
-- README.md
+extra_rdoc_files: []
 files:
-- .ruby
-- .yardopts
+- LICENSE.txt
+- README.md
+- VERSIONS.md
+- lib/brass.rb
 - lib/brass/adapters/minitest.rb
 - lib/brass/adapters/testunit.rb
-- lib/brass/adapters/testunit1.rb
 - lib/brass/expect.rb
-- lib/brass.rb
-- test/case_brass.rb
-- HISTORY.rdoc
-- README.md
-- COPYING.rdoc
-homepage: http://rubyworks.github.com/brass
+homepage: https://github.com/rubyworks/brass
 licenses:
 - BSD-2-Clause
-post_install_message: 
+metadata: {}
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.11
-signing_key: 
-specification_version: 3
-summary: Bare-Metal Ruby Assertion System Standard
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Bare-metal Ruby Assertion System Standard
 test_files: []

data/.ruby

@@ -1,53 +0,0 @@
----
-source:
-- meta
-authors:
-- name: Thomas Sawyer
-  email: transfire@gmail.com
-copyrights:
-- holder: Rubyworks
-  year: '2012'
-  license: BSD-2-Clause
-replacements: []
-alternatives: []
-requirements:
-- name: detroit
-  groups:
-  - build
-  development: true
-- name: lemon
-  groups:
-  - test
-  development: true
-- name: rubytest
-  groups:
-  - test
-  development: true
-dependencies: []
-conflicts: []
-repositories:
-- uri: git@github.com:rubyworks/brass.git
-  scm: git
-  name: upstream
-resources:
-  home: http://rubyworks.github.com/brass
-  docs: http://rubydoc.info/gems/brass
-  code: http://github.com/rubyworks/brass
-  mail: http://groups.google.com/groups/rubyworks-mailinglist
-extra: {}
-load_path:
-- lib
-revision: 0
-created: '2012-01-24'
-summary: Bare-Metal Ruby Assertion System Standard
-title: BRASS
-version: 1.2.1
-name: brass
-description: ! 'BRASS stands for Bare-Metal Ruby Assertion System Standard. It is
-  a very basic
-
-  foundational assertions framework for other assertion and test frameworks
-
-  to make use so they can all work together harmoniously.'
-organization: Rubyworks
-date: '2012-02-09'

data/.yardopts

@@ -1,7 +0,0 @@
---title "BRASS"
---readme README.md
---protected
---private
-lib
--
-[A-Z]*.*

data/COPYING.rdoc

@@ -1,38 +0,0 @@
-= COPYRIGHT
-
-== NOTICES
-
-=== Brass
-
-Copyright:: (c) 2012 RubyWorks
-License::   (r) BSD-2-Clause
-Website::   http://rubyworks.github.com/brass
-
-== LICENSES
-
-=== BSD-2-Clause License
-
-    Brass
-
-    Copyright (c) 2012 Rubyworks. All rights reserved.
-
-    Redistribution and use in source and binary forms, with or without
-    modification, are permitted provided that the following conditions are met:
-
-       1. Redistributions of source code must retain the above copyright notice,
-          this list of conditions and the following disclaimer.
-
-       2. Redistributions in binary form must reproduce the above copyright
-          notice, this list of conditions and the following disclaimer in the
-          documentation and/or other materials provided with the distribution.
-
-    THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
-    INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
-    FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
-    COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
-    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR  SERVICES; LOSS OF USE,
-    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
-    OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
-    EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/lib/brass/adapters/testunit1.rb

@@ -1,42 +0,0 @@
-module Test #:nodoc:
-  module Unit #:nodoc:
-    class TestCase #:nodoc:
-      # Runs the individual test method represented by this
-      # instance of the fixture, collecting statistics, failures
-      # and errors in result.
-      def run(result)
-        yield(STARTED, name)
-        @_result = result
-        begin
-          setup
-          __send__(@method_name)
-        rescue AssertionFailedError => e
-          add_failure(e.message, e.backtrace)
-        rescue Exception => e
-          if e.respond_to?(:assertion?) && e.assertion?
-            add_failure(e.message, e.backtrace)
-          else
-            raise if PASSTHROUGH_EXCEPTIONS.include? $!.class
-            add_error($!)
-          end
-        ensure
-          begin
-            teardown
-          rescue AssertionFailedError => e
-            add_failure(e.message, e.backtrace)
-          rescue Exception => e
-            if e.respond_to?(:assertion?) && e.assertion?
-              add_failure(e.message, e.backtrace)
-            else
-              raise if PASSTHROUGH_EXCEPTIONS.include? $!.class
-              add_error($!)
-            end
-          end
-        end
-        result.add_run
-        yield(FINISHED, name)
-      end 
-    end
-  end
-end
-

data/test/case_brass.rb

@@ -1,22 +0,0 @@
-covers 'brass'
-
-testcase Kernel do
-
-  method :assert do
-
-    test do
-      assert(true)
-    end
-
-  end
-
-  method :refute do
-
-    test do
-      refute(false)
-    end
-
-  end
-
-end
-