feat(assets): Add Support for Electrical Component Connections

[eduardiazf]

Summary

This PR adds functionality to list and manage electrical component connections within microgrids, representing the physical wiring between components in the microgrid infrastructure.

Changes

New Core Functionality

• ComponentConnection class (_connection.py):
  • Represents a single electrical link between two components
  • Tracks source and destination component IDs following physical wiring direction
  • Includes operational lifetime tracking with helper methods (is_operational_at(), is_operational_now())
  • Validates that source and destination components are different
  • Direction aligned with current flow away from grid connection point (or islanding point)

API Client Enhancement

• New method: list_microgrid_electrical_component_connections() in AssetsApiClient:
  • Lists all electrical component connections for a given microgrid
  • Optional filtering by source_component_ids and/or destination_component_ids
  • Returns list[ComponentConnection | None]

CLI Enhancement

• New command: component-connections <microgrid-id>
  • Retrieves and displays electrical component connections in JSON format
  • Options:
    • --source: Filter by source component ID(s) (can be specified multiple times)
    • --destination: Filter by destination component ID(s) (can be specified multiple times)
  • Examples:

    # Get all connections for microgrid 123
    assets-cli component-connections 123
    
    # Filter by source component
    assets-cli component-connections 123 --source 5
    
    # Filter by multiple sources and destinations
    assets-cli component-connections 123 --source 5 --source 6 --destination 10
    
    # Pipe to jq for further processing
    assets-cli component-connections 123 | jq ".[]"

Supporting Infrastructure

• JSON serialization (_connection_json.py): Converts connections to JSON format
• Protobuf conversion (_connection_proto.py):
  • Parses protobuf messages into ComponentConnection objects
  • Validates connection data with detailed issue reporting (major/minor issues)
  • Handles missing or invalid operational lifetime gracefully
  • Logs warnings for invalid connections

Resources

• https://github.com/frequenz-floss/frequenz-client-microgrid-python/blob/v0.18.x/src/frequenz/client/microgrid/component/_connection.py