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-built-in-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":2,"ref":"refs/changes/28/1174728/2","targetBranch":"alpha"}
cue-lang · Jan 18, 2024 · 0c0f0b8 · 0c0f0b8
1 parent 4cf5259
commit 0c0f0b8
Show file tree

Hide file tree

Showing 4 changed files with 110 additions and 0 deletions.
diff --git a/.../howto/use-the-built-in-function-path-join-to-construct-well-formed-paths/en.md b/.../howto/use-the-built-in-function-path-join-to-construct-well-formed-paths/en.md
@@ -0,0 +1,44 @@
+---
+title: Using the built-in 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 built-in 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) built-in package
diff --git a/...cs/howto/use-the-built-in-function-path-join-to-construct-well-formed-paths/gen_cache.cue b/...cs/howto/use-the-built-in-function-path-join-to-construct-well-formed-paths/gen_cache.cue
@@ -0,0 +1,18 @@
+package site
+{
+	content: {
+		docs: {
+			howto: {
+				"use-the-built-in-function-path-join-to-construct-well-formed-paths": {
+					page: {
+						cache: {
+							code: {
+								cc: "cse+WWX+uowJG/2noGjtURmZGxLi3Y7w3JjRT1BAHD0="
+							}
+						}
+					}
+				}
+			}
+		}
+	}
+}
diff --git a/...nt/docs/howto/use-the-built-in-function-path-join-to-construct-well-formed-paths/page.cue b/...nt/docs/howto/use-the-built-in-function-path-join-to-construct-well-formed-paths/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: howto: "use-the-built-in-function-path-join-to-construct-well-formed-paths": {}
diff --git a/...wto/use-the-built-in-function-path-join-to-construct-well-formed-paths/index.md b/...wto/use-the-built-in-function-path-join-to-construct-well-formed-paths/index.md
@@ -0,0 +1,45 @@
+---
+title: Using the built-in 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 built-in 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) built-in package
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

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