brass 1.2.0 → 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/VERSIONS.md

@@ -0,0 +1,59 @@
+# HISTORY
+
+## 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
+as "errors".
+
+Changes:
+
+* Add framework adapters for MiniTest and TestUnit.
+
+
+## 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`.
+
+Changes:
+
+* Change default error to RuntimeError.
+
+
+## 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.
+
+Changes:
+
+* Fix arguments parsing for assert/refute.
+* Add #fail! method to dry-up code.
+
+
+## 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 
+the code is derived from other system that have used it for some time.
+
+Changes:
+
+* Happy Birthday!
+

data/lib/brass/adapters/minitest.rb

@@ -0,0 +1,23 @@
+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
+        self.failures << UnexpectedError.new(sanitize_exception(e))
+      end
+    end
+  end
+end

data/lib/brass/adapters/testunit.rb

@@ -0,0 +1,36 @@
+module Test #:nodoc:
+  module Unit #:nodoc:
+
+    module BrassAssertionHandler
+      class << self
+        def included(base)
+          base.exception_handler(:handle_brass_assertion_failed_error)
+        end
+      end
+
+      private
+      def handle_brass_assertion_failed_error(exception)
+        return false unless exception.assertion?
+        problem_occurred
+        #parameters = exception.parameters    # TODO: assertion parameters
+        add_brass_failure exception.message, exception.backtrace,
+                    #:expected => exception.expected,
+                    #:actual => exception.actual,
+                    #:inspected_expected => exception.inspected_expected,
+                    #:inspected_actual => exception.inspected_actual,
+                    :user_message => exception.message #exception.user_message
+        true
+      end
+
+      def add_brass_failure(message, backtrace, options={})
+        failure = Failure.new(name, filter_backtrace(backtrace), message, options)
+        current_result.add_failure(failure)
+      end
+    end
+
+    class TestCase #:nodoc:
+      include BrassAssertionHandler
+    end
+  end
+end
+

data/lib/brass/expect.rb

@@ -16,7 +16,7 @@ module Kernel
     rescue error_class
       assert(true)
     rescue Exception => err
-      assert(false, error_class, "#{error_class} expected but #{err} was thrown")
+      assert(false, error_class, "#{error_class} expected but #{err.class} was thrown")
     end
   end
 

data/lib/brass.rb

@@ -1,21 +1,55 @@
 class Exception
 
-  # Is the exception an assertion error?
+  # Is the exception an assertion?
   def assertion?
     @assertion
   end
 
   # Set the the exception's assertion flag.
   def set_assertion(boolean)
-    @assertion = boolean  # ? true : false
+    @assertion = boolean # ? true : false
   end
 
   # Set message.
   # (not strictly needed here, but can be useful anyway).
+  #
+  # @todo Does the message have to be a string?
   def set_message(msg)
     @mesg = msg.to_str
   end
 
+  # 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
+  ## 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
@@ -78,7 +112,7 @@ module Kernel
                   error_class = raise_arguments.shift
                   error_class.new(*raise_arguments)
                 else
-                  error_class = RuntimeError
+                  error_class = $! || RuntimeError
                   error_class.new(*raise_arguments)
                 end
 

metadata

@@ -1,95 +1,91 @@
 --- !ruby/object:Gem::Specification
 name: brass
 version: !ruby/object:Gem::Version
-  version: 1.2.0
-  prerelease: 
+  version: 1.3.0
 platform: ruby
 authors:
 - Thomas Sawyer
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: detroit
-  requirement: &16988520 !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: *16988520
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13'
 - !ruby/object:Gem::Dependency
   name: lemon
-  requirement: &16987480 !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: *16987480
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: rubytest
-  requirement: &16986520 !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: *16986520
-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
-- lib/brass/expect.rb
-- lib/brass.rb
-- test/case_brass.rb
-- HISTORY.rdoc
+- LICENSE.txt
 - README.md
-- COPYING.rdoc
-homepage: http://rubyworks.github.com/brass
+- VERSIONS.md
+- lib/brass.rb
+- lib/brass/adapters/minitest.rb
+- lib/brass/adapters/testunit.rb
+- lib/brass/expect.rb
+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.10
-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.0
-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-01-25'

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/HISTORY.rdoc

@@ -1,33 +0,0 @@
-= HISTORY
-
-== 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`.
-
-Changes:
-
-* Change default error to RuntimeError.
-
-
-== 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.
-
-Changes:
-
-* Fix arguments parsing for assert/refute.
-* Add #fail! method to dry-up code.
-
-
-== 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 
-the code is derived from other system that have used it for some time.
-
-Changes:
-
-* Happy Birthday!
-

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
-