Fragletize: awk, elixir, php

Author: frison

awk/Dockerfile

@@ -3,3 +3,6 @@
 FROM 100hellos/000-base:local
 
 COPY --chown=human:human ./files /hello-world
+COPY --chown=human:human ./fraglet /
+
+ENTRYPOINT [ "/fraglet-entrypoint" ]

awk/files/hello-world.awk

@@ -1,5 +1,7 @@
 #!/usr/bin/awk -f
 
+# BEGIN_FRAGLET
 BEGIN {
   print "Hello World!"
-}
+}
+# END_FRAGLET

awk/fraglet/fraglet.yml

@@ -0,0 +1,15 @@
+# fraglet-entrypoint configuration for AWK container
+
+fragletTempPath: /FRAGLET
+
+injection:
+  codePath: /hello-world/hello-world.awk
+  match_start: "# BEGIN_FRAGLET"
+  match_end: "# END_FRAGLET"
+
+guide: /guide.md
+
+execution:
+  path: awk -f /hello-world/hello-world.awk
+  makeExecutable: false
+

awk/fraglet/guide.md

@@ -0,0 +1,79 @@
+# AWK Fraglet Guide
+
+## Language Version
+GNU AWK (gawk)
+
+## Execution Model
+- Interpreted, runs directly from source
+- Code executes in blocks: BEGIN, pattern-action, END
+- Scripts use `.awk` extension or can be executed with `awk -f script.awk`
+
+## Key Characteristics
+- Pattern-action programming language
+- Field-based text processing
+- Built-in variables: `$0` (entire line), `$1`, `$2`, etc. (fields)
+- Automatic field splitting on whitespace
+- Case-sensitive
+- Indentation is preserved based on the injection point
+
+## Fragment Authoring
+Write normal AWK code: define any functions first, then put runtime logic in `BEGIN { ... }`. Your fraglet becomes the script body; you don’t need to know how it’s wired into the container.
+
+## Available Packages
+Standard AWK (gawk) is available. No additional packages are pre-installed.
+
+## Common Patterns
+- Print: `print "message"` or `print("message")`
+- String concatenation: `"Hello" " " "World"` or `"Hello" " " name`
+- Variables: `name = "Alice"` (no declaration needed)
+- Arrays: `arr[1] = "value"` (associative arrays)
+- Loops: `for (i in array) { }` or `for (i = 1; i <= 10; i++) { }`
+- Conditionals: `if (condition) { } else { }`
+- Functions: `function name(args) { }` (must be defined outside BEGIN block, but can be included in fraglet)
+
+## Examples
+```awk
+# Simple output
+BEGIN {
+  print "Hello, World!"
+}
+
+# Variable assignment
+BEGIN {
+  name = "Alice"
+  print "Hello, " name "!"
+}
+
+# Array processing
+BEGIN {
+  numbers[1] = 1
+  numbers[2] = 2
+  numbers[3] = 3
+  numbers[4] = 4
+  numbers[5] = 5
+
+  sum = 0
+  for (i in numbers) {
+      sum += numbers[i] * numbers[i]
+  }
+  print "Sum of squares: " sum
+}
+
+# Function definition (outside BEGIN block) with execution (inside BEGIN block)
+function greet(name) {
+    return "Hello, " name "!"
+}
+
+BEGIN {
+    print greet("Bob")
+}
+```
+
+## Caveats
+- AWK is primarily designed for text processing with input streams
+- For fraglets without input, use BEGIN blocks (already in the file)
+- String concatenation is done by placing strings next to each other
+- Arrays are associative (can use strings as indices)
+- Variables don't need declaration
+- Field variables (`$1`, `$2`, etc.) are only meaningful when processing input
+

elixir/Dockerfile

@@ -7,3 +7,6 @@ RUN sudo \
     elixir
 
 COPY --chown=human:human ./files /hello-world
+COPY --chown=human:human ./fraglet /
+
+ENTRYPOINT [ "/fraglet-entrypoint" ]

elixir/files/hello-world.exs

@@ -2,5 +2,7 @@
 
 import IO, only: [puts: 1]
 
+# BEGIN_FRAGLET
 puts("Hello World!")
+# END_FRAGLET
 

elixir/fraglet/fraglet.yml

@@ -0,0 +1,15 @@
+# fraglet-entrypoint configuration for Elixir container
+
+fragletTempPath: /FRAGLET
+
+injection:
+  codePath: /hello-world/hello-world.exs
+  match_start: "# BEGIN_FRAGLET"
+  match_end: "# END_FRAGLET"
+
+guide: /guide.md
+
+execution:
+  path: elixir /hello-world/hello-world.exs
+  makeExecutable: false
+

elixir/fraglet/guide.md

@@ -0,0 +1,70 @@
+# Elixir Fraglet Guide
+
+## Language Version
+Elixir 1.x (runs on Erlang/OTP)
+
+## Execution Model
+- Interpreted, runs directly from source
+- Code executes at the top level
+- Scripts use `.exs` extension (executable scripts)
+
+## Key Characteristics
+- Functional programming language
+- Immutable data structures
+- Pattern matching
+- Pipe operator (`|>`)
+- Case-sensitive
+- Indentation is preserved based on the injection point
+
+## Fragment Authoring
+Write normal Elixir code; your fraglet becomes the script body. The file already imports `IO.puts`, so add modules, functions, or expressions as you normally would.
+
+## Available Packages
+Standard Elixir library is available. No additional packages are pre-installed.
+
+## Common Patterns
+- Print: `IO.puts("message")` or `IO.puts "message"`
+- String interpolation: `"Total: #{count}"`
+- Lists: `[1, 2, 3]`
+- Maps: `%{key: "value"}`
+- Pattern matching: `{a, b} = {1, 2}`
+- Pipe operator: `list |> Enum.map(fn x -> x * 2 end)`
+- Functions: `defmodule MyModule do ... end`
+
+## Examples
+```elixir
+# Simple output
+IO.puts("Hello, World!")
+
+# Function definition
+greet = fn name -> "Hello, #{name}!" end
+IO.puts(greet.("Alice"))
+
+# List processing
+numbers = [1, 2, 3, 4, 5]
+squared = Enum.map(numbers, fn x -> x * x end)
+sum = Enum.sum(squared)
+IO.puts("Sum of squares: #{sum}")
+
+# Using pipe operator
+[1, 2, 3, 4, 5]
+|> Enum.map(fn x -> x * x end)
+|> Enum.sum()
+|> IO.puts()
+
+# Module example (now possible with range-based injection)
+defmodule Math do
+  def sum(numbers) do
+    Enum.sum(numbers)
+  end
+end
+
+IO.puts("Sum: #{Math.sum([1, 2, 3, 4, 5])}")
+```
+
+## Caveats
+- Elixir uses immutable data structures
+- Functions are first-class citizens
+- Pattern matching is a core feature
+- The pipe operator (`|>`) is commonly used for data transformation
+

php/Dockerfile

@@ -8,3 +8,6 @@ RUN sudo \
     php
 
 COPY --chown=human:human ./files /hello-world
+COPY --chown=human:human ./fraglet /
+
+ENTRYPOINT [ "/fraglet-entrypoint" ]

php/fraglet/fraglet.yml

@@ -0,0 +1,14 @@
+# fraglet-entrypoint configuration for PHP container
+
+fragletTempPath: /FRAGLET
+
+injection:
+  codePath: /hello-world/hello-world.php
+  match: "Hello World!"
+
+guide: /guide.md
+
+execution:
+  path: php /hello-world/hello-world.php
+  makeExecutable: false
+