Agent
6b718f7af3
- 支持 .xls (BIFF8) 和 .xlsx 格式 - GUI 文件选择 + 命令行双模式 - 智能结构验证（重复/间隙/空单元格检测） - 逆时针 PinMAP → 顺时针 PinList 自动转换 - Python 标准库，零第三方依赖
61 lines
1.5 KiB
Python
61 lines
1.5 KiB
Python
"""Data models for PinMAP → PinList conversion."""
|
|
|
|
from dataclasses import dataclass, field
|
|
|
|
|
|
@dataclass
|
|
class Pin:
|
|
"""A single pin on the package."""
|
|
number: int
|
|
name: str
|
|
edge: str # "top" | "right" | "bottom" | "left"
|
|
position_on_edge: int
|
|
|
|
|
|
@dataclass
|
|
class PinMAP:
|
|
"""Parsed pin map from an Excel file."""
|
|
package_info: str
|
|
pins: list[Pin]
|
|
width: int
|
|
height: int
|
|
grid_origin: tuple[int, int] # (row, col) of top-left corner
|
|
raw_cells: dict[tuple[int, int], str] = field(default_factory=dict)
|
|
|
|
|
|
@dataclass
|
|
class PinList:
|
|
"""Flat pin list for output."""
|
|
package_info: str
|
|
rows: list[tuple[str, int]] # [(PinName, Pin序号), ...]
|
|
|
|
|
|
@dataclass
|
|
class ValidationError:
|
|
"""A single validation issue."""
|
|
level: str # "error" | "warning"
|
|
message: str
|
|
details: str
|
|
|
|
|
|
@dataclass
|
|
class ValidationResult:
|
|
"""Aggregate validation result."""
|
|
is_valid: bool
|
|
errors: list[ValidationError] = field(default_factory=list)
|
|
warnings: list[ValidationError] = field(default_factory=list)
|
|
|
|
|
|
# ── Custom exceptions ──────────────────────────────────────────────
|
|
|
|
class PinMapError(Exception):
|
|
"""Base exception for this project."""
|
|
|
|
|
|
class FileFormatError(PinMapError):
|
|
"""Raised when a file is not a valid Excel format."""
|
|
|
|
|
|
class StructureError(PinMapError):
|
|
"""Raised when the PinMAP structure is invalid or unrecognisable."""
|