blackstart 0.2.0 → 0.8.0

metadata

@@ -1,13 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: blackstart
 version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: 
-  segments: 
-  - 0
-  - 2
-  - 0
-  version: 0.2.0
+  version: 0.8.0
 platform: ruby
 authors: 
 - Aaron Beckerman
@@ -15,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2024-05-14 00:00:00 -07:00
+date: 2026-06-04 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -28,39 +22,29 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- LICENSE.txt
-- README.txt
-- blackstart.gemspec
+- LICENSE
+- README
 - lib/blackstart.rb
+- sig/blackstart.rbs
 - test/blackstart_test.rb
 has_rdoc: true
 homepage: 
 licenses: 
-- MIT
+- Apache-2.0
 post_install_message: 
 rdoc_options: []
 
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 57
-      segments: 
-      - 1
-      - 8
-      - 7
       version: 1.8.7
 required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
 requirements: []
 
@@ -69,5 +53,5 @@ rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: A small, subdued library for automated testing.
-test_files: 
-- test/blackstart_test.rb
+test_files: []
+

data/LICENSE.txt

@@ -1,19 +0,0 @@
-Copyright (c) 2024 Aaron Beckerman
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

data/README.txt

@@ -1,152 +0,0 @@
-Blackstart
-
-Blackstart is a small, subdued library for automated testing in Ruby. It
-doesn't depend on anything beyond the Ruby platform and doesn't modify the
-environment outside its conventional namespace. It's tested with a primitive
-program, not via another automated-testing library.
-
-The blackstart is a small, subdued bird that eats bugs. A black start is when a
-power plant starts up without relying on the electrical grid.
-
-Here's an example of a test program that uses Blackstart:
-
-  require "blackstart"
-
-  exit Blackstart.run Blackstart.add { |adder|
-    adder.call do
-      unless "Hello, World!" == ["He", "", "o, Wor", "d!"].join("l")
-        raise "join did not work as expected"
-      end
-    end
-
-    adder.call do
-      unless "sample" == "simple".gsub(/i/, "a")
-        raise "gsub did not work as expected"
-      end
-    end
-  }
-
-Blackstart.add adds procs to a collection and returns that collection. In the
-example, each proc is designed to run a test and, if it fails, raise an error
-to signal this.
-
-Blackstart.run runs a sequence of tests and reports information about any that
-fail -- that is, any that raise an error. In the example, failure information
-would be written to the standard output stream. It returns false if there were
-failures; otherwise, it returns true.
-
-The library provides little beyond this, but it's easy to do relatively
-sophisticated things with it. Some examples follow.
-
-
-- Exiting with the appropriate status
-
-Blackstart.run returns false if there were any failures; otherwise, it returns
-true. If you use this as the argument to Kernel#exit, your test program will
-exit with a successful status only if there were no failures.
-
-
-- Defining helpers
-
-You may want all your tests to be able to assert something, generate test data,
-or perform some other task by sending a message. You could implement this
-statelessly in a singleton object or all instances of Object, for example, but
-there's another option that may be more convenient. Blackstart.run calls each
-test proc in the context of a new Blackstart::Context instance. You can define
-instance methods in that class like this:
-
-  class Blackstart::Context
-    def assert boolean
-      raise "assertion failed" unless boolean
-    end
-
-    def make_products
-      @cabbage = { :description => "head of cabbage", :price => 125 }
-      @orange = { :description => "Cara cara navel orange", :price => 100 }
-      nil
-    end
-  end
-
-All of your tests will be able to use them by sending messages to self. These
-methods can see and modify the test's state, which is disposable: it will be
-discarded after the test is complete and so will not affect later tests.
-
-
-- Running code before and after each test
-
-You can run code before and after each test by defining a custom
-Blackstart::Context#instance_exec. For example:
-
-  class Blackstart::Context
-    def instance_exec(*)
-      puts "before test"
-      @variable = "example"
-      super
-    ensure
-      puts "after test"
-    end
-  end
-
-
-- Building a test collection in stages
-
-You can build your collection of test objects in stages and run it at the end.
-For example:
-
-  require "blackstart"
-
-  TEST_OBJECTS = []
-
-  Blackstart.add TEST_OBJECTS do |adder|
-    adder.call do
-      unless "Hello, World!" == ["He", "", "o, Wor", "d!"].join("l")
-        raise "join did not work as expected"
-      end
-    end
-  end
-
-  Blackstart.add TEST_OBJECTS do |adder|
-    adder.call do
-      unless "sample" == "simple".gsub(/i/, "a")
-        raise "gsub did not work as expected"
-      end
-    end
-  end
-
-  exit Blackstart.run TEST_OBJECTS
-
-This makes it straightforward to define your tests in multiple files that you
-load in your test program.
-
-
-- Running tests in random order
-
-Blackstart.run runs a sequence of tests in order, but you can pass it a
-randomly-ordered sequence. Array#shuffle may be helpful for this. If you do
-this, you may also want to print the random seed at the start of your program
-so you can re-run your tests in the same order.
-
-
-- Reporting detailed test descriptions
-
-After a test fails, Blackstart.run writes a description of the test to the
-output stream. It gets this description by converting the test object to a
-string. When the test object is an instance of Proc, which is what
-Blackstart.add normally produces, this string typically includes the file path
-and line number where it was defined: helpful, but it won't be immediately
-clear what was being tested.
-
-You can improve this by making your own test objects instead of using
-Blackstart.add. Blackstart.run does not strictly need a sequence of Proc
-instances; it only needs a sequence of objects that convert to Proc instances
-in response to to_proc messages. Your custom test objects can respond to to_s
-with detailed descriptions instead of mere file paths and line numbers.
-
-
-- Handling failures differently
-
-Blackstart.run handles each failure by sending a puts message to the output
-stream, one of its parameters. By default, this is $stdout, so the default
-behavior is to print unadorned failure information to standard output. But you
-can specify any object as the output stream -- even if it's not really a stream
--- allowing you to handle failure information however you want.

data/blackstart.gemspec

@@ -1,11 +0,0 @@
-Gem::Specification.new do |s|
-  s.name = "blackstart"
-  s.version = "0.2.0"
-  s.authors = ["Aaron Beckerman"]
-  s.summary = "A small, subdued library for automated testing."
-  s.licenses = ["MIT"]
-  s.required_ruby_version = ">= 1.8.7"
-  s.files = ["LICENSE.txt", "README.txt", "blackstart.gemspec",
-    "lib/blackstart.rb", "test/blackstart_test.rb"]
-  s.test_files = ["test/blackstart_test.rb"]
-end