70 lines
2.2 KiB
Markdown
70 lines
2.2 KiB
Markdown
|
# Changelog
|
||
|
|
|
||
|
|
All notable changes to this project will be documented in this file.
|
||
|
|
|
||
|
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||
|
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||
|
|
|
||
|
|
## [0.2.0] - 2025-01-16
|
||
|
|
|
||
|
|
### Added
|
||
|
|
|
||
|
|
- Extended `MusicSource` trait with comprehensive async methods:
|
||
|
|
- `root_container()`: Get root container for ContentDirectory
|
||
|
|
- `browse(object_id)`: Browse containers and items
|
||
|
|
- `resolve_uri(object_id)`: Resolve audio URIs (with cache support)
|
||
|
|
- `supports_fifo()`: Indicate FIFO support
|
||
|
|
- `append_track(track)`: Add track to FIFO
|
||
|
|
- `remove_oldest()`: Remove oldest track from FIFO
|
||
|
|
- `update_id()`: Get current update counter
|
||
|
|
- `last_change()`: Get last modification timestamp
|
||
|
|
- `get_items(offset, count)`: Paginated browsing
|
||
|
|
- `search(query)`: Optional search functionality
|
||
|
|
|
||
|
|
- New types:
|
||
|
|
- `BrowseResult`: Enum for browse results (Containers, Items, or Mixed)
|
||
|
|
- Extended `MusicSourceError` with more error variants
|
||
|
|
|
||
|
|
- Dependencies:
|
||
|
|
- `async-trait`: For async trait methods
|
||
|
|
- `tokio`: Async runtime
|
||
|
|
- `pmodidl`: DIDL-Lite support
|
||
|
|
- `pmoplaylist`: FIFO playlist management
|
||
|
|
- `pmoaudiocache` (optional): Audio caching
|
||
|
|
- `pmocovers` (optional): Cover art caching
|
||
|
|
|
||
|
|
- Complete Radio Paradise example (`examples/radio_paradise.rs`) demonstrating:
|
||
|
|
- FIFO management using `pmoplaylist`
|
||
|
|
- Cache integration simulation
|
||
|
|
- DIDL-Lite generation
|
||
|
|
- Change tracking
|
||
|
|
- Full trait implementation
|
||
|
|
|
||
|
|
- Comprehensive documentation:
|
||
|
|
- Updated README with architecture diagrams
|
||
|
|
- Usage examples for static and dynamic sources
|
||
|
|
- Integration guides for PMOMusic ecosystem
|
||
|
|
- Thread safety notes
|
||
|
|
|
||
|
|
### Changed
|
||
|
|
|
||
|
|
- `MusicSource` trait is now async (requires `#[async_trait]`)
|
||
|
|
- All implementations must be `Send + Sync`
|
||
|
|
- Trait is now much more comprehensive and ready for UPnP/OpenHome integration
|
||
|
|
|
||
|
|
### Removed
|
||
|
|
|
||
|
|
- Outdated `show_sources.rs` example
|
||
|
|
|
||
|
|
## [0.1.0] - Initial Release
|
||
|
|
|
||
|
|
### Added
|
||
|
|
|
||
|
|
- Basic `MusicSource` trait with:
|
||
|
|
- `name()`: Human-readable name
|
||
|
|
- `id()`: Unique identifier
|
||
|
|
- `default_image()`: Embedded WebP logo
|
||
|
|
- `default_image_mime_type()`: MIME type
|
||
|
|
- Basic error types
|
||
|
|
- Standard image size constant (300x300px)
|