angry_io 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8333b37ab325a405861724fec5d256e85255551879736909482389b3a203c14c
-  data.tar.gz: 2b3f00b29dc6573e4ddf3ef33b7c91856ee49d56d31d2a0b0b293a59ca02adec
+  metadata.gz: e481e761566636d3cc9fcf965a2d5880a3b65e818cc1312c1c62897ccd6c16a1
+  data.tar.gz: 702fc8469bf85c8aec44fbfa861fcc86263b5bbb3bdb28b25338f26d3148caa7
 SHA512:
-  metadata.gz: ef3525263035d341ada9c302472c468676a2196df6a1b57ed9b67d09e7c2d1bde7148dd18ca6fc6ed888e78bff6949ea97f4d645914d08e3a21094db77c306b4
-  data.tar.gz: 3ca41798772a5e17b5406b4d70446edb08eedffb21f5c62c1115c22e849e1b397cbe3ea5dec41bf44e3b84da4fcc0fcfc5e565396294226d8fe922ab9bc72e54
+  metadata.gz: a862f0a1adf1077e3b7c6a43192692d22086e72f0761f7bd7629e13fc7b23908e798308ba969482b78d411686f34edee159544a2f93840d1391a18728f240c0a
+  data.tar.gz: 2ed4b06091d5afb5a9449e5fd3acd649995a09ee2e73ca8f4bf68b9f3cd27bef67d91959b4c2b9f503b1eec0847ff7b268d502e5c071fa11e866c11103a6ac18

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-09-04
+
+- Remove the `angry_io/enable_for_ci_true` convenience require; require `angry_io/rspec` or `angry_io/minitest` directly instead.
+- Remove the configurable `opt_out_metadata` field; the RSpec opt-out metadata is now always `:i_absolutely_need_to_write_to_stdout`.
+- Adapters no longer swallow `LoadError` when their framework is missing; requiring an adapter now hard-requires its framework.
+
 ## [0.1.0] - 2026-09-04
 
 - Initial release

data/README.md

@@ -4,15 +4,13 @@ Friends don't let friends write tests or specs that outputs to stdout/stderr. Wh
 
 AngryIo replaces `$stdout` and `$stderr` during your test suite with an IO that _raises on write_, so accidental output fails loudly instead of quietly cluttering your output. It ships self-registering adapters for both RSpec and Minitest, gated by a configurable `enabled` callable.
 
-The name and the default opt-out metadata are a nod to [minitest](https://github.com/minitest/minitest)'s `i_suck_and_my_tests_are_order_dependent!`.
-
 ## Installation
 
 Add to your application's Gemfile:
 
 ```ruby
 group :test do
-  gem "angry_io", require: "angry_io/enable_for_ci_true"
+  gem "angry_io"
 end
 ```
 
@@ -24,19 +22,28 @@ gem install angry_io
 
 ## Usage
 
-The simplest setup is to point the Gemfile `require:` at `angry_io/enable_for_ci_true`. That file turns AngryIo on only when the `CI` environment variable is `"true"` — a convention set by GitHub Actions, GitLab CI, CircleCI, Travis, and others — and wires up whichever test framework is loaded (RSpec or Minitest); the other is a no-op.
+Depending on your test framework, you should require either `angry_io/rspec` or `angry_io/minitest`:
 
 ```ruby
-# Gemfile
-gem "angry_io", require: "angry_io/enable_for_ci_true"
+# spec_helper.rb (RSpec) or test_helper.rb (Minitest)
+require "angry_io/rspec"      # or "angry_io/minitest"
 ```
 
-That's it. Under `CI=true`, every test that writes to `$stdout` or `$stderr` raises:
+By default, AngryIo is always on, and every test that writes to `$stdout` or `$stderr` now raises:
 
 ```
 IOError: not opened for writing
 ```
 
+If you want to allow test output in some environments but not in others - e.g allow output when testing locally, but fail on CI - you can configure like this:
+
+```ruby
+# On by default; turn it off in environments where you'll allow real output.
+AngryIo.configure do |config|
+  config.enabled = -> { ENV["CI"] == "true" }
+end
+```
+
 ### Opting out
 
 While onboarding this gem, some tests will likely already be writing to stdout. Opt them out per-test until they are fixed:
@@ -59,22 +66,6 @@ class PrintTest < Minitest::Test
 end
 ```
 
-### Manual setup
-
-If you'd rather control the gate yourself, require an adapter directly. `enabled` defaults to always-on, so it's most useful as a kill switch for environments where you need real output:
-
-```ruby
-# spec_helper.rb (RSpec) or test_helper.rb (Minitest)
-require "angry_io/rspec"      # or "angry_io/minitest"
-
-# On by default; turn it off in environments where you need real output.
-AngryIo.configure do |config|
-  config.enabled = -> { ENV["ANGRY_IO"] != "off" }
-end
-```
-
-Requiring `angry_io/rspec` or `angry_io/minitest` self-registers the hook if that framework is loaded; requiring plain `angry_io` gives you just the `AngryIo::Stream` class with no side effects.
-
 ## Configuration
 
 `AngryIo.configure` yields a config struct with two fields:
@@ -82,7 +73,6 @@ Requiring `angry_io/rspec` or `angry_io/minitest` self-registers the hook if tha
 | Field              | Default                                 | Description                                                                                                           |
 | ---                | ---                                     | ---                                                                                                                   |
 | `enabled`          | `-> { true }`                           | A callable returning whether AngryIo is active. Invoked once per test, so it can read env vars or feature flags live. |
-| `opt_out_metadata` | `:i_absolutely_need_to_write_to_stdout` | The RSpec metadata symbol that opts an example out.                                                                   |
 
 ## How it works
 

data/lib/angry_io/minitest.rb

@@ -4,10 +4,8 @@ require "angry_io"
 
 # Prepends an override of +Minitest::Test#run+ that swaps $stdout/$stderr to
 # AngryIo::Stream instances around each test. A test class opts out by calling
-# +i_absolutely_need_to_write_to_stdout!+ in its body — a nod to minitest's own
-# +i_suck_and_my_tests_are_order_dependent!+. Force-loads Minitest so
-# registration works regardless of Bundler.require ordering; no-op if Minitest
-# isn't installed.
+# +i_absolutely_need_to_write_to_stdout!+ in its body. Force-loads Minitest so
+# registration works regardless of Bundler.require ordering.
 module AngryIo
   module Minitest
     module Adapter
@@ -34,9 +32,5 @@ module AngryIo
   end
 end
 
-begin
-  require "minitest"
-  AngryIo::Minitest.setup!
-rescue LoadError
-  # Minitest isn't installed; nothing to wire up.
-end
+require "minitest"
+AngryIo::Minitest.setup!

data/lib/angry_io/rspec.rb

@@ -3,17 +3,16 @@
 require "angry_io"
 
 # Registers an +around+ hook that swaps $stdout/$stderr to AngryIo::Stream
-# instances during each example, unless the example opts out via the configured
-# metadata (default +:i_absolutely_need_to_write_to_stdout+). Force-loads
-# rspec-core so registration works regardless of Bundler.require ordering;
-# no-op if RSpec isn't installed.
+# instances during each example, unless the example opts out via the
+# +:i_absolutely_need_to_write_to_stdout+ metadata. Force-loads rspec-core so
+# registration works regardless of Bundler.require ordering.
 module AngryIo
   module RSpec
     def self.setup!
       ::RSpec.configure do |config|
         config.around do |example|
-          opt_out = example.metadata.key?(AngryIo.config.opt_out_metadata) &&
-            example.metadata[AngryIo.config.opt_out_metadata]
+          opt_out = example.metadata.key?(:i_absolutely_need_to_write_to_stdout) &&
+            example.metadata[:i_absolutely_need_to_write_to_stdout]
           AngryIo.around_streams(opted_out: opt_out) { example.run }
         end
       end
@@ -21,9 +20,5 @@ module AngryIo
   end
 end
 
-begin
-  require "rspec/core"
-  AngryIo::RSpec.setup!
-rescue LoadError
-  # RSpec isn't installed; nothing to wire up.
-end
+require "rspec/core"
+AngryIo::RSpec.setup!

data/lib/angry_io/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AngryIo
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/angry_io.rb

@@ -13,10 +13,9 @@ module AngryIo
     end
   end
 
-  Config = Struct.new(:enabled, :opt_out_metadata) do
+  Config = Struct.new(:enabled) do
     def initialize
       self.enabled = -> { true }
-      self.opt_out_metadata = :i_absolutely_need_to_write_to_stdout
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: angry_io
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Benjamin Quorning
@@ -23,7 +23,6 @@ files:
 - LICENSE.txt
 - README.md
 - lib/angry_io.rb
-- lib/angry_io/enable_for_ci_true.rb
 - lib/angry_io/minitest.rb
 - lib/angry_io/rspec.rb
 - lib/angry_io/version.rb

data/lib/angry_io/enable_for_ci_true.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-# Require this file from your Gemfile (+require: "angry_io/enable_for_ci_true"+)
-# to turn AngryIo on only when the +CI+ environment variable is +"true"+ — a
-# convention set by GitHub Actions, GitLab CI, CircleCI, Travis, and others.
-# Whichever test framework is loaded (RSpec or Minitest) wires itself up; the
-# other is a no-op.
-
-require "angry_io"
-
-AngryIo.configure do |config|
-  config.enabled = -> { ENV["CI"] == "true" }
-end
-
-require "angry_io/rspec"
-require "angry_io/minitest"