23 KiB
Changelog
0.2.0-beta.2 — 2021-05-11 — Magpie
These notes will be adjusted between 0.2.0-beta.0 and the stable release.
Magpies are a common sight year-round; strong, intelligent, industrious, and loyal.
Taking after the humble magpie, this breaking release makes API changes favouring extensibility, patching some of the API rough spots, and adding resilience to some additional classes of failure.
Thanks to the following for their contributions:
Upgrade Pathway
- References to
songbird::{opus, Bitrate};should now usesongbird::driver::{opus, Bitrate};. - Custom
Inputs(i.e.,Reader::Extension/ExtensionSeek) now need to implementinput::reader::MediaSourcerather than justReadand/orSeek. - Sources which do not support seeking should have an
unreachable!()function body or always return an error, asMediaSource::is_seekable()is used to gate support. - Many event handler types in
songbird::EventContexthave changed to unitenums, rather thanstructvariants. - New body types are included in
songbird::events::context_data::*. Configstructs have been made non-exhaustive; they should be initialised viaConfig::default().- Channel join operations may now timeout after a default 10s—which should be handled.
- Errors returned when joining a channel will now inform you whether you should try to
leavea channel before rejoining. - Youtube-dl variants of
songbird::input::error::Errorhave had their case altered fromDL->Dl.
Added
- [input] Input: Implement StdError for DcaError, input::Error (#73) (@vilgotf) c:e1fc041
- [gateway] Gateway: Add debug logging around shard handling (@FelixMcFelix) c:b3caf05
- [gateway] Gateway: Add connection timeout, add
Configto gateway. (#51) (@FelixMcFelix) c:d303e0a
Changed
- [input] Input, Driver: Make error messages more idiomatic (#74) (@vilgotf) c:a96f033
- [docs] Chore: Rewrite update pathway. (@FelixMcFelix) c:8000da6
- [deps] Deps: Bump DiscoRTP version -> 0.4 (@FelixMcFelix) c:7fc971a
- [deps] Deps: Bump twilight versions -> 0.4 (@FelixMcFelix) c:fc94ddb
- [deps] Deps: Bump xsalsa20poly1305 version -> 0.7 (@FelixMcFelix) c:eb22443
- [input] Input: Change all Youtube-dl functions to take
AsRef<str>(#70) (@clarity0) c:a1ba760 - [gateway] Chore: Adapt #60, #64 in line with other breaking changes. (@FelixMcFelix) c:63d53b2
- [input] Use symphonia::io::MediaSource for Reader extensions (#61) (@james7132) c:a86898c
- [input] Input: Rename YTDL error variants for Clippy (#55) (@FelixMcFelix) c:3c7f86d
- [events] Events: Break out and non-exhaust context body structs (#54) (@FelixMcFelix) c:e7af0ff
- [driver] Driver: Move
Bitrateimport out of crate root. (#53) (@FelixMcFelix) c:1eed9dd - [deps] Deps: Bump DiscoRTP version -> 0.3 (#52) (@FelixMcFelix) c:bc952d0
Fixed
- [fmt] Chore: Repair formatting. (@FelixMcFelix) c:cd2ade9
- [fmt] Chore: Fix clippy warnings (useless clones). (@FelixMcFelix) c:21b8383
- [gateway] Gateway: Fix repeat joins on same channel from stalling (#47) (@FelixMcFelix) c:95dd19e
0.1.8 — 2021-07-01
This release patches a metadata parsing panic caused by Ogg files with negative start times.
Thanks to the following for their contributions:
Fixed
0.1.7 — 2021-06-14
This release mainly patches an occasionally spinning task, due to a critical WebSocket read error.
Thanks to the following for their code contributions:
And special thanks to @jtscuba and @JellyWX for their efforts in reproducing, debugging and diagnosing the above issue.
Changed
Fixed
- [driver] Driver: Fix for busy-wait in WS thread. (#78) (@FelixMcFelix) c:b925309
0.1.6 — 2021-04-11
This patch release fixes a driver crash on leaving a channel, adds a utility method for requesting the current channel ID, and limits a sub-dependency to ensure compatibility with Rust v1.48.0.
Thanks to the following for their contributions:
Added
- [gateway] Gateway: Introduce Call::current_channel (#60) (@DoumanAsh) c:22214a0
Fixed
- [deps] Deps: Prevent MSRV breakage via
spinning_top(#64) (@FelixMcFelix) c:a88b185 - [driver] Driver: Fix crash on
.leave()(#63) (@FelixMcFelix) c:24d8da6
0.1.5 — 2021-03-23
This patch release adds bugfixes for incorrect seeking in Restartable sources and resource usage of inactive Drivers, as well as some utility methods and reduced logging.
Thanks to the following for their contributions:
Added
- [gateway] Gateway: Allow connection info to be retrieved (#49) (@FelixMcFelix) c:db79940
- [misc] Repo: Organise and document processes and architecture (#43) (@FelixMcFelix) c:1fcc8c0
Changed
- [deps] Deps: Update async-tungstenite -> 0.13 (#50) (@FelixMcFelix) c:f230b41
- [driver] Driver: Reduce logging level in general (#48) (@FelixMcFelix) c:a3f86ad
Fixed
- [driver] Prevent mixer thread from waking while inactive (#46) (@FelixMcFelix) c:a9b4cb7
- [input] Fix input source timestamp pre-input argument decimal formatting (#45) (@DasEtwas) c:c488ce3
- [examples] Break reference cycle in voice storage example (#44) (@FelixMcFelix) c:b9a926c
0.1.4 — 2021-02-10
This patch release updates introduces a new event type, to expose a driver's SSRC externally on connect.
Thanks to the following for their contributions:
Added
- [events] Events: Add
SsrcKnownevent (@FelixMcFelix) c:f3f5242 - [misc] Chore: Add missing changelog notes for 0.1.3 (@FelixMcFelix) c:0e860dc
Changed
- [deps] Deps: Update async-tungstenite -> 0.12 (@FelixMcFelix) c:a40fac3
0.1.3 — 2021-02-04
This patch release corrects the process drop logic to cleanup all chained child processes, and for Inputs to be safe to drop in async contexts. Additionally, this adds backwards-compatibility for Tokio 0.2 in serenity-based bots.
Thanks to the following for their contributions:
Added
- [deps] Chore + Deps: Add the
logfeature to tracing (@FelixMcFelix) c:1863d39 - [driver] Library: Add compatibility for legacy Tokio 0.2 (#40) (@FelixMcFelix) c:aaab975
Fixed
- [input] Fix: hand off process killing to blocking thread, await all children. (@FelixMcFelix) c:b245309
0.1.2 — 2021-01-26
This patch release fixes a PID/zombie process leak affecting bots running on Linux/Mac, and prevents youtube-dl warnings from being converted into fatal errors.
This release also changes Songbird managers to use DashMap internally, which should substantially speed up concurrent shard accesses to the central call registry.
Thanks to the following for their contributions:
Changed
- [gateway] Gateway: Move from RwLock to DashMap (@FelixMcFelix) c:a0e905a
- [misc] Chore: Categorise v0.1.1 commits (@FelixMcFelix) c:196d5be
Fixed
- [driver] Input & Driver: Fix zombie processes on Unix (#39) (@FelixMcFelix) c:fe2282c
- [input] Fix: Prevent ytdl treating warnings as errors. (@FelixMcFelix) c:658fd83
0.1.1 — 2021-01-17
This is a short patch release, fixing some error message spam under network failures, adding some new convenience event classes, as well as making it easier to cancel many event handlers.
Thanks to the following for their contributions:
Added
- [events] Events: Add Play/Pause events. (@FelixMcFelix) c:868c44c
- [events] Events: Add (re)connect success/fail events. (@FelixMcFelix) c:cb2398f
- [driver] Driver: Add ability to clear all global event handlers. (@FelixMcFelix) c:55b8e7f
Fixed
- [driver] Driver: Fix noisy errors, UDP message send failure spam. (@FelixMcFelix) c:dcb6ad9
0.1.0 — 2021-01-08 — Robin
We're very excited to publish and announce the first release of Songbird, an async Rust voice library for Discord! It's been a long time coming, but all the hard work has paid off in bringing the first version of this library to completion.
Thanks to the following for their contributions:
Songbird is based heavily on serenity's voice module, which has served as its base design, informed many of the design changes, and paved a lot of the API/protocol research needed.
We'd also like to thank all users who have contributed to this module in the past for laying the groundwork for Songbird:
- @Arcterus
- @acdenisSK
- @Elinvynia
- @Erk-
- @FelixMcFelix
- @Flat
- @ForsakenHarmony
- @ftriquet
- @hiratara
- @indiv0
- @JellyWX
- @Lakelezz
- @LikeLakers2
- @mendess
- @nickelc
- @nitsuga5124
- @perryprog
- @Prof-Bloodstone
- @Proximyst
- @Roughsketch
- @s0lst1ce
- @Sreyas-Sreelal
- @tarcieri
- @vivian
Added
- [tracks] Tracks: Add TypeMap to Handles. (@FelixMcFelix) c:d42e09f
- [tracks] Tracks: Allow custom UUID setting (#33) (@peppizza) c:873458d
- [input] Input: Allow Restartable sources to be lazy (@FelixMcFelix) c:03ae0e7
- [driver] Driver, Input: Performance & Benchmarks (#27) (@FelixMcFelix) c:504b8df
- [input] Metadata: Add source_url and thumbnail fields (#28) (@saanuregh) c:700f20d
- [tracks] TrackHandle: add metadata field (#25) (@peppizza) c:57df3fe
- [tracks] TrackQueue: Add current_queue method (#16) (@peppizza) c:69acea8
- [tracks] TrackQueues: Convenience methods and extension (#7) (@FelixMcFelix) c:de65225
- [docs] Docs: Add a dependencies section in the README (#2) (@acdenisSK) c:047ce03
- [input] Offer youtube-dlc as an alternative to youtube-dl (#1) (@peppizza) c:6702520
- [misc] Attempt CI similar to serenity (@FelixMcFelix) c:c5ce107
- [misc] Add the ISC license (@acdenisSK) c:a778d24
- [examples] Move examples from the Serenity repository (@acdenisSK) c:f5bf54a
- [misc] Add a
.gitignorefile as songbird is in its own repository (@acdenisSK) c:ec7f5bc - [driver] Implement Songbird driver configuration (#1074) (@FelixMcFelix) c:8b7f388
- [docs] Document intents for Songbird (#1061) (@FelixMcFelix) c:38a55da
- [driver] Voice Rework -- Events, Track Queues (#806) (@FelixMcFelix) c:7e4392a
Changed
- [misc] Chore: Bump to published twilight. (@FelixMcFelix) c:7d767d2
- [misc] Chore: Bump to published serenity. (@FelixMcFelix) c:53ab9da
- [misc] Songbird: Tokio 1.0 (#36) (@FelixMcFelix) c:f05b741
- [docs] Docs: Warn about twilight task deadlock (@FelixMcFelix) c:c0d3cb3
- [misc] Deps: Patch flume. (@FelixMcFelix) c:2fc88a6
- [input] Input: Json parsing errors now contain the parsed text (#31) (@Maspenguin) c:8d6bd4f
- [driver] Driver, Tracks: Cleanup of leaky types (#20) (@FelixMcFelix) c:f222ce9
- [docs] Docs: Move to new intra-doc links, make events non-exhaustive. (#19) (@FelixMcFelix) c:94157b1
- [input] Input: Make restartable sources fully async. (#15) (@FelixMcFelix) c:2da5901
- [misc] Lint: Clippy warning cleanup (#8) (@peppizza) c:cb7d8cc
- [docs] Docs: describe
youtube-dlcfeature (@FelixMcFelix) c:45b1fb1 - [misc] Some updated links, move to current/next branches. (@FelixMcFelix) c:09da85b
- [misc] Remove mentions of versions to Serenity git dependencies (@acdenisSK) c:4a897a7
- [misc] Update
Cargo.tomlto reflect the separation of songbird from Serenity's repository (@acdenisSK) c:6724655 - [misc] Update versions for twilight and serenity-voice-model in songbird (#1075) (@FelixMcFelix) c:868785b
Fixed
- [driver] Driver: Handle receiving large non-standard packets (#23) (@FelixMcFelix) c:9fdbcd7
- [misc] Fix: Remove serenity default features (#18) (@Maspenguin) c:1ada46d
- [driver] Fix: Use correct tokio features for driver-only mode (@FelixMcFelix) c:a9f8d6c
- [misc] CI round 2 (@FelixMcFelix) c:35d262d
- [examples] Fix links in the README regarding examples (@acdenisSK) c:4f5b767
- [driver] Handle Voice close codes, prevent Songbird spinning WS threads (#1068) (@FelixMcFelix) c:26c9c91