elvish/pkg/eval/builtin_fn_cmd.go
Qi Xiao 6e8ecc8bd5 pkg/eval: Cleanups for reducing the API surface area number of files.
- Move NewEnvListVar to pkg/eval/vars.

- De-export GlobPattern, GlobFlag and ExternalCmd.

- Merge editor.go and chdir.go into eval.go, value_helper.go into compile_value.go.

- Remove eval_internal_test.go and replace it with a new test for $pid.
2021-01-05 04:33:52 +00:00

122 lines
2.0 KiB
Go

package eval
import (
"fmt"
"os"
"os/exec"
)
// Command and process control.
// TODO(xiaq): Document "fg".
func init() {
addBuiltinFns(map[string]interface{}{
// Command resolution
"external": external,
"has-external": hasExternal,
"search-external": searchExternal,
// Process control
"fg": fg,
"exec": execFn,
"exit": exit,
})
}
//elvdoc:fn external
//
// ```elvish
// external $program
// ```
//
// Construct a callable value for the external program `$program`. Example:
//
// ```elvish-transcript
// ~> x = (external man)
// ~> $x ls # opens the manpage for ls
// ```
//
// @cf has-external search-external
func external(cmd string) Callable {
return NewExternalCmd(cmd)
}
//elvdoc:fn has-external
//
// ```elvish
// has-external $command
// ```
//
// Test whether `$command` names a valid external command. Examples (your output
// might differ):
//
// ```elvish-transcript
// ~> has-external cat
// ▶ $true
// ~> has-external lalala
// ▶ $false
// ```
//
// @cf external search-external
func hasExternal(cmd string) bool {
_, err := exec.LookPath(cmd)
return err == nil
}
//elvdoc:fn search-external
//
// ```elvish
// search-external $command
// ```
//
// Output the full path of the external `$command`. Throws an exception when not
// found. Example (your output might vary):
//
// ```elvish-transcript
// ~> search-external cat
// ▶ /bin/cat
// ```
//
// @cf external has-external
func searchExternal(cmd string) (string, error) {
return exec.LookPath(cmd)
}
//elvdoc:fn exit
//
// ```elvish
// exit $status?
// ```
//
// Exit the Elvish process with `$status` (defaulting to 0).
func exit(fm *Frame, codes ...int) error {
code := 0
switch len(codes) {
case 0:
case 1:
code = codes[0]
default:
return ErrArgs
}
preExit(fm)
os.Exit(code)
// Does not return
panic("os.Exit returned")
}
func preExit(fm *Frame) {
daemon := fm.Evaler.DaemonClient()
if daemon != nil {
err := daemon.Close()
if err != nil {
fmt.Fprintln(os.Stderr, err)
}
}
}