]> git.lizzy.rs Git - rust.git/blob - src/rewrite.rs
Merge pull request #1015 from srinivasreddy/readme
[rust.git] / src / rewrite.rs
1 // Copyright 2015 The Rust Project Developers. See the COPYRIGHT
2 // file at the top-level directory of this distribution and at
3 // http://rust-lang.org/COPYRIGHT.
4 //
5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
8 // option. This file may not be copied, modified, or distributed
9 // except according to those terms.
10
11 // A generic trait to abstract the rewriting of an element (of the AST).
12
13 use syntax::codemap::{CodeMap, Span};
14 use syntax::parse::ParseSess;
15
16 use Indent;
17 use config::Config;
18
19 pub trait Rewrite {
20     /// Rewrite self into offset and width.
21     /// `offset` is the indentation of the first line. The next lines
22     /// should begin with a least `offset` spaces (except backwards
23     /// indentation). The first line should not begin with indentation.
24     /// `width` is the maximum number of characters on the last line
25     /// (excluding offset). The width of other lines is not limited by
26     /// `width`.
27     fn rewrite(&self, context: &RewriteContext, width: usize, offset: Indent) -> Option<String>;
28 }
29
30 #[derive(Clone)]
31 pub struct RewriteContext<'a> {
32     pub parse_session: &'a ParseSess,
33     pub codemap: &'a CodeMap,
34     pub config: &'a Config,
35     // Indentation due to nesting of blocks.
36     pub block_indent: Indent,
37 }
38
39 impl<'a> RewriteContext<'a> {
40     pub fn nested_context(&self) -> RewriteContext<'a> {
41         RewriteContext {
42             parse_session: self.parse_session,
43             codemap: self.codemap,
44             config: self.config,
45             block_indent: self.block_indent.block_indent(self.config),
46         }
47     }
48
49     pub fn snippet(&self, span: Span) -> String {
50         self.codemap.span_to_snippet(span).unwrap()
51     }
52 }