// Copyright 2012-2015 The Rust Project Developers. See the COPYRIGHT // file at the top-level directory of this distribution and at // http://rust-lang.org/COPYRIGHT. // // Licensed under the Apache License, Version 2.0 or the MIT license // , at your // option. This file may not be copied, modified, or distributed // except according to those terms. // Code for annotating snippets. use syntax_pos::{Span, FileMap}; use CodeMapper; use std::rc::Rc; use Level; #[derive(Clone)] pub struct SnippetData { codemap: Rc, files: Vec, } #[derive(Clone)] pub struct FileInfo { file: Rc, /// The "primary file", if any, gets a `-->` marker instead of /// `>>>`, and has a line-number/column printed and not just a /// filename. It appears first in the listing. It is known to /// contain at least one primary span, though primary spans (which /// are designated with `^^^`) may also occur in other files. primary_span: Option, lines: Vec, } #[derive(Clone, Debug, PartialOrd, Ord, PartialEq, Eq)] pub struct Line { pub line_index: usize, pub annotations: Vec, } #[derive(Clone, Debug, PartialOrd, Ord, PartialEq, Eq)] pub struct MultilineAnnotation { pub depth: usize, pub line_start: usize, pub line_end: usize, pub start_col: usize, pub end_col: usize, pub is_primary: bool, pub label: Option, } impl MultilineAnnotation { pub fn increase_depth(&mut self) { self.depth += 1; } pub fn as_start(&self) -> Annotation { Annotation { start_col: self.start_col, end_col: self.start_col + 1, is_primary: self.is_primary, label: Some("starting here...".to_owned()), annotation_type: AnnotationType::MultilineStart(self.depth) } } pub fn as_end(&self) -> Annotation { Annotation { start_col: self.end_col - 1, end_col: self.end_col, is_primary: self.is_primary, label: match self.label { Some(ref label) => Some(format!("...ending here: {}", label)), None => Some("...ending here".to_owned()), }, annotation_type: AnnotationType::MultilineEnd(self.depth) } } pub fn as_line(&self) -> Annotation { Annotation { start_col: 0, end_col: 0, is_primary: self.is_primary, label: None, annotation_type: AnnotationType::MultilineLine(self.depth) } } } #[derive(Clone, Debug, PartialOrd, Ord, PartialEq, Eq)] pub enum AnnotationType { /// Annotation under a single line of code Singleline, /// Annotation under the first character of a multiline span Minimized, /// Annotation enclosing the first and last character of a multiline span Multiline(MultilineAnnotation), // The Multiline type above is replaced with the following three in order // to reuse the current label drawing code. // // Each of these corresponds to one part of the following diagram: // // x | foo(1 + bar(x, // | _________^ starting here... < MultilineStart // x | | y), < MultilineLine // | |______________^ ...ending here: label < MultilineEnd // x | z); /// Annotation marking the first character of a fully shown multiline span MultilineStart(usize), /// Annotation marking the last character of a fully shown multiline span MultilineEnd(usize), /// Line at the left enclosing the lines of a fully shown multiline span MultilineLine(usize), } #[derive(Clone, Debug, PartialOrd, Ord, PartialEq, Eq)] pub struct Annotation { /// Start column, 0-based indexing -- counting *characters*, not /// utf-8 bytes. Note that it is important that this field goes /// first, so that when we sort, we sort orderings by start /// column. pub start_col: usize, /// End column within the line (exclusive) pub end_col: usize, /// Is this annotation derived from primary span pub is_primary: bool, /// Optional label to display adjacent to the annotation. pub label: Option, /// Is this a single line, multiline or multiline span minimized down to a /// smaller span. pub annotation_type: AnnotationType, } impl Annotation { pub fn is_minimized(&self) -> bool { match self.annotation_type { AnnotationType::Minimized => true, _ => false, } } pub fn is_multiline(&self) -> bool { match self.annotation_type { AnnotationType::Multiline(_) | AnnotationType::MultilineStart(_) | AnnotationType::MultilineLine(_) | AnnotationType::MultilineEnd(_) => true, _ => false, } } } #[derive(Debug)] pub struct StyledString { pub text: String, pub style: Style, } #[derive(Copy, Clone, Debug, PartialEq)] pub enum Style { HeaderMsg, FileNameStyle, LineAndColumn, LineNumber, Quotation, UnderlinePrimary, UnderlineSecondary, LabelPrimary, LabelSecondary, OldSchoolNoteText, OldSchoolNote, NoStyle, ErrorCode, Level(Level), }