refactor: centralize item payload construction with simplified format handling

[Copilot]

📥 Pull Request

✨ Description of new changes

Summary

Eliminates redundant payload construction logic scattered across multiple files by introducing a single build_item_payload() utility. Previously, adding new item types required updating switch-case statements in fab_item.py; now only command_support.yaml needs modification. The implementation uses an extensible design with configuration-based format handling and unsupported types constant.

Changes

Core refactoring:

• Added build_item_payload() in fab_item_util.py - Single source of truth for payload construction. Handles common fields (type, description, folderId, displayName) and applies format directly to definition dict
  • Uses negative check against UNSUPPORTED_DEFINITION_ITEM_TYPES constant - new item types work automatically unless explicitly unsupported
  • Simplified logic: checks if definition exists, validates item type, applies format from input_format parameter or default from definition_format_mapping
  • Sets format directly on definition dict instead of wrapping - eliminates special case handling
• Removed get_payload() from fab_item.py - Eliminated 60+ lines of switch-case duplication
• Renamed _build_payload → _build_definition in fab_cmd_import_utils.py - More accurate naming; now delegates to centralized builder

Configuration improvements:

• Added UNSUPPORTED_DEFINITION_ITEM_TYPES to fab_constant.py - Centralized tuple of item types that don't support definition payloads
• Enhanced definition_format_mapping in fab_types.py - Returns simple format strings instead of query parameters:
  • Notebook: "fabricGitSource" (default), None for .py format, "ipynb" for .ipynb format
  • SparkJobDefinition: "SparkJobDefinitionV1" (default)

Command updates:

• fab_fs_import_item.py, fab_fs_mkdir_item.py, fab_fs_cp_item.py all use centralized builder
• Removed redundant default parameter values from function calls
• Environment item creation uses builder for base payload

Code formatting:

• Applied black formatter with --skip-string-normalization to preserve existing quote style
• Fixed trailing spaces and line length issues without changing quotes from single to double

Example usage:

# Before: had to update fab_item.py switch-case for each new item type
case ItemType.NEW_ITEM:
    return {
        "type": str(self.item_type),
        "description": "Imported from fab",
        "folderId": self.folder_id,
        "displayName": self.short_name,
        "definition": definition,
    }

# After: single call handles all item types
payload = fab_item_util.build_item_payload(item, definition)
# Format automatically applied from definition_format_mapping
# New item types work automatically unless in UNSUPPORTED_DEFINITION_ITEM_TYPES

Testing:

• Added 7 unit tests covering payload construction scenarios (with/without definition, various formats including default, unsupported types)
• Updated existing hierarchy test to reflect new default format (fabricGitSource)
• All tests passing with simplified logic

Context

The original design required explicitly adding each item type to fab_item.py switch statements, creating maintenance burden and violating DRY. Default format handling was hardcoded with complex special case logic. This refactoring enables adding new item types by configuration alone with a significantly simplified architecture (~30 lines vs ~70 lines) that:

• Moves configuration to appropriate constants (fab_constant.py and fab_types.py)
• Applies format directly to definition dict
• Eliminates all special case handling for different item types
• Uses simple format strings instead of query parameter format
• Preserves code style by using black with --skip-string-normalization flag

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[ayeshurun]

@copilot enhance that section. the elif item_type in (), should check if the item type is NOT supported, and raise exception, otherwise it should do

base_payload["definition"] = definition

and return base_payload.

secondly, try to extract the format from args and if not exists try to extract from the definition_format_mapping default value, instead of hardcoding it.

[Copilot]

Enhanced the logic as requested:

1. ✅ Changed to check if item type is NOT supported (using unsupported_types list) - new supported types will work automatically without code changes
2. ✅ Extract format from definition_format_mapping instead of hardcoding - parses query param format (e.g., "?format=ipynb" → "ipynb")
3. ✅ All other item types (not in unsupported list) use definition directly

Commit: bb8f01e

The function now:

• Checks against an explicit unsupported types list
• Extracts format values from definition_format_mapping for Notebook and SparkJobDefinition
• Maintains original behavior (.py format has no format key)
• All tests passing ✅

[ayeshurun]

@copilot this is the default value, no need to specify it explicitly.

[Copilot]

Removed explicit description="Imported from fab" parameter since it's the default value.

Commit: b8af1ca

[ayeshurun]

@copilot both definition=None and description="Imported from fab" are the default values, no need to explictly pass them

[Copilot]

Removed explicit definition=None and description="Imported from fab" parameters since they're defaults.

Commit: b8af1ca

[ayeshurun]

@copilot defined this in fab_constant

[Copilot]

Moved unsupported types tuple to fab_constant.UNSUPPORTED_DEFINITION_ITEM_TYPES.

Commit: b8af1ca

[ayeshurun]

@copilot there are lots of changes you made for formatting. use black formatter and avoid and revert all changes of quotes (' to " you did) and spaces.

[Copilot]

Reverted unwanted formatting changes and applied black with --skip-string-normalization:

• Reverted file to state before formatting commit (preserving single quotes)
• Applied black with --skip-string-normalization flag to preserve quote style
• Only fixed trailing spaces and line length issues
• No quote changes from ' to "

Commit: 71aada5