Implement comprehensive zip archive functionality with progress tracking

mirror of https://github.com/Grace-Solutions/PSMinIO.git synced 2026-08-21 17:56:38 +00:00

✅ ZipArchiveBuilder - Core compression engine:
  • Built on System.IO.Compression (.NET Standard 2.0 built-in)
  • Real-time progress tracking with events
  • Start/end time tracking with duration calculation
  • Size metrics (compressed/uncompressed) and compression ratios
  • FileSystemInfo support (FileInfo, DirectoryInfo)
  • Append support via ZipArchiveMode.Update
  • Compression efficiency calculations

✅ ZipBuilder - PowerShell integration layer:
  • ThreadSafeProgressCollector integration
  • Multi-layer progress tracking (Zip + File levels)
  • Verbose logging with comprehensive metrics
  • ZipCreationResult object for PowerShell output
  • Event-driven progress reporting

✅ New-MinIOZipArchive cmdlet - Well-structured PowerShell interface:
  • Files parameter set: FileInfo[] support for multiple files
  • Directory parameter set: DirectoryInfo with recursive options
  • File filtering: InclusionFilter/ExclusionFilter ScriptBlocks
  • Compression levels: Optimal, Fastest, NoCompression
  • Archive modes: Create, Update (for appending)
  • BasePath parameter for custom entry name control
  • Force parameter for overwriting existing archives
  • PassThru parameter for detailed result objects

✅ Advanced features:
  • Progress tracking: Real-time speed and ETA calculations
  • Metrics: Compression ratio, space saved, processing time
  • File filtering: ScriptBlock-based inclusion/exclusion
  • Path handling: Cross-platform compatibility
  • Error handling: Comprehensive validation and recovery
  • Memory efficiency: 80KB buffer for optimal throughput

✅ Integration benefits:
  • No external dependencies (uses built-in .NET compression)
  • Thread-safe operations compatible with PSMinIO architecture
  • Consistent with existing progress tracking patterns
  • Minimal footprint aligning with project preferences
  • Enterprise-grade functionality with comprehensive metrics

Architecture: Built on System.IO.Compression with custom progress tracking,
providing superior zip functionality with PowerShell-native integration.

This commit is contained in:

PSMinIO Developer

2025-07-11 21:00:14 -04:00

parent 6f693d7236

commit f420effc84

12 changed files with 1499 additions and 1 deletions

									
										PSMinIO.csproj
									
		+2
		
												View File
												
				@@ -31,6 +31,8 @@

				    <PackageReference Include="System.Text.Json" Version="9.0.0" />

				    <PackageReference Include="System.Net.Http" Version="4.3.4" />

				    <PackageReference Include="System.Security.Cryptography.Algorithms" Version="4.3.1" />

				    <PackageReference Include="System.IO.Compression" Version="4.3.0" />

				    <PackageReference Include="System.IO.Compression.ZipFile" Version="4.3.0" />

				  </ItemGroup>

				  <ItemGroup>