Unified progress reporting for compression and extraction operations

[Copilot]

Unified progress reporting for compression and extraction operations

Adds unified progress reporting support using the IProgress<T> interface for both compression and extraction operations, similar to what 7-Zip's GUI provides.

Changes Made

New Progress Reporting API

• ProgressReport class: Reports progress with EntryPath, BytesTransferred, TotalBytes, and PercentComplete properties
• ProgressReportingStream: Internal stream wrapper that tracks read operations and reports progress
• WriterOptions.Progress: IProgress<ProgressReport>? property for compression progress
• ReaderOptions.Progress: IProgress<ProgressReport>? property for reader-based extraction progress
• IArchiveEntry.WriteTo/WriteToAsync: Now accept optional IProgress<ProgressReport>? parameter for archive entry extraction progress

Removed Old Event-Based Progress Reporting

• Removed IExtractionListener, IReaderExtractionListener, IArchiveExtractionListener interfaces
• Removed ReaderProgress, ListeningStream, ArchiveExtractionEventArgs classes
• Removed CompressedBytesReadEventArgs and FilePartExtractionBeginEventArgs
• Removed old events from IArchive and IReader interfaces
• Updated MultiVolumeReadOnlyStream, RarArchiveEntry, RarReader to remove listener dependencies

Merged from Master

• ✅ Integrated new ZStandard compression implementation
• ✅ Integrated TarHeaderWriteFormat option for TarWriter
• ✅ All progress reporting tests pass (19 tests)
• ✅ Code formatted with CSharpier

Fixes #1027

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Feature Suggestion: Saving progress</issue_title>
<issue_description>I searched existing issues and only found something related to extraction progress.
It would be very helpful to have progress reporting during compression operations, similar to what 7-Zip's GUI provides.
Ideally, this could be implemented using the IProgress interface, which would make it easy for users to read progress updates.
If a way to read saving progress is already available can you please point out how can I hook into it?</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Feature Suggestion: Saving progress #1027

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[adamhathcock]

Continue

[Copilot]

Continue

Completed the progress reporting feature (0f374b2). Added:

• CompressionProgress class with entry path, bytes read, total bytes, and percentage
• IProgress<CompressionProgress> support via WriterOptions.Progress property
• Progress reporting in ZipWriter, TarWriter, and GZipWriter
• Comprehensive tests for the feature

Usage example:

var progress = new Progress<CompressionProgress>(p => 
    Console.WriteLine($"{p.EntryPath}: {p.PercentComplete:F1}%"));

var options = new ZipWriterOptions(CompressionType.Deflate) { Progress = progress };
using var writer = new ZipWriter(archiveStream, options);
writer.Write("file.txt", sourceStream, DateTime.Now);

[adamhathcock]

@copilot remove IExtractionListener and ReaderProgress in favor of this new approach. Reimplement progress for reading like this.

[adamhathcock]

Continue

[adamhathcock]

@copilot retry

[Copilot]

@copilot retry

Completed the refactoring (7af029b). Removed IExtractionListener, ReaderProgress, and related event-based progress reporting. Now using unified IProgress<ProgressReport> approach for both reading and writing:

Changes made:

• Renamed CompressionProgress to ProgressReport for unified use
• Added ReaderOptions.Progress for extraction progress
• Removed IExtractionListener, IReaderExtractionListener, ReaderProgress, ListeningStream
• Removed old events from IArchive, IReader, AbstractArchive, AbstractReader
• Updated MultiVolumeReadOnlyStream, RarArchiveEntry, RarReader to remove listener dependencies
• Added tests for both writing and reading progress

Usage:

// Extraction progress
var progress = new Progress<ProgressReport>(p => 
    Console.WriteLine($"{p.EntryPath}: {p.PercentComplete:F1}%"));
var options = new ReaderOptions { Progress = progress };
using var reader = ReaderFactory.Open(stream, options);

[adamhathcock]

Archive Entry reading and writing should also have progress using the same interface and style.