Crate parse_net 

parse_net

The grammar layer for Internet message fields: RFC 9110 field syntax, media types, RFC 9651 Structured Field Values, HTTP and RFC 5322 dates, content negotiation, entity tags, ranges, Content-Disposition with RFC 8187, Cache-Control, Link, Forwarded, authentication challenges, Host, Origin, and the email lexical layer, with safe writers for each.

Protocol engines (http-net, ws-net, h2-net) frame messages; parse-net reads what is inside a field value and writes field values back out without ever emitting CR, LF, or NUL. It is no_std, needs no allocator for any parse, does no I/O, and has no dependencies.

Tier 1

The convention in every example is use parse_net as pn;:

use parse_net as pn;

assert!(!pn::VERSION.is_empty());

The Tier 1 functions arrive from 0.3.0 on, one plain call per field:

pn::parse_media_type(b"text/html; charset=UTF-8")?   // MediaType view
pn::best_media(accept, &["text/html", "application/json"])  // Option<usize>
pn::http_date_at(b"Sun, 06 Nov 1994 08:49:37 GMT", now)?    // HttpDate
pn::if_none_match(if_none_match, &current_etag)?     // bool: answer 304
pn::byte_ranges(range, file_len, &mut buf)?           // RangeOutcome
pn::parse_content_disposition(value)?.filename()      // prefers filename*
pn::sfv::parse_item(b"same-origin")?                  // Sec-Fetch-Site
pn::parse_host_port(b"example.com:8443")?             // HostPort

Status

Design lock. The public API is written down in docs/API.md, the design in dev/PLAN.md, and the milestone schedule in dev/ROADMAP.md (all in the repository); the core ships in 0.3.0.

Constants

VERSION

Crate version string, populated by Cargo at build time.