setup builder and examples

Author: jahvon

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @jahvon

.github/workflows/ci.yaml

@@ -0,0 +1,26 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+permissions:
+  contents: read # for actions/checkout to fetch code
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "^1.24"
+      - name: Install yamlfmt
+        run: go install github.com/google/yamlfmt/cmd/[email protected]
+      - uses: flowexec/action@v1
+        with:
+          executable: 'validate'
+          timeout: '5m'
+          flow-version: 'main'

.gitignore

@@ -0,0 +1 @@
+savedResponse.*

.yamlfmt

@@ -0,0 +1,3 @@
+formatter:
+    type: basic
+    max_line_length: 120

README.md

@@ -0,0 +1,32 @@
+<p align="center"><a href="https://flowexec.io"><img src="https://flowexec.io/_media/logo.png" alt="flow" width="200"/></a></p>
+
+<br>
+
+# flow file examples
+
+This repository contains example flow files demonstrating various executable types and workflows.
+
+### Generated Files
+
+- **`*.flow.yaml`** - Flow file examples demonstrating different executable types
+- **`assets/`** - Supporting files (scripts, templates, data files) referenced by the examples
+
+### Examples Include
+
+- **Exec Examples** - Running shell commands and scripts
+- **Parallel Examples** - Executing multiple tasks concurrently
+- **Serial Examples** - Sequential task execution
+- **Request Examples** - HTTP requests and API interactions
+- **Render Examples** - Template rendering with data
+- **Launch Examples** - Launching processes
+- **Executable Template Example** - Define flowfile templates for reusable workflows patterns
+
+## Generating Examples
+
+The examples are generated using the builder tool in `cmd/builder/`. To regenerate all examples:
+
+```bash
+go run cmd/builder/*.go
+# or run via flow with
+flow validate
+```

assets/env-script.sh

@@ -0,0 +1,12 @@
+#!/bin/sh
+
+echo "Environment variables demonstration:"
+echo "NAME: $NAME"
+echo "HOME: $HOME"
+echo "USER: $USER"
+echo "PATH: $PATH"
+echo "PWD: $PWD"
+
+# Some flow-specific environment variables
+echo "FLOW_WORKSPACE_PATH: $FLOW_WORKSPACE_PATH"
+echo "FLOW_NAMESPACE: $FLOW_NAMESPACE"

assets/generated.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+# f:name=generated f:verb=run
+# f:description="start of the description"
+# But I'm not done yet!
+#
+# <f|description>
+# continued description
+# <f|description>
+
+echo "This executable was generated from shell comments!"

assets/hello.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+echo "Hello $NAME from hello.sh!"
+echo "This is a simple example script."

assets/message.txt

@@ -0,0 +1,6 @@
+This is a simple text file used in examples.
+
+It contains multiple lines of text to demonstrate 
+file handling and processing in flow executables.
+
+End of message.

assets/simple-script.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+
+echo "Hello, world!"
+echo "The current date and time is: $(date)"
+echo "You are in: $(pwd)"
+echo "The files in this directory are:"
+ls