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

//! Реализация структуры, описывающей ошибки кодирования или декодирования GFF

use std::borrow::Cow;
use std::fmt;
use std::error;
use std::io;
use std::result;
use std::str::Utf8Error;
use std::string::FromUtf8Error;
use serde::de;
use serde::ser;

use crate::parser::Token;
use self::Error::*;

/// Виды ошибок, который могут возникнуть при чтении и интерпретации GFF-файла
#[derive(Debug)]
pub enum Error {
  /// Произошла ошибка чтения или записи из/в нижележащего буфера
  Io(io::Error),
  /// Произошла ошибка кодирования или декодирования строки, например, из-за использования
  /// символа, не поддерживаемого кодировкой
  Encoding(Cow<'static, str>),
  /// В файле встретилось значение неизвестного типа, хранящее указанное значение
  UnknownValue {
    /// Идентификатор типа значения
    tag: u32,
    /// Значение, которое было записано в файле для данного тега
    value: u32
  },
  /// Разбор уже завершен
  ParsingFinished,
  /// Некорректное значение для метки. Метка не должна превышать по длине 16 байт в UTF-8,
  /// но указанное значение больше. Ошибка содержит длину текста, который пытаются преобразовать
  TooLongLabel(usize),
  /// При десериализации был обнаружен указанный токен, хотя ожидался не он.
  /// Ожидаемые значения описаны в первом параметре
  Unexpected(&'static str, Token),
  /// Ошибка, возникшая при десериализации
  Deserialize(String),
  /// Ошибка, возникшая при сериализации
  Serialize(String),
}
/// Тип результата, используемый в методах данной библиотеки
pub type Result<T> = result::Result<T, Error>;

impl fmt::Display for Error {
  fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
    match *self {
      Io(ref err) => err.fmt(fmt),
      Encoding(ref msg) => msg.fmt(fmt),
      UnknownValue { tag, value } => write!(fmt, "Unknown field value (tag: {}, value: {})", tag, value),
      ParsingFinished => write!(fmt, "Parsing finished"),
      TooLongLabel(len) => write!(fmt, "Too long label: label can contain up to 16 bytes, but string contains {} bytes in UTF-8", len),
      Unexpected(ref expected, ref actual) => write!(fmt, "Expected {}, but {:?} found", expected, actual),
      Deserialize(ref msg) => msg.fmt(fmt),
      Serialize(ref msg) => msg.fmt(fmt),
    }
  }
}

impl error::Error for Error {
  fn source(&self) -> Option<&(dyn error::Error + 'static)> {
    match *self {
      Io(ref err) => Some(err),
      _ => None,
    }
  }
}

impl From<io::Error> for Error {
  fn from(value: io::Error) -> Self { Io(value) }
}
/// Реализация для конвертации из ошибок кодирования библиотеки `encodings`
impl From<Cow<'static, str>> for Error {
  fn from(value: Cow<'static, str>) -> Self { Encoding(value) }
}
impl From<Utf8Error> for Error {
  fn from(value: Utf8Error) -> Self { Encoding(value.to_string().into()) }
}
impl From<FromUtf8Error> for Error {
  fn from(value: FromUtf8Error) -> Self { Encoding(value.to_string().into()) }
}

impl de::Error for Error {
  fn custom<T: fmt::Display>(msg: T) -> Self {
    Deserialize(msg.to_string())
  }
}
impl ser::Error for Error {
  fn custom<T: fmt::Display>(msg: T) -> Self {
    Error::Serialize(msg.to_string())
  }
}