]> git.lizzy.rs Git - rust.git/blob - src/rewrite.rs
Merge pull request #445 from marcusklaas/comments
[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
15 use Indent;
16 use config::Config;
17
18 pub trait Rewrite {
19     /// Rewrite self into offset and width.
20     /// `offset` is the indentation of the first line. The next lines
21     /// should begin with a least `offset` spaces (except backwards
22     /// indentation). The first line should not begin with indentation.
23     /// `width` is the maximum number of characters on the last line
24     /// (excluding offset). The width of other lines is not limited by
25     /// `width`.
26     fn rewrite(&self, context: &RewriteContext, width: usize, offset: Indent) -> Option<String>;
27 }
28
29 pub struct RewriteContext<'a> {
30     pub codemap: &'a CodeMap,
31     pub config: &'a Config,
32     // Indentation due to nesting of blocks.
33     pub block_indent: Indent,
34 }
35
36 impl<'a> RewriteContext<'a> {
37     pub fn nested_context(&self) -> RewriteContext<'a> {
38         RewriteContext {
39             codemap: self.codemap,
40             config: self.config,
41             block_indent: self.block_indent.block_indent(self.config),
42         }
43     }
44
45     pub fn snippet(&self, span: Span) -> String {
46         self.codemap.span_to_snippet(span).unwrap()
47     }
48 }