style: apply ruff auto-fixes

cmdlet/add_file.py

@@ -499,6 +499,9 @@ class Add_File(Cmdlet):
         pending_url_associations: Dict[str,
                                        List[tuple[str,
                                                   List[str]]]] = {}
+        pending_tag_associations: Dict[str,
+                                      List[tuple[str,
+                                                 List[str]]]] = {}
         successes = 0
         failures = 0
 
@@ -612,6 +615,8 @@ class Add_File(Cmdlet):
                                 collect_relationship_pairs=pending_relationship_pairs,
                                 defer_url_association=defer_url_association,
                                 pending_url_associations=pending_url_associations,
+                                defer_tag_association=defer_url_association,
+                                pending_tag_associations=pending_tag_associations,
                                 suppress_last_stage_overlay=want_final_search_file,
                                 auto_search_file=auto_search_file_after_add,
                                 store_instance=storage_registry,
@@ -664,6 +669,17 @@ class Add_File(Cmdlet):
             except Exception:
                 pass
 
+        # Apply deferred tag associations (bulk) if collected
+        if pending_tag_associations:
+            try:
+                Add_File._apply_pending_tag_associations(
+                    pending_tag_associations,
+                    config,
+                    store_instance=storage_registry
+                )
+            except Exception:
+                pass
+
         # Always end add-file -store (when last stage) by showing item detail panels.
         # Legacy search-file refresh is no longer used for final display.
         if want_final_search_file and collected_payloads:
@@ -1854,6 +1870,10 @@ class Add_File(Cmdlet):
         pending_url_associations: Optional[Dict[str,
                                                 List[tuple[str,
                                                            List[str]]]]] = None,
+        defer_tag_association: bool = False,
+        pending_tag_associations: Optional[Dict[str,
+                                               List[tuple[str,
+                                                          List[str]]]]] = None,
         suppress_last_stage_overlay: bool = False,
         auto_search_file: bool = True,
         store_instance: Optional[Store] = None,
@@ -2072,15 +2092,22 @@ class Add_File(Cmdlet):
             resolved_hash = chosen_hash
 
             if hydrus_like_backend and tags:
-                try:
-                    adder = getattr(backend, "add_tag", None)
-                    if callable(adder):
-                        debug(
-                            f"[add-file] Applying {len(tags)} tag(s) post-upload to Hydrus"
-                        )
-                        adder(resolved_hash, list(tags))
-                except Exception as exc:
-                    log(f"[add-file] Hydrus post-upload tagging failed: {exc}", file=sys.stderr)
+                # Support deferring tag application for batching bulk operations
+                if defer_tag_association and pending_tag_associations is not None:
+                    try:
+                        pending_tag_associations.setdefault(str(backend_name), []).append((str(resolved_hash), list(tags)))
+                    except Exception:
+                        pass
+                else:
+                    try:
+                        adder = getattr(backend, "add_tag", None)
+                        if callable(adder):
+                            debug(
+                                f"[add-file] Applying {len(tags)} tag(s) post-upload to Hydrus"
+                            )
+                            adder(resolved_hash, list(tags))
+                    except Exception as exc:
+                        log(f"[add-file] Hydrus post-upload tagging failed: {exc}", file=sys.stderr)
 
             # If we have url(s), ensure they get associated with the destination file.
             # This mirrors `add-url` behavior but avoids emitting extra pipeline noise.
@@ -2322,6 +2349,47 @@ class Add_File(Cmdlet):
                     except Exception:
                         continue
 
+    @staticmethod
+    def _apply_pending_tag_associations(
+        pending: Dict[str,
+                      List[tuple[str,
+                                 List[str]]]],
+        config: Dict[str,
+                     Any],
+        store_instance: Optional[Store] = None,
+    ) -> None:
+        """Apply deferred tag associations in bulk, grouped per backend."""
+
+        try:
+            store = store_instance if store_instance is not None else Store(config)
+        except Exception:
+            return
+
+        for backend_name, pairs in (pending or {}).items():
+            if not pairs:
+                continue
+            try:
+                backend = store[backend_name]
+            except Exception:
+                continue
+
+            # Try bulk variant first
+            bulk = getattr(backend, "add_tags_bulk", None)
+            if callable(bulk):
+                try:
+                    bulk([(h, t) for h, t in pairs])
+                    continue
+                except Exception:
+                    pass
+
+            single = getattr(backend, "add_tag", None)
+            if callable(single):
+                for h, t in pairs:
+                    try:
+                        single(h, t)
+                    except Exception:
+                        continue
+
     @staticmethod
     def _load_sidecar_bundle(
         media_path: Path,