Add MidiInputPort::id() and MidiOutputPort::id()

src/backend/alsa/mod.rs

@@ -143,6 +143,12 @@ pub struct MidiInputPort {
     addr: Addr,
 }
 
+impl MidiInputPort {
+    pub fn id(&self) -> String {
+        format!("{}:{}", self.addr.client, self.addr.port)
+    }
+}
+
 pub struct MidiInputConnection<T: 'static> {
     subscription: Option<PortSubscribe>,
     thread: Option<JoinHandle<(HandlerData<T>, T)>>,
@@ -523,6 +529,12 @@ pub struct MidiOutputPort {
     addr: Addr,
 }
 
+impl MidiOutputPort {
+    pub fn id(&self) -> String {
+        format!("{}:{}", self.addr.client, self.addr.port)
+    }
+}
+
 pub struct MidiOutputConnection {
     seq: Option<Seq>,
     vport: i32,

src/backend/coremidi/mod.rs

@@ -23,12 +23,22 @@ pub struct MidiInputPort {
     source: Arc<Source>,
 }
 
+impl MidiInputPort {
+    pub fn id(&self) -> String {
+        self.source
+            .unique_id()
+            // According to macos docs "The system assigns unique IDs to all objects.", so I think we can ignore this case
+            .unwrap_or(0)
+            .to_string()
+    }
+}
+
 impl PartialEq for MidiInputPort {
     fn eq(&self, other: &Self) -> bool {
         if let (Some(id1), Some(id2)) = (self.source.unique_id(), other.source.unique_id()) {
             id1 == id2
         } else {
-            // Acording to macos docs "The system assigns unique IDs to all objects.", so I think we can ignore this case
+            // According to macos docs "The system assigns unique IDs to all objects.", so I think we can ignore this case
             false
         }
     }
@@ -292,6 +302,16 @@ pub struct MidiOutputPort {
     dest: Arc<Destination>,
 }
 
+impl MidiOutputPort {
+    pub fn id(&self) -> String {
+        self.dest
+            .unique_id()
+            // According to macos docs "The system assigns unique IDs to all objects.", so I think we can ignore this case
+            .unwrap_or(0)
+            .to_string()
+    }
+}
+
 impl PartialEq for MidiOutputPort {
     fn eq(&self, other: &Self) -> bool {
         if let (Some(id1), Some(id2)) = (self.dest.unique_id(), other.dest.unique_id()) {

src/backend/jack/mod.rs

@@ -29,6 +29,12 @@ pub struct MidiInputPort {
     name: CString,
 }
 
+impl MidiInputPort {
+    pub fn id(&self) -> String {
+        self.name.to_string_lossy().to_string()
+    }
+}
+
 pub struct MidiInputConnection<T> {
     handler_data: Box<InputHandlerData<T>>,
     client: Option<Client>,
@@ -258,6 +264,12 @@ pub struct MidiOutputPort {
     name: CString,
 }
 
+impl MidiOutputPort {
+    pub fn id(&self) -> String {
+        self.name.to_string_lossy().to_string()
+    }
+}
+
 pub struct MidiOutputConnection {
     handler_data: Box<OutputHandlerData>,
     client: Option<Client>,

src/backend/webmidi/mod.rs

@@ -95,6 +95,12 @@ pub struct MidiInputPort {
     input: web_sys::MidiInput,
 }
 
+impl MidiInputPort {
+    pub fn id(&self) -> String {
+        self.input.id()
+    }
+}
+
 pub struct MidiInput {
     ignore_flags: Ignore,
 }
@@ -223,6 +229,12 @@ pub struct MidiOutputPort {
     output: web_sys::MidiOutput,
 }
 
+impl MidiOutputPort {
+    pub fn id(&self) -> String {
+        self.output.id()
+    }
+}
+
 pub struct MidiOutput {}
 
 impl MidiOutput {

src/backend/winmm/mod.rs

@@ -65,6 +65,12 @@ pub struct MidiInputPort {
     interface_id: Box<[u16]>,
 }
 
+impl MidiInputPort {
+    pub fn id(&self) -> String {
+        String::from_utf16_lossy(&self.interface_id)
+    }
+}
+
 impl PartialEq for MidiInputPort {
     fn eq(&self, other: &Self) -> bool {
         self.interface_id == other.interface_id
@@ -396,6 +402,12 @@ pub struct MidiOutputPort {
     interface_id: Box<[u16]>,
 }
 
+impl MidiOutputPort {
+    pub fn id(&self) -> String {
+        String::from_utf16_lossy(&self.interface_id)
+    }
+}
+
 impl PartialEq for MidiOutputPort {
     fn eq(&self, other: &Self) -> bool {
         self.interface_id == other.interface_id

src/backend/winrt/mod.rs

@@ -17,6 +17,12 @@ pub struct MidiInputPort {
     id: HSTRING,
 }
 
+impl MidiInputPort {
+    pub fn id(&self) -> String {
+        self.id.to_string_lossy()
+    }
+}
+
 pub struct MidiInput {
     selector: HSTRING,
     ignore_flags: Ignore,
@@ -189,6 +195,12 @@ pub struct MidiOutputPort {
     id: HSTRING,
 }
 
+impl MidiOutputPort {
+    pub fn id(&self) -> String {
+        self.id.to_string_lossy()
+    }
+}
+
 pub struct MidiOutput {
     selector: HSTRING,
 }

src/common.rs

@@ -41,6 +41,14 @@ pub struct MidiInputPort {
     pub(crate) imp: MidiInputPortImpl,
 }
 
+impl MidiInputPort {
+    /// Get a unique stable identifier for this port.
+    /// This identifier must be treated as an opaque string.
+    pub fn id(&self) -> String {
+        self.imp.id()
+    }
+}
+
 /// A collection of input ports.
 pub type MidiInputPorts = Vec<MidiInputPort>;
 
@@ -84,6 +92,11 @@ impl MidiInput {
         self.imp.port_name(&port.imp)
     }
 
+    /// Get a MIDI input port by its unique identifier.
+    pub fn find_port_by_id(&self, id: String) -> Option<MidiInputPort> {
+        self.ports().into_iter().find(|port| port.id() == id)
+    }
+
     /// Connect to a specified MIDI input port in order to receive messages.
     /// For each incoming MIDI message, the provided `callback` function will
     /// be called. The first parameter of the callback function is a timestamp
@@ -199,6 +212,14 @@ pub struct MidiOutputPort {
     pub(crate) imp: MidiOutputPortImpl,
 }
 
+impl MidiOutputPort {
+    /// Get a unique stable identifier for this port.
+    /// This identifier must be treated as an opaque string.
+    pub fn id(&self) -> String {
+        self.imp.id()
+    }
+}
+
 /// A collection of output ports.
 pub type MidiOutputPorts = Vec<MidiOutputPort>;
 
@@ -235,6 +256,11 @@ impl MidiOutput {
         self.imp.port_name(&port.imp)
     }
 
+    /// Get a MIDI output port by its unique identifier.
+    pub fn find_port_by_id(&self, id: String) -> Option<MidiOutputPort> {
+        self.ports().into_iter().find(|port| port.id() == id)
+    }
+
     /// Connect to a specified MIDI output port in order to send messages.
     /// The connection will be kept open as long as the returned
     /// `MidiOutputConnection` is kept alive.