feat: add exec lib for crystal

Author: initdc

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*.cr]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true

.gitignore

@@ -0,0 +1,9 @@
+/docs/
+/lib/
+/bin/
+/.shards/
+*.dwarf
+
+# Libraries don't need dependency lock
+# Dependencies will be locked in applications that use them
+/shard.lock

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 initdc <initd@outlook.com>
+
+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.

README.md

@@ -0,0 +1,38 @@
+# exec
+
+> Subclass for `Process`
+
+## Installation
+
+1. Add the dependency to your `shard.yml`:
+
+   ```yaml
+   dependencies:
+     exec:
+       github: initdc/exec
+       version: 0.0.1
+   ```
+
+2. Run `shards install`
+
+## Usage
+
+```crystal
+require "exec"
+
+Exec.run("sudo apt update")
+p Exec.code("unamea")
+p Exec.output("uname")
+```
+
+## Contributing
+
+1. Fork it (<https://github.com/initdc/exec/fork>)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+## Contributors
+
+- [initdc](https://github.com/initdc) - creator and maintainer

shard.yml

@@ -0,0 +1,9 @@
+name: exec
+version: 0.1.0
+
+authors:
+  - initdc <initd@outlook.com>
+
+crystal: ">= 1.0.0, < 2.0.0"
+
+license: MIT

spec/exec_spec.cr

@@ -0,0 +1,39 @@
+require "./spec_helper"
+
+describe Exec do
+  it "print lines" do
+    Exec.run("sudo apt update")
+  end
+
+  it "return 0" do
+    Exec.code("uname").should eq 0
+  end
+
+  it "accept multi string" do
+    Exec.code("uname -s").should eq 0
+  end
+
+  it "return 127" do
+    Exec.code("unamea").should eq 127
+  end
+
+  it "get Linux" do
+    Exec.output("uname").should eq "Linux"
+  end
+
+  it "log to file" do
+    tempfile = File.tempfile("test_", ".log")
+    Exec.run("uname", output: File.open(tempfile.path, "a+"))
+
+    tempfile.gets_to_end.should eq "Linux\n"
+    tempfile.delete
+  end
+
+  it "list file" do
+    Exec.each_line("ls spec").should eq ["exec_spec.cr\n", "spec_helper.cr\n"]
+  end
+
+  it "list file with option" do
+    Exec.each_line("ls spec", chomp: true).should eq ["exec_spec.cr", "spec_helper.cr"]
+  end
+end

spec/spec_helper.cr

@@ -0,0 +1,2 @@
+require "spec"
+require "../src/exec"

src/exec.cr

@@ -0,0 +1,45 @@
+class Exec < Process
+  VERSION = "0.1.0"
+
+  def self.run(command : String, args = nil, env : Env = nil, clear_env : Bool = false, shell : Bool = true,
+               input : Stdio = Redirect::Inherit, output : Stdio = Redirect::Inherit, error : Stdio = Redirect::Inherit, chdir : Path | String? = nil) : Process::Status
+    status = new(command, args, env, clear_env, shell, input, output, error, chdir).wait
+    $? = status
+    status
+  end
+
+  def self.code(command : String, args = nil, env : Env = nil, clear_env : Bool = false, shell : Bool = true,
+                input : Stdio = Redirect::Inherit, output : Stdio = Redirect::Inherit, error : Stdio = Redirect::Inherit, chdir : Path | String? = nil) : Int32
+    status = new(command, args, env, clear_env, shell, input, output, error, chdir).wait
+    $? = status
+    status.exit_code
+  rescue File::NotFoundError
+    127
+  end
+
+  def self.output(command) : String
+    process = new(command, shell: true, input: Redirect::Inherit, output: Redirect::Pipe, error: Redirect::Inherit)
+    output = process.output.gets_to_end
+    status = process.wait
+    $? = status
+    output.chomp
+  end
+
+  def self.each_line(command, chomp = false, &block : String ->) : Nil
+    process = new(command, shell: true, input: Redirect::Inherit, output: Redirect::Pipe, error: Redirect::Inherit)
+    output = process.output.gets_to_end
+    status = process.wait
+    $? = status
+    output.each_line(chomp) do |line|
+      yield line
+    end
+  end
+
+  def self.each_line(command, chomp = false)
+    process = new(command, shell: true, input: Redirect::Inherit, output: Redirect::Pipe, error: Redirect::Inherit)
+    output = process.output.gets_to_end
+    status = process.wait
+    $? = status
+    output.each_line(chomp).to_a
+  end
+end