1
Fork 0
rust/src/libsyntax/ext/deriving/show.rs

142 lines
4.8 KiB
Rust
Raw Normal View History

2014-02-06 23:02:28 +11:00
// Copyright 2014 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 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.
use ast;
2014-09-13 19:06:01 +03:00
use ast::{MetaItem, Item, Expr,};
2014-02-06 23:02:28 +11:00
use codemap::Span;
use ext::format;
use ext::base::ExtCtxt;
use ext::build::AstBuilder;
use ext::deriving::generic::*;
use ext::deriving::generic::ty::*;
2014-02-06 23:02:28 +11:00
use parse::token;
2014-09-13 19:06:01 +03:00
use ptr::P;
2014-02-06 23:02:28 +11:00
use std::collections::HashMap;
2014-02-06 23:02:28 +11:00
2014-12-08 13:28:32 -05:00
pub fn expand_deriving_show<F>(cx: &mut ExtCtxt,
span: Span,
mitem: &MetaItem,
item: &Item,
push: F) where
F: FnOnce(P<Item>),
{
2014-02-06 23:02:28 +11:00
// &mut ::std::fmt::Formatter
let fmtr = Ptr(box Literal(path_std!(cx, core::fmt::Formatter)),
2014-02-06 23:02:28 +11:00
Borrowed(None, ast::MutMutable));
let trait_def = TraitDef {
span: span,
attributes: Vec::new(),
path: path_std!(cx, core::fmt::Debug),
additional_bounds: Vec::new(),
2014-02-06 23:02:28 +11:00
generics: LifetimeBounds::empty(),
methods: vec![
2014-02-06 23:02:28 +11:00
MethodDef {
name: "fmt",
generics: LifetimeBounds::empty(),
explicit_self: borrowed_explicit_self(),
args: vec!(fmtr),
ret_ty: Literal(path_std!(cx, core::fmt::Result)),
attributes: Vec::new(),
combine_substructure: combine_substructure(Box::new(|a, b, c| {
show_substructure(a, b, c)
}))
2014-02-06 23:02:28 +11:00
}
],
associated_types: Vec::new(),
2014-02-06 23:02:28 +11:00
};
trait_def.expand(cx, mitem, item, push)
2014-02-06 23:02:28 +11:00
}
2014-06-09 13:12:30 -07:00
/// We construct a format string and then defer to std::fmt, since that
/// knows what's up with formatting and so on.
2014-02-06 23:02:28 +11:00
fn show_substructure(cx: &mut ExtCtxt, span: Span,
2014-09-13 19:06:01 +03:00
substr: &Substructure) -> P<Expr> {
2014-02-06 23:02:28 +11:00
// build `<name>`, `<name>({}, {}, ...)` or `<name> { <field>: {},
// <field>: {}, ... }` based on the "shape".
//
// Easy start: they all start with the name.
let name = match *substr.fields {
Struct(_) => substr.type_ident,
EnumMatching(_, v, _) => v.node.name,
EnumNonMatchingCollapsed(..) | StaticStruct(..) | StaticEnum(..) => {
std: Rename Show/String to Debug/Display This commit is an implementation of [RFC 565][rfc] which is a stabilization of the `std::fmt` module and the implementations of various formatting traits. Specifically, the following changes were performed: [rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0565-show-string-guidelines.md * The `Show` trait is now deprecated, it was renamed to `Debug` * The `String` trait is now deprecated, it was renamed to `Display` * Many `Debug` and `Display` implementations were audited in accordance with the RFC and audited implementations now have the `#[stable]` attribute * Integers and floats no longer print a suffix * Smart pointers no longer print details that they are a smart pointer * Paths with `Debug` are now quoted and escape characters * The `unwrap` methods on `Result` now require `Display` instead of `Debug` * The `Error` trait no longer has a `detail` method and now requires that `Display` must be implemented. With the loss of `String`, this has moved into libcore. * `impl<E: Error> FromError<E> for Box<Error>` now exists * `derive(Show)` has been renamed to `derive(Debug)`. This is not currently warned about due to warnings being emitted on stage1+ While backwards compatibility is attempted to be maintained with a blanket implementation of `Display` for the old `String` trait (and the same for `Show`/`Debug`) this is still a breaking change due to primitives no longer implementing `String` as well as modifications such as `unwrap` and the `Error` trait. Most code is fairly straightforward to update with a rename or tweaks of method calls. [breaking-change] Closes #21436
2015-01-20 15:45:07 -08:00
cx.span_bug(span, "nonsensical .fields in `#[derive(Debug)]`")
2014-02-06 23:02:28 +11:00
}
};
let mut format_string = String::from_str(&token::get_ident(name));
2014-02-06 23:02:28 +11:00
// the internal fields we're actually formatting
let mut exprs = Vec::new();
2014-02-06 23:02:28 +11:00
// Getting harder... making the format string:
match *substr.fields {
// unit struct/nullary variant: no work necessary!
Struct(ref fields) if fields.len() == 0 => {}
EnumMatching(_, _, ref fields) if fields.len() == 0 => {}
2014-02-06 23:02:28 +11:00
Struct(ref fields) | EnumMatching(_, _, ref fields) => {
if fields[0].name.is_none() {
2014-02-06 23:02:28 +11:00
// tuple struct/"normal" variant
format_string.push_str("(");
for (i, field) in fields.iter().enumerate() {
if i != 0 { format_string.push_str(", "); }
format_string.push_str("{:?}");
2014-02-06 23:02:28 +11:00
2014-09-13 19:06:01 +03:00
exprs.push(field.self_.clone());
2014-02-06 23:02:28 +11:00
}
format_string.push_str(")");
} else {
// normal struct/struct variant
format_string.push_str(" {{");
2014-02-06 23:02:28 +11:00
for (i, field) in fields.iter().enumerate() {
if i != 0 { format_string.push_str(","); }
let name = token::get_ident(field.name.unwrap());
2014-02-06 23:02:28 +11:00
format_string.push_str(" ");
format_string.push_str(&name);
format_string.push_str(": {:?}");
2014-02-06 23:02:28 +11:00
2014-09-13 19:06:01 +03:00
exprs.push(field.self_.clone());
2014-02-06 23:02:28 +11:00
}
format_string.push_str(" }}");
2014-02-06 23:02:28 +11:00
}
}
_ => unreachable!()
}
// AST construction!
// we're basically calling
//
// format_arg_method!(fmt, write_fmt, "<format_string>", exprs...)
2014-02-06 23:02:28 +11:00
//
// but doing it directly via ext::format.
2014-09-13 19:06:01 +03:00
let formatter = substr.nonself_args[0].clone();
2014-02-06 23:02:28 +11:00
let meth = cx.ident_of("write_fmt");
let s = token::intern_and_get_ident(&format_string[..]);
2014-02-06 23:02:28 +11:00
let format_string = cx.expr_str(span, s);
// phew, not our responsibility any more!
let args = vec![
format::expand_preparsed_format_args(cx, span, format_string,
exprs, vec![], HashMap::new())
];
cx.expr_method_call(span, formatter, meth, args)
2014-02-06 23:02:28 +11:00
}