1.0 Release

[sagebind]

This is a master issue for tracking the upcoming 1.0 release of Isahc.

Isahc's API has pretty much settled into a comfortable position at this point and has no outstanding obvious API deficiencies any more, so now is a great time to make the few pending breaking changes we want to make and release the next version as 1.0.

I've decided that we will not wait for our public dependencies to reach 1.0 first even though it is recommended, because we have very few such dependencies and they move slowly anyway.

Timeline

1.0 is scheduled to be released before the end of December 2020.

API

• Make changes to error types: Error type updates #182
• Split sync and async responses to avoid existing confusion: Split sync and async response APIs #202
• Determine whether the body type ought to change further
• Review serialization/deserialization ergonomics. We don't need to implement Unified body encoders/decoders #211 as the current methods can be changed to convenience methods around a more powerful API later, but we should make sure that the existing methods make sense with that in mind.
• Fix our cookie API situation: Additional cookie features #215
• Pin minimum supported Rust version (MSRV) to a specific version. Figure out which version that can be. Please document the minimum supported rust version (MSRV) #219

Release tasks

• Write blog post announcement
• Publish to Crates.io

---

Original description

Isahc 1.0 will encompass a stabilization of the API, and will include full Future and async/await support. The plan is to release a new minor version with the updated API after futures are stabilized in the standard library. After that, let the API soak for a month leaving room for any fixes that might be needed or changes that need to be made to the design. After that we'll release version 1.0.

Most of the open feature requests will be deferred to post-1.0 (though the API needs to keep these requests in mind). The things that must be done before 1.0 are tracked in this milestone: https://github.com/sagebind/isahc/milestone/3

Preparation for 1.0 will be done on a separate branch from master, since Isahc is already a "stable" library and requiring nightly is not on the table.

[sagebind]

It would be preferable to wait for the http crate to stabilize first, since it is part of the API, according to the API guidelines: https://rust-lang-nursery.github.io/api-guidelines/print.html#public-dependencies-of-a-stable-crate-are-stable-c-stable. Though honestly, I'm not sure I want to wait that long. There's always a 2.0 after 1.0...

[sagebind]

Note to self: 1.0-beta.1 will be scheduled for December 12, if everything goes as planned. We will release at least 1 beta to be used early to ensure everything is ready and the new API designs are working as intended.

[sagebind]

This is now complete! Check out the official announcement post.