Struct ProtocolVersion 

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

Protocol version with validation and proper encapsulation

Represents an MCP protocol version in the format YYYY-MM-DD. The internal string representation is private to ensure validation and provide flexibility for future implementation changes.

Examples

use airsprotocols_mcp::protocol::ProtocolVersion;

// Create current protocol version
let version = ProtocolVersion::current();
assert_eq!(version.as_str(), "2025-06-18");

// Create custom version with validation
let version = ProtocolVersion::new("2025-06-18")?;
assert_eq!(version.as_str(), "2025-06-18");

// Invalid version format fails
let result = ProtocolVersion::new("invalid");
assert!(result.is_err());

Implementations

impl ProtocolVersion

pub const CURRENT: &'static str = "2025-06-18"

Current supported protocol version

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

Create a new protocol version with validation

Errors

Returns ProtocolError::InvalidProtocolVersion if the version format is not YYYY-MM-DD.

pub fn current() -> Self

Create current protocol version

This is guaranteed to be valid and will never fail.

pub fn as_str(&self) -> &str

Get the version string

pub fn is_compatible_with(&self, other: &Self) -> bool

Check if this version is compatible with another version

Currently implements exact version matching, but can be enhanced for semantic version compatibility in the future.

Trait Implementations

impl Clone for ProtocolVersion

fn clone(&self) -> ProtocolVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProtocolVersion

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

Formats the value using the given formatter.

impl Default for ProtocolVersion

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ProtocolVersion

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ProtocolVersion

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

Formats the value using the given formatter.

impl Hash for ProtocolVersion

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 ProtocolVersion

fn eq(&self, other: &ProtocolVersion) -> 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 ProtocolVersion

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 ProtocolVersion

impl StructuralPartialEq for ProtocolVersion