Rename ensure_file_manager_exists to ensure_managed_file_exists (#872)

nathanjmcdougall · web-flow · commit 9fab283c228f · 2025-07-18T23:16:25.000+12:00
diff --git a/src/usethis/_tool/config.py b/src/usethis/_tool/config.py
@@ -124,8 +124,8 @@ def paths(self) -> set[Path]:
         return {(usethis_config.cpd() / path).resolve() for path in self.root}
 
 
-def ensure_file_manager_exists(file_manager: UsethisFileManager) -> None:
-    """Ensure the file manager exists."""
+def ensure_managed_file_exists(file_manager: UsethisFileManager) -> None:
+    """Ensure a file manager's managed file exists."""
     if isinstance(file_manager, PyprojectTOMLManager):
         ensure_pyproject_toml()
     elif not file_manager.path.exists():
diff --git a/src/usethis/_tool/impl/deptry.py b/src/usethis/_tool/impl/deptry.py
@@ -21,7 +21,7 @@
     ConfigEntry,
     ConfigItem,
     ConfigSpec,
-    ensure_file_manager_exists,
+    ensure_managed_file_exists,
 )
 from usethis._tool.pre_commit import PreCommitConfig
 
@@ -136,7 +136,7 @@ def ignore_rules(self, rules: list[Rule]) -> None:
         s = "" if len(rules) == 1 else "s"
 
         (file_manager,) = self.get_active_config_file_managers()
-        ensure_file_manager_exists(file_manager)
+        ensure_managed_file_exists(file_manager)
         tick_print(
             f"Ignoring {self.name} rule{s} {rules_str} in '{file_manager.name}'."
         )
@@ -153,7 +153,7 @@ def unignore_rules(self, rules: list[str]) -> None:
         s = "" if len(rules) == 1 else "s"
 
         (file_manager,) = self.get_active_config_file_managers()
-        ensure_file_manager_exists(file_manager)
+        ensure_managed_file_exists(file_manager)
         tick_print(
             f"No longer ignoring {self.name} rule{s} {rules_str} in '{file_manager.name}'."
         )
diff --git a/src/usethis/_tool/impl/ruff.py b/src/usethis/_tool/impl/ruff.py
@@ -27,7 +27,7 @@
     ConfigEntry,
     ConfigItem,
     ConfigSpec,
-    ensure_file_manager_exists,
+    ensure_managed_file_exists,
 )
 from usethis._tool.pre_commit import PreCommitConfig, PreCommitRepoConfig
 
@@ -308,7 +308,7 @@ def select_rules(self, rules: list[Rule]) -> None:
         s = "" if len(rules) == 1 else "s"
 
         (file_manager,) = self.get_active_config_file_managers()
-        ensure_file_manager_exists(file_manager)
+        ensure_managed_file_exists(file_manager)
         tick_print(
             f"Selecting {self.name} rule{s} {rules_str} in '{file_manager.name}'."
         )
@@ -326,7 +326,7 @@ def ignore_rules(self, rules: list[Rule]) -> None:
         s = "" if len(rules) == 1 else "s"
 
         (file_manager,) = self.get_active_config_file_managers()
-        ensure_file_manager_exists(file_manager)
+        ensure_managed_file_exists(file_manager)
         tick_print(
             f"Ignoring {self.name} rule{s} {rules_str} in '{file_manager.name}'."
         )
@@ -344,7 +344,7 @@ def unignore_rules(self, rules: list[str]) -> None:
         s = "" if len(rules) == 1 else "s"
 
         (file_manager,) = self.get_active_config_file_managers()
-        ensure_file_manager_exists(file_manager)
+        ensure_managed_file_exists(file_manager)
         tick_print(
             f"No longer ignoring {self.name} rule{s} {rules_str} in '{file_manager.name}'."
         )
@@ -362,7 +362,7 @@ def deselect_rules(self, rules: list[Rule]) -> None:
         s = "" if len(rules) == 1 else "s"
 
         (file_manager,) = self.get_active_config_file_managers()
-        ensure_file_manager_exists(file_manager)
+        ensure_managed_file_exists(file_manager)
         tick_print(
             f"Deselecting {self.name} rule{s} {rules_str} in '{file_manager.name}'."
         )
@@ -398,7 +398,7 @@ def ignore_rules_in_glob(self, rules: list[Rule], *, glob: str) -> None:
             return
 
         (file_manager,) = self.get_active_config_file_managers()
-        ensure_file_manager_exists(file_manager)
+        ensure_managed_file_exists(file_manager)
         keys = self._get_per_file_ignore_keys(file_manager, glob=glob)
         file_manager.extend_list(keys=keys, values=rules)
 
