Struct Uri 

pub struct Uri(/* private fields */);

URI with validation and type safety

Represents a Uniform Resource Identifier with validation and utility methods. The internal string representation is private to ensure validation.

Examples

use airsprotocols_mcp::protocol::Uri;

// Valid URI construction
let uri = Uri::new("file:///path/to/file")?;
assert_eq!(uri.scheme(), Some("file"));
assert_eq!(uri.as_str(), "file:///path/to/file");

// Invalid URI fails validation
let result = Uri::new("not-a-uri");
assert!(result.is_err());

// Unchecked construction for trusted sources
let uri = Uri::new_unchecked("custom://internal");

Implementations

impl Uri

pub fn new(uri: impl Into<String>) -> ProtocolResult<Self>

Create a new URI with validation

Errors

Returns ProtocolError::InvalidUri if the URI format is invalid.

pub fn new_unchecked(uri: impl Into<String>) -> Self

Create URI without validation (for trusted sources)

This should only be used when the URI is known to be valid, such as constants or internally generated URIs.

pub fn as_str(&self) -> &str

Get the URI string

pub fn scheme(&self) -> Option<&str>

Extract the URI scheme (e.g., “file”, “http”, “custom”)

pub fn is_file_uri(&self) -> bool

Check if this is a file URI

pub fn is_http_uri(&self) -> bool

Check if this is an HTTP/HTTPS URI

Trait Implementations

impl Clone for Uri

fn clone(&self) -> Uri

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Uri

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Uri

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Uri

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Uri

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Uri

fn eq(&self, other: &Uri) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Uri

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Uri

impl StructuralPartialEq for Uri