zproto 0.4.2

A library from communicating with Zaber products in Rust.
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
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

//! The ASCII info message type.

use crate::ascii::{
	command::Target,
	response::{packet, AnyResponse, Header, Response, SpecificResponse},
};

/// The contents of an [`Info`] message.
#[derive(Debug, Clone, PartialEq)]
pub(crate) struct InfoInner {
	pub target: Target,
	pub id: Option<u8>,
	pub data: String,
}

/// A decoded Zaber ASCII Info message.
#[derive(Debug, Clone, PartialEq)]
pub struct Info(pub(super) Box<InfoInner>);

impl Info {
	/// Try to convert a packet into an Info message.
	///
	/// The conversion will fail if the packet is the wrong kind or if the packet
	/// is not the start of a message. The packet does not need to complete the
	/// message.
	pub(crate) fn try_from_packet<T>(packet: &packet::Packet<T>) -> Result<Self, &packet::Packet<T>>
	where
		T: AsRef<[u8]>,
	{
		if packet.kind() != packet::PacketKind::Info || packet.cont() {
			return Err(packet);
		}
		Ok(InfoInner {
			target: packet.target(),
			id: packet.id(),
			data: packet.data().to_string(),
		}
		.into())
	}

	/// The device and axis number the Info message came from.
	pub fn target(&self) -> Target {
		self.0.target
	}
	/// The message ID, if any.
	pub fn id(&self) -> Option<u8> {
		self.0.id
	}
	/// The message's data.
	pub fn data(&self) -> &str {
		self.0.data.as_str()
	}
}

impl From<InfoInner> for Info {
	fn from(inner: InfoInner) -> Self {
		Info(Box::new(inner))
	}
}

impl std::convert::TryFrom<AnyResponse> for Info {
	type Error = AnyResponse;
	fn try_from(response: AnyResponse) -> Result<Self, Self::Error> {
		if let AnyResponse::Info(info) = response {
			Ok(info)
		} else {
			Err(response)
		}
	}
}

impl std::fmt::Display for Info {
	fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
		write!(f, "{}", char::from(packet::INFO_MARKER))?;
		Header {
			address: self.target().device(),
			axis: self.target().axis(),
			id: self.id(),
		}
		.fmt(f)?;
		if !self.data().is_empty() {
			write!(f, " {}", self.data())?;
		}
		Ok(())
	}
}

impl Response for Info {
	fn target(&self) -> Target {
		self.target()
	}
	fn id(&self) -> Option<u8> {
		self.id()
	}
	fn data(&self) -> &str {
		self.data()
	}
}

impl SpecificResponse for Info {}