deterministic id generator per module (#5811)

* deterministic id generator per module

Signed-off-by: Jess Frazelle <github@jessfraz.com>

* non

Signed-off-by: Jess Frazelle <github@jessfraz.com>

* updates

Signed-off-by: Jess Frazelle <github@jessfraz.com>

* do not remake the planes if they are alreaady made;

Signed-off-by: Jess Frazelle <github@jessfraz.com>

* updates

Signed-off-by: Jess Frazelle <github@jessfraz.com>

* do not remake the planes if they are alreaady made;

Signed-off-by: Jess Frazelle <github@jessfraz.com>

* clippy

Signed-off-by: Jess Frazelle <github@jessfraz.com>

---------

Signed-off-by: Jess Frazelle <github@jessfraz.com>

rust/kcl-lib/src/execution/id_generator.rs

@@ -0,0 +1,83 @@
+//! A generator for ArtifactIds that can be stable across executions.
+
+use crate::execution::ModuleId;
+
+const NAMESPACE_KCL: uuid::Uuid = uuid::uuid!("efcd6508-4ce6-4a09-8317-e6a6994a3cd7");
+
+/// A generator for ArtifactIds that can be stable across executions.
+#[derive(Debug, Clone, Default, PartialEq)]
+pub struct IdGenerator {
+    module_id: Option<ModuleId>,
+    next_id: u64,
+}
+
+impl IdGenerator {
+    pub fn new(module_id: Option<ModuleId>) -> Self {
+        Self { module_id, next_id: 0 }
+    }
+
+    pub fn next_uuid(&mut self) -> uuid::Uuid {
+        let next_id = self.next_id;
+
+        let next = format!(
+            "{} {}",
+            self.module_id.map(|id| id.to_string()).unwrap_or("none".to_string()),
+            next_id
+        );
+        let next_uuid = uuid::Uuid::new_v5(&NAMESPACE_KCL, next.as_bytes());
+
+        self.next_id += 1;
+
+        next_uuid
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_id_generator() {
+        let mut generator = IdGenerator::new(Some(ModuleId::default()));
+
+        let uuid1 = generator.next_uuid();
+        let uuid2 = generator.next_uuid();
+
+        assert_ne!(uuid1, uuid2);
+    }
+
+    #[test]
+    // Test that the same generator produces the same UUIDs.
+    fn test_id_generator_stable() {
+        let mut generator = IdGenerator::new(Some(ModuleId::default()));
+
+        let uuid1 = generator.next_uuid();
+        let uuid2 = generator.next_uuid();
+
+        let mut generator = IdGenerator::new(Some(ModuleId::default()));
+
+        let uuid3 = generator.next_uuid();
+        let uuid4 = generator.next_uuid();
+
+        assert_eq!(uuid1, uuid3);
+        assert_eq!(uuid2, uuid4);
+    }
+
+    #[test]
+    // Generate 20 uuids and make sure all are unique.
+    fn test_id_generator_unique() {
+        let mut generator = IdGenerator::new(Some(ModuleId::default()));
+
+        let mut uuids = Vec::new();
+
+        for _ in 0..20 {
+            uuids.push(generator.next_uuid());
+        }
+
+        for i in 0..uuids.len() {
+            for j in i + 1..uuids.len() {
+                assert_ne!(uuids[i], uuids[j]);
+            }
+        }
+    }
+}