Format data in Python using dataclasses like gRPC messages

from dataclasses import dataclass
from typing import Any, Dict, List, Optional


@dataclass
class ProductInfo:
    """Data class representing a gRPC-style product message."""

    name: str
    price: float
    tags: List[str]
    description: Optional[str] = None

    def to_dict(self) -> Dict[str, Any]:
        """Convert to plain dict (like gRPC message to Python dict)."""
        return {
            "name": self.name,
            "price": self.price,
            "tags": list(self.tags),
            "description": self.description,
        }

    @classmethod
    def from_dict(cls, data: Dict[str, Any]) -> "ProductInfo":
        """Create from dict (like parsing JSON into gRPC message)."""
        return cls(
            name=data["name"],
            price=float(data.get("price", 0.0)),
            tags=list(data.get("tags", [])),
            description=data.get("description"),
        )


def format_product_grpc_style(product: ProductInfo) -> str:
    """Format product like a gRPC debug string for beginners."""
    lines = [f"ProductInfo(name: {product.name}, price: {product.price})"]
    if product.description:
        lines.insert(0, f"# {product.description}")
    lines.append(f"  tags: {', '.join(product.tags) if product.tags else '(none)'}")
    return "\n".join(lines)


if __name__ == "__main__":
    # Simulate gRPC message round-trip using dicts
    raw_data = {
        "name": "Wireless Mouse",
        "price": 29.99,
        "tags": ["electronics", "computer"],
        "description": "Ergonomic 2.4GHz wireless mouse",
    }

    msg_dict = ProductInfo.from_dict(raw_data).to_dict()
    print("Dict (gRPC serialization):", msg_dict)

    product = ProductInfo.from_dict(msg_dict)
    print("\nFormatted output:")
    print(format_product_grpc_style(product))