aria-core 0.1.0

Generic adaptive sequencing engine — zero dependencies, domain-agnostic. Suggest(), feedback(). Works from item one.
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

use std::fmt;

#[derive(Debug, PartialEq)]
pub enum AriaError {
    /// No items registered in the engine
    NoItems,
    /// All items filtered out (prereqs, already seen, etc.)
    NoEligibleItems,
    /// User ID not found
    UserNotFound(String),
    /// Item ID not found
    ItemNotFound(String),
    /// Prerequisite graph contains a cycle
    CyclicPrerequisite(String),
    /// Factor list is empty — engine needs at least one factor
    NoFactors,
    /// Serialisation / deserialisation failure
    SerialisationError(String),
}

impl fmt::Display for AriaError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            AriaError::NoItems => write!(f, "No items registered"),
            AriaError::NoEligibleItems => write!(f, "No eligible items for this user"),
            AriaError::UserNotFound(id) => write!(f, "User not found: {id}"),
            AriaError::ItemNotFound(id) => write!(f, "Item not found: {id}"),
            AriaError::CyclicPrerequisite(id) => {
                write!(f, "Cyclic prerequisite detected at item: {id}")
            }
            AriaError::NoFactors => write!(f, "Engine has no factors registered"),
            AriaError::SerialisationError(msg) => write!(f, "Serialisation error: {msg}"),
        }
    }
}

impl std::error::Error for AriaError {}