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
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Mostly internal types for handling versions.

use std::{collections::HashSet, str::FromStr};

use semver::{Version, VersionReq};
use serde::{Deserialize, Deserializer, Serialize, Serializer};

use crate::{
	error::CniError,
	reply::{reply, ReplyPayload},
	Cni,
};

pub const COMPATIBLE_VERSIONS: &str = "=0.4.0||^1.0.0";
pub const SUPPORTED_VERSIONS: &[&str] = &["0.4.0", "1.0.0"];

#[derive(Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub(crate) struct VersionPayload {
	#[serde(deserialize_with = "deserialize_version")]
	#[serde(serialize_with = "serialize_version")]
	pub cni_version: Version,
}

impl Cni {
	pub(crate) fn check_version(version: &Version) -> Result<(), CniError> {
		if !VersionReq::parse(COMPATIBLE_VERSIONS)
			.unwrap()
			.matches(version)
		{
			Err(CniError::Incompatible(version.clone()))
		} else {
			Ok(())
		}
	}

	pub(crate) fn handle_version(version: Version) -> ! {
		let mut supported_versions = SUPPORTED_VERSIONS
			.iter()
			.map(|v| Version::parse(*v))
			.collect::<Result<HashSet<_>, _>>()
			.unwrap();

		let supported = Self::check_version(&version).is_ok();
		if supported {
			supported_versions.insert(version.clone());
		}

		reply(VersionReply {
			cni_version: version,
			supported_versions: supported_versions.into_iter().collect(),
		});
	}
}

/// The reply structure used when returning for a `VERSION` command.
///
/// The spec currently mandates that supported versions are provided as an
/// exhaustive array, but this library hopes to do support according to semver
/// compatibility, so it cheats a bit when rendering this reply within
/// [`Cni::load()`][crate::Cni::load()] and adds the runtime-requested version
/// number to the `supported_versions` field when it is semver-compatible.
#[derive(Clone, Debug, Deserialize, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct VersionReply {
	/// The CNI version of the plugin input config.
	#[serde(deserialize_with = "deserialize_version")]
	#[serde(serialize_with = "serialize_version")]
	pub cni_version: Version,

	/// The versions this plugin supports.
	#[serde(deserialize_with = "deserialize_version_list")]
	#[serde(serialize_with = "serialize_version_list")]
	pub supported_versions: Vec<Version>,
}

impl<'de> ReplyPayload<'de> for VersionReply {}

pub(crate) fn serialize_version<S>(version: &Version, serializer: S) -> Result<S::Ok, S::Error>
where
	S: Serializer,
{
	version.to_string().serialize(serializer)
}

pub(crate) fn serialize_version_list<S>(list: &[Version], serializer: S) -> Result<S::Ok, S::Error>
where
	S: Serializer,
{
	list.iter()
		.map(Version::to_string)
		.collect::<Vec<String>>()
		.serialize(serializer)
}

pub(crate) fn deserialize_version<'de, D>(deserializer: D) -> Result<Version, D::Error>
where
	D: Deserializer<'de>,
{
	use serde::de::Error;
	let j = String::deserialize(deserializer)?;
	Version::from_str(&j).map_err(Error::custom)
}

pub(crate) fn deserialize_version_list<'de, D>(deserializer: D) -> Result<Vec<Version>, D::Error>
where
	D: Deserializer<'de>,
{
	use serde::de::Error;
	let j = Vec::<String>::deserialize(deserializer)?;
	j.iter()
		.map(|s| Version::from_str(s).map_err(Error::custom))
		.collect()
}