local-development-gateway 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70776ca78ffae5950698180364c42f598368971d93dcec7a262088b9a599fde1
-  data.tar.gz: 4fe4a0b113e7d7f6efd6a30f7d9a537fddd9b215ac5c746f22c5699d7e7a557e
+  metadata.gz: 10a939f848cae2b9e243772bb0b71e55f9f4ef7db51df904dbc44dceda981b0f
+  data.tar.gz: 0fe2303e0a7452356971343a371a73d897550d2461502bafba85ba81beb8bcba
 SHA512:
-  metadata.gz: e6543f1423068cdf0ab5aca3215487ae1a343beea7a583c1031de21357e9d1e7f1690fd20cb9bb73748d15d01cd8c33197c610cc5230c5540f6cda94ca9831ba
-  data.tar.gz: 5ea9608dd49f657d3ae4de5b8da00752f787b9a08da3e83651eeb6dffb92b41005b93587f97e66e2c5fe9302c1494914b0ab9bd0a6b11bddcfd621afe60e6329
+  metadata.gz: 9a5b33aceca3f70ae6d50fe53dd6a398badbde7b2f7869a2099507bd361308843cc8189924cae4adb0c8203afe189c62a002ed694d73cb0efe9bc8089edab92e
+  data.tar.gz: '086a30b8f018bf0fd4ce44d410ba5dc23cbb4923d28afd225df171a1c9453a2a3f4cf2a24f8c2a4ed75fb3587f00aa9022cf03c4556a1e73ffc98f269936e95b'

data/README.md

@@ -87,6 +87,25 @@ version declared by the gem. The `~> 0.1` constraint follows the consuming
 project's published Gemfile.
 The repository's `bin/dev` is only a thin wrapper around this executable API.
 
+### Ruby API lifecycle
+
+Wrap a command that needs the gateway with the block-oriented helper:
+
+```ruby
+require "local_development_gateway"
+
+result = LocalDevelopmentGateway.with_running do
+  run_development_command
+end
+```
+
+The helper starts or reuses the gateway before yielding, returns the block's
+result, and conditionally stops an unused gateway afterward. Cleanup also runs
+when the block raises without replacing the original exception. For a shutdown
+command that must not start a missing gateway, pass
+`ensure_running: false`; the block still runs and unused-gateway cleanup is
+attempted.
+
 ## Development checks
 
 Install the locked development tools with `bundle install`. Run the Ruby

data/lib/local_development_gateway/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LocalDevelopmentGateway
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/lib/local_development_gateway.rb

@@ -94,6 +94,20 @@ module LocalDevelopmentGateway
       :stopped
     end
 
+    def with_running(ensure_running: true)
+      begin
+        self.ensure_running if ensure_running
+        yield
+      ensure
+        block_error = $!
+        begin
+          stop_if_unused
+        rescue StandardError => cleanup_error
+          raise cleanup_error unless block_error
+        end
+      end
+    end
+
     def compose(*args, capture: true)
       @runner.call(
         "compose",
@@ -174,7 +188,6 @@ module LocalDevelopmentGateway
       output =
         @runner.call(
           "ps",
-          "--all",
           "--filter",
           "network=#{NETWORK_NAME}",
           "--format",
@@ -275,6 +288,10 @@ module LocalDevelopmentGateway
       Client.new.ensure_running(*args)
     end
 
+    def with_running(ensure_running: true, &block)
+      Client.new.with_running(ensure_running: ensure_running, &block)
+    end
+
     def start(*args)
       ensure_running(*args)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: local-development-gateway
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Marlen Brunner
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-28 00:00:00.000000000 Z
+date: 2026-08-12 00:00:00.000000000 Z
 dependencies: []
 description: Ruby API and CLI for starting, monitoring, and conditionally stopping
   the shared Docker gateway.