soukoban 0.1.2

A library provides the implementation of some algorithms and data structures related to Sokoban
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

//! Error types.

use thiserror::Error;

/// An error which can be returned when parsing a level.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum ParseLevelError {
    /// There is a duplicate metadata with the same key.
    #[error("duplicate metadata with key `{0}`")]
    DuplicateMetadata(String),
    /// There is an unterminated block comment.
    #[error("unterminated block comment")]
    UnterminatedBlockComment,
    /// There is no map data.
    #[error("no map data")]
    NoMap,
    /// An error occurred while parsing the map.
    #[error(transparent)]
    ParseMapError(#[from] ParseMapError),
}

/// An error which can be returned when parsing a map.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum ParseMapError {
    /// There is no player. There should be exactly one player.
    #[error("no player")]
    NoPlayer,
    /// There are multiple players. There should be exactly one player.
    #[error("more than one player")]
    MoreThanOnePlayer,
    /// The number of boxes and goals do not match. They should be equal.
    #[error("mismatch between number of boxes and goals")]
    BoxGoalMismatch,
    /// There are no boxes or goals. There should be at least one box and one
    /// goal.
    #[error("no box or goal")]
    NoBoxOrGoal,
    /// Contains non-XSB format character.
    #[error("invalid character: `{0}`")]
    InvalidCharacter(char),
    /// An error occurred during RLE decoding.
    #[error(transparent)]
    DecodeRleError(#[from] DecodeRleError),
    /// Actions are invalid and cannot be used to create level.
    #[error("invalid actions")]
    InvalidActions,
}

/// An error which can be returned when parsing actions.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum ParseActionsError {
    /// An error which can be returned when parsing a action.
    #[error(transparent)]
    ParseActionError(#[from] ParseActionError),
    /// An error occurred during RLE decoding.
    #[error(transparent)]
    DecodeRleError(#[from] DecodeRleError),
}

/// An error which can be returned when parsing a action.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum ParseActionError {
    /// Contains non-LURD format character.
    #[error("invalid character: `{0}`")]
    InvalidCharacter(char),
}

/// An error which can be returned when encoding RLE.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum EncodeRleError {
    /// Encountered an unencodable numeric character.
    #[error("numeric character encountered: `{0}`")]
    NumericCharacter(char),
}

/// An error which can be returned when decoding RLE.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum DecodeRleError {
    /// The decoded string ends with digits.
    #[error("end with digits: `{0}`")]
    EndWithDigits(usize),
}

/// An error which can be returned when searching for a solution.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum SearchError {
    /// No solution found.
    #[error("no solution found")]
    NoSolution,
}

/// An error which can be returned when level do/undo/redo actions.
#[derive(Error, Clone, Eq, PartialEq, Debug)]
pub enum ActionError {
    /// Movement in the specified direction is blocked.
    #[error("movement in the specified direction is blocked")]
    MoveBlocked,
    /// Push in the specified direction is blocked.
    #[error("push in the specified direction is blocked")]
    PushBlocked,
    /// No actions available.
    #[error("no actions")]
    NoActions,
    /// No undone actions available.
    #[error("no undone actions")]
    NoUndoneActions,
}