updated plugin refactor and added FTP and SCP plugins , also hydrusnetwork plugin migration

cmdlet/archive_file.py

@@ -13,6 +13,7 @@ from typing import Any, Dict, List, Sequence, Set
 from urllib.parse import parse_qs, urlparse
 
 from SYS.logger import log
+from ProviderCore.registry import get_plugin
 from SYS.item_accessors import get_http_url, get_sha256_hex, get_store_name
 from SYS.utils import extract_hydrus_hash_from_url
 
@@ -71,10 +72,8 @@ def _maybe_download_hydrus_item(
 
     This is intentionally side-effect free except for writing the local temp file.
     """
-    try:
-        from SYS.config import get_hydrus_access_key, get_hydrus_url
-        from API.HydrusNetwork import HydrusNetwork as HydrusClient, download_hydrus_file
-    except Exception:
+    hydrus_provider = get_plugin("hydrusnetwork", config)
+    if hydrus_provider is None:
         return None
 
     store_name = _extract_store_name(item)
@@ -102,68 +101,10 @@ def _maybe_download_hydrus_item(
             is_hydrus_url = False
     if not (is_hydrus_url or store_hint):
         return None
-
-    # Prefer store name as instance key; fall back to "home".
-    access_key = None
-    hydrus_url = None
-    for inst in [s for s in [store_lower, "home"] if s]:
-        try:
-            access_key = (get_hydrus_access_key(config, inst) or "").strip() or None
-            hydrus_url = (get_hydrus_url(config, inst) or "").strip() or None
-            if access_key and hydrus_url:
-                break
-        except Exception:
-            access_key = None
-            hydrus_url = None
-
-    if not access_key or not hydrus_url:
-        return None
-
-    client = HydrusClient(url=hydrus_url, access_key=access_key, timeout=60.0)
-    file_url = url if (url and is_hydrus_url) else client.file_url(file_hash)
-
-    # Best-effort extension from Hydrus metadata.
-    suffix = ".hydrus"
-    try:
-        meta_response = client.fetch_file_metadata(
-            hashes=[file_hash],
-            include_mime=True
-        )
-        entries = meta_response.get("metadata"
-                                    ) if isinstance(meta_response,
-                                                    dict) else None
-        if isinstance(entries, list) and entries:
-            entry = entries[0]
-            if isinstance(entry, dict):
-                ext = entry.get("ext")
-                if isinstance(ext, str) and ext.strip():
-                    cleaned = ext.strip()
-                    if not cleaned.startswith("."):
-                        cleaned = "." + cleaned.lstrip(".")
-                    if len(cleaned) <= 12:
-                        suffix = cleaned
-    except Exception:
-        pass
-
-    try:
-        output_dir.mkdir(parents=True, exist_ok=True)
-    except Exception:
-        pass
-
-    dest = output_dir / f"{file_hash}{suffix}"
-    if dest.exists():
-        dest = output_dir / f"{file_hash}_{uuid.uuid4().hex[:10]}{suffix}"
-
-    headers = {
-        "Hydrus-Client-API-Access-Key": access_key
-    }
-    download_hydrus_file(file_url, headers, dest, timeout=60.0)
-    try:
-        if dest.exists() and dest.is_file():
-            return dest
-    except Exception:
-        return None
-    return None
+    preferred_store = store_name or None
+    if url and is_hydrus_url:
+        return hydrus_provider.download_url(url, output_dir)
+    return hydrus_provider.download_hash_to_temp(file_hash, store_name=preferred_store, temp_root=output_dir)
 
 
 def _resolve_existing_or_fetch_path(item: Any,