Class ScanResult

core/models.py:61–102

Results from a scan or reconnaissance operation.

class ScanResult(BaseModel):
    """Results from a scan or reconnaissance operation."""

    target: Target
    module: str = Field(..., description="Module that performed the scan")
    success: bool = True
    started_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
    completed_at: datetime | None = None
    findings: list[Finding] = Field(default_factory=list)
    raw_data: dict[str, Any] = Field(default_factory=dict)
    errors: list[str] = Field(default_factory=list)

    def add_finding(
        self,
        title: str,
        description: str,
        severity: Severity = Severity.INFO,
        data: dict[str, Any] | None = None,
        references: list[str] | None = None,
    ) -> Finding:
        """Add a finding to the result."""
        finding = Finding(
            title=title,
            description=description,
            severity=severity,
            source=self.module,
            data=data or {},
            references=references or [],
        )
        self.findings.append(finding)
        return finding

    def complete(self) -> None:
        """Mark the scan as complete."""
        self.completed_at = datetime.now(timezone.utc)

    @property
    def duration_seconds(self) -> float | None:
        """Get scan duration in seconds."""
        if self.completed_at and self.started_at:
            return (self.completed_at - self.started_at).total_seconds()
        return None