codemp-proto 0.8.0

protocol definitions for codemp -- code multiplexer
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

//! # CodeMP Protocol - cooperative development
//! `codemp-proto` is the gRPC protocol specification powering [`codemp`](https://code.mp).
//!
//! This is built on top of [tonic] and provides both clientside and serverside service
//! implementations.
#![doc(html_logo_url = "https://code.mp/logo-round.png")]

/// common types across services
#[allow(non_snake_case)]
pub mod common {
	tonic::include_proto!("common");

	impl From<uuid::Uuid> for Identifier {
		fn from(id: uuid::Uuid) -> Self {
			let (hi, lo) = id.as_u64_pair();
			Identifier { hi, lo }
		}
	}

	impl From<&uuid::Uuid> for Identifier {
		fn from(id: &uuid::Uuid) -> Self {
			let (hi, lo) = id.as_u64_pair();
			Identifier { hi, lo }
		}
	}

	impl From<Identifier> for uuid::Uuid {
		fn from(value: Identifier) -> Self {
			uuid::Uuid::from_u64_pair(value.hi, value.lo)
		}
	}

	impl From<&Identifier> for uuid::Uuid {
		fn from(value: &Identifier) -> Self {
			uuid::Uuid::from_u64_pair(value.hi, value.lo)
		}
	}

	impl Identifier {
		pub fn uuid(&self) -> uuid::Uuid {
			uuid::Uuid::from(self)
		}
	}
}

/// filetree related types
pub mod files {
	tonic::include_proto!("files");
}

/// buffer synchronisation protocol types and procedures
pub mod buffer {
	tonic::include_proto!("buffer");
}

/// cursor position protocol types and procedures
pub mod cursor {
	tonic::include_proto!("cursor");

	impl From<RowCol> for (i32, i32) {
		fn from(pos: RowCol) -> (i32, i32) {
			(pos.row, pos.col)
		}
	}

	impl From<(i32, i32)> for RowCol {
		fn from((row, col): (i32, i32)) -> Self {
			RowCol { row, col }
		}
	}

	impl PartialOrd for RowCol {
		fn partial_cmp(&self, other: &Self) -> Option<std::cmp::Ordering> {
			match self.row.partial_cmp(&other.row) {
				Some(core::cmp::Ordering::Equal) => {}
				ord => return ord,
			}
			self.col.partial_cmp(&other.col)
		}
	}
}

/// workspace state protocol types and procedures
pub mod workspace {
	tonic::include_proto!("workspace");
}

/// session management protocol types and procedures
pub mod session {
	tonic::include_proto!("session");
}

/// authentication and authorization protocol types and procedures
pub mod auth {
	tonic::include_proto!("auth");
}