amplify-excel-migrator 1.1.5__py3-none-any.whl → 1.2.15__py3-none-any.whl

{amplify_excel_migrator-1.1.5.dist-info → amplify_excel_migrator-1.2.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amplify-excel-migrator
-Version: 1.1.5
+Version: 1.2.15
 Summary: A CLI tool to migrate Excel data to AWS Amplify
 Home-page: https://github.com/EyalPoly/amplify-excel-migrator
 Author: Eyal Politansky
@@ -59,14 +59,6 @@ Install the latest stable version from PyPI:
 pip install amplify-excel-migrator
 ```
 
-### From GitHub
-
-Install directly from GitHub:
-
-```bash
-pip install git+https://github.com/EyalPoly/amplify-excel-migrator.git
-```
-
 ### From Source
 
 Clone the repository and install:
@@ -77,16 +69,6 @@ cd amplify-excel-migrator
 pip install .
 ```
 
-### For Development
-
-Install with development dependencies:
-
-```bash
-pip install -e ".[dev]"
-```
-
-This installs the package in editable mode with pytest and other development tools.
-
 ## Usage
 
 The tool has three subcommands:
@@ -107,7 +89,7 @@ This will prompt you for:
 - Cognito Client ID
 - Admin username
 
-Configuration is saved to `~/.amplify-migrator/config.json` (passwords are never saved).
+Configuration is saved to `~/.amplify-migrator/config.json`
 
 ### 2. Show Configuration
 
@@ -186,13 +168,26 @@ Admin Password: ********
 
 ## Features
 
+### Data Processing & Conversion
+- **Automatic type parsing** - Smart field type detection for all GraphQL types including scalars, enums, and custom types
+- **Custom types and enums** - Full support for Amplify custom types with automatic conversion
+- **Duplicate detection** - Automatically skips existing records to prevent duplicates
+- **Foreign key resolution** - Automatic relationship handling with pre-fetching for performance
+
+### AWS Integration
 - **Configuration caching** - Save your setup, reuse it for multiple migrations
-- **Interactive prompts** - Easy step-by-step configuration
-- **Custom types and enums** - Full support for Amplify custom types
-- **Duplicate detection** - Automatically skips existing records
-- **Async uploads** - Fast parallel uploads for better performance
 - **MFA support** - Works with multi-factor authentication
-- **Automatic type parsing** - Smart field type detection and conversion
+- **Admin group validation** - Ensures proper authorization before migration
+
+### Performance
+- **Async uploads** - Fast parallel uploads with configurable batch size
+- **Connection pooling** - Efficient HTTP connection reuse for better performance
+- **Pagination support** - Handles large datasets efficiently
+
+### User Experience
+- **Interactive prompts** - Easy step-by-step configuration
+- **Progress reporting** - Real-time feedback on migration status
+- **Detailed error messages** - Clear context for troubleshooting failures
 
 ## Excel File Format
 
@@ -201,19 +196,119 @@ The Excel file should have:
 - Column names matching the model field names
 - First row as headers
 
-### Example Excel Structure
+### Basic Structure
 
 **Sheet: User**
+
 | name | email | age |
 |------|-------|-----|
 | John | john@example.com | 30 |
 | Jane | jane@example.com | 25 |
 
 **Sheet: Post**
+
 | title | content | userId |
 |-------|---------|--------|
 | First Post | Hello World | john@example.com |
 
+### Relationships (Foreign Keys)
+
+To reference related records, use the primary key value of the related model:
+
+**Sheet: Comment**
+
+| content      | postId   | userId           |
+|--------------|----------|------------------|
+| Great post!  | post-123 | john@example.com |
+
+The tool automatically resolves foreign keys by looking up the related records.
+
+### Array/List Fields
+
+Array fields support multiple input formats:
+
+- **JSON format:** `["tag1", "tag2", "tag3"]`
+- **Semicolon-separated:** `tag1; tag2; tag3`
+- **Comma-separated:** `tag1, tag2, tag3`
+
+## Advanced Features
+
+- **Foreign Key Resolution** - Automatically resolves relationships between models with pre-fetching for optimal performance
+- **Schema Introspection** - Dynamically queries your GraphQL schema to understand model structures and field types
+- **Configurable Batch Processing** - Tune upload performance with adjustable batch sizes (default: 20 records per batch)
+- **Progress Reporting** - Real-time batch progress with per-sheet confirmation prompts before upload
+
+## Error Handling & Recovery
+
+When records fail to upload, the tool provides a robust recovery mechanism to help you identify and fix issues without starting over.
+
+### How It Works
+
+1. **Automatic Error Capture** - Each failed record is logged with detailed error messages explaining what went wrong
+2. **Failed Records Export** - After migration completes, you'll be prompted to export failed records to a new Excel file with a timestamp (e.g., `data_failed_records_20251201_143022.xlsx`)
+3. **Easy Retry** - Fix the issues in the exported file and run the migration again using only the failed records
+4. **Progress Visibility** - Detailed summary shows success/failure counts, percentages, and specific error reasons for each failed record
+
+### Recovery Workflow Example
+
+```bash
+# Run initial migration
+amplify-migrator migrate
+
+# Migration completes with some failures:
+# ✅ Successfully uploaded: 95 records (95%)
+# ❌ Failed to upload: 5 records (5%)
+#
+# Export failed records? (y/n): y
+# Failed records exported to: data_failed_records_20251201_143022.xlsx
+
+# Fix the errors in the exported Excel file
+# Then re-run migration with the failed records file
+
+amplify-migrator migrate
+# Excel file path: data_failed_records_20251201_143022.xlsx
+```
+
+The tool tracks which records succeeded and failed, providing row-level context to help you quickly identify and resolve issues.
+
+## Troubleshooting
+
+### Authentication Errors
+
+**Error: Unable to authenticate with Cognito**
+- Verify your Cognito User Pool ID and Client ID are correct
+- Ensure your username and password are valid
+- Check that your user is in the ADMINS group
+
+### MFA Issues
+
+**Error: MFA required but not configured**
+- Enable MFA in your Cognito User Pool settings
+- Ensure your user has MFA set up (SMS or software token)
+
+### AWS Credentials
+
+**Error: AWS credentials not found**
+- Set up AWS credentials in `~/.aws/credentials`
+- Or set environment variables: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_DEFAULT_REGION`
+- Or use `aws configure` to set up your default profile
+
+### Excel File Format
+
+**Error: Sheet name does not match any model**
+- Ensure sheet names exactly match your Amplify GraphQL model names (case-sensitive)
+- Check for extra spaces or special characters in sheet names
+
+**Error: Required field missing**
+- Verify all required fields in your GraphQL schema have corresponding columns in Excel
+- Check column names match field names (case-sensitive)
+
+### Permission Errors
+
+**Error: User is not in ADMINS group**
+- Add your user to the ADMINS group in Cognito User Pool
+- Contact your AWS administrator if you don't have permission
+
 ## License
 
 MIT

amplify_excel_migrator-1.2.15.dist-info/RECORD

@@ -0,0 +1,40 @@
+amplify_excel_migrator/__init__.py,sha256=g1LICPlL6J3KYfJuOMEtu0SLXqD_2n3N59_hx18aARQ,525
+amplify_excel_migrator/client.py,sha256=i-FV9uMrPcRG_rKNk5_i4Xu_D-tz2YFRxrM4SYF2-A0,1953
+amplify_excel_migrator/auth/__init__.py,sha256=_vvKeC-szE__R4ctSvqxsabdUU8AcFBmQc1EtETPGUI,209
+amplify_excel_migrator/auth/cognito_auth.py,sha256=t8gNg4oaTZgJaJgV3xH2HXpjpp_lu87dI-mBY5Ni1lw,11855
+amplify_excel_migrator/auth/provider.py,sha256=GaQ2cSuFDN4RDa86YxMNRhBRxMbmhOoWgflDq8igS0Q,1046
+amplify_excel_migrator/cli/__init__.py,sha256=kQ7VrL50-TdB4lrB70gPgJXX7YxBRDGAGmyGkr0yKc8,169
+amplify_excel_migrator/cli/commands.py,sha256=zrT6aaDx_M1ByCY6Fboyl_dcXYPVMKZx53-EwPEwZN0,6708
+amplify_excel_migrator/core/__init__.py,sha256=anEP7jSxUQzXlrgclsbGSoj2GXlz2PM_n2hlp2T90ng,115
+amplify_excel_migrator/core/config.py,sha256=0wENxoUfiEiCm5WpnJX_Q4tE6IuU03VnWcQTbc2Nmbw,3143
+amplify_excel_migrator/data/__init__.py,sha256=rDJxPoHEoWepJFCEc2Wd5TG8Tp1XSMaUqWGbxuu3JmU,238
+amplify_excel_migrator/data/excel_reader.py,sha256=wXh1lNpC53mhq-UQIDJbRq990H6onXuuwrbpnW2tKJI,736
+amplify_excel_migrator/data/transformer.py,sha256=rHpJQvftj_XULMnSYwngmOup8sOxApyHWL5QxiF709E,4484
+amplify_excel_migrator/data/validator.py,sha256=iZYGHLVMtSyjBHQIzRkBTu5nH9CpfdmL4KCH0kJFRRM,1499
+amplify_excel_migrator/graphql/__init__.py,sha256=PGj3f5VGUGiPdKCJu_SqAhnTN2PxbE6gyFqeAhlhYWk,366
+amplify_excel_migrator/graphql/client.py,sha256=56DPQU8atjI3c62VYxbErAF4aTiRMlhDzUPPE4Pn_nU,4882
+amplify_excel_migrator/graphql/executor.py,sha256=e904NBB5XIB2PKRZ3plCt-t80LSEXYQ9EtDMstwFZnA,16018
+amplify_excel_migrator/graphql/mutation_builder.py,sha256=e33tX7gGjMdtOrt5MLXXfAzD16atmrbfOgVSjAa9KlM,2089
+amplify_excel_migrator/graphql/query_builder.py,sha256=etV8ku1NaFG8Akk1oWLEpwUKaXVt5FaVnvDiw_QXPAY,4679
+amplify_excel_migrator/migration/__init__.py,sha256=k85cEbTI96WC0RD5sLj6nRWWE3VU9iHfAu4BWsDNJcI,312
+amplify_excel_migrator/migration/batch_uploader.py,sha256=Z_cp03VyZk0fxbm4e8tns3aLi_x-bbPak9N9_GMI7vk,684
+amplify_excel_migrator/migration/failure_tracker.py,sha256=92BB2o2uJ1J5nKctctXbj5SYXZeHWAF4SBhzyG3gmUg,3249
+amplify_excel_migrator/migration/orchestrator.py,sha256=pAllQZa5RzlKbSYQ6dBrOsBUc_WMgYavHiZ2qd-MPfc,5910
+amplify_excel_migrator/migration/progress_reporter.py,sha256=91YS_Qfys-0ALoeBoWA5v7SwvWOk3DLrsVwyTnz0vus,2156
+amplify_excel_migrator/schema/__init__.py,sha256=U12KKPjFvDhlXUXwc4JD0T4TAPjdLvBVfbwn-xGit-4,179
+amplify_excel_migrator/schema/field_parser.py,sha256=UqJVnllZmdUjPh3hCnhMfY1GYUBSjdMaRQpCttR-mb4,14840
+amplify_excel_migrator/schema/introspector.py,sha256=L6ZY-Uk4zo2Ixh9O9Sx-s5DM9TJkgvxE2OPSS_p01qc,3612
+amplify_excel_migrator-1.2.15.dist-info/licenses/LICENSE,sha256=i8Sf8mXscGI9l-HTQ5RLQkAJU6Iv5hPYctJksPY70U0,1071
+tests/__init__.py,sha256=-j_kF6eQuLjtULc_VPYxuIY0bqpDCVfDikK8RS1YIQY,39
+tests/test_cli_commands.py,sha256=-QNkQqF2s5VB1H4wQ4H3HWWX1DHDf4dwLY2Sw4gxnOA,12010
+tests/test_client.py,sha256=Wso4zn_TcoyjEIZKAopqTO3yPOsKP9JpJmI2UpUz0zU,7966
+tests/test_cognito_auth.py,sha256=sRptE9GGiLW2ur4sm6Zs4FIH8DH61xwap9p4D5GffI0,16302
+tests/test_config_manager.py,sha256=Wc5D3tx8fBwVvGPg0Lkzjjgv6aYlXxYGHjPILpufPLU,14454
+tests/test_field_parser.py,sha256=jbpaWxrgZv-K-QUq7rPg9cCpTpbRjfcDsPfcOLQL4uI,23861
+tests/test_mutation_builder.py,sha256=yvlRW7Cimzv0pNCyfnEgre4NYWEW2DyfUnfyQHWneYE,16485
+tests/test_query_builder.py,sha256=Br3sJELVpC3v1LMWvkNdLWk0BMmTSwZiGTJzOKvJy_M,15332
+amplify_excel_migrator-1.2.15.dist-info/METADATA,sha256=V9r1vipoT8LC3vfrOFmZ8E2imq6KI8dI7XxMf4TCnWA,10236
+amplify_excel_migrator-1.2.15.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+amplify_excel_migrator-1.2.15.dist-info/entry_points.txt,sha256=Ru4V8BBdNJLIksS5taxjtu5bAnXt1EKpjmpGxYcOA2E,78
+amplify_excel_migrator-1.2.15.dist-info/top_level.txt,sha256=zJf_3yBinR9ufYWKB3UzqJXfoXIToIwxmEcJAVzMufI,29
+amplify_excel_migrator-1.2.15.dist-info/RECORD,,

amplify_excel_migrator-1.2.15.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+amplify-migrator = amplify_excel_migrator.cli.commands:main

amplify_excel_migrator-1.2.15.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+amplify_excel_migrator
+tests

tests/__init__.py

@@ -0,0 +1 @@
+"""Tests for amplify-excel-migrator"""

tests/test_cli_commands.py

@@ -0,0 +1,292 @@
+"""Tests for CLI commands"""
+
+import json
+import sys
+import pytest
+from pathlib import Path
+from unittest.mock import patch, MagicMock
+from amplify_excel_migrator.cli.commands import (
+    cmd_show,
+    cmd_config,
+    cmd_migrate,
+)
+from amplify_excel_migrator.core import ConfigManager
+
+
+@pytest.fixture
+def sample_config():
+    """Sample configuration for testing"""
+    return {
+        "excel_path": "test_data.xlsx",
+        "api_endpoint": "https://test.appsync-api.us-east-1.amazonaws.com/graphql",
+        "region": "us-east-1",
+        "user_pool_id": "us-east-1_testpool",
+        "client_id": "test-client-id",
+        "username": "test@example.com",
+    }
+
+
+@pytest.fixture
+def mock_config_manager(tmp_path):
+    """Create a mock ConfigManager for testing"""
+    test_config_file = tmp_path / "config.json"
+
+    def init_mock(self, config_path=None):
+        self.config_path = test_config_file
+        self._config = {}
+
+    return init_mock
+
+
+class TestCmdShow:
+    """Test 'show' command"""
+
+    def test_show_with_no_config(self, capsys, mock_config_manager):
+        """Test show command with no config file"""
+        with patch.object(ConfigManager, "__init__", mock_config_manager):
+            cmd_show()
+
+        captured = capsys.readouterr()
+        assert "❌ No configuration found!" in captured.out
+        assert "amplify-migrator config" in captured.out
+
+    def test_show_with_existing_config(self, capsys, tmp_path, sample_config):
+        """Test show command with existing config"""
+        test_config_file = tmp_path / "config.json"
+        test_config_file.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(test_config_file, "w") as f:
+            json.dump(sample_config, f)
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            cmd_show()
+
+        captured = capsys.readouterr()
+        assert "test_data.xlsx" in captured.out
+        assert "test@example.com" in captured.out
+        assert "us-east-1" in captured.out
+        assert "test-client-id" in captured.out
+
+    def test_show_displays_config_location(self, capsys, tmp_path, sample_config):
+        """Test that show command displays config file location"""
+        test_config_file = tmp_path / "config.json"
+        test_config_file.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(test_config_file, "w") as f:
+            json.dump(sample_config, f)
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            cmd_show()
+
+        captured = capsys.readouterr()
+        assert str(test_config_file) in captured.out
+
+
+class TestCmdConfig:
+    """Test 'config' command"""
+
+    def test_config_prompts_for_all_values(self, tmp_path):
+        """Test that config command prompts for all required values"""
+        test_config_file = tmp_path / "config.json"
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        # Mock all input prompts
+        inputs = [
+            "test.xlsx",
+            "https://test.appsync-api.us-east-1.amazonaws.com/graphql",
+            "us-east-1",
+            "us-east-1_test",
+            "test-client",
+            "admin@test.com",
+        ]
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            with patch("builtins.input", side_effect=inputs):
+                cmd_config()
+
+        # Verify config was saved
+        assert test_config_file.exists()
+        with open(test_config_file) as f:
+            saved_config = json.load(f)
+            assert saved_config["excel_path"] == "test.xlsx"
+            assert saved_config["username"] == "admin@test.com"
+
+    def test_config_saves_to_correct_location(self, capsys, tmp_path):
+        """Test that config is saved to the correct location"""
+        test_config_file = tmp_path / "config.json"
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        inputs = ["test.xlsx", "https://test.com", "us-east-1", "pool", "client", "user"]
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            with patch("builtins.input", side_effect=inputs):
+                cmd_config()
+
+        captured = capsys.readouterr()
+        assert "✅ Configuration saved successfully!" in captured.out
+        assert "amplify-migrator migrate" in captured.out
+
+    def test_config_uses_cached_values_as_defaults(self, tmp_path, sample_config):
+        """Test that config command shows cached values as defaults"""
+        test_config_file = tmp_path / "config.json"
+        test_config_file.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(test_config_file, "w") as f:
+            json.dump(sample_config, f)
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        # Press enter to accept all defaults (from cached config)
+        inputs = ["", "", "", "", "", ""]  # Empty strings use cached values
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            with patch("builtins.input", side_effect=inputs):
+                cmd_config()
+
+        with open(test_config_file) as f:
+            saved_config = json.load(f)
+            assert saved_config["excel_path"] == "test_data.xlsx"
+            assert saved_config["region"] == "us-east-1"
+
+
+class TestCmdMigrate:
+    """Test 'migrate' command"""
+
+    def test_migrate_fails_without_config(self, capsys, tmp_path):
+        """Test that migrate command fails when no config exists"""
+        test_config_file = tmp_path / "config.json"
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            with pytest.raises(SystemExit) as exc_info:
+                cmd_migrate()
+
+        assert exc_info.value.code == 1
+
+        captured = capsys.readouterr()
+        assert "❌ No configuration found!" in captured.out
+        assert "amplify-migrator config" in captured.out
+
+    def test_migrate_uses_cached_config(self, tmp_path, sample_config):
+        """Test that migrate command uses cached configuration"""
+        test_config_file = tmp_path / "config.json"
+        test_config_file.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(test_config_file, "w") as f:
+            json.dump(sample_config, f)
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        # Mock the entire migration process
+        with patch.object(ConfigManager, "__init__", init_mock):
+            with patch("amplify_excel_migrator.auth.CognitoAuthProvider") as mock_auth_provider_class:
+                with patch("amplify_excel_migrator.cli.commands.ExcelReader") as mock_excel_reader_class:
+                    with patch("amplify_excel_migrator.cli.commands.MigrationOrchestrator") as mock_orchestrator_class:
+                        with patch("amplify_excel_migrator.core.config.getpass", return_value="password123"):
+                            mock_auth_instance = MagicMock()
+                            mock_auth_instance.authenticate.return_value = True
+                            mock_auth_provider_class.return_value = mock_auth_instance
+
+                            mock_excel_reader_instance = MagicMock()
+                            mock_excel_reader_class.return_value = mock_excel_reader_instance
+
+                            mock_orchestrator_instance = MagicMock()
+                            mock_orchestrator_class.return_value = mock_orchestrator_instance
+
+                            cmd_migrate()
+
+                            # Verify auth provider was initialized with cached values
+                            mock_auth_provider_class.assert_called_once()
+                            call_args = mock_auth_provider_class.call_args
+                            assert call_args[1]["user_pool_id"] == "us-east-1_testpool"
+                            assert call_args[1]["client_id"] == "test-client-id"
+                            assert call_args[1]["region"] == "us-east-1"
+
+                            # Verify authenticate was called
+                            mock_auth_instance.authenticate.assert_called_once_with("test@example.com", "password123")
+
+                            # Verify orchestrator was called
+                            mock_orchestrator_instance.run.assert_called_once()
+
+    def test_migrate_prompts_for_password(self, tmp_path, sample_config):
+        """Test that migrate command always prompts for password"""
+        test_config_file = tmp_path / "config.json"
+        test_config_file.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(test_config_file, "w") as f:
+            json.dump(sample_config, f)
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            with patch("amplify_excel_migrator.auth.CognitoAuthProvider") as mock_auth_provider_class:
+                with patch("amplify_excel_migrator.cli.commands.ExcelReader") as mock_excel_reader_class:
+                    with patch("amplify_excel_migrator.cli.commands.MigrationOrchestrator") as mock_orchestrator_class:
+                        with patch(
+                            "amplify_excel_migrator.core.config.getpass", return_value="secret_password"
+                        ) as mock_getpass:
+                            mock_auth_instance = MagicMock()
+                            mock_auth_instance.authenticate.return_value = True
+                            mock_auth_provider_class.return_value = mock_auth_instance
+
+                            mock_excel_reader_instance = MagicMock()
+                            mock_excel_reader_class.return_value = mock_excel_reader_instance
+
+                            mock_orchestrator_instance = MagicMock()
+                            mock_orchestrator_class.return_value = mock_orchestrator_instance
+
+                            cmd_migrate()
+
+                            # Verify getpass was called (for password prompt)
+                            mock_getpass.assert_called()
+
+    def test_migrate_stops_if_authentication_fails(self, tmp_path, sample_config):
+        """Test that migrate stops if authentication fails"""
+        test_config_file = tmp_path / "config.json"
+        test_config_file.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(test_config_file, "w") as f:
+            json.dump(sample_config, f)
+
+        def init_mock(self, config_path=None):
+            self.config_path = test_config_file
+            self._config = {}
+
+        with patch.object(ConfigManager, "__init__", init_mock):
+            with patch("amplify_excel_migrator.auth.CognitoAuthProvider") as mock_auth_provider_class:
+                with patch("amplify_excel_migrator.cli.commands.MigrationOrchestrator") as mock_orchestrator_class:
+                    with patch("amplify_excel_migrator.core.config.getpass", return_value="wrong_password"):
+                        mock_auth_instance = MagicMock()
+                        mock_auth_instance.authenticate.return_value = False  # Authentication fails
+                        mock_auth_provider_class.return_value = mock_auth_instance
+
+                        mock_orchestrator_instance = MagicMock()
+                        mock_orchestrator_class.return_value = mock_orchestrator_instance
+
+                        cmd_migrate()
+
+                        # Verify run() was NOT called
+                        mock_orchestrator_instance.run.assert_not_called()