diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-21 11:44:51 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-21 11:44:51 +0000 |
commit | 9e3c08db40b8916968b9f30096c7be3f00ce9647 (patch) | |
tree | a68f146d7fa01f0134297619fbe7e33db084e0aa /third_party/rust/httparse/README.md | |
parent | Initial commit. (diff) | |
download | thunderbird-upstream.tar.xz thunderbird-upstream.zip |
Adding upstream version 1:115.7.0.upstream/1%115.7.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'third_party/rust/httparse/README.md')
-rw-r--r-- | third_party/rust/httparse/README.md | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/third_party/rust/httparse/README.md b/third_party/rust/httparse/README.md new file mode 100644 index 0000000000..ce79aa6088 --- /dev/null +++ b/third_party/rust/httparse/README.md @@ -0,0 +1,43 @@ +# httparse + +[![crates.io](https://img.shields.io/crates/v/httparse.svg)](https://crates.io/crates/httparse) +[![Released API docs](https://docs.rs/httparse/badge.svg)](https://docs.rs/httparse) +[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE-MIT) +[![CI](https://github.com/seanmonstar/httparse/workflows/CI/badge.svg)](https://github.com/seanmonstar/httparse/actions?query=workflow%3ACI) +[![Discord chat][discord-badge]][discord-url] + +A push parser for the HTTP 1.x protocol. Avoids allocations. No copy. **Fast.** + +Works with `no_std`, simply disable the `std` Cargo feature. + +[Changelog](https://github.com/seanmonstar/httparse/releases) + + +[discord-badge]: https://img.shields.io/discord/500028886025895936.svg?logo=discord +[discord-url]: https://discord.gg/kkwpueZ + +## Usage + +```rust +let mut headers = [httparse::EMPTY_HEADER; 64]; +let mut req = httparse::Request::new(&mut headers); + +let buf = b"GET /index.html HTTP/1.1\r\nHost"; +assert!(req.parse(buf)?.is_partial()); + +// a partial request, so we try again once we have more data + +let buf = b"GET /index.html HTTP/1.1\r\nHost: example.domain\r\n\r\n"; +assert!(req.parse(buf)?.is_complete()); +``` + +## License + +Licensed under either of + +- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or https://apache.org/licenses/LICENSE-2.0) +- MIT license ([LICENSE-MIT](LICENSE-MIT) or https://opensource.org/licenses/MIT) + +### Contribution + +Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions. |