Configuration Examples

# Example: Configuration Defaults
# OrchStep functions have built-in defaults (e.g. the shell function
# defaults to the "gosh" interpreter). You can override those defaults
# using a config file (orchstep-config.yml) so every invocation of a
# function uses your preferred settings without repeating them.
#
# In this example we assume an orchstep-config.yml file in the same
# directory sets:
#   func:
#     shell:
#       type: "shell"     # Use system shell instead of gosh
#       timeout: 120      # 2-minute timeout for all shell steps
#
# Steps no longer need to specify `type: shell` -- it is the default.
#
# Try: orchstep run

name: config-defaults-demo
desc: "Setting default function configuration via config file"

# With a config file that sets shell defaults, these steps inherit
# those defaults automatically.
tasks:
  main:
    desc: "Run commands using config-file defaults"
    steps:
      - name: hello
        desc: "Uses the shell type from config -- no need to specify it"
        func: shell
        do: echo 'Hello with config defaults!'

      - name: system_info
        desc: "Another shell step -- also inherits the config defaults"
        func: shell
        do: |
          echo "Shell type: inherited from orchstep-config.yml"
          echo "Timeout:    inherited from orchstep-config.yml"
          echo "User:       $USER"
          echo "Working in: $(pwd)"

      - name: explain
        func: shell
        do: |
          echo ""
          echo "=== Config Defaults ==="
          echo "Place an orchstep-config.yml alongside your orchstep.yml:"
          echo ""
          echo "  func:"
          echo "    shell:"
          echo "      type: shell       # Override default interpreter"
          echo "      timeout: 120      # Default timeout in seconds"
          echo "    http:"
          echo "      timeout: 30       # HTTP request timeout"
          echo ""
          echo "All functions will use these defaults automatically."

# Example: Inline Configuration
# Instead of a separate orchstep-config.yml file, you can embed
# function defaults directly in your orchstep.yml using the `config:` key.
#
# This is useful for self-contained workflows that need specific
# function behavior without external files.
#
# Try: orchstep run

name: inline-config-demo
desc: "Inline configuration in orchstep.yml -- no external config file needed"

# Inline config: set function defaults right here
config:
  func:
    shell:
      type: "shell"      # Use system shell instead of gosh
      timeout: 60        # 60-second timeout for all shell commands

    http:
      timeout: 30        # 30-second timeout for HTTP requests
      method: "GET"      # Default HTTP method

tasks:
  main:
    desc: "Steps inherit inline config defaults"
    steps:
      - name: hello
        desc: "Uses shell type from inline config automatically"
        func: shell
        do: echo 'Hello with inline config!'

      - name: show_config
        desc: "All shell steps get type=shell and timeout=60"
        func: shell
        do: |
          echo "=== Inline Configuration ==="
          echo ""
          echo "This workflow uses inline config to set:"
          echo "  shell.type    = shell  (instead of default gosh)"
          echo "  shell.timeout = 60s"
          echo "  http.timeout  = 30s"
          echo "  http.method   = GET"
          echo ""
          echo "Every shell step inherits these without repeating them."

  # You can still override per-step when needed
  custom_step:
    desc: "Per-step args override inline config"
    steps:
      - name: with_longer_timeout
        desc: "Override the timeout for a long-running command"
        func: shell
        args:
          timeout: 300     # 5 minutes for this specific step
          cmd: echo 'This step has a 5-minute timeout'

# Example: Task File Discovery
# OrchStep automatically discovers task files in a `tasks/` directory.
# Each file defines one task and is named after the task.
#
# Directory layout:
#   orchstep.yml              <-- this file (main orchestrator)
#   tasks/
#     build.yml               <-- defines the "build" task
#     test.yml                <-- defines the "test" task
#     deploy/
#       staging.yml           <-- defines the "deploy-staging" task
#       production.yml        <-- defines the "deploy-production" task
#     infra/
#       provision.yml         <-- defines the "infra-provision" task
#       destroy.yml           <-- defines the "infra-destroy" task
#
# Naming convention:
#   - Flat files:   tasks/build.yml      -> task name: "build"
#   - Nested files: tasks/deploy/staging.yml -> task name: "deploy-staging"
#
# Try: orchstep run
# Try: orchstep run build
# Try: orchstep run deploy-staging
# Try: orchstep list   (see all discovered tasks)

name: task-discovery-demo
desc: "Auto-discovering tasks from the tasks/ directory"

# The main orchestrator calls auto-discovered tasks by name.
# No need to define them here -- they are loaded from tasks/*.yml
tasks:
  main:
    desc: "Run the full pipeline using discovered tasks"
    steps:
      - name: build_app
        desc: "Call the auto-discovered build task"
        task: build

      - name: run_tests
        desc: "Call the auto-discovered test task"
        task: test

      - name: deploy_to_staging
        desc: "Call tasks/deploy/staging.yml as 'deploy-staging'"
        task: deploy-staging

      - name: deploy_to_production
        desc: "Call tasks/deploy/production.yml as 'deploy-production'"
        task: deploy-production

      - name: done
        func: shell
        do: |
          echo "=== Task Discovery ==="
          echo "Tasks are auto-discovered from tasks/ directory:"
          echo "  tasks/build.yml           -> 'build'"
          echo "  tasks/test.yml            -> 'test'"
          echo "  tasks/deploy/staging.yml  -> 'deploy-staging'"
          echo "  tasks/deploy/production.yml -> 'deploy-production'"
          echo ""
          echo "Use 'orchstep list' to see all available tasks."