docs/howto: use path.Join

This adds a Commented CUE guide that demonstrates using path.Join to construct well-formed paths. One example of parent directory traversal is included. Preview-Path: /docs/howto/use-the-builtin-function-path-join-to-construct-well-formed-paths/ Signed-off-by: Jonathan Matthews <[email protected]> Change-Id: I046a00af48dd5a34e15affe49a7ab8949bd0d787 Dispatch-Trailer: {"type":"trybot","CL":1174728,"patchset":1,"ref":"refs/changes/28/1174728/1","targetBranch":"alpha"}
cue-lang · Jan 17, 2024 · b378567 · b378567
1 parent 39efc8c
commit b378567
Show file tree

Hide file tree

Showing 4 changed files with 110 additions and 0 deletions.
diff --git a/...s/howto/use-the-builtin-function-path-join-to-construct-well-formed-paths/en.md b/...s/howto/use-the-builtin-function-path-join-to-construct-well-formed-paths/en.md
@@ -0,0 +1,44 @@
+---
+title: Using the builtin function "path.Join" to construct well-formed paths
+tags:
+- commented cue
+authors:
+- jpluscplusm
+toc_hide: true
+---
+
+This [Commented CUE]({{< relref "docs/howto#commented-cue-guides" >}})
+demonstrates how to use the builtin function `path.Join` to construct
+well-formed paths from their individual string components.
+
+{{{with code "en" "cc"}}}
+exec cue export
+cmp stdout out
+-- file.cue --
+package example
+
+import "path"
+
+inline: path.Join(["foo", "bar", "baz"], path.Unix)
+
+unix:    path.Join(_components, path.Unix)
+windows: path.Join(_components, path.Windows)
+
+_components: [
+	"foo",
+	"bar",
+	"baz",
+	"..",
+	"quux",
+]
+-- out --
+{
+    "inline": "foo/bar/baz",
+    "unix": "foo/bar/quux",
+    "windows": "foo\\bar\\quux"
+}
+{{{end}}}
+
+## Related content
+
+- The [`path`](https://pkg.go.dev/cuelang.org/go/pkg/path) builtin package
diff --git a/...ocs/howto/use-the-builtin-function-path-join-to-construct-well-formed-paths/gen_cache.cue b/...ocs/howto/use-the-builtin-function-path-join-to-construct-well-formed-paths/gen_cache.cue
@@ -0,0 +1,18 @@
+package site
+{
+	content: {
+		docs: {
+			howto: {
+				"use-the-builtin-function-path-join-to-construct-well-formed-paths": {
+					page: {
+						cache: {
+							code: {
+								cc: "cse+WWX+uowJG/2noGjtURmZGxLi3Y7w3JjRT1BAHD0="
+							}
+						}
+					}
+				}
+			}
+		}
+	}
+}
diff --git a/...ent/docs/howto/use-the-builtin-function-path-join-to-construct-well-formed-paths/page.cue b/...ent/docs/howto/use-the-builtin-function-path-join-to-construct-well-formed-paths/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: howto: "use-the-builtin-function-path-join-to-construct-well-formed-paths": {}
diff --git a/...owto/use-the-builtin-function-path-join-to-construct-well-formed-paths/index.md b/...owto/use-the-builtin-function-path-join-to-construct-well-formed-paths/index.md
@@ -0,0 +1,45 @@
+---
+title: Using the builtin function "path.Join" to construct well-formed paths
+tags:
+- commented cue
+authors:
+- jpluscplusm
+toc_hide: true
+---
+
+This [Commented CUE]({{< relref "docs/howto#commented-cue-guides" >}})
+demonstrates how to use the builtin function `path.Join` to construct
+well-formed paths from their individual string components.
+
+{{< code-tabs >}}
+{{< code-tab name="file.cue" language="cue"  area="top-left" >}}
+package example
+
+import "path"
+
+inline: path.Join(["foo", "bar", "baz"], path.Unix)
+
+unix:    path.Join(_components, path.Unix)
+windows: path.Join(_components, path.Windows)
+
+_components: [
+	"foo",
+	"bar",
+	"baz",
+	"..",
+	"quux",
+]
+{{< /code-tab >}}
+{{< code-tab name="TERMINAL" language="" type="terminal" area="top-right" >}}
+$ cue export
+{
+    "inline": "foo/bar/baz",
+    "unix": "foo/bar/quux",
+    "windows": "foo\\bar\\quux"
+}
+{{< /code-tab >}}
+{{< /code-tabs >}}
+
+## Related content
+
+- The [`path`](https://pkg.go.dev/cuelang.org/go/pkg/path) builtin package
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: howto: "use-the-builtin-function-path-join-to-construct-well-formed-paths": {}