rvlib/tools/
attributes.rs

1use tracing::info;
2
3use super::Manipulate;
4use crate::{
5    annotations_accessor_mut,
6    events::Events,
7    file_util::PathPair,
8    history::{History, Record},
9    make_tool_transform,
10    result::trace_ok_err,
11    tools_data::{
12        AttributesToolData,
13        attributes_data::set_attrmap_val,
14        parameters::{ParamMap, ParamVal},
15    },
16    tools_data_accessors,
17    world::World,
18    world_annotations_accessor,
19};
20use std::mem;
21const MISSING_DATA_MSG: &str = "Missing data for Attributes";
22pub const ACTOR_NAME: &str = "Attributes";
23annotations_accessor_mut!(
24    ACTOR_NAME,
25    attributes_mut,
26    "Attribute didn't work",
27    ParamMap
28);
29world_annotations_accessor!(ACTOR_NAME, attributes, "Attribute didn't work", ParamMap);
30tools_data_accessors!(
31    ACTOR_NAME,
32    MISSING_DATA_MSG,
33    attributes_data,
34    AttributesToolData,
35    attributes,
36    attributes_mut
37);
38
39fn propagate_annos(
40    mut annos: ParamMap,
41    attr_names: &[String],
42    to_propagate: &[(usize, ParamVal)],
43) -> ParamMap {
44    for (attr_idx, val) in to_propagate {
45        if let Some(attr_val) = annos.get_mut(&attr_names[*attr_idx]) {
46            *attr_val = val.clone();
47        }
48    }
49    annos
50}
51
52fn get_buffers(world: &World) -> Vec<String> {
53    let annos = get_annos(world);
54    let data = get_specific(world);
55    if let (Some(data), Some(annos)) = (data, annos) {
56        data.attr_names()
57            .iter()
58            .map(|attr_name| {
59                if let Some(attrval) = annos.get(attr_name) {
60                    attrval.to_string()
61                } else {
62                    "".to_string()
63                }
64            })
65            .collect()
66    } else {
67        vec![]
68    }
69}
70fn propagate_buffer(
71    mut attribute_buffer: Vec<String>,
72    to_propagate: &[(usize, ParamVal)],
73) -> Vec<String> {
74    for (attr_idx, val) in to_propagate {
75        attribute_buffer[*attr_idx] = val.to_string();
76    }
77    attribute_buffer
78}
79fn file_change(mut world: World) -> World {
80    use_currentimageshape_for_annos(&mut world);
81    let attr_buffers = get_buffers(&world);
82    let annos = get_annos_mut(&mut world).map(mem::take);
83    let data = get_specific_mut(&mut world);
84
85    if let (Some(data), Some(mut annos)) = (data, annos) {
86        for (attr_name, attr_val) in data.attr_names().iter().zip(data.attr_vals().iter()) {
87            if !annos.contains(attr_name) {
88                set_attrmap_val(&mut annos, attr_name, attr_val);
89            }
90        }
91
92        // put string representations of the attribute values into the buffer
93        let attr_buffers = propagate_buffer(attr_buffers, &data.to_propagate_attr_val);
94        for (i, buffer) in attr_buffers.into_iter().enumerate() {
95            *data.attr_value_buffer_mut(i) = buffer;
96        }
97
98        annos = propagate_annos(annos, data.attr_names(), &data.to_propagate_attr_val);
99
100        if let Some(annos_) = get_annos_mut(&mut world) {
101            *annos_ = annos;
102        }
103    }
104    let current = get_annos(&world).cloned();
105    if let Some(data) = get_specific_mut(&mut world) {
106        data.current_attr_map = current;
107    }
108    world
109}
110fn add_attribute(
111    mut world: World,
112    mut history: History,
113    suppress_exists_err: bool,
114) -> (World, History) {
115    let attr_map_tmp = get_annos_mut(&mut world).map(mem::take);
116    let data = get_specific_mut(&mut world);
117
118    if let (Some(mut attr_map_tmp), Some(data)) = (attr_map_tmp, data) {
119        let new_attr_name = data.new_attr_name.clone();
120        if data.attr_names().contains(&new_attr_name) && !suppress_exists_err {
121            tracing::error!("New attribute {new_attr_name} could not be created, already exists");
122        } else {
123            let new_attr_val = data.new_attr_val.clone();
124            for (_, (val_map, _)) in data.anno_iter_mut() {
125                set_attrmap_val(val_map, &new_attr_name, &new_attr_val);
126            }
127            set_attrmap_val(&mut attr_map_tmp, &new_attr_name, &new_attr_val);
128            if let Some(a) = get_annos_mut(&mut world) {
129                a.clone_from(&attr_map_tmp);
130            }
131            if let Some(data) = get_specific_mut(&mut world) {
132                data.current_attr_map = Some(attr_map_tmp);
133                data.push(new_attr_name, new_attr_val);
134                history.push(Record::new(world.clone(), ACTOR_NAME));
135            }
136        }
137    }
138    if let Some(data) = get_specific_mut(&mut world) {
139        data.options.is_addition_triggered = false;
140        data.new_attr_name = String::new();
141        data.new_attr_val = ParamVal::default();
142    }
143    (world, history)
144}
145
146fn check_remove(mut world: World, mut history: History) -> (World, History) {
147    if let Some(removal_idx) = get_specific(&world).map(|d| d.options.removal_idx) {
148        let data = get_specific_mut(&mut world);
149        if let (Some(data), Some(removal_idx)) = (data, removal_idx) {
150            data.remove_attr(removal_idx);
151            history.push(Record::new(world.clone(), ACTOR_NAME));
152        }
153        if let Some(removal_idx) = get_specific_mut(&mut world).map(|d| &mut d.options.removal_idx)
154        {
155            *removal_idx = None;
156        }
157    }
158    (world, history)
159}
160
161#[derive(Clone, Copy, Debug)]
162pub struct Attributes;
163
164impl Manipulate for Attributes {
165    fn new() -> Self
166    where
167        Self: Sized,
168    {
169        Self
170    }
171
172    fn on_activate(&mut self, mut world: World) -> World {
173        let data = get_data_mut(&mut world);
174        if let Some(data) = trace_ok_err(data) {
175            data.menu_active = true;
176        }
177        file_change(world)
178    }
179    fn on_deactivate(&mut self, mut world: World) -> World {
180        let data = get_data_mut(&mut world);
181        if let Some(data) = trace_ok_err(data) {
182            data.menu_active = false;
183        }
184        world
185    }
186    fn on_filechange(&mut self, world: World, history: History) -> (World, History) {
187        (file_change(world), history)
188    }
189    fn events_tf(
190        &mut self,
191        mut world: World,
192        mut history: History,
193        _event: &Events,
194    ) -> (World, History) {
195        let is_addition_triggered = get_specific(&world).map(|d| d.options.is_addition_triggered);
196        if is_addition_triggered == Some(true) {
197            // handle addition triggered in the GUI
198            (world, history) = add_attribute(world, history, false);
199        }
200        let attr_data = get_specific_mut(&mut world);
201        if let Some(attr_data) = attr_data
202            && let Some(rename_src_idx) = attr_data.options.rename_src_idx
203        {
204            let from_name = &attr_data.attr_names()[rename_src_idx].clone();
205            let to_name = &attr_data.new_attr_name.clone();
206            tracing::info!("Rename attribute {from_name} to {to_name}");
207            attr_data.rename(from_name, to_name);
208            attr_data.options.rename_src_idx = None;
209        }
210        let is_update_triggered = get_specific(&world).map(|d| d.options.is_update_triggered);
211        if is_update_triggered == Some(true) {
212            info!("update attr");
213            let current_from_menu_clone =
214                get_specific(&world).and_then(|d| d.current_attr_map.clone());
215            if let (Some(mut cfm), Some(anno)) =
216                (current_from_menu_clone, get_annos_mut(&mut world))
217            {
218                *anno = mem::take(&mut cfm);
219            }
220            if let Some(update_current_attr_map) =
221                get_specific_mut(&mut world).map(|d| &mut d.options.is_update_triggered)
222            {
223                *update_current_attr_map = false;
224            }
225        }
226        (world, history) = check_remove(world, history);
227
228        let is_export_triggered =
229            get_specific(&world).map(|d| d.options.import_export_trigger.export_triggered());
230        if is_export_triggered == Some(true) {
231            let ssh_cfg = world.data.meta_data.ssh_cfg.clone();
232            let attr_data = get_specific(&world);
233            let export_only_opened_folder =
234                attr_data.map(|d| d.options.export_only_opened_folder) == Some(true);
235            let key_filter = if export_only_opened_folder {
236                world
237                    .data
238                    .meta_data
239                    .opened_folder
240                    .as_ref()
241                    .map(PathPair::path_relative)
242            } else {
243                None
244            };
245            let annos_str = get_specific(&world)
246                .and_then(|d| trace_ok_err(d.serialize_annotations(key_filter)));
247            if let (Some(annos_str), Some(data)) = (annos_str, get_specific(&world))
248                && trace_ok_err(data.export_path.conn.write(
249                    &annos_str,
250                    &data.export_path.path,
251                    ssh_cfg.as_ref(),
252                ))
253                .is_some()
254            {
255                info!("exported annotations to {:?}", data.export_path.path);
256            }
257
258            if let Some(export_triggered) =
259                get_specific_mut(&mut world).map(|d| &mut d.options.import_export_trigger)
260            {
261                export_triggered.untrigger_export();
262            }
263        }
264        let is_import_triggered =
265            get_specific(&world).map(|d| d.options.import_export_trigger.import_triggered());
266        if is_import_triggered == Some(true) {
267            tracing::info!("import attr tiggered");
268            let ssh_cfg = world.data.meta_data.ssh_cfg.clone();
269            let cur_prj = world.data.meta_data.prj_path().map(|p| p.to_path_buf());
270            let attr_data = get_specific_mut(&mut world);
271            let imported_map = attr_data.and_then(|data| {
272                let in_path = &data.export_path.path;
273                tracing::info!("importing attributes from {in_path:?}");
274                let json_str = trace_ok_err(data.export_path.conn.read(in_path, ssh_cfg.as_ref()));
275                if let Some(s) = json_str {
276                    trace_ok_err(AttributesToolData::deserialize_annotations(
277                        &s,
278                        cur_prj.as_deref(),
279                    ))
280                } else {
281                    None
282                }
283            });
284            if let Some(imported_map) = &imported_map {
285                // add attributes in case they don't exist
286                for (_, (attr_map, _)) in imported_map.iter() {
287                    for (attr_name, attr_val) in attr_map.iter() {
288                        let data = get_specific_mut(&mut world);
289                        if let Some(d) = data {
290                            d.new_attr_name = attr_name.clone();
291                            d.new_attr_val = attr_val.clone().reset();
292                        }
293                        tracing::debug!("inserting attr {attr_name} with value {attr_val}");
294                        (world, history) = add_attribute(world, history, true);
295                    }
296                }
297            }
298            if let Some(imported_map) = imported_map {
299                let data = get_specific_mut(&mut world);
300                if let Some(d) = data {
301                    d.merge_map(imported_map);
302                }
303            }
304            let annos = get_annos(&world).cloned();
305            let attr_buffer = get_buffers(&world);
306            if let (Some(data), Some(annos)) = (get_specific_mut(&mut world), annos) {
307                data.current_attr_map = Some(annos);
308                data.set_new_attr_value_buffer(attr_buffer);
309            }
310        }
311        if let Some(import_trigger) =
312            get_specific_mut(&mut world).map(|d| &mut d.options.import_export_trigger)
313        {
314            import_trigger.untrigger_import();
315        }
316        make_tool_transform!(self, world, history, event, [])
317    }
318}
319#[cfg(test)]
320use {
321    crate::tracing_setup::init_tracing_for_tests,
322    crate::types::{ExtraIms, ViewImage},
323    image::DynamicImage,
324    std::collections::HashMap,
325    std::fs,
326    std::path::Path,
327};
328#[cfg(test)]
329pub(super) fn test_data() -> (World, History) {
330    use std::path::Path;
331
332    use crate::ToolsDataMap;
333
334    let im_test = DynamicImage::ImageRgb8(ViewImage::new(64, 64));
335    let mut world = World::from_real_im(
336        im_test,
337        ExtraIms::default(),
338        ToolsDataMap::new(),
339        None,
340        Some("superimage.png".to_string()),
341        Path::new("superimage.png"),
342        Some(0),
343    );
344    world.data.meta_data.flags.is_loading_screen_active = Some(false);
345
346    let history = History::default();
347    (world, history)
348}
349#[test]
350fn test_import_export() {
351    init_tracing_for_tests();
352    fn test(testpath: &Path) {
353        let (mut world, history) = test_data();
354        let data = get_specific_mut(&mut world).unwrap();
355        let json_str = fs::read_to_string(testpath).unwrap();
356        let reference_data = AttributesToolData::deserialize_annotations(&json_str, None).unwrap();
357        tracing::debug!("reference_data: {:?}", reference_data);
358        data.export_path.path = testpath.to_path_buf();
359        data.options.import_export_trigger.trigger_import();
360        let events = Events::default();
361        let (world, _) = Attributes {}.events_tf(world, history, &events);
362        let annos = world.data.tools_data_map[ACTOR_NAME]
363            .specifics
364            .attributes()
365            .unwrap()
366            .anno_iter()
367            .collect::<HashMap<_, _>>();
368        tracing::debug!("annos: {:?}", annos);
369        for k in reference_data.keys() {
370            tracing::debug!("k: {:?}", k);
371            let (annos, _) = annos.get(k).unwrap();
372            let (ref_annos, _) = &reference_data[k];
373            assert_eq!(annos, ref_annos);
374        }
375        let current = get_annos(&world).unwrap();
376        for v in current.values() {
377            assert!(v.is_default());
378        }
379    }
380    let testpath = Path::new("resources/test_data/attr_import.json");
381    test(testpath);
382    let testpath = Path::new("resources/test_data/attr_import_untagged.json");
383    test(testpath);
384}
385
386#[test]
387fn test_add() {
388    init_tracing_for_tests();
389    let mut attr_tool = Attributes::new();
390    let events = Events::default();
391    let (mut world, history) = test_data();
392    let attr_data = get_specific_mut(&mut world).unwrap();
393    attr_data.options.is_addition_triggered = true;
394    attr_data.new_attr_name = "a attr".to_string();
395    attr_data.new_attr_val = ParamVal::Int(Some(1));
396    let (mut world, history) = attr_tool.events_tf(world, history, &events);
397    let attr_data = get_specific_mut(&mut world).unwrap();
398    attr_data.options.is_addition_triggered = true;
399    attr_data.new_attr_name = "c attr".to_string();
400    attr_data.new_attr_val = ParamVal::Int(Some(2));
401    let (mut world, history) = attr_tool.events_tf(world, history, &events);
402    let attr_data = get_specific_mut(&mut world).unwrap();
403    attr_data.options.is_addition_triggered = true;
404    attr_data.new_attr_name = "b attr".to_string();
405    attr_data.new_attr_val = ParamVal::Int(Some(3));
406    let (world, _) = attr_tool.events_tf(world, history, &events);
407    let data = get_specific(&world).unwrap();
408    let cam = data.current_attr_map.as_ref().unwrap();
409    let c_attr_val = cam.get("c attr").unwrap();
410    assert_eq!(c_attr_val, &ParamVal::Int(Some(2)));
411    let b_attr_val = cam.get("b attr").unwrap();
412    assert_eq!(b_attr_val, &ParamVal::Int(Some(3)));
413    let a_attr_val = cam.get("a attr").unwrap();
414    assert_eq!(a_attr_val, &ParamVal::Int(Some(1)));
415
416    // cur map is a BTree and hence sorted
417    assert_eq!(data.attr_names(), &["a attr", "b attr", "c attr"]);
418    assert_eq!(
419        data.attr_vals(),
420        &[
421            ParamVal::Int(Some(1)),
422            ParamVal::Int(Some(3)),
423            ParamVal::Int(Some(2)),
424        ]
425    );
426}
427#[test]
428fn test_rm_add() {
429    init_tracing_for_tests();
430    let (mut world, history) = test_data();
431    let attr_data = get_specific_mut(&mut world).unwrap();
432    attr_data.options.is_addition_triggered = true;
433    attr_data.new_attr_name = "test_attr".to_string();
434    attr_data.new_attr_val = ParamVal::Str("123".into());
435    let (mut world, history) = add_attribute(world, history, false);
436    let attr_data = get_specific_mut(&mut world).unwrap();
437    attr_data.options.removal_idx = Some(0);
438    let (mut world, _) = check_remove(world, history);
439    let attr_data = get_specific_mut(&mut world).unwrap();
440    assert!(!attr_data.options.is_addition_triggered);
441    assert!(attr_data.options.removal_idx.is_none());
442    assert_eq!(
443        attr_data.current_attr_map.as_ref().map(|cam| cam.len()),
444        Some(0)
445    );
446}