angry_io 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8333b37ab325a405861724fec5d256e85255551879736909482389b3a203c14c
+  data.tar.gz: 2b3f00b29dc6573e4ddf3ef33b7c91856ee49d56d31d2a0b0b293a59ca02adec
+SHA512:
+  metadata.gz: ef3525263035d341ada9c302472c468676a2196df6a1b57ed9b67d09e7c2d1bde7148dd18ca6fc6ed888e78bff6949ea97f4d645914d08e3a21094db77c306b4
+  data.tar.gz: 3ca41798772a5e17b5406b4d70446edb08eedffb21f5c62c1115c22e849e1b397cbe3ea5dec41bf44e3b84da4fcc0fcfc5e565396294226d8fe922ab9bc72e54

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-09-04
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Benjamin Quorning
+
+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.md

@@ -0,0 +1,111 @@
+# AngryIo
+
+Friends don't let friends write tests or specs that outputs to stdout/stderr. When you look at your test output, you should only see green dots, right?
+
+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"
+end
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+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.
+
+```ruby
+# Gemfile
+gem "angry_io", require: "angry_io/enable_for_ci_true"
+```
+
+That's it. Under `CI=true`, every test that writes to `$stdout` or `$stderr` raises:
+
+```
+IOError: not opened for writing
+```
+
+### Opting out
+
+While onboarding this gem, some tests will likely already be writing to stdout. Opt them out per-test until they are fixed:
+
+```ruby
+# RSpec
+it "prints a deprecation", :i_absolutely_need_to_write_to_stdout do
+  puts "deprecated!"
+end
+```
+
+```ruby
+# Minitest — opt out a whole test class
+class PrintTest < Minitest::Test
+  i_absolutely_need_to_write_to_stdout!
+
+  def test_prints
+    puts "ok"
+  end
+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:
+
+| 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
+
+`AngryIo::Stream` is a `StringIO` backed by a frozen empty string, which makes `StringIO` refuse writes with an `IOError`. Around each test, the adapter swaps `$stdout` and `$stderr` to fresh `AngryIo::Stream` instances and restores the originals (closing the buffers) in an `ensure`.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake` to run the test suite (Minitest + RSpec, both dogfooding the gem's own adapters) and StandardRB.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+### Releasing
+
+Releases are automated. Bump the version in `lib/angry_io/version.rb`, commit, and merge to `main` — the `Publish to RubyGems.org` workflow builds the gem, creates and pushes the `vX.Y.Z` tag, and pushes the `.gem` file to [rubygems.org](https://rubygems.org) via trusted publishing (OIDC, no stored API key). You can also trigger a release manually from the Actions tab via `workflow_dispatch`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/bquorning/angry_io.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the AngryIo project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](https://github.com/bquorning/angry_io/blob/main/CODE_OF_CONDUCT.md).

data/lib/angry_io/enable_for_ci_true.rb

@@ -0,0 +1,16 @@
+# 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"

data/lib/angry_io/minitest.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+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.
+module AngryIo
+  module Minitest
+    module Adapter
+      def run
+        AngryIo.around_streams(opted_out: self.class.i_absolutely_need_to_write_to_stdout?) { super }
+      end
+    end
+
+    module ClassMethods
+      def i_absolutely_need_to_write_to_stdout!
+        @i_absolutely_need_to_write_to_stdout = true
+      end
+
+      def i_absolutely_need_to_write_to_stdout?
+        @i_absolutely_need_to_write_to_stdout ||= false
+      end
+    end
+
+    def self.setup!
+      test = ::Minitest::Test
+      test.extend(ClassMethods)
+      test.prepend(Adapter)
+    end
+  end
+end
+
+begin
+  require "minitest"
+  AngryIo::Minitest.setup!
+rescue LoadError
+  # Minitest isn't installed; nothing to wire up.
+end

data/lib/angry_io/rspec.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+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.
+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]
+          AngryIo.around_streams(opted_out: opt_out) { example.run }
+        end
+      end
+    end
+  end
+end
+
+begin
+  require "rspec/core"
+  AngryIo::RSpec.setup!
+rescue LoadError
+  # RSpec isn't installed; nothing to wire up.
+end

data/lib/angry_io/version.rb

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

data/lib/angry_io.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "stringio"
+require_relative "angry_io/version"
+
+module AngryIo
+  # An IO that raises when you write to it, so tests can't silently pollute
+  # stdout/stderr. Backed by a frozen empty string, which makes StringIO
+  # refuse writes with an IOError ("not opened for writing").
+  class Stream < StringIO
+    def initialize
+      super(-"")
+    end
+  end
+
+  Config = Struct.new(:enabled, :opt_out_metadata) do
+    def initialize
+      self.enabled = -> { true }
+      self.opt_out_metadata = :i_absolutely_need_to_write_to_stdout
+    end
+  end
+
+  @config = Config.new
+
+  class << self
+    attr_reader :config
+
+    def configure
+      yield @config
+    end
+
+    # Swap $stdout and $stderr to AngryIo::Stream instances around the given
+    # block, restoring them (and closing the buffers) in an ensure. No-ops when
+    # +opted_out+ is true or when +config.enabled+ returns false, so the block
+    # runs untouched.
+    def around_streams(opted_out: false)
+      return yield if opted_out
+      return yield unless config.enabled.call
+
+      original_stdout = $stdout
+      original_stderr = $stderr
+      stdout_buffer = Stream.new
+      stderr_buffer = Stream.new
+      $stdout = stdout_buffer
+      $stderr = stderr_buffer
+
+      begin
+        yield
+      ensure
+        $stdout = original_stdout
+        $stderr = original_stderr
+        stdout_buffer.close
+        stderr_buffer.close
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: angry_io
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Benjamin Quorning
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: AngryIo replaces $stdout/$stderr during tests with an IO that raises
+  on write, so accidental output fails loudly instead of cluttering CI logs. Ships
+  RSpec and Minitest adapters that self-register, gated by a configurable enabled
+  callable.
+email:
+- bquorning@zendesk.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- 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
+homepage: https://github.com/bquorning/angry_io
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/bquorning/angry_io
+  source_code_uri: https://github.com/bquorning/angry_io
+  changelog_uri: https://github.com/bquorning/angry_io/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: An IO that raises on write, to keep tests from polluting stdout/stderr.
+test_files: []