svgparser 0.4.3

Simple, streaming, zero-allocation SVG parser.
Documentation
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

use std::fmt;
use std::str;

/// Position of an error.
///
/// Position indicates row/line and column. Starting positions is 1:1.
#[derive(Clone,Copy,PartialEq)]
pub struct ErrorPos {
    #[allow(missing_docs)]
    pub row: usize,
    #[allow(missing_docs)]
    pub col: usize,
}

impl ErrorPos {
    /// Constructs a new error position.
    pub fn new(row: usize, col: usize) -> ErrorPos {
        ErrorPos {
            row: row,
            col: col,
        }
    }
}

impl fmt::Display for ErrorPos {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "{}:{}", &self.row, &self.col)
    }
}

/// List of all errors.
#[derive(Clone,Copy,PartialEq)]
pub enum Error {
    /// The steam ended earlier than we expected.
    ///
    /// Should only appear on invalid input data.
    /// Errors in the valid SVG should be handled by errors below.
    UnexpectedEndOfStream(ErrorPos),
    /// Can appear during consuming expected char.
    InvalidChar {
        /// Current char in the stream.
        current: char,
        /// Expected char.
        expected: char,
        /// Absolute stream position.
        pos: ErrorPos,
    },
    /// Invalid SVG token.
    InvalidSvgToken(ErrorPos),
    /// The stream found closing tag without an opening tag.
    UnexpectedClosingTag(ErrorPos),
    /// Error during a number parsing.
    InvalidNumber(ErrorPos),
    /// Error during a length parsing.
    InvalidLength(ErrorPos),
    /// Error during a color parsing.
    InvalidColor(ErrorPos),
    /// Error during a transform parsing.
    InvalidTransform(ErrorPos),
    /// Invalid attribute value.
    InvalidAttributeValue(ErrorPos),
    /// Can appear during moving along the data stream.
    InvalidAdvance {
        /// The advance step.
        expected: isize, // TODO: to usize when "look back" Stream features will be removed
        /// Full length of the steam.
        total: usize,
        /// Absolute stream position.
        pos: ErrorPos,
    },
    /// UTF-8 processing error.
    Utf8Error(str::Utf8Error),
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            Error::UnexpectedEndOfStream(ref pos) =>
                write!(f, "Unexpected end of stream at {}", pos),
            Error::InvalidChar{ref current, ref expected, ref pos} =>
                write!(f, "Expected '{}', found '{}' at pos {}", expected, current, pos),
            Error::InvalidSvgToken(ref pos) =>
                write!(f, "Invalid SVG token at {}", pos),
            Error::UnexpectedClosingTag(ref pos) =>
                write!(f, "The stream found closing tag without an opening tag at {}", pos),
            Error::InvalidNumber(ref pos) =>
                write!(f, "Invalid number at {}", pos),
            Error::InvalidLength(ref pos) =>
                write!(f, "Invalid length at {}", pos),
            Error::InvalidColor(ref pos) =>
                write!(f, "Invalid color at {}", pos),
            Error::InvalidTransform(ref pos) =>
                write!(f, "Invalid transform at {}", pos),
            Error::InvalidAttributeValue(ref pos) =>
                write!(f, "Invalid attribute at {}", pos),
            Error::InvalidAdvance{ ref expected, ref total, ref pos } =>
                write!(f, "Attempt to advance to the pos {} from {}, but total len is {}",
                       expected, pos, total),
            Error::Utf8Error(e) =>
                write!(f, "{}", e),
        }
    }
}

impl fmt::Debug for Error {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "{}", &self)
    }
}

impl From<str::Utf8Error> for Error {
    fn from(value: str::Utf8Error) -> Error {
        Error::Utf8Error(value)
    }
}