feat(reports) report carved directories - CarveDirectoryReport

Carve directories were hard to explain, as they look like extraction
directories and there was no public information to tell them apart.

Adding this report makes the purpose of the directory visible.

Author: e3krisztian

tests/test_report.py

@@ -10,6 +10,7 @@
 from unblob.models import ProcessResult, Task, TaskResult
 from unblob.processing import ExtractionConfig, process_file
 from unblob.report import (
+    CarveDirectoryReport,
     ChunkReport,
     FileMagicReport,
     HashReport,
@@ -120,6 +121,7 @@ def hello_kitty_task_results(
                     sha1="febca6ed75dc02e0def065e7b08f1cca87b57c74",
                     sha256="144d8b2c949cb4943128aa0081153bcba4f38eb0ba26119cc06ca1563c4999e1",
                 ),
+                CarveDirectoryReport(carve_dir=extract_root / "hello_kitty_extract"),
                 UnknownChunkReport(
                     id=ANY,
                     start_offset=0,

unblob/processing.py

@@ -34,6 +34,7 @@
 from .pool import make_pool
 from .report import (
     CalculateMultiFileExceptionReport,
+    CarveDirectoryReport,
     ExtractDirectoryExistsReport,
     FileMagicReport,
     HashReport,
@@ -577,6 +578,9 @@ def _process_chunks(
     def _carve_then_extract_chunks(self, file, outer_chunks, unknown_chunks):
         carve_dir = self.config.get_carve_dir_for(self.task.path)
 
+        # report the technical carve directory explicitly
+        self.result.add_report(CarveDirectoryReport(carve_dir=carve_dir))
+
         for chunk in unknown_chunks:
             carved_unknown_path = carve_unknown_chunk(carve_dir, file, chunk)
             randomness = self._calculate_randomness(carved_unknown_path)

unblob/report.py

@@ -233,6 +233,11 @@ class UnknownChunkReport(Report):
     randomness: Optional[RandomnessReport]
 
 
+@attr.define(kw_only=True, frozen=True)
+class CarveDirectoryReport(Report):
+    carve_dir: Path
+
+
 @final
 @attr.define(kw_only=True, frozen=True)
 class MultiFileReport(Report):