qubit-http 0.5.1

General-purpose HTTP infrastructure for Rust with unified client semantics, secure logging, and built-in SSE decoding
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

/*******************************************************************************
 *
 *    Copyright (c) 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/
//! Header parsing helpers for request configuration paths.

use http::{HeaderName, HeaderValue};

use crate::{HttpError, HttpResult};

/// Parses a header name and value pair into typed HTTP header components.
///
/// # Parameters
/// - `name`: Header name text.
/// - `value`: Header value text.
///
/// # Returns
/// Parsed [`HeaderName`] and [`HeaderValue`] on success.
///
/// # Errors
/// Returns [`HttpError`] when `name` is not a valid HTTP header name or `value`
/// is not a valid HTTP header value.
pub(crate) fn parse_header(name: &str, value: &str) -> HttpResult<(HeaderName, HeaderValue)> {
    let header_name = HeaderName::from_bytes(name.as_bytes())
        .map_err(|error| HttpError::other(format!("Invalid header name '{}': {}", name, error)))?;
    let header_value = HeaderValue::from_str(value).map_err(|error| {
        HttpError::other(format!("Invalid header value for '{}': {}", name, error))
    })?;
    Ok((header_name, header_value))
}