support cache clear

Author: wpbonelli

autotest/test_models.py

@@ -494,6 +494,35 @@ def test_cli_list_with_cache(self, capsys):
         assert f"{TEST_SOURCE_NAME}@{TEST_REF}" in captured.out
         assert "Models:" in captured.out
 
+    def test_cli_clear(self, capsys):
+        """Test 'clear' command."""
+        # Sync a registry first
+        _DEFAULT_CACHE.clear(source=TEST_SOURCE_NAME, ref=TEST_REF)
+        source = ModelSourceRepo(
+            repo=TEST_REPO,
+            name=TEST_SOURCE_NAME,
+            refs=[TEST_REF],
+        )
+        result = source.sync(ref=TEST_REF)
+        assert len(result.synced) == 1
+
+        # Verify it's cached
+        assert _DEFAULT_CACHE.has(TEST_SOURCE_NAME, TEST_REF)
+
+        # Clear with force flag
+        import argparse
+
+        from modflow_devtools.models.__main__ import cmd_clear
+
+        args = argparse.Namespace(source=TEST_SOURCE_NAME, ref=TEST_REF, force=True)
+        cmd_clear(args)
+
+        # Verify it was cleared
+        assert not _DEFAULT_CACHE.has(TEST_SOURCE_NAME, TEST_REF)
+
+        captured = capsys.readouterr()
+        assert "Cleared 1 cached registry" in captured.out
+
 
 @pytest.mark.xdist_group("registry_cache")
 class TestIntegration:

docs/md/dev/models.md

@@ -707,6 +707,22 @@ $ mf models list --ref registry
 $ mf models list --source mf6/test --ref registry --verbose
 ```
 
+#### Clear Cached Registries
+
+```bash
+# Clear all cached registries (with confirmation)
+$ mf models clear
+
+# Clear specific source
+$ mf models clear --source mf6/test
+
+# Clear specific source and ref
+$ mf models clear --source mf6/test --ref develop
+
+# Skip confirmation prompt
+$ mf models clear --force
+```
+
 ### Registry Creation Tool
 
 The `make_registry` tool uses a mode-based interface with **remote-first operation** by default:

docs/md/models.md

@@ -266,8 +266,29 @@ for source, ref in cached:
 # Check specific cache
 is_cached = _DEFAULT_CACHE.has("mf6/test", "develop")
 
-# Clear cache (if needed)
-_DEFAULT_CACHE.clear()
+# Clear cache programmatically
+_DEFAULT_CACHE.clear()  # Clear all
+_DEFAULT_CACHE.clear(source="mf6/test")  # Clear specific source
+_DEFAULT_CACHE.clear(source="mf6/test", ref="develop")  # Clear specific source@ref
+```
+
+Or via CLI:
+
+```bash
+# List cached registries
+mf models list
+
+# Clear all cached registries (with confirmation prompt)
+mf models clear
+
+# Clear specific source
+mf models clear --source mf6/test
+
+# Clear specific source and ref
+mf models clear --source mf6/test --ref develop
+
+# Skip confirmation prompt
+mf models clear --force
 ```
 
 ## Automatic Synchronization

modflow_devtools/models/__main__.py

@@ -5,6 +5,7 @@
     python -m modflow_devtools.models sync
     python -m modflow_devtools.models info
     python -m modflow_devtools.models list
+    python -m modflow_devtools.models clear
 """
 
 import argparse
@@ -227,6 +228,58 @@ def cmd_list(args):
             print()
 
 
+def cmd_clear(args):
+    """Clear command handler."""
+    cached = _DEFAULT_CACHE.list()
+
+    # Determine what will be cleared
+    if args.source and args.ref:
+        items_to_clear = [(args.source, args.ref)]
+        desc = f"{args.source}@{args.ref}"
+    elif args.source:
+        items_to_clear = [(source, ref) for source, ref in cached if source == args.source]
+        desc = f"all refs for source '{args.source}'"
+    else:
+        items_to_clear = cached
+        desc = "all cached registries"
+
+    if not items_to_clear:
+        if args.source or args.ref:
+            filter_desc = []
+            if args.source:
+                filter_desc.append(f"source={args.source}")
+            if args.ref:
+                filter_desc.append(f"ref={args.ref}")
+            print(f"No cached registries matching filters: {', '.join(filter_desc)}")
+        else:
+            print("No cached registries to clear")
+        return
+
+    # Show what will be cleared
+    print(f"Will clear {desc}:")
+    for source, ref in sorted(items_to_clear):
+        print(f"  {source}@{ref}")
+
+    # Confirm unless --force
+    if not args.force:
+        try:
+            response = input("\nProceed? [y/N] ").strip().lower()
+            if response not in ["y", "yes"]:
+                print("Cancelled")
+                return
+        except (KeyboardInterrupt, EOFError):
+            print("\nCancelled")
+            return
+
+    # Clear the cache
+    _DEFAULT_CACHE.clear(source=args.source, ref=args.ref)
+
+    print(
+        f"\nCleared {len(items_to_clear)} cached registr"
+        f"{'y' if len(items_to_clear) == 1 else 'ies'}"
+    )
+
+
 def main():
     """Main CLI entry point."""
     parser = argparse.ArgumentParser(
@@ -280,6 +333,25 @@ def main():
         help="Show all model names (not truncated)",
     )
 
+    # Clear command
+    clear_parser = subparsers.add_parser("clear", help="Clear cached registries")
+    clear_parser.add_argument(
+        "--source",
+        "-s",
+        help="Clear specific source (default: all sources)",
+    )
+    clear_parser.add_argument(
+        "--ref",
+        "-r",
+        help="Clear specific ref (requires --source)",
+    )
+    clear_parser.add_argument(
+        "--force",
+        "-f",
+        action="store_true",
+        help="Skip confirmation prompt",
+    )
+
     args = parser.parse_args()
 
     if not args.command:
@@ -293,6 +365,8 @@ def main():
             cmd_info(args)
         elif args.command == "list":
             cmd_list(args)
+        elif args.command == "clear":
+            cmd_clear(args)
     except Exception as e:
         print(f"Error: {e}", file=sys.stderr)
         sys.exit(1)