bookmarkt 0.0.3

A Netscape Bookmark File format parser
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

//! Contains the [Item] enum that dispatches all the implementations of the items.
use kuchiki::NodeRef;
use serde::Serialize;

use crate::Bookmark;
use crate::Folder;

/// Represents all available item types of the Microsoft's Netscape Bookmark File format.
///
/// * TODO The `feed` item should represent a RSS feed.
/// * TODO The `web slice` item represents a legacy [Web Slice] object.
///
/// [Web Slice]: https://docs.microsoft.com/en-us/previous-versions/windows/desktop/cc956158(v=vs.85)
#[derive(Clone, Debug, Serialize)]
#[serde(untagged)]
pub enum Item {
    /// The `Subfolder` item is implemented by the [Folder] struct.
    Subfolder(Folder),

    /// The `Shortcut` item is represented by a [Bookmark].
    Shortcut(Bookmark),
}

impl Item {
    /// Creates a [Folder] or a [Bookmark] models from any given item.
    pub fn from_node(node: &NodeRef) -> Option<Self> {
        if let Some(bookmark) = Bookmark::from_node(node) {
            Some(Item::Shortcut(bookmark))
        } else if let Some(folder) = Folder::from_node(node) {
            Some(Item::Subfolder(folder))
        } else {
            None
        }
    }

    /// Checks if the item is a shortcut
    pub fn is_shortcut(&self) -> bool {
        match self {
            Item::Subfolder(_) => false,
            Item::Shortcut(_) => true,
        }
    }

    /// Takes a [Bookmark] out of the shortcut item
    pub fn take_shortcut(&self) -> Option<&Bookmark> {
        match self {
            Item::Subfolder(_) => None,
            Item::Shortcut(bookmark) => Some(bookmark),
        }
    }

    /// Checks if the item is a subfolder
    pub fn is_subfolder(&self) -> bool {
        match self {
            Item::Subfolder(_) => true,
            Item::Shortcut(_) => false,
        }
    }

    /// Takes a [Folder] out of the subfolder item
    pub fn take_subfolder(&self) -> Option<&Folder> {
        match self {
            Item::Subfolder(folder) => Some(folder),
            Item::Shortcut(_) => None,
        }
    }
}

impl PartialEq for Item {
    fn eq(&self, other: &Self) -> bool {
        match (self, other) {
            (Item::Subfolder(f1), Item::Subfolder(f2)) => f1 == f2,
            (Item::Shortcut(b1), Item::Shortcut(b2)) => b1 == b2,
            _ => false,
        }
    }
}