Add two examples: imports and foreach pattern

examples/foreach-pattern/README.md

@@ -0,0 +1,16 @@
+# Foreach Pattern
+
+This example shows how a _foreach pattern_ works in Nickel using
+`std.array.map`. A second example combines a yaml-import with the map function.
+
+## Run
+
+```console
+nickel -f foreach-pattern.ncl export
+```
+
+Second example:
+
+```
+nickel -f foreach-pattern-on-import export
+```

examples/foreach-pattern/data_users.yml

@@ -0,0 +1,6 @@
+---
+users:
+  - jane
+  - pete
+  - richie
+  - ellen

examples/foreach-pattern/foreach-pattern-on-import.ncl

@@ -0,0 +1,12 @@
+let users = (import "data_users.yml").users |> std.array.map
+  (
+    fun name =>
+      {
+        username = name,
+        email = "%{name}@nickel-lang.org"
+      }
+  ) in
+
+{
+  posix_users = users
+}

examples/foreach-pattern/foreach-pattern.ncl

@@ -0,0 +1,12 @@
+let users = ["jane", "pete", "richie"] |> std.array.map
+  (
+    fun name =>
+      {
+        username = name,
+        email = "%{name}@nickel-lang.org"
+      }
+  ) in
+
+{
+  usernames = users
+}

examples/various-imports/README.md

@@ -0,0 +1,10 @@
+# Various Imports
+
+This example shows how Nickel and import different filetypes without needing
+extra boilerplate code.
+
+## Run
+
+```console
+nickel -f various-imports.ncl export
+```

examples/various-imports/data_groups.json

@@ -0,0 +1,7 @@
+{
+  "groups": [
+    "desktop-users",
+    "administrators",
+    "terminal-users"
+  ]
+}

examples/various-imports/data_machines.toml

@@ -0,0 +1,5 @@
+machines = [
+  "VAX-11",
+  "PDP-1",
+  "Bomba"
+]

examples/various-imports/data_nickel_properties.ncl

@@ -0,0 +1,15 @@
+let kelvin_to_celcius = fun kelvin => kelvin - 273.15 in
+let kelvin_to_fahrenheit = fun kelvin => (kelvin - 273.15) * 1.8000 + 32.00 in
+
+{
+  physical = {
+    phase_at_STP = "solid",
+    melting_point = "1728 K (%{std.string.from_number (kelvin_to_celcius 1728)} °C, %{std.string.from_number(kelvin_to_fahrenheit 1728)} °F)",
+    boiling_point = "3003 K (%{std.string.from_number (kelvin_to_celcius 3003)} °C, %{std.string.from_number(kelvin_to_fahrenheit 3003)} °F)",
+    density = "8.908 g/cm3",
+    when_liquid = "7.81 g/cm3",
+    heat_of_fusion = "17.48 kJ/mol",
+    heat_of_vaporization = "379 kJ/mol",
+    molar_heat_capacity = "26.07 J/(mol·K)"
+  }
+}

examples/various-imports/data_users.yml

@@ -0,0 +1,6 @@
+---
+users:
+  - jane
+  - pete
+  - richie
+  - ellen

examples/various-imports/various-imports.ncl

@@ -0,0 +1,19 @@
+# Nickel can import plain yaml, or json files
+let _users = (import "data_users.yml") in
+let _groups = (import "data_groups.json") in
+
+# It even imports toml
+let _machines = (import "data_machines.toml") in
+
+# And of course other nickel files
+let _nickel_properties = (import "data_nickel_properties.ncl") in
+
+# This is the output object
+{
+  users = _users.users,
+  groups = _groups.groups,
+  machines = _machines.machines,
+  off_topic = {
+    nickel_properties = _nickel_properties
+  }
+}