test-cmd.rb 0.4.2 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d42f6af0807d07f2fe0aef5e9ca2143e2ae28165c4786393eba628fe0eb11626
-  data.tar.gz: 834df6cb9fe0c5688e1c60fedbd4643a5114001eb25e51e3ceb074691ac68d07
+  metadata.gz: 7dff5c9ec06745d82889cd41c9e6577984c0ed1c92b58b1d69db24abb63bbed8
+  data.tar.gz: 705f57c755ac6b5c9f586fd71b8af263dc36ed4b75cb36b86dc776c4612556f0
 SHA512:
-  metadata.gz: 4219aa993d546ff5c09081b0f72e5f9a680aa810d1b760e9ed2fabbb951a881c28ea3a92a985c966ca9fdf98ed356760c40ce99acd014f3c8c576a03f0d9ce93
-  data.tar.gz: c2893ffc88a9682c00fe911771006aa3641e7ec5cbd11fda1d8598f57d091fa74eb69f9046ea67890267b05a5df2cc1f517a9ad967cefe190ed981ec1c65a344
+  metadata.gz: c9c84f22a646b7890dcd68e3c9b45e5cd7a0e33807dd1bc05991bfda9b9573d555af9e4060a2fab9edaf73d4822b7e2c4cc4d29aa4d8a1fc08221177b54237bc
+  data.tar.gz: f5b2359e1b359fa3e96d8fa558664d082a8226ec8d07758432ce337779f999094ac20cf61408867ea099aab32bff9eafd63766f1dc9c8887b93f062c81ed6512

data/README.md

@@ -13,21 +13,14 @@ test environment, too.
 
 The following example demonstrates how tests might be written with
 test-unit from the standard library. The
-[`Test::Cmd`](https://0x1eef.github.io/x/test-cmd.rb/Test/Cmd.html)
-module implements a
-[`cmd`](https://0x1eef.github.io/x/test-cmd.rb/Test/Cmd.html#cmd-class_method)
-method that can be included into a
-testcase. The
-[`cmd`](https://0x1eef.github.io/x/test-cmd.rb/Test/Cmd.html#cmd-class_method)
-method takes the command to run as its first and only argument:
+[`cmd`](https://0x1eef.github.io/x/test-cmd.rb/Test/CmdMixin.html#cmd-instance_method)
+method is given the name of a command, along with any arguments:
 
 ```ruby
 require "test/unit"
 require "test/cmd"
 
 class CmdTest < Test::Unit::TestCase
-  include Test::Cmd
-
   def test_ruby_stdout
     assert_equal "foo\n", cmd(%q(ruby -e '$stdout.puts "foo"')).stdout
   end
@@ -46,6 +39,23 @@ class CmdTest < Test::Unit::TestCase
 end
 ```
 
+### Builder
+
+test-cmd.rb provides an API that is similar to Rust's
+[Command API](https://doc.rust-lang.org/std/process/struct.Command.html).
+<br>
+The
+[API reference](https://0x1eef.github.io/x/test-cmd.rb)
+covers it in more-depth:
+
+``` ruby
+require "test/cmd"
+str = cmd("du")
+      .arg("-s").arg("-h")
+      .spawn.stdout
+puts str      
+```
+
 ### IO#sync
 
 Sometimes it can be neccessary to bypass Ruby's internal buffer and flush
@@ -101,7 +111,7 @@ are available as sources.
 
 ``` ruby
 # Gemfile
-gem "test-cmd.rb", github: "0x1eef/test-cmd.rb", tag: "v0.4.2"
+gem "test-cmd.rb", github: "0x1eef/test-cmd.rb", tag: "v0.5.1"
 ```
 
 **Rubygems.org**

data/lib/test-cmd.rb

@@ -8,69 +8,118 @@ end unless defined?(Test)
 # for verifying that when code examples are run they produce the
 # expected output. The library can be generally useful outside a
 # test environment, too.
-module Test::Cmd
-  class Result
-    require "tempfile"
-    ##
-    # @return [String]
-    #  Returns the contents of stdout
-    attr_reader :stdout
+class Test::Cmd
+  require "tempfile"
 
-    ##
-    # @return [String]
-    #  Returns the contents of stderr
-    attr_reader :stderr
-
-    ## @return [Process::Status]
-    #  Returns the status of a process
-    attr_reader :status
+  ##
+  # @param [String] cmd
+  #  A command to spawn.
+  # @param [Array<String>] args
+  #  An array of command-line arguments.
+  # @return [Test::Cmd]
+  def initialize(cmd, args = [])
+    @cmd = cmd
+    @args = args.dup
+    @out = Tempfile.new("cmd-stdout").tap(&:unlink)
+    @err = Tempfile.new("cmd-stderr").tap(&:unlink)
+    @status = nil
+    @spawned = false
+  end
 
-    ##
-    # @param [Tempfile] stdout
-    # @param [Tempfile] stderr
-    # @param [Process::Status] pstatus
-    # @return [Test::Cmd::Result]
-    def initialize(stdout, stderr, pstatus)
-      @stdout = stdout.tap(&:rewind).read
-      @stderr = stderr.tap(&:rewind).read
-      @status = pstatus
+  ##
+  # @param [String, #to_s] arg
+  #  A command-line argument.
+  # @return [Test::Cmd]
+  def arg(arg)
+    tap do
+      @args.push(arg)
     end
+  end
 
-    ##
-    # @return [Integer]
-    #  Returns the exit status of a process
-    def exit_status
-      @status.exitstatus
+  ##
+  # @param [Array<String, #to_s>] args
+  #  One or more command-line arguments.
+  # @return [Test::Cmd]
+  def args(*args)
+    tap do
+      @args.concat(args)
     end
+  end
 
-    ##
-    # Yields each line of stdout when the command
-    # was successful, or each line of stderr when
-    # the command was not successful.
-    #
-    # @return [Enumerator]
-    #  Returns an Enumerator when a block is not given.
-    def each_line
-      return enum_for(:each_line) unless block_given?
-      io = @status.success? ? @stdout : @stderr
-      io.each_line.each { yield(_1.chomp) }
+  ##
+  # Spawns a command.
+  # @return [Test::Cmd]
+  def spawn
+    tap do
+      @spawned = true
+      Process.wait Process.spawn(@cmd, *@args, {out: @out, err: @err})
+      @status = $?
     end
+  ensure
+    [stdout,stderr]
+  end
+
+  ##
+  # @return [String]
+  #  Returns the contents of stdout.
+  def stdout
+    spawn unless @spawned
+    @stdout ||= @out.tap(&:rewind).read
+  ensure
+    @out.close unless @out.closed?
+  end
+
+  ##
+  # @return [String]
+  #  Returns the contents of stderr.
+  def stderr
+    spawn unless @spawned
+    @stderr ||= @err.tap(&:rewind).read
+  ensure
+    @err.close unless @err.closed?
+  end
+
+  ## @return [Process::Status]
+  #  Returns the status of a process
+  def status
+    spawn unless @spawned
+    @status
+  end
+
+  ##
+  # @return [Integer]
+  #  Returns the exit status of a process
+  def exit_status
+    status.exitstatus
   end
 
+  ##
+  # Yields each line of stdout when the command
+  # was successful, or each line of stderr when
+  # the command was not successful.
+  # @return [Enumerator]
+  #  Returns an Enumerator when a block is not given.
+  def each_line
+    return enum_for(:each_line) unless block_given?
+    spawn unless @spawned
+    io = @status.success? ? @stdout : @stderr
+    io.each_line.each { yield(_1.chomp) }
+  end
+end
+
+module Test::CmdMixin
   ##
   # @param [String] cmd
   #  A command to execute
-  #
-  # @return [Test::Cmd::Result]
-  #  Returns an instance of {Test::Cmd::Result Test::Cmd::Result}
-  def cmd(cmd)
-    out = Tempfile.new("cmd-stdout").tap(&:unlink)
-    err = Tempfile.new("cmd-stderr").tap(&:unlink)
-    Process.wait spawn(cmd, {err:, out:})
-    Result.new(out, err, $?)
-  ensure
-    out.close
-    err.close
+  # @param [Array<String>] args
+  #  An array of command-line arguments.
+  # @return [Test::Cmd]
+  #  Returns an instance of {Test::Cmd Test::Cmd}
+  def cmd(cmd, args = [])
+    Test::Cmd.new(cmd, args)
   end
-  module_function :cmd
+end
+
+module Kernel
+  include Test::CmdMixin
 end

data/test/test_cmd_test.rb

@@ -1,8 +1,6 @@
 require_relative "setup"
 
 class CmdTest < Test::Unit::TestCase
-  include Test::Cmd
-
   def test_ruby_stdout
     assert_equal "foo\n", cmd(%q(ruby -e '$stdout.puts "foo"')).stdout
   end

data/test-cmd.rb.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |gem|
   gem.authors = ["0x1eef"]
   gem.email = ["0x1eef@protonmail.com"]
   gem.homepage = "https://github.com/0x1eef/test-cmd.rb#readme"
-  gem.version = "0.4.2"
+  gem.version = "0.5.1"
   gem.required_ruby_version = ">= 3.0"
   gem.licenses = ["0BSD"]
   gem.files = `git ls-files`.split($/)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: test-cmd.rb
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.1
 platform: ruby
 authors:
 - '0x1eef'
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-07 00:00:00.000000000 Z
+date: 2024-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-unit