feat(report): Report carved files

unblob/processing.py

@@ -34,6 +34,7 @@
 from .pool import make_pool
 from .report import (
     CalculateMultiFileExceptionReport,
+    CarveReport,
     EntropyReport,
     ExtractDirectoryExistsReport,
     FileMagicReport,
@@ -579,6 +580,10 @@ def _extract_chunk(self, file, chunk: ValidChunk):  # noqa: C901
             carved_path = None
         else:
             inpath = carve_valid_chunk(self.carve_dir, file, chunk)
+            self.result.add_report(
+                CarveReport.from_chunk(self.task.path, inpath, chunk)
+            )
+
             extract_dir = self.carve_dir / (inpath.name + self.config.extract_suffix)
             carved_path = inpath
 

unblob/report.py

@@ -236,6 +236,27 @@ class UnknownChunkReport(Report):
     entropy: Optional[EntropyReport]
 
 
+@attr.define(kw_only=True, frozen=True)
+class CarveReport(Report):
+    """Describes a successful carving operation."""
+
+    carved_from: Path
+    carved_to: Path
+    start_offset: int
+    end_offset: int
+    handler_name: str
+
+    @classmethod
+    def from_chunk(cls, carved_from: Path, carved_to: Path, chunk: ChunkReport):
+        return cls(
+            carved_from=carved_from,
+            carved_to=carved_to,
+            start_offset=chunk.start_offset,
+            end_offset=chunk.end_offset,
+            handler_name=chunk.handler.NAME,
+        )
+
+
 @final
 @attr.define(kw_only=True, frozen=True)
 class MultiFileReport(Report):