What's New in v0.6.0
🧹 Breaking Changes for Better API Design
This release removes deprecated functionality and improves API consistency across the library.
| Change | Rationale |
|---|---|
Removed MusicIpId |
MusicIP service discontinued; use AcoustID instead |
Removed AiffFile.TryParse |
Use AiffFile.Read which returns result type with error context |
Removed WavFile.ReadFromData |
Use WavFile.Read for span-based parsing |
AudioProperties → struct |
Better performance and immutability semantics |
Renamed AsfFile.AudioProperties |
Now Properties for consistency with other file types |
📊 Quality Metrics
- Test coverage: 90.1% line, 77.6% branch
- Test count: 3,780 passing tests (+605 from v0.5.0)
- Formats: 15 audio formats with full read/write
- Build: Zero warnings, all analyzers passing
💡 Migration Notes
MusicIpId Removal
// Before (v0.5.0)
tag.MusicIpId = "..."
// After (v0.6.0) - Use AcoustID instead
tag.AcoustId = "..."AudioProperties Struct
// Before (v0.5.0)
AudioProperties props = file.Properties; // class
// After (v0.6.0)
AudioProperties props = file.Properties; // readonly struct (no API changes needed)ASF Properties
// Before (v0.5.0)
var props = asfFile.AudioProperties;
// After (v0.6.0)
var props = asfFile.Properties; // Consistent with other formats📦 Installation
dotnet add package TagLibSharp2 --version 0.6.0🔗 Links
Full Changelog: v0.5.0...v0.6.0