Rename to _copier_operation

Author: lkubb

copier/main.py

@@ -347,7 +347,7 @@ def _execute_tasks(self, tasks: Sequence[Task]) -> None:
         operation = _operation.get()
         for i, task in enumerate(tasks):
             extra_context = {f"_{k}": v for k, v in task.extra_vars.items()}
-            extra_context["_operation"] = operation
+            extra_context["_copier_operation"] = operation
 
             if not cast_to_bool(self._render_value(task.condition, extra_context)):
                 continue
@@ -644,7 +644,7 @@ def match_exclude(self) -> Callable[[Path], bool]:
         # Include the current operation in the rendering context.
         # Note: This method is a cached property, it needs to be regenerated
         # when reusing an instance in different contexts.
-        extra_context = {"_operation": _operation.get()}
+        extra_context = {"_copier_operation": _operation.get()}
         return self._path_matcher(
             self._render_string(exclusion, extra_context=extra_context)
             for exclusion in self.all_exclusions

docs/configuring.md

@@ -966,12 +966,12 @@ Each pattern can be templated using Jinja.
 
 !!! example
 
-    Templating `exclude` patterns using `_operation` allows to have files
+    Templating `exclude` patterns using `_copier_operation` allows to have files
     that are rendered once during `copy`, but are never updated:
 
     ```yaml
     _exclude:
-        - "{% if _operation == 'update' -%}src/*_example.py{% endif %}"
+        - "{% if _copier_operation == 'update' -%}src/*_example.py{% endif %}"
     ```
 
 !!! info
@@ -1587,7 +1587,7 @@ other items not present.
         - ["{{ _copier_python }}", task.py]
         # Run a command during the initial copy operation only, excluding updates
         - command: ["{{ _copier_python }}", task.py]
-          when: "{{ _operation == 'copy' }}"
+          when: "{{ _copier_operation == 'copy' }}"
         # OS-specific task (supported values are "linux", "macos", "windows" and `None`)
         - command: rm {{ name_of_the_project }}/README.md
           when: "{{ _copier_conf.os in  ['linux', 'macos'] }}"

docs/creating.md

@@ -140,7 +140,7 @@ The name of the project root directory.
 
 Some variables are only available in select contexts:
 
-### `_operation`
+### `_copier_operation`
 
 The current operation, either `"copy"` or `"update"`.
 

tests/test_context.py

@@ -14,11 +14,11 @@ def test_exclude_templating_with_operation(
 ) -> None:
     """
     Ensure it's possible to create one-off boilerplate files that are not
-    managed during updates via `_exclude` using the `_operation` context variable.
+    managed during updates via `_exclude` using the `_copier_operation` context variable.
     """
     src, dst = map(tmp_path_factory.mktemp, ("src", "dst"))
 
-    template = "{% if _operation == 'update' %}copy-only{% endif %}"
+    template = "{% if _copier_operation == 'update' %}copy-only{% endif %}"
     with local.cwd(src):
         build_file_tree(
             {
@@ -67,8 +67,8 @@ def test_task_templating_with_operation(
                 "copier.yml": (
                     f"""\
                     _tasks:
-                        -   command: echo {{{{ _operation }}}} >> {json.dumps(str(task_counter))}
-                            when: "{{{{ _operation == 'copy' }}}}"
+                        -   command: echo {{{{ _copier_operation }}}} >> {json.dumps(str(task_counter))}
+                            when: "{{{{ _copier_operation == 'copy' }}}}"
                     """
                 ),
                 "{{ _copier_conf.answers_file }}.jinja": "{{ _copier_answers|to_yaml }}",