You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You can duplicate and modify that file to create variants (e.g., `data-with-ruff.yml`).
51
56
57
+
**Note:** This template uses conditional tasks (see [Tasks Behavior](#-tasks-behavior-with-different-copier-commands)), which require the `--trust` flag:
@@ -66,44 +76,80 @@ The following tools must be installed:
66
76
67
77
This template uses **conditional tasks** to manage optional features (LICENSE file, GitHub integration). Understanding their behavior is important for safe updates:
68
78
79
+
#### Task Execution Process
80
+
Tasks always run at the end of both `copier copy` and `copier update` operations, **after** all files are generated. This means:
81
+
- Files are created/updated first
82
+
- Tasks execute based on your current answers
83
+
- Any deletions from tasks are permanent for that operation
84
+
69
85
#### Initial Project Generation (`copier copy`)
70
-
Tasks execute **after** files are created:
71
-
-`include_license=false` → `LICENSE` file is removed
72
-
-`github_integration=false` → `.github/` directory (with issue templates and workflows) is removed
86
+
When you generate a new project with conditions set:
87
+
- ✅ `include_license=true` → LICENSE file is kept
88
+
- ✅ `include_license=false` → `LICENSE` file is **removed** after generation
89
+
- ✅ `github_integration=true` → `.github/` files (templates, workflows) are kept
90
+
- ✅ `github_integration=false` → `.github/` directory is **removed** after generation
73
91
74
92
#### Project Updates (`copier update`)
75
-
**Tasks are executed again** during updates. This means:
76
-
- ✅ Safe to run with `--defaults` (keeps your previous answers)
77
-
- ⚠️ **Dangerous if you change boolean settings** (e.g., setting `github_integration=false`)
93
+
**Tasks are executed again** during updates. This is important:
94
+
- ✅ Safe with `--defaults` (keeps your previous answers as-is)
95
+
- ✅ Safe if you keep boolean settings unchanged
96
+
- ⚠️ **Dangerous if you change boolean settings** when you have customizations
0 commit comments