Add platform: module to expose platform data

pkg/eval/platform/platform.go

@@ -0,0 +1,29 @@
+// Package `os` exposes variables and functions that deal with the specific
+// platform being run on; such as the OS name and CPU architecture.
+package platform
+
+import (
+	"runtime"
+
+	"github.com/elves/elvish/pkg/eval"
+	"github.com/elves/elvish/pkg/eval/vars"
+)
+
+//elvdoc:var arch
+//
+// The architecture of the platform; e.g., amd64, arm, ppc.
+// This corresponds to Go's
+// [`GOARCH`](https://pkg.go.dev/runtime?tab=doc#pkg-constants) constant.
+// This is read-only.
+
+//elvdoc:var os
+//
+// The name of the operating system; e.g., darwin (macOS), linux, etc.
+// This corresponds to Go's
+// [`GOOS`](https://pkg.go.dev/runtime?tab=doc#pkg-constants) constant.
+// This is read-only.
+
+var Ns = eval.Ns{
+	"arch": vars.NewReadOnly(runtime.GOARCH),
+	"os": vars.NewReadOnly(runtime.GOOS),
+}

pkg/eval/platform/platform_test.go

@@ -0,0 +1,18 @@
+package platform
+
+import (
+	"runtime"
+	"testing"
+
+	"github.com/elves/elvish/pkg/eval"
+)
+
+var That = eval.That
+
+func TestOs(t *testing.T) {
+	setup := func(ev *eval.Evaler) { ev.Builtin.AddNs("platform", Ns) }
+	eval.TestWithSetup(t, setup,
+		That(`put $platform:arch`).Puts(runtime.GOARCH),
+		That(`put $platform:os`).Puts(runtime.GOOS),
+	)
+}

pkg/program/shell/runtime.go

@@ -15,6 +15,7 @@ import (
 	"github.com/elves/elvish/pkg/eval/re"
 	"github.com/elves/elvish/pkg/eval/store"
 	"github.com/elves/elvish/pkg/eval/str"
+	"github.com/elves/elvish/pkg/eval/platform"
 	daemonp "github.com/elves/elvish/pkg/program/daemon"
 )
 
@@ -74,6 +75,7 @@ func InitRuntime(binpath, sockpath, dbpath string) (*eval.Evaler, string) {
 	ev.InstallModule("math", eval.MathNs)
 	ev.InstallModule("re", re.Ns)
 	ev.InstallModule("str", str.Ns)
+	ev.InstallModule("platform", platform.Ns)
 	if sockpath != "" && dbpath != "" {
 		spawner := &daemonp.Daemon{
 			BinPath:       binpath,

website/ref/index.toml

@@ -10,6 +10,10 @@ title = "The Builtin Module"
 name = "edit"
 title = "The Editor Module (edit:)"
 
+[[articles]]
+name = "platform"
+title = "Access to the platform’s identifying data (platform:)"
+
 [[articles]]
 name = "re"
 title = "The Regular Expression Module (re:)"

website/ref/platform.md

@@ -0,0 +1,7 @@
+<!-- toc -->
+
+# Introduction
+
+The `platform:` module provides access to the platform’s identifying data.
+
+@elvdoc -ns platform: -dir ../pkg/eval/platform