Add project filter support for migrations list

Author: bhuvanshah7

azure-devops/azext_devops/dev/migration/arguments.py

@@ -17,6 +17,8 @@ def load_migration_arguments(self, _):
     with self.argument_context('devops migrations list') as context:
         context.argument('include_inactive', options_list='--include-inactive', action='store_true',
                          help='Include inactive (completed, abandoned, failed) migrations in the results.')
+        context.argument('project', options_list='--project',
+                         help='Optional project name or ID to filter migrations.')
 
     with self.argument_context('devops migrations create') as context:
         context.argument('target_repository', options_list='--target-repository',

azure-devops/azext_devops/dev/migration/migration.py

@@ -4,6 +4,7 @@
 # --------------------------------------------------------------------------------------------
 
 import re
+from urllib.parse import quote_plus
 
 from msrest import Configuration
 from msrest.service_client import ServiceClient
@@ -44,12 +45,15 @@
 _URL_PATTERN = re.compile(r'^https?://[^\s]+$', re.IGNORECASE)
 
 
-def list_migrations(include_inactive=False, organization=None, detect=None):
+def list_migrations(include_inactive=False, project=None, organization=None, detect=None):
     organization = _resolve_org_for_auth(organization, detect)
     client = _get_service_client(organization)
     url = _build_migration_url(organization)
     if include_inactive:
         url += '&includeInactiveMigrations=true'
+    project = _normalize_optional_text(project)
+    if project:
+        url += '&project={}'.format(quote_plus(project))
     return _send_request(client, 'GET', url)
 
 

azure-devops/azext_devops/tests/latest/migration/test_migration.py

@@ -53,6 +53,32 @@ def test_list_migrations_include_inactive(self):
             self.assertEqual(args[1], 'GET')
             self.assertIn('includeInactiveMigrations=true', args[2])
 
+    def test_list_migrations_with_project_filter(self):
+        with patch('azext_devops.dev.migration.migration.resolve_instance') as mock_resolve, \
+             patch('azext_devops.dev.migration.migration._get_service_client') as mock_client, \
+             patch('azext_devops.dev.migration.migration._send_request') as mock_send:
+            mock_send.return_value = {}
+            mock_resolve.return_value = self._TEST_ORG
+
+            list_migrations(project='MyProject', organization=self._TEST_ORG, detect=False)
+
+            args = mock_send.call_args[0]
+            self.assertEqual(args[1], 'GET')
+            self.assertIn('project=MyProject', args[2])
+
+    def test_list_migrations_with_project_filter_url_encoded(self):
+        with patch('azext_devops.dev.migration.migration.resolve_instance') as mock_resolve, \
+             patch('azext_devops.dev.migration.migration._get_service_client') as mock_client, \
+             patch('azext_devops.dev.migration.migration._send_request') as mock_send:
+            mock_send.return_value = {}
+            mock_resolve.return_value = self._TEST_ORG
+
+            list_migrations(project='My Project', organization=self._TEST_ORG, detect=False)
+
+            args = mock_send.call_args[0]
+            self.assertEqual(args[1], 'GET')
+            self.assertIn('project=My+Project', args[2])
+
     def test_create_migration_payload_defaults_validate_only_false(self):
         with patch('azext_devops.dev.migration.migration.resolve_instance') as mock_resolve, \
              patch('azext_devops.dev.migration.migration._get_service_client') as mock_client, \

doc/elm_migrations_tsg.md

@@ -126,6 +126,9 @@ See if any migrations already exist for your org:
 # Active migrations only
 az devops migrations list --detect false
 
+# Filter by project name or ID
+az devops migrations list --detect false --project MyProject
+
 # All migrations including completed/failed/suspended
 az devops migrations list --detect false --include-inactive
 ```

doc/migrations.md

@@ -52,7 +52,7 @@ az repos show --repository MyRepo --project MyProject --query id -o tsv
 
 ## Command reference
 
-- `list`: List migrations for the org. Use `--include-inactive` to include completed/failed/suspended migrations.
+- `list`: List migrations for the org. Use `--include-inactive` to include completed/failed/suspended migrations. Use `--project` to filter by project name or ID.
 - `status`: Show migration status for a repository GUID.
 - `create`: Create a migration. Use `--validate-only` for pre-migration checks only.
 - `pause`: Pause an active migration.
@@ -97,6 +97,12 @@ What this does:
 az devops migrations list --org https://dev.azure.com/myorg
 ```
 
+### List migrations for a project
+
+```bash
+az devops migrations list --org https://dev.azure.com/myorg --project MyProject
+```
+
 ### List all migrations including inactive
 
 ```bash