http

What's Changed

• feat(method): add QUERY method by @seanmonstar in #798
• fix(uri): allow empty paths in uri::Builder by @seanmonstar in #853
• perf(header,uri): faster value validation, URI parse/format, map inserts by @geeknoid in #852
• fix(uri): enforce max length in PathAndQuery by @seanmonstar in #856

New Contributors

• @geeknoid made their first contribution in #852

Full Changelog: v1.4.2...v1.5.0

• Add Method::QUERY constant for the new QUERY method defined in RFC 10008.
• Fix uri::Builder::path_and_query() to allow empty strings to mean no path.
• Fix uri::PathAndQuery parsing to enforce URI max length.

What's Changed

• feat(method): impl PartialOrd + Ord by @mmirate in #840
• fix(uri): allow STAR paths with scheme/auth by @seanmonstar in #843
• fix: reject DEL character by @Isvane in #842

New Contributors

• @mmirate made their first contribution in #840
• @Isvane made their first contribution in #842

Full Changelog: v1.4.1...v1.4.2

• Fix uri::Builder to allow "*" as the path when scheme and authority are also set, used in HTTP/2 requests.
• Fix Uri to properly reject DEL characters.

tl;dr

• Fix PathAndQuery::from_static() and from_shared() to reject inputs that do not start with /.
• Fix Extend for HeaderMap to clamp max size hint and not overflow.
• Fix header::IntoIter that could use-after-free if the generic value type could panic on drop.
• Fix header::{IterMut, ValuesIterMut} to not violate stacked borrows.

What's Changed

• chore(header): fix clippy::assign_op_pattern by @rxc-amzn in #806
• ci: pin itoa in msrv job by @seanmonstar in #813
• Remove unnecessary explicit lifetimes by @jplatte in #815
• chore(ci): update to actions/checkout@v6 by @tottoto in #819
• tests: update to rand 0.10 by @tottoto in #818
• refactor: Remove usage of float instruction by @AurelienFT in #823
• refactor(uri): consolidate PathAndQuery::from_shared and from_static by @seanmonstar in #825
• fix(uri): reject Path::from_shared/from_static if doesn't start with slash by @seanmonstar in #826
• Rephrase comment by @daalfox in #827
• Fix typo in request builder docs by @vleksis in #831
• fix: clamp Extend size hint so HeaderMap reserve cannot overflow by @SAY-5 in #833
• fix(headers): fix stacked borrows for IterMut/ValuesIterMut by @seanmonstar in #837
• fix(header): use a set_len guard in IntoIter drop by @seanmonstar in #838

New Contributors

• @rxc-amzn made their first contribution in #806
• @AurelienFT made their first contribution in #823
• @daalfox made their first contribution in #827
• @vleksis made their first contribution in #831
• @SAY-5 made their first contribution in #833

Full Changelog: v1.4.0...v1.4.1

• Fix PathAndQuery::from_static() and from_shared() to reject inputs that do not start with /.
• Fix Extend for HeaderMap to clamp max size hint and not overflow.
• Fix header::IntoIter that could use-after-free if the generic value type could panic on drop.
• Fix header::{IterMut, ValuesIterMut} to not violate stacked borrows.

Highlights

• Add StatusCode::EARLY_HINTS constant for 103 Early Hints.
• Make StatusCode::from_u16 now a const fn.
• Make Authority::from_static now a const fn.
• Make PathAndQuery::from_static now a const fn.
• MSRV increased to 1.57 (allows legible const fn panic messages).

What's Changed

• Updated Rand dependency to v0.9.1 by @FarzadMohtasham in #763
• Fix compilation on latest nightly by @akonradi-signal in #769
• Avoid unnecessary .expect()s for empty HeaderMap by @akonradi-signal in #768
• feat: show types in Extensions debug output by @crepererum in #773
• Docs: Clarify the HeaderMap documentaion by @Sol-Ell in #774
• style: update format for tests by @seanmonstar in #782
• Make StatusCode::from_u16 const by @coolreader18 in #761
• docs: Fix typo 'an' to 'and' in http::status module documentation by @zxzxovo in #784
• fix: Prevent panic in try_reserve/try_with_capacity on capacity overflow by @AriajSarkar in #787
• fix: Add reserve() to Extend impl for (Option, T)) by @AriajSarkar in #788
• chore: minor improvement for docs by @claudecodering in #790
• chore: bump MSRV to 1.57 by @seanmonstar in #793
• Add EARLY_HINTS status code by @mdevino in #758
• refactor(header): use better panic message in const HeaderName and HeaderValue by @seanmonstar in #797
• docs: remove unnecessary extern crate sentence by @tottoto in #799
• chore(ci): update to actions/checkout@v5 by @tottoto in #800
• feat(uri): make Authority/PathAndQuery::from_static const by @WaterWhisperer in #786
• refactor(header): inline FNV hasher to reduce dependencies by @seanmonstar in #796
• v1.4.0 by @seanmonstar in #803

New Contributors

• @FarzadMohtasham made their first contribution in #763
• @akonradi-signal made their first contribution in #769
• @crepererum made their first contribution in #773
• @Sol-Ell made their first contribution in #774
• @coolreader18 made their first contribution in #761
• @zxzxovo made their first contribution in #784
• @AriajSarkar made their first contribution in #787
• @claudecodering made their first contribution in #790
• @mdevino made their first contribution in #758
• @WaterWhisperer made their first contribution in #786

Full Changelog: v1.3.1...v1.4.0

• Add StatusCode::EARLY_HINTS constant for 103 Early Hints.
• Make StatusCode::from_u16 now a const fn.
• Make Authority::from_static now a const fn.
• Make PathAndQuery::from_static now a const fn.
• MSRV increased to 1.57 (allows legible const fn panic messages).

What's Changed

• fix: validate path bytes are at least utf8 by @seanmonstar in #756

Full Changelog: v1.3.0...v1.3.1

• Fix validation that all characters are UTF-8 in URI path and query.

What's Changed

• Allow most UTF-8 characters in URI path and query. (#715)
  • This means paring Uris with previously illegal characters according the original RFC will now be accepted. They used to be rejected in the name of spec purity, but many operators were using a fork of http because reality is that most characters are seen in the real world.
• Fix HeaderMap::reserve() to allocate sufficient capacity.

New Contributors

• @joelwurtz made their first contribution in #715
• @ADD-SP made their first contribution in #738
• @kawaemon made their first contribution in #741
• @DaniPopes made their first contribution in #748
• @jpds made their first contribution in #695

Thanks!

• @seanmonstar
• @tottoto

Full Changelog: v1.2.0...v1.3.0

• Allow most UTF-8 characters in URI path and query.
• Fix HeaderMap::reserve() to allocate sufficient capacity.

What's Changed

• Add StatusCode::TOO_EARLY constant for 425 status. (#725)
• Loosen TryFrom<HashMap> for HeaderMap to work with any state generic. (#729)
• Change Builder methods to use TryInto instead of TryFrom arguments. (#730)
• Make StatusCode::as_u16 a const function. (#680)
• Fix Method parsing to allow #$%&' characters. (#713)
• Fix HeaderName parsing to reject " characters. (#716)
• Fix off by 1 error in Method::from_bytes that could cause extra allocations. (#708)
• Fix HeaderMap capacity calculation in some cases (#710)

New Contributors

• @lgmsantos made their first contribution in #559
• @Pi-Cla made their first contribution in #690
• @franfastly made their first contribution in #713
• @wyatt-herkamp made their first contribution in #714
• @chen-hongzhi made their first contribution in #716
• @39zde made their first contribution in #718
• @gretchenfrage made their first contribution in #722
• @alistaircarscadden made their first contribution in #724
• @cemoktra made their first contribution in #725
• @Qqwy made their first contribution in #729
• @SmolPatches made their first contribution in #730
• @dlzht made their first contribution in #708
• @asudox made their first contribution in #705
• @WhyNotHugo made their first contribution in #680

Thanks

• @tottoto
• @seanmonstar

Full Changelog: v1.1.0...v1.2.0

• Add StatusCode::TOO_EARLY constant for 425 status.
• Loosen TryFrom<HashMap> for HeaderMap to work with any state generic.
• Change Builder methods to use TryInto instead of TryFrom arguments.
• Make StatusCode::as_u16 a const function.
• Fix Method parsing to allow #$%&' characters.
• Fix HeaderName parsing to reject " characters.
• Fix off by 1 error in Method::from_bytes that could cause extra allocations.

What's Changed

• Add methods to allow trying to allocate in the HeaderMap, returning an error if oversize instead of panicking.
• Add Extensions::get_or_insert() method.
• Implement From<Uri> for uri::Builder.
• Fix HeaderName::from_lowercase that could allow NUL bytes in some cases.

New Contributors

• @tottoto made their first contribution in #645
• @julianbraha made their first contribution in #652
• @LukeMathWalker made their first contribution in #654
• @mattgathu made their first contribution in #660
• @LukasKalbertodt made their first contribution in #667
• @dswij made their first contribution in #673

Full Changelog: v1.0.0...v1.1.0

• Add methods to allow trying to allocate in the HeaderMap, returning an error if oversize instead of panicking.
• Add Extensions::get_or_insert() method.
• Implement From<Uri> for uri::Builder.
• Fix HeaderName::from_lowercase that could allow NUL bytes in some cases.

What's Changed

• Implement Clone for Request, Response, and Extensions. This breaking change requires
  that all extensions now implement Clone.
• Add a default-on std feature. Disabling it currently is not supported.
• Fix MIRI warnings in HeaderMap::iter().

New Contributors

• @hjr3 made their first contribution in #644

• Implement Clone for Request, Response, and Extensions. This breaking change requires that all extensions now implement Clone.
• Add a default-on std feature. Disabling it currently is not supported.
• Fix MIRI warnings in HeaderMap::iter().

What's Changed

• Add methods to allow trying to allocate in the HeaderMap, returning an error if oversize instead of panicking.
• Fix HeaderName::from_lowercase that could allow NUL bytes in some cases.

• Fix parsing of Authority to handle square brackets in incorrect order.
• Fix HeaderMap::with_capacity() to handle arithmetic overflow.

• Add HeaderName constants for cache-status and cdn-cache-control.
• Implement Hash for PathAndQuery.
• Re-export HeaderName at crate root.

• Fix internal usage of uninitialized memory to use MaybeUninit inside HeaderName.

• MSRV bumped to 1.49.
• Add extend() method to Extensions.
• Add From<Authority> and From<PathAndQuery> impls for Uri.
• Make HeaderName::from_static a const fn.

• Upgrade internal itoa dependency to 1.0.

• Add is_empty() and len() methods to Extensions.
• Add version_ref() method to request::Builder.
• Implement TryFrom<Vec<u8>> and TryFrom<String> for Authority, Uri, PathAndQuery, and HeaderName.
• Make HeaderValue::from_static a const fn.

• Fix Uri parsing to allow {, ", and } in paths.

• Upgrade internal (private) bytes dependency to 1.0.

• Fix (potential double) panic of (HeaderMap) OccupiedEntry::remove_entry and remove_entry_mult when multiple values are present. ([#446], [#449] dekellum)
• Safety audits of (priv) ByteStr and refactor of Authority ([#408], [#414] sbosnick)
• Fix HeaderName to error instead of panic when input is too long ([#432] [#433] acfoltzer)
• Allow StatusCode to encode values 100-999 without error. Use of the unclassified range 600-999 remains discouraged. ([#144], [#438], [#443] quininer dekellum)
• Add String and &String fallible conversions to PathAndQuery ([#450] mkindahl)
• Fix Authority (and Uri) to error instead of panic on unbalanced brackets ([#435], [#445] aeryz)

• Add extensions_ref and extensions_mut to request::Builder and response::Builder.

• Add Version::HTTP_3 constant.
• Add HeaderValue::from_maybe_shared, HeaderValue::from_maybe_shared_unchecked, Uri::from_maybe_shared, Authority::from_maybe_shared, and PathAndQuery::from_maybe_shared.
• Change request::Builder, response::Builder, and uri::Builder to use by-value methods instead of by-ref.
• Change from HttpTryFrom trait to std::convert::TryFrom.
• Change HeaderMap::entry to no longer return a Result.
• Change HeaderMap::drain iterator to match the behavior of IntoIter.
• Change Authority::port to return an Option<Port> instead of Option<u16>.
• Change Uri::scheme to return Option<&Scheme> instead of Option<&str>.
• Change Uri::authority to return Option<&Authority> instead of Option<&str>.
• Remove InvalidUriBytes, InvalidHeaderNameBytes, and InvalidHeaderValueBytes error types.
• Remove HeaderValue::from_shared, HeaderValue::from_shared_unchecked, Uri::from_shared, Authority::from_shared, Scheme::from_shared, and PathAndQuery::from_shared.
• Remove Authority::port_part.
• Remove Uri::scheme_part and Uri::authority_part.

• Fix possible double-free if header::Drain iterator is std::mem::forgoten (#357).
• Fix possible data race if multiple header::ValueDrains are iterated on different threads (#362).
• Fix HeaderMap::reserve capacity overflows (#360).
• Fix parsing long authority-form Uris (#351).

• Allow % in IPv6 addresses in Uri (#343).

• Fix compilation of HeaderName parsing on WASM targets (#324).
• Implement HttpTryFrom<HashMap> for HeaderMap (#326).
• Export http::header::HeaderValue as http::HeaderValue.

• Add Error::inner_ref() to view the kind of error (#303)
• Add headers_ref() and headers_mut() methods to request::Builder and response::Builder (#293)

• Fix Uri to permit more characters in the path (#296)

• Fix Uri::host() to include brackets of IPv6 literals (#292)
• Add scheme_str and port_u16 methods to Uri (#287)
• Add method_ref, uri_ref, and headers_ref to request::Builder (#284)

• Add Port struct (#252, #255, #265)
• Introduce Uri builder (#219)
• Empty Method no longer considered valid (#262)
• Fix Uri equality when terminating question mark is present (#270)
• Allow % character in userinfo (#269)
• Support additional tokens for header names (#271)
• Export http::headers::{IterMut, ValuesMut} (#278)

• impl fmt::Display for HeaderName (#249)
• Fix uri::Authority parsing when there is no host after an @ (#248)
• Fix Uri parsing to allow more characters in query strings (#247)

• Fix HeaderValue parsing to allow HTABs (#244)

• Add From<&Self> for HeaderValue, Method, and StatusCode (#238)
• Add Uri::from_static (#240)

• impl HttpTryFrom<String> for HeaderValue (#236)

• Fix double percent encoding (#233)
• Add additional HttpTryFrom impls (#234)

• Add fuller set of PartialEq for Method (#221)
• Reduce size of HeaderMap by using Box<[Entry]> instea of Vec (#224)
• Reduce size of Extensions by storing as Option<Box<AnyMap>> (#227)
• Implement Iterator::size_hint for most iterators in header (#226)

• Add From<uN> for HeaderValue for most integer types (#218).
• Add Uri::into_parts() inherent method (same as Parts::from(uri)) (#214).
• Fix converting Uris in authority-form to Parts and then back into Uri (#216).
• Fix Authority parsing to reject multiple port sections (#215).
• Fix parsing 1 character authority-form Uris into illegal forms (#220).

• Add HeaderName::from_static() constructor (#195).
• Add Authority::from_static() constructor (#186).
• Implement From<HeaderName> for HeaderValue (#184).
• Fix duplicate keys when iterating over header::Keys (#201).

• Add websocket handshake related header constants (#162).
• Parsing Authority with an empty string now returns an error (#164).
• Implement PartialEq<u16> for StatusCode (#153).
• Implement HttpTryFrom<&Uri> for Uri (#165).
• Implement FromStr for Method (#167).
• Implement HttpTryFrom<String> for Uri (#171).
• Add into_body fns to Request and Response (#172).
• Fix Request::options (#177).

• Add PathAndQuery::from_static (#148).
• Impl PartialOrd / PartialEq for Authority and PathAndQuery (#150).
• Add map fn to Request and Response (#151).

• Add Scheme associated consts for common protos.

• Add Uri accessor for scheme part.
• Fix Uri parsing bug (#134)

• Provide Uri accessors for parts (#129)
• Add Request builder helpers. (#123)
• Misc performance improvements (#126)

• Initial release.