Getting Started

This guide will walk you through creating your first Dyngle operation.

Your First Operation

Create a file called .dyngle.yml in your current directory:

dyngle:
  operations:
    hello:
      - echo "Hello world"

Run the operation:

dyngle run hello

You should see:

Hello world

Using Templates

Now let's make it more dynamic by using data and templates. Update your .dyngle.yml:

dyngle:
  operations:
    hello:
      - echo "Hello {{name}}!"

Pass data to your operation via stdin:

echo "name: Francis" | dyngle run hello

Output:

Hello Francis!

Common Pitfalls

YAML Syntax with Special Characters

If your commands contain colons (:) or other special YAML characters, you may encounter parsing errors. Use multiline syntax:

dyngle:
  operations:
    fetch-json:
      - >-
        echo '{"temperature": 72}' => data

See Operations - YAML Syntax for Special Characters for details.

Shell Features Don't Work

Dyngle doesn't use a shell, so shell-specific syntax won't work:

# ❌ Won't work
- echo "Hello" | grep Hello
- export VAR=value
- ls > files.txt

# ✅ Use Dyngle's features instead
- echo "Hello" => output
- output -> grep Hello

See Operations - Command Syntax for details.

What's Next?

You've learned the basics of:

  • Defining operations in YAML
  • Running operations with dyngle run
  • Using template substitution with {{variable}}

Now explore more: