rodio Release 0.21.0

Chores:

[ ] check upgrade guide
[x] write announcement
[ ] put release date in CHANGELOG
[ ] update examples link in README

Mar 27 '25 18:03 yara-blue

There are may API changes. 0.30 maybe?

// Who does not like bike-shedding?

Mar 28 '25 19:03 PetrGlad

There are may API changes. 0.30 maybe?

luckily we do not need to make that decision, semver (https://semver.org) has done it for us :)

I do like the idea of a 1.0.0 eventually. We can probably do that after:

solving the span silliness
replacing Sink with something that handles crossfade gracefully

Mar 28 '25 19:03 yara-blue

As you mentioned already thousands of projects depend on it and it is sad fact of live that people generally do not read documentation, including semantic versioning guides. No problem picking next minor version, of course.

Mar 29 '25 18:03 PetrGlad

I'll place an announcement on reddit and the rust user forum noting its a breaking release and explicitly mention the upgrade guide and documentation.

maybe that will help

Mar 29 '25 20:03 yara-blue

Ready for review and then release. I would prefer to release either next monday or before friday this week. Since during the weekend I can not handle any fallout/questions.

Mar 31 '25 23:03 yara-blue

On a business trip now, could offer a few nitpicks but would have to do it on mobile (biggest one: gapless is only with Symphonia, and already was in 0.20 - biggest fix here is the availability of total_duration).

Come to think of, there are also some function return type changes in the Source trait that users who implement that need to know about.

Overarching question: the way I perceive the upgrade guide, it's indeed to migrate and fix compilation issues. I'm wondering if we should shed a little more light on some internals; the f32 pipeline and why we moved away from the generics?

Apr 01 '25 12:04 roderickvd

another thing, bincode has the migration guide in the docs, seems like a good idea to me.

Apr 01 '25 13:04 yara-blue

blocked by #724

Apr 01 '25 15:04 yara-blue

Some suggestions.

thank you very much, I'll get on that some day next week. Next time full free to edit the code/docs on the branch directly. Then I'll just look at the diff and bring up any contentious change.

Apr 04 '25 20:04 yara-blue

blocked by #730

Apr 11 '25 11:04 roderickvd

rebased on main

May 12 '25 06:05 yara-blue

rebased on master

Jun 04 '25 21:06 yara-blue

we should be good to release now :)

Jun 04 '25 22:06 yara-blue

Mind if I suggest you include https://github.com/RustAudio/rodio/pull/754 in this release as well?

Jun 10 '25 02:06 madsmtm

Okay this is rebased on main now. I think we are still missing some stuff in the upgrade guide related to the feature overhaul. Would you mind giving that a look @roderickvd?

Jul 05 '25 13:07 yara-blue

Okay this is rebased on main now. I think we are still missing some stuff in the upgrade guide related to the feature overhaul. Would you mind giving that a look @roderickvd?

As the upgrade guide contains required code changes, and does not aim to replace the changelog, I think the upgrade contents on features is good enough.

I did go through it to improve readability.

Jul 12 '25 14:07 roderickvd

rebases on main

Jul 12 '25 15:07 yara-blue

Congratulations to all contributors on this new and pretty hefty release.

Should we do some communication on it on the socials? I think we did previously on Reddit.

Jul 13 '25 08:07 roderickvd

Should we do some communication on it on the socials? I think we did previously on Reddit.

Almost forgot :sweat_smile:

I've just done reddit, we will also get a channel and a announcement in the rust audio discord. If you know any other places please do go ahead and post there too. We've got the announcement text ready in outreach/v0.21_announcement.md

Jul 13 '25 09:07 yara-blue