34 KiB
Changelog
0.3.1 — 2023-03-02
This patch release applies some minor fixes, while correcting documentation errors and adjusting some organisaation in the repository.
Thanks to the following for their contributions:
Added
- [repo] Repo: Update issue templates (@FelixMcFelix) c:eedab8f
Fixed
- [docs] Chore: Fix README.md CI badge (#161) (@FelixMcFelix) c:d6c82f5
- [input] Input: Fix read position after seek restart (#154) (@JamesDSource) c:39a6f69
- [docs] Docs: Fix wrong docstring for Track::volume (#152) (@btoschek) c:a2f55b7
- [docs] Events: Fix typo in docs for VoiceData (#142) (@tazz4843) c:dc53087
0.3.0 — 2022-07-22 — Chaffinch
Abundant and ever-curious, chaffinches are a vibrant and welcome visitor in these spring and summer months.
Making a quick and colourful splash, this breaking release mainly bumps our own dependencies and support for Discord libraries without any sweeping changes -- while adding generic support for any future rust-based Discord library. However, we have now removed support for the v0.2 series of the Tokio runtime.
Thanks to the following for their contributions:
Upgrade Pathway
- Tokio v0.2 support has been removed in parity with other Discord libraries -- users must now migrate to v1.x.x.
- Deprecated events (
ClientConnect,DriverConnectFailed,DriverReconnectFailedandSsrcKnown) have been removed. ClientConnectmust now be detected using VoiceStateUpdate messages from your main gateway library of choice.- The remainder should be replaced with
DriverDisconnect, andDriverConnect/DriverReconnect
Added
- [queue] driver, queue: return track handle when adding an
Inputto the queue (#116) (@vaporox) c:bacf681 - [gateway] Gateway: Generic Shard and Twilight v0.8 Support (#109) (@FelixMcFelix) c:b4ce845
- [gateway] Gateway: Add generics to
Callmethods. (#102) (@FelixMcFelix) c:8dedf3b - [docs] Events: Document format of
VoiceData. (#114) (@FelixMcFelix) c:806a422
Changed
- [deps] Chore: Update to twilight 0.12 (@FelixMcFelix) c:865c75f
- [deps] Chore: Update to serenity 0.11 (@FelixMcFelix) c:a85a1f0
- [deps] Update twilight support to twilight 0.11 (#132) (@Erk-) c:69339e8
- [deps] Deps: Update to Audiopus v0.3.0-rc.0 (#125) (@FelixMcFelix) c:4eb95d4
- [deps] Deps: Bump dependencies and document bumped MSRV (#119) (@GnomedDev) c:98f0d02
- [deps] Gateway: Twilight v0.10 support (#117) (@FelixMcFelix) c:fac6664
- [deps] Gateway: Twilight v0.9 support (#110) (@FelixMcFelix) c:0730a00
- [gateway] Gateway: Remove lifetime from Serenity setup trait (#103) (@FelixMcFelix) c:12c76a9
- [deps] Deps: Bump streamcatcher version -> 1.0 (#93) (@tktcorporation) c:67ad7c9
- [docs] Chore: Update link to lavalink-basic-bot.rs (#135) (@wlcx) c:f9b7e76
- [deps] Chore: Pin flume version to prevent MSRV breakage. (@FelixMcFelix) c:312457e
- [deps] Chore: Bump MSRV to 1.51.0 (@FelixMcFelix) c:05c6762
Fixed
- [examples] Examples: support new Serenity Intents init (@FelixMcFelix) c:d3a40fe
- [examples] Examples: Fix serenity-next cache accesses (#99) (@FelixMcFelix) c:f1ed41e
- [driver] Driver: Prevent panic when decrypting undersized RTP packets (#122) (@FelixMcFelix) c:8791805
Removed
- [driver] Driver: Remove spin_sleep in
Mixer::march_deadline(#124) (@GnomedDev) c:e3476e7 - [driver] Driver, Gateway: Remove tokio 0.2 support (#118) (@GnomedDev) c:f2cd8a0
- [events] Events: Remove deprecated events. (#115) (@FelixMcFelix) c:ac20764
0.2.2 — 2022-02-13
This patch release makes it easier to create new ChildContainers, and deprecates the ClientConnect event. Users should instead make use of SpeakingStateUpdate events and Discord gateway events.
Thanks to the following for their contributions:
Added
Changed
- [events] Events: Deprecate
ClientConnect(#112) (@FelixMcFelix) c:c464fcc
Fixed
- [docs] Docs: fix ClientConnect to recommend
SpeakingStateUpdate(@FelixMcFelix) c:652ec1f - [repo] Chore: Fix typo in CHANGELOG.md (#111) (@reiyw) c:2feadc7
0.2.1 — 2022-01-05
This patch release adds support for the yt-dlp fork of youtube-dl, and fixes track events to correctly fire events when multiple timed handlers are present on a track.
Thanks to the following for their contributions:
Added
- [docs] Docs: added documentation for
yt-dlpfeature (#106) (@Lunarmagpie) c:73323e5 - [input] Input: Allows yt-dlp usage as another youtube-dl fork (#90) (@Miezhiko) c:6fcb196
Fixed
- [docs] Examples: Fix unmatched quotation mark in comment. (#101) (@lajp) c:62ecfe6
- [events] Events: fix handling of multiple timed events on a single track (#96) (@FelixMcFelix) c:e25cc14
0.2.0 — 2021-08-17 — Magpie
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. TrackStatesent from the driver are no longer boxed objects.DriverDisconnectevents have been introduced, which cover all disconnect events. As a result,DriverConnectFailedandDriverReconnectFailedare deprecated.- Tokio 0.2 support is deprecated. Related features will be removed as of Songbird 0.3.
Added
- [driver] Driver: Automate (re)connection logic (#81) (@FelixMcFelix) c:210e3ae
- [input] Input: Add separate YouTube title and channel to Metadata (#75) (@vilgotf) c:edcd39a
- [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
- [deps] Deps: Bump async-tungstenite version -> 0.14 (@FelixMcFelix) c:47e20d6
- [docs] Chore: Update Lavalink URLs (@FelixMcFelix) c:3efe756
- [deps] Deps: Bump twilight versions -> [0.5, 0.7) (#87) (@vilgotf) c:91d7542
- [tracks] Tracks: Remove box around TrackState (#84) (@vilgotf) c:91d7542
- [deps] Deps: Bump twilight versions -> 0.5 (#79) (@vilgotf) c:d2bb277
- [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
- [driver] Driver: Fix incorrect leave behaviour in Drop handler (@FelixMcFelix) c:dad48ca
- [benchmarks] Fix: Update Benchmark Imports (@FelixMcFelix) c:338a042
- [lint] Chore: Clippy fixes for new lints (@FelixMcFelix) c:a1c4f07
- [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