libexec 0.1.3 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77b2818bcb0419a2a77206010ffd1b9c8fb968c94c8edc5eab9885874371f388
-  data.tar.gz: 2179f593890be22ce4fead91f43074eec53230ef90443c869450393f4c2bcea7
+  metadata.gz: 8705278823a3fe7c5edd0913befd194389f692ed9833396138a0a97d75b6f72b
+  data.tar.gz: 0eccd36d324534284495454e5116890c4620a63657d8fa44dca2fec36f837b49
 SHA512:
-  metadata.gz: 3f59c196e116b776292e56d1f32655221681416e64f9fdca4f5a84975eb37d3b80d37142422ebc65fb56b8ff92caceba23b7c0aa9d9dfd0708bff7f4706d10e2
-  data.tar.gz: 835c4005bdfe3b68d481582c6b30a882779ceba0352b1d09e6126245025082a322417c087c7cf99f5990c6fca0909051dcb1ade42b8463f6272947e3a55a821e
+  metadata.gz: 8062c95b812bf5f3e5d7d491984bfdfd842a54a4e1446af536476832c720dd9f1d8807c9c4b70936163a8d14b282eb703f6cec072eabb33ba8e54fb836c62e91
+  data.tar.gz: 3bc5590a2d359db0d1efbea7ccef0f447ecb8ecbe74e9e20bebfce3ec049b7a33ef8ab5b994febac6fbfc276185e7b438ee6d7d71cc9814aa97a6c21e721bf7d

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    libexec (0.1.3)
+    libexec (0.2.1)
 
 GEM
   remote: https://rubygems.org/

data/lib/libexec/exec.rb

@@ -2,38 +2,75 @@
 
 module Libexec
   module Exec
-    def run(cmd)
-      # https://docs.ruby-lang.org/en/master/IO.html#method-c-popen
-      IO.popen(cmd) do |pipe|
+    # wrapper for Ruby IO.popen
+    # {https://docs.ruby-lang.org/en/master/IO.html#method-c-popen link} <br>
+    # cmd first grammar <br>
+    # conv argv by _ruby_style_cmd
+    #
+    # @return [nil]
+    def run(*argv, env: {}, mode: "r", **opts)
+      cmd = _ruby_style_cmd(argv)
+
+      IO.popen(env, cmd, mode, opts) do |pipe|
         print pipe.gets until pipe.eof?
       end
       nil
     end
 
-    def each_line(cmd, &block)
-      # https://docs.ruby-lang.org/en/master/IO.html#method-i-each_line
-      IO.popen(cmd) do |pipe|
+    # Run code block in IO.popen <br>
+    # inspired from Ruby IO.each_line
+    # {https://docs.ruby-lang.org/en/master/IO.html#method-i-each_line link}
+    def each_line(*argv, env: {}, mode: "r", **opts, &block)
+      cmd = _ruby_style_cmd(argv)
+
+      IO.popen(env, cmd, mode, opts) do |pipe|
         pipe.each_line(&block)
       end
     end
 
-    def by_ls_1(dir)
+    # wrapper for `ls -1` which will be often used
+    #
+    # @param  [Array] argv
+    # @return [Array] line.chomp
+    def by_ls_1(*argv, **opts)
       arr = []
-      each_line("ls -1 #{dir}") do |line|
+      each_line("ls", "-1", argv, opts: opts) do |line|
         arr.push line.chomp
       end
       arr
     end
 
-    def each_ls_1(dir, &block)
-      each_line("ls -1 #{dir}", &block)
+    # Operate each line result by yourself in `ls -1`
+    #
+    # @param [Array] argv
+    def each_ls_1(*argv, **opts, &block)
+      each_line("ls", "-1", argv, opts: opts, &block)
     end
 
-    def code(cmd, *opt, **args)
-      catch_error = !opt.empty? || args[:catch_error] || false
-      code = opt[0] || args[:code] || 1
+    # wrapper for Process.spawn
+    # {https://docs.ruby-lang.org/en/master/Process.html#method-c-last_status link}
+    #
+    # @return [Integer]
+    def code(*argv, **opts)
+      catch_error = opts[:catch_error]
+      code = opts[:code]
+
+      if argv.size < 2
+        catch_error ||= false
+        code ||= 1
+
+        cmd = _js_style_cmd(argv)
+      else
+        is_integer = argv.last.instance_of?(Integer)
+
+        catch_error ||= is_integer
+        code ||= (argv.last if is_integer) || 1
+
+        args = argv.clone
+        args.pop
+        cmd = is_integer ? _js_style_cmd(args) : _js_style_cmd(argv)
+      end
 
-      # https://docs.ruby-lang.org/en/master/Process.html#method-c-last_status
       Process.spawn(cmd)
       Process.wait
 
@@ -48,10 +85,68 @@ module Libexec
       127
     end
 
-    def output(cmd)
-      # https://docs.ruby-lang.org/en/master/Kernel.html#method-i-60
+    # wrapper for Kernel.`command`
+    # {https://docs.ruby-lang.org/en/master/Kernel.html#method-i-60 link}
+    #
+    # @note Only recommend to use when get single line output
+    # @return [String] output.chomp
+    def output(*argv)
+      cmd = _js_style_cmd(argv)
+
       output = `#{cmd}`
       output.chomp
     end
+
+    private
+
+    # cmd must be unix command String <br>
+    # no " ", not Array <br>
+    # not support cmd with opt like `ls -1`
+    #
+    # @param [Array] argv
+    # @return [String | Array]
+    #
+    # @since 0.2.1
+    def _ruby_style_cmd(argv)
+      cmd, *args = argv
+
+      unless args.empty?
+        arr = [cmd]
+        args.each do |arg|
+          # https://docs.ruby-lang.org/en/master/Kernel.html#method-i-class
+          if arg.instance_of?(Array)
+            arr.concat(arg)
+          elsif arg.instance_of?(String)
+            arr.push(arg)
+          end
+        end
+        cmd = arr
+      end
+      cmd
+    end
+
+    # in JS style, all arg connect with " " <br>
+    # so cmd like `ls -1` is OK
+    #
+    # @param [Array] argv
+    # @return [String | Array]
+    #
+    # @since 0.2.1
+    def _js_style_cmd(argv)
+      cmd, *args = argv
+
+      unless args.empty?
+        arr = [cmd]
+        args.each do |arg|
+          if arg.instance_of?(Array)
+            arr.push(%('#{arg.join(" ")}'))
+          elsif arg.instance_of?(String)
+            arr.push(arg)
+          end
+        end
+        cmd = arr.join(" ")
+      end
+      cmd
+    end
   end
 end

data/lib/libexec/version.rb

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

data/lib/libexec.rb

@@ -4,8 +4,5 @@ require_relative "libexec/version"
 require_relative "libexec/exec"
 
 module Libexec
-  class Error < StandardError; end
-  # Your code goes here...
-
   extend Libexec::Exec
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libexec
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.1
 platform: ruby
 authors:
 - initdc
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-12-25 00:00:00.000000000 Z
+date: 2022-12-27 00:00:00.000000000 Z
 dependencies: []
 description: Wrapper for ruby exec shell command.
 email: