relaunch 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72b9d31380594b154a7da4a467e47f6e4fc555af0b7cfb5a71d1f45bcf3bd2c5
-  data.tar.gz: b83f6350d7302b369939fc1afb2a8fb3fbea729fb149d1e135f945edb0a26ccb
+  metadata.gz: b82966b5c2f6770cbe54fa75491aea07e93b748675b1addc9c199bce27726a83
+  data.tar.gz: 54208d5f0a33f47e20e8e18e443038180263197e8e7d1cf4aa15a90704e4b674
 SHA512:
-  metadata.gz: 9d12530b843c2624a7b789af56cf998644aa54ed0487d08eeb7a847966d616c3c39608ee51e7a3458a2be561ce24df7794815c9a0f5759be2ec7257c2341d6f4
-  data.tar.gz: e777eb25ab636c8dd165877632d4a3e1e71d97ccc00ed99fd19c6444e4142e28619b1f9d21ce404efb85072a90737ec88ddd4565930a5f4d2fc0f43a09e3a9e9
+  metadata.gz: 94a29158b46f63ad14222bb8618f794134c3711320c89d8081183c1d9299e4153d52fedd3538a77cc5ad0d17351807cff690fd7c247f9ef97874c117706db322
+  data.tar.gz: d64f7e8adbefe1be146c54ee61cecdc666b06fff0c36340af5243aa207994e3a64a9de03970c4cd7d74a7402f23d5dcdbd47aa9ba33bfeda5e9f4e7e77e3195c

data/Changelog.md

@@ -1,15 +1,32 @@
 # Changelog
 
-## 0.15.0 (unreleased)
+## 0.16.0
+
+- Fix an intermittent crash when restarting a command with `--exit` by
+  sharing the child's exit-status waiter between startup and shutdown.
+  ([#4](https://github.com/spinels/relaunch/pull/4))
+
+- Enable keyboard controls only when standard input is a terminal and, on
+  Unix, the runner is in its foreground process group. This avoids stops
+  under supervisors such as Overman and `stty` warnings with redirected
+  input while preserving file watching and automatic restarts.
+  ([#3](https://github.com/spinels/relaunch/pull/3))
+
+## 0.15.0
 
 - Require Ruby 3.3 or newer.
+  ([29a07e1](https://github.com/spinels/relaunch/commit/29a07e19033f828720d5b563e98df09ca5c054dd))
 - Publish as `relaunch`, preserving the `rerun` command, `.rerun`
   configuration, and `Rerun` namespace.
+  ([b1f9165](https://github.com/spinels/relaunch/commit/b1f91653f800e53f9cd421f844a8dc7d9c366839))
 - Add `relaunch` as a command alias and `require "relaunch"` as an entry
   point to the existing library.
+  ([b1f9165](https://github.com/spinels/relaunch/commit/b1f91653f800e53f9cd421f844a8dc7d9c366839))
 - Support Ruby 4.0 keyboard input using upstream's `IO#wait_readable` fix.
+  ([b00ffc6](https://github.com/alexch/rerun/commit/b00ffc6fb7e2c9da676a672200678da0154a60a1))
 - Raise `Rerun::ExitException` when the runner exits so library callers can
   handle shutdown. The command continues to exit successfully.
+  ([072c356](https://github.com/spinels/relaunch/commit/072c3561fd1581ac2c954c239202e755265de7e2))
 
 Earlier Rerun releases are documented in the
 [upstream version history](README.md#version-history).

data/Fork.md

@@ -3,6 +3,25 @@
 Relaunch is a fork of [alexch/rerun](https://github.com/alexch/rerun).
 Functional changes are listed newest first.
 
+## September 13, 2026: Preserve exit status during restart
+
+Fix [#1](https://github.com/spinels/relaunch/issues/1), an intermittent
+`undefined method 'success?' for nil` crash when restarting with `--exit`.
+Shutdown now waits for the existing detached process waiter instead of
+collecting the child's status with a competing `Process.wait` call.
+
+## September 13, 2026: Require a foreground terminal for keyboard controls
+
+[a4d833e](https://github.com/spinels/relaunch/commit/a4d833e11ce32caf96dde784e9a65950f5df76c2)
+enables keyboard controls only when standard input is a terminal and, on
+Unix, the runner belongs to its foreground process group. This prevents
+terminal access from stopping background process groups under supervisors
+such as Overman and avoids repeated `stty` warnings with redirected input.
+
+File watching and automatic restarts remain enabled when keyboard controls
+are unavailable. The `--background` option still disables keyboard controls
+explicitly.
+
 ## September 13, 2026: Minimum Ruby version
 
 Relaunch requires Ruby 3.3 or newer.

data/README.md

@@ -252,8 +252,12 @@ While the app is (re)running, you can make things happen by pressing keys:
 * **x** or **q** -- exit (just like control-C)
 * **p** -- pause/unpause filesystem watching
 
-If you're backgrounding or using Pry or a debugger, you might not want these
-keys to be trapped, so use the `--background` option.
+Keyboard commands are enabled only when standard input is a terminal and,
+on Unix, rerun belongs to its foreground process group. File watching and
+automatic restarts remain enabled when keyboard commands are unavailable.
+
+Use `--background` to disable keyboard commands explicitly, for example when
+using Pry or a debugger.
 
 # Signals
 
@@ -369,10 +373,9 @@ of Ruby nor config file syntax.
 
 ## Development
 
-Set up the test dependencies, install the bundle, and run the specs:
+Install the bundle and run the specs:
 
 ```sh
-./bin/setup-deps
 bundle install
 bundle exec rake spec
 ```

data/lib/rerun/runner.rb

@@ -26,7 +26,7 @@ module Rerun
     end
 
     def start_keypress_thread
-      return if @options[:background]
+      return if @options[:background] || !interactive_terminal?
 
       @keypress_thread = Thread.new do
         while true
@@ -163,7 +163,7 @@ module Rerun
         raise ExitException
       end
 
-      status_thread = Process.detach(@pid) # so if the child exits, it dies
+      status_thread = @status_thread = Process.detach(@pid)
 
       Signal.trap("INT") do # INT = control-C -- allows user to stop the top-level rerun process
         die
@@ -250,6 +250,7 @@ module Rerun
     # @returns true if the process dies
     # @returns false if either sending the signal fails or the process fails to die
     def signal_and_wait(signal)
+      status_thread = @status_thread
 
       signal_sent = if windows?
                       force_kill = (signal == 'KILL')
@@ -262,9 +263,9 @@ module Rerun
         # the signal was successfully sent, so wait for the process to die
         begin
           timeout(@options[:wait]) do
-            Process.wait(@pid)
+            status_thread.join
           end
-          process_status = $?
+          process_status = status_thread.value
           say "Process ended: #{process_status}" if verbose?
           true
         rescue Timeout::Error
@@ -362,6 +363,20 @@ module Rerun
     end
 
     private
+
+    def interactive_terminal?
+      return false unless $stdin.tty?
+      return true if windows?
+
+      # A terminal can be inherited by a background group (e.g. under Overman).
+      # Querying ps avoids platform-specific terminal ioctl constants.
+      foreground_group = IO.popen(['ps', '-o', 'tpgid=', '-p', Process.pid.to_s],
+        err: File::NULL, &:read).to_i
+      foreground_group == Process.getpgrp
+    rescue IOError, SystemCallError
+      false
+    end
+
     def one_char
       c = nil
       msg = $stdin.respond_to?(:wait_readable) ? :wait_readable : :ready?

data/relaunch.gemspec

@@ -3,7 +3,7 @@ $spec = Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
 
   s.name = 'relaunch'
-  s.version = '0.15.0'
+  s.version = '0.16.0'
   s.required_ruby_version = '>= 3.3'
 
   s.description = "Restarts your app when a file changes. A no-frills, command-line alternative to Guard, Shotgun, Autotest, etc."

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: relaunch
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Alex Chaffee