Add get_parameter_by_uuid to CircuitData (#12926)

* Initial: Add `parameter_by_uuid` to `CircuitData`
- This method receives a `uuid` instance from Python and returns the parameter object identified by said `uuid`.

* Fix: Make `get_parameter_by_uuid` a rust only method.

crates/circuit/src/circuit_data.rs

@@ -1284,6 +1284,11 @@ impl CircuitData {
         }
         Ok(())
     }
+
+    /// Retrieves the python `Param` object based on its `ParameterUuid`.
+    pub fn get_parameter_by_uuid(&self, uuid: ParameterUuid) -> Option<&Py<PyAny>> {
+        self.param_table.py_parameter_by_uuid(uuid)
+    }
 }
 
 /// Helper struct for `assign_parameters` to allow use of `Param::extract_no_coerce` in

crates/circuit/src/parameter_table.rs

@@ -225,6 +225,11 @@ impl ParameterTable {
             .map(|uuid| &self.by_uuid[uuid].object)
     }
 
+    /// Lookup the Python parameter object by uuid.
+    pub fn py_parameter_by_uuid(&self, uuid: ParameterUuid) -> Option<&Py<PyAny>> {
+        self.by_uuid.get(&uuid).map(|param| &param.object)
+    }
+
     /// Get the (maybe cached) Python list of the sorted `Parameter` objects.
     pub fn py_parameters<'py>(&mut self, py: Python<'py>) -> Bound<'py, PyList> {
         if let Some(py_parameters) = self.py_parameters.as_ref() {