Process (#129)

Adds a basic `process.create` method to create a subprocess. Supports
shell, cwd, and env options. See `examples/process.luau` for some usage.

```luau
type ProcessOptions = {
    shell: boolean | string?,
    cwd: string?,
    env: { [string]: string }?,
}

type ProcessResult = {
    ok: boolean,
    exitcode: number,
    stdout: string,
    stderr: string,
    signal: string?,
}

type process = {
    create: (args: string | {string}, options: ProcessOptions?) -> ProcessResult,
}
```

Closes #115

Author: Nicell

CMakeLists.txt

@@ -15,6 +15,7 @@ add_library(Lute.Luau STATIC)
 add_library(Lute.Net STATIC)
 add_library(Lute.Task STATIC)
 add_library(Lute.VM STATIC)
+add_library(Lute.Process STATIC)
 
 # luau setup
 set(LUAU_BUILD_CLI OFF)
@@ -83,20 +84,23 @@ target_compile_features(Lute.Luau PUBLIC cxx_std_17)
 target_compile_features(Lute.Net PUBLIC cxx_std_17)
 target_compile_features(Lute.Task PUBLIC cxx_std_17)
 target_compile_features(Lute.VM PUBLIC cxx_std_17)
+target_compile_features(Lute.Process PUBLIC cxx_std_17)
 target_include_directories(Lute.Runtime PUBLIC runtime/include ${LIBUV_INCLUDE_DIR})
 target_include_directories(Lute.Fs PUBLIC fs/include ${LIBUV_INCLUDE_DIR})
 target_include_directories(Lute.Luau PUBLIC luau/include ${LIBUV_INCLUDE_DIR})
 target_include_directories(Lute.Net PUBLIC net/include ${LIBUV_INCLUDE_DIR} ${UWEBSOCKETS_INCLUDE_DIR})
 target_include_directories(Lute.Task PUBLIC task/include ${LIBUV_INCLUDE_DIR})
 target_include_directories(Lute.VM PUBLIC vm/include ${LIBUV_INCLUDE_DIR})
+target_include_directories(Lute.Process PUBLIC process/include ${LIBUV_INCLUDE_DIR})
 
 target_link_libraries(Lute.Runtime PRIVATE Luau.CLI.lib Luau.Compiler Luau.Config Luau.CodeGen Luau.VM uv_a)
 target_link_libraries(Lute.Fs PRIVATE Lute.Runtime Luau.VM uv_a)
 target_link_libraries(Lute.Luau PRIVATE Lute.Runtime Luau.VM uv_a Luau.Analysis Luau.Ast Luau.Compiler)
 target_link_libraries(Lute.Net PRIVATE Lute.Runtime Luau.VM uv_a ${WOLFSSL_LIBRARY} libcurl uWS)
 target_link_libraries(Lute.Task PRIVATE Lute.Runtime Luau.VM uv_a)
 target_link_libraries(Lute.VM PRIVATE Lute.Runtime Luau.VM uv_a)
-target_link_libraries(Lute.CLI PRIVATE Luau.CLI.lib Luau.Compiler Luau.Config Luau.CodeGen Luau.Analysis Luau.VM Lute.Runtime Lute.Fs Lute.Luau Lute.Net Lute.Task Lute.VM)
+target_link_libraries(Lute.Process PRIVATE Lute.Runtime Luau.VM uv_a)
+target_link_libraries(Lute.CLI PRIVATE Luau.CLI.lib Luau.Compiler Luau.Config Luau.CodeGen Luau.Analysis Luau.VM Lute.Runtime Lute.Fs Lute.Luau Lute.Net Lute.Task Lute.VM Lute.Process)
 
 set(LUTE_OPTIONS)
 
@@ -119,4 +123,5 @@ target_compile_options(Lute.Luau PRIVATE ${LUTE_OPTIONS})
 target_compile_options(Lute.Net PRIVATE ${LUTE_OPTIONS})
 target_compile_options(Lute.Task PRIVATE ${LUTE_OPTIONS})
 target_compile_options(Lute.VM PRIVATE ${LUTE_OPTIONS})
+target_compile_options(Lute.Process PRIVATE ${LUTE_OPTIONS})
 target_compile_options(Lute.CLI PRIVATE ${LUTE_OPTIONS})

Sources.cmake

@@ -42,6 +42,12 @@ target_sources(Lute.VM PRIVATE
     vm/src/vm.cpp
 )
 
+target_sources(Lute.Process PRIVATE
+    process/include/lute/process.h
+
+    process/src/process.cpp
+)
+
 target_sources(Lute.CLI PRIVATE
     cli/main.cpp
     cli/tc.h

cli/main.cpp

@@ -12,6 +12,7 @@
 #include "lute/luau.h"
 #include "lute/net.h"
 #include "lute/options.h"
+#include "lute/process.h"
 #include "lute/ref.h"
 #include "lute/require.h"
 #include "lute/runtime.h"
@@ -61,6 +62,9 @@ lua_State* setupState(Runtime& runtime)
     luteopen_net(L);
     lua_setfield(L, -2, "@lute/net");
 
+    luteopen_process(L);
+    lua_setfield(L, -2, "@lute/process");
+
     luteopen_task(L);
     lua_setfield(L, -2, "@lute/task");
 

examples/process.luau

@@ -0,0 +1,32 @@
+local process = require("@lute/process")
+local task = require("@std/task")
+
+local result = process.create({ "echo", "Hello, lute!" })
+
+print(result.exitcode)
+print(result.stdout)
+
+local t1 = task.create(process.create, { "echo", "-n", "One" })
+local t2 = task.create(process.create, { "echo", "-n", "Two" })
+local t3 = task.create(process.create, { "echo", "-n", "Three" })
+
+local r1, r2, r3 = task.awaitall(t1, t2, t3)
+
+print(r1.stdout)
+print(r2.stdout)
+print(r3.stdout)
+
+local r4 = process.create("echo Hello, lute!", { shell = true })
+print(r4.stdout)
+
+local r5 = process.create({ "echo", "$HOME" }, { env = { HOME = "/home/lute" }, shell = true })
+print(r5.stdout)
+
+local r6 = process.create({ "pwd" }, { cwd = "/" })
+print(r6.stdout)
+
+local r7 = process.create("echo $0", { shell = true })
+print(r7.stdout)
+
+local r8 = process.create("echo $0", { shell = "/bin/sh" })
+print(r8.stdout)

process/include/lute/process.h

@@ -0,0 +1,21 @@
+#pragma once
+
+#include "lua.h"
+#include "lualib.h"
+
+// open the library as a standard global luau library
+int luaopen_process(lua_State* L);
+// open the library as a table on top of the stack
+int luteopen_process(lua_State* L);
+
+namespace process
+{
+
+int create(lua_State* L);
+
+static const luaL_Reg lib[] = {
+    {"create", create},
+    {nullptr, nullptr}
+};
+
+} // namespace process