rama-net 0.3.0

rama network types and utilities
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

//! Owned-form internals for a parsed [`Uri`](super::Uri).
//!
//! `OwnedUriRef` holds decomposed, individually mutable components. Reached
//! by upgrading from [`LazyUriRef`](super::lazy::LazyUriRef) on first
//! mutation via the (pub(crate)) `to_mut` machinery in `mod.rs`.

use super::{Fragment, Query};
use crate::Protocol;
use crate::address::Authority;

use rama_core::bytes::BytesMut;

/// Decomposed, individually mutable URI reference.
#[derive(Debug, Clone, Default)]
pub(crate) struct OwnedUriRef {
    pub(crate) scheme: Option<Protocol>,
    pub(crate) authority: Option<Authority>,
    /// Path bytes. Always present (§3.3); empty `BytesMut` = empty path.
    /// `/` is part of the path itself, not an outer delimiter — hence no `Option`.
    pub(crate) path: BytesMut,
    /// `None` = no `?` on wire; `Some(empty)` = `?` with empty content.
    /// Distinct URIs per §3.4 (SigV4 / cache keys / proxy fidelity).
    pub(crate) query: Option<Query>,
    /// Same `None` vs `Some(empty)` distinction as `query`, per §3.5.
    pub(crate) fragment: Option<Fragment>,
}