Skip to content

feat: add conditional execution for tasks and commands#2564

Merged
vmaerten merged 8 commits intomainfrom
if
Jan 21, 2026
Merged

feat: add conditional execution for tasks and commands#2564
vmaerten merged 8 commits intomainfrom
if

Conversation

@vmaerten
Copy link
Member

@vmaerten vmaerten commented Dec 10, 2025 •
edited by andreynering
Loading

Summary

  • Add if attribute for conditional execution of tasks and commands
  • When the shell command in if exits with non-zero, the task/command is skipped (not failed)
  • Supports Go template expressions (e.g., {{eq .VAR "value"}}) which evaluate to true/false
  • Works with for loops, evaluating the condition for each iteration

Turns out it was not that hard and it can solve most of problems described in the issue

Example

tasks:
  deploy:
    if: '[ "$CI" = "true" ]'
    cmds:
      - cmd: echo "Production build"
        if: '{{eq .ENV "production"}}'
      - ./deploy.sh

@vmaerten vmaerten changed the title feat(if): add conditional execution for tasks and commands feat: add conditional execution for tasks and commands Dec 11, 2025
@vmaerten vmaerten marked this pull request as ready for review December 11, 2025 20:58
trulede
trulede reviewed Dec 12, 2025
View reviewed changes
task.go
if err := execext.RunCommand(ctx, &execext.RunCommandOptions{
Command: t.If,
Dir: t.Dir,
Env: env.Get(t),
Copy link
Contributor

@trulede trulede Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sometimes people ask to have Posix and Bash opt available on these commands. I don't know if that is a good or a bad idea, never the less please see #2538 where the idea is in draft form.

Copy link
Member Author

@vmaerten vmaerten Jan 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it make sense
I'll take a look at your PR soon ! :)

@vmaerten vmaerten self-assigned this Dec 12, 2025
@vmaerten vmaerten added the area: exec Changes related to the execution of commands. label Dec 12, 2025
@vmaerten
feat(if): add conditional execution for tasks and commands
58e0083 
Add `if` field to tasks and commands that allows conditional execution
based on a shell command exit code. When the condition returns non-zero,
the task/command is silently skipped (with verbose logging).

- Task-level: skip entire task if condition fails
- Command-level: skip individual command if condition fails
- Supports template variables in conditions
- Works with for loops (condition evaluated per iteration)
- Works with deferred commands
@vmaerten
test(if): add tests for task calls and go templates
ad9c15c 
Add comprehensive test cases for:
- Task calls in cmds with if conditions
- Go template functions (eq, ne, and, or)
- Direct template variable evaluation
- CLI variable overrides
- Task-level if with templates
@vmaerten
test(if): add golden fixture tests for if conditions
96333e5 
Add comprehensive golden fixture tests for if feature:
- Command-level if (true/false)
- Task-level if (true/false)
- Task calls with if conditions
- Go template functions (eq, ne, and, or)
- Direct template variable evaluation
- CLI variable overrides
- For loops with if conditions
@vmaerten
docs(if): add documentation for conditional execution
542a73a
@vmaerten
fix docs
286bbcb
@task-bot
Copy link
Collaborator

task-bot commented Jan 14, 2026 •
edited
Loading

📦 Build artifacts ready!

Download binaries from this workflow run.

Available platforms: Linux, macOS, Windows (amd64, arm64)

andreynering
andreynering approved these changes Jan 21, 2026
View reviewed changes
Copy link
Member

@andreynering andreynering left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is perfect, thank you @vmaerten! 🚀

Reminder that we talked about having a short blog post. Feel free to merge, though. If you add it on this PR or on a follow-up one, as you prefer.

Image

testdata/if/Taskfile.yml
Copy link
Member

@andreynering andreynering Jan 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I liked that you kept all tests in the same file. Looks very clean!

This was referenced Jan 21, 2026
Closed
Merged
vmaerten and others added 3 commits January 21, 2026 19:11
@vmaerten vmaerten merged commit 9bc1efb into main Jan 21, 2026
14 checks passed
@vmaerten vmaerten deleted the if branch January 21, 2026 22:05
vmaerten added a commit that referenced this pull request Jan 21, 2026
@vmaerten
chore: changelog for #2564
c84cfa4
@andreynering andreynering mentioned this pull request Jan 24, 2026
Merged
@coderabbitai coderabbitai bot mentioned this pull request Jan 25, 2026
Open
1 task
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@andreynering andreynering andreynering approved these changes

@pd93 pd93 Awaiting requested review from pd93

+1 more reviewer

@trulede trulede trulede left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

@vmaerten vmaerten

Labels

area: exec Changes related to the execution of commands. needs-build

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Add if: keyword to control when a task or command is ran?

4 participants

@vmaerten @task-bot @andreynering @trulede