top-level mf sync command

Author: wpbonelli

modflow_devtools/cli.py

@@ -2,6 +2,11 @@
 Root CLI for modflow-devtools.
 
 Usage:
+    mf sync
+    mf dfns sync
+    mf dfns info
+    mf dfns list
+    mf dfns clean
     mf models sync
     mf models info
     mf models list
@@ -17,6 +22,56 @@
 
 import argparse
 import sys
+import warnings
+
+
+def _sync_all():
+    """Sync all registries (dfns, models, programs)."""
+    print("Syncing all registries...")
+    print()
+
+    # Sync DFNs
+    print("=== DFNs ===")
+    try:
+        from modflow_devtools.dfns.registry import sync_dfns
+
+        registries = sync_dfns()
+        for registry in registries:
+            meta = registry.registry_meta
+            print(f"  {registry.ref}: {len(meta.files)} files")
+        print(f"Synced {len(registries)} DFN registry(ies)")
+    except Exception as e:
+        print(f"Error syncing DFNs: {e}")
+    print()
+
+    # Sync Models
+    print("=== Models ===")
+    try:
+        from modflow_devtools.models import ModelSourceConfig
+
+        config = ModelSourceConfig.load()
+        config.sync()
+        print("Models synced successfully")
+    except Exception as e:
+        print(f"Error syncing models: {e}")
+    print()
+
+    # Sync Programs
+    print("=== Programs ===")
+    try:
+        # Suppress experimental warning
+        with warnings.catch_warnings():
+            warnings.filterwarnings("ignore", message=".*modflow_devtools.programs.*experimental.*")
+            from modflow_devtools.programs import ProgramSourceConfig
+
+        config = ProgramSourceConfig.load()
+        config.sync()
+        print("Programs synced successfully")
+    except Exception as e:
+        print(f"Error syncing programs: {e}")
+    print()
+
+    print("All registries synced!")
 
 
 def main():
@@ -27,6 +82,12 @@ def main():
     )
     subparsers = parser.add_subparsers(dest="subcommand", help="Available commands")
 
+    # Sync subcommand (syncs all APIs)
+    subparsers.add_parser("sync", help="Sync all registries (dfns, models, programs)")
+
+    # DFNs subcommand
+    subparsers.add_parser("dfns", help="Manage MODFLOW 6 definition files")
+
     # Models subcommand
     subparsers.add_parser("models", help="Manage MODFLOW model registries")
 
@@ -41,7 +102,14 @@ def main():
         sys.exit(1)
 
     # Dispatch to the appropriate module CLI with remaining args
-    if args.subcommand == "models":
+    if args.subcommand == "sync":
+        _sync_all()
+    elif args.subcommand == "dfns":
+        from modflow_devtools.dfns.__main__ import main as dfns_main
+
+        sys.argv = ["mf dfns", *remaining]
+        sys.exit(dfns_main())
+    elif args.subcommand == "models":
         from modflow_devtools.models.__main__ import main as models_main
 
         # Replace sys.argv to make it look like we called the submodule directly

modflow_devtools/dfns/__main__.py

@@ -2,10 +2,10 @@
 Command-line interface for the DFNs API.
 
 Usage:
-    python -m modflow_devtools.dfns sync [--ref REF] [--force]
-    python -m modflow_devtools.dfns info
-    python -m modflow_devtools.dfns list [--ref REF]
-    python -m modflow_devtools.dfns clean [--all]
+    mf dfns sync [--ref REF] [--force]
+    mf dfns info
+    mf dfns list [--ref REF]
+    mf dfns clean [--all]
 """
 
 from __future__ import annotations
@@ -138,7 +138,7 @@ def cmd_list(args: argparse.Namespace) -> int:
 
     except DfnRegistryNotFoundError as e:
         print(f"Error: {e}", file=sys.stderr)
-        print("Try running 'python -m modflow_devtools.dfn sync' first.", file=sys.stderr)
+        print("Try running 'mf dfns sync' first.", file=sys.stderr)
         return 1
     except Exception as e:
         print(f"Error: {e}", file=sys.stderr)
@@ -198,7 +198,7 @@ def _format_size(size_bytes: int) -> str:
 def main(argv: list[str] | None = None) -> int:
     """Main entry point for the CLI."""
     parser = argparse.ArgumentParser(
-        prog="python -m modflow_devtools.dfn",
+        prog="mf dfns",
         description="MODFLOW 6 definition file tools",
     )
     parser.add_argument(

modflow_devtools/models/__init__.py

@@ -1062,15 +1062,15 @@ def _load(self):
         Load registry data from cache.
 
         Raises an error if no cached registries are found.
-        Run 'python -m modflow_devtools.models sync' to populate the cache.
+        Run 'mf models sync' to populate the cache.
         """
         # Try to load from cache
         loaded_from_cache = self._try_load_from_cache()
 
         if not loaded_from_cache:
             raise RuntimeError(
                 "No model registries found in cache. "
-                "Run 'python -m modflow_devtools.models sync' to download registries, "
+                "Run 'mf models sync' to download registries, "
                 "or use ModelSourceConfig.load().sync() programmatically."
             )
 

modflow_devtools/programs/__main__.py

@@ -145,7 +145,9 @@ def cmd_list(args):
     cached = _DEFAULT_CACHE.list()
 
     if not cached:
-        print("No cached program registries. Run 'sync' first.")
+        print(
+            "No program registries found in cache. Run 'mf programs sync' to download registries."
+        )
         return
 
     # Apply filters