1 // Copyright 2014 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.
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.
11 //! The various pretty print routines.
13 pub use self::UserIdentifiedItem::*;
14 pub use self::PpSourceMode::*;
15 pub use self::PpMode::*;
16 use self::NodesMatchingUII::*;
18 use {abort_on_err, driver};
20 use rustc::ty::{self, TyCtxt, Resolutions, AllArenas};
22 use rustc::cfg::graphviz::LabelledCFG;
23 use rustc::middle::cstore::CrateStore;
24 use rustc::session::Session;
25 use rustc::session::config::{Input, OutputFilenames};
26 use rustc_borrowck as borrowck;
27 use rustc_borrowck::graphviz as borrowck_dot;
29 use rustc_mir::util::{write_mir_pretty, write_mir_graphviz};
31 use syntax::ast::{self, BlockCheckMode};
32 use syntax::fold::{self, Folder};
33 use syntax::print::{pprust};
34 use syntax::print::pprust::PrintState;
36 use syntax::util::small_vector::SmallVector;
37 use syntax_pos::{self, FileName};
43 use std::io::{self, Write};
46 use std::str::FromStr;
49 use rustc::hir::map as hir_map;
50 use rustc::hir::map::blocks;
52 use rustc::hir::print as pprust_hir;
54 #[derive(Copy, Clone, PartialEq, Debug)]
55 pub enum PpSourceMode {
60 PpmExpandedIdentified,
65 #[derive(Copy, Clone, PartialEq, Debug)]
66 pub enum PpFlowGraphMode {
68 /// Drops the labels from the edges in the flowgraph output. This
69 /// is mostly for use in the -Z unpretty flowgraph run-make tests,
70 /// since the labels are largely uninteresting in those cases and
71 /// have become a pain to maintain.
74 #[derive(Copy, Clone, PartialEq, Debug)]
76 PpmSource(PpSourceMode),
78 PpmHirTree(PpSourceMode),
79 PpmFlowGraph(PpFlowGraphMode),
85 pub fn needs_ast_map(&self, opt_uii: &Option<UserIdentifiedItem>) -> bool {
87 PpmSource(PpmNormal) |
88 PpmSource(PpmEveryBodyLoops) |
89 PpmSource(PpmIdentified) => opt_uii.is_some(),
91 PpmSource(PpmExpanded) |
92 PpmSource(PpmExpandedIdentified) |
93 PpmSource(PpmExpandedHygiene) |
98 PpmFlowGraph(_) => true,
99 PpmSource(PpmTyped) => panic!("invalid state"),
103 pub fn needs_analysis(&self) -> bool {
105 PpmMir | PpmMirCFG | PpmFlowGraph(_) => true,
111 pub fn parse_pretty(sess: &Session,
114 -> (PpMode, Option<UserIdentifiedItem>) {
115 let mut split = name.splitn(2, '=');
116 let first = split.next().unwrap();
117 let opt_second = split.next();
118 let first = match (first, extended) {
119 ("normal", _) => PpmSource(PpmNormal),
120 ("identified", _) => PpmSource(PpmIdentified),
121 ("everybody_loops", true) => PpmSource(PpmEveryBodyLoops),
122 ("expanded", _) => PpmSource(PpmExpanded),
123 ("expanded,identified", _) => PpmSource(PpmExpandedIdentified),
124 ("expanded,hygiene", _) => PpmSource(PpmExpandedHygiene),
125 ("hir", true) => PpmHir(PpmNormal),
126 ("hir,identified", true) => PpmHir(PpmIdentified),
127 ("hir,typed", true) => PpmHir(PpmTyped),
128 ("hir-tree", true) => PpmHirTree(PpmNormal),
129 ("mir", true) => PpmMir,
130 ("mir-cfg", true) => PpmMirCFG,
131 ("flowgraph", true) => PpmFlowGraph(PpFlowGraphMode::Default),
132 ("flowgraph,unlabelled", true) => PpmFlowGraph(PpFlowGraphMode::UnlabelledEdges),
135 sess.fatal(&format!("argument to `unpretty` must be one of `normal`, \
136 `expanded`, `flowgraph[,unlabelled]=<nodeid>`, \
137 `identified`, `expanded,identified`, `everybody_loops`, \
138 `hir`, `hir,identified`, `hir,typed`, or `mir`; got {}",
141 sess.fatal(&format!("argument to `pretty` must be one of `normal`, `expanded`, \
142 `identified`, or `expanded,identified`; got {}",
147 let opt_second = opt_second.and_then(|s| s.parse::<UserIdentifiedItem>().ok());
153 // This slightly awkward construction is to allow for each PpMode to
154 // choose whether it needs to do analyses (which can consume the
155 // Session) and then pass through the session (now attached to the
156 // analysis results) on to the chosen pretty-printer, along with the
159 // Note that since the `&PrinterSupport` is freshly constructed on each
160 // call, it would not make sense to try to attach the lifetime of `self`
161 // to the lifetime of the `&PrinterObject`.
163 // (The `use_once_payload` is working around the current lack of once
164 // functions in the compiler.)
167 /// Constructs a `PrinterSupport` object and passes it to `f`.
168 fn call_with_pp_support<'tcx, A, F>(&self,
170 hir_map: Option<&hir_map::Map<'tcx>>,
173 where F: FnOnce(&PrinterSupport) -> A
176 PpmNormal | PpmEveryBodyLoops | PpmExpanded => {
177 let annotation = NoAnn {
179 hir_map: hir_map.map(|m| m.clone()),
184 PpmIdentified | PpmExpandedIdentified => {
185 let annotation = IdentifiedAnnotation {
187 hir_map: hir_map.map(|m| m.clone()),
191 PpmExpandedHygiene => {
192 let annotation = HygieneAnnotation {
197 _ => panic!("Should use call_with_pp_support_hir"),
200 fn call_with_pp_support_hir<'tcx, A, F>(&self,
202 cstore: &'tcx CrateStore,
203 hir_map: &hir_map::Map<'tcx>,
204 analysis: &ty::CrateAnalysis,
205 resolutions: &Resolutions,
206 arenas: &'tcx AllArenas<'tcx>,
207 output_filenames: &OutputFilenames,
211 where F: FnOnce(&HirPrinterSupport, &hir::Crate) -> A
215 let annotation = NoAnn {
217 hir_map: Some(hir_map.clone()),
219 f(&annotation, hir_map.forest.krate())
223 let annotation = IdentifiedAnnotation {
225 hir_map: Some(hir_map.clone()),
227 f(&annotation, hir_map.forest.krate())
230 let control = &driver::CompileController::basic();
231 let trans = ::get_trans(sess);
232 abort_on_err(driver::phase_3_run_analysis_passes(&*trans,
243 let empty_tables = ty::TypeckTables::empty(None);
244 let annotation = TypedAnnotation {
246 tables: Cell::new(&empty_tables)
248 tcx.dep_graph.with_ignore(|| {
249 f(&annotation, hir_map.forest.krate())
254 _ => panic!("Should use call_with_pp_support"),
259 trait PrinterSupport: pprust::PpAnn {
260 /// Provides a uniform interface for re-extracting a reference to a
261 /// `Session` from a value that now owns it.
262 fn sess<'a>(&'a self) -> &'a Session;
264 /// Produces the pretty-print annotation object.
266 /// (Rust does not yet support upcasting from a trait object to
267 /// an object for one of its super-traits.)
268 fn pp_ann<'a>(&'a self) -> &'a pprust::PpAnn;
271 trait HirPrinterSupport<'hir>: pprust_hir::PpAnn {
272 /// Provides a uniform interface for re-extracting a reference to a
273 /// `Session` from a value that now owns it.
274 fn sess<'a>(&'a self) -> &'a Session;
276 /// Provides a uniform interface for re-extracting a reference to an
277 /// `hir_map::Map` from a value that now owns it.
278 fn hir_map<'a>(&'a self) -> Option<&'a hir_map::Map<'hir>>;
280 /// Produces the pretty-print annotation object.
282 /// (Rust does not yet support upcasting from a trait object to
283 /// an object for one of its super-traits.)
284 fn pp_ann<'a>(&'a self) -> &'a pprust_hir::PpAnn;
286 /// Computes an user-readable representation of a path, if possible.
287 fn node_path(&self, id: ast::NodeId) -> Option<String> {
288 self.hir_map().and_then(|map| map.def_path_from_id(id)).map(|path| {
291 .map(|elem| elem.data.to_string())
300 hir_map: Option<hir_map::Map<'hir>>,
303 impl<'hir> PrinterSupport for NoAnn<'hir> {
304 fn sess<'a>(&'a self) -> &'a Session {
308 fn pp_ann<'a>(&'a self) -> &'a pprust::PpAnn {
313 impl<'hir> HirPrinterSupport<'hir> for NoAnn<'hir> {
314 fn sess<'a>(&'a self) -> &'a Session {
318 fn hir_map<'a>(&'a self) -> Option<&'a hir_map::Map<'hir>> {
319 self.hir_map.as_ref()
322 fn pp_ann<'a>(&'a self) -> &'a pprust_hir::PpAnn {
327 impl<'hir> pprust::PpAnn for NoAnn<'hir> {}
328 impl<'hir> pprust_hir::PpAnn for NoAnn<'hir> {
329 fn nested(&self, state: &mut pprust_hir::State, nested: pprust_hir::Nested)
331 if let Some(ref map) = self.hir_map {
332 pprust_hir::PpAnn::nested(map, state, nested)
339 struct IdentifiedAnnotation<'hir> {
341 hir_map: Option<hir_map::Map<'hir>>,
344 impl<'hir> PrinterSupport for IdentifiedAnnotation<'hir> {
345 fn sess<'a>(&'a self) -> &'a Session {
349 fn pp_ann<'a>(&'a self) -> &'a pprust::PpAnn {
354 impl<'hir> pprust::PpAnn for IdentifiedAnnotation<'hir> {
355 fn pre(&self, s: &mut pprust::State, node: pprust::AnnNode) -> io::Result<()> {
357 pprust::NodeExpr(_) => s.popen(),
361 fn post(&self, s: &mut pprust::State, node: pprust::AnnNode) -> io::Result<()> {
363 pprust::NodeIdent(_) |
364 pprust::NodeName(_) => Ok(()),
366 pprust::NodeItem(item) => {
368 s.synth_comment(item.id.to_string())
370 pprust::NodeSubItem(id) => {
372 s.synth_comment(id.to_string())
374 pprust::NodeBlock(blk) => {
376 s.synth_comment(format!("block {}", blk.id))
378 pprust::NodeExpr(expr) => {
380 s.synth_comment(expr.id.to_string())?;
383 pprust::NodePat(pat) => {
385 s.synth_comment(format!("pat {}", pat.id))
391 impl<'hir> HirPrinterSupport<'hir> for IdentifiedAnnotation<'hir> {
392 fn sess<'a>(&'a self) -> &'a Session {
396 fn hir_map<'a>(&'a self) -> Option<&'a hir_map::Map<'hir>> {
397 self.hir_map.as_ref()
400 fn pp_ann<'a>(&'a self) -> &'a pprust_hir::PpAnn {
405 impl<'hir> pprust_hir::PpAnn for IdentifiedAnnotation<'hir> {
406 fn nested(&self, state: &mut pprust_hir::State, nested: pprust_hir::Nested)
408 if let Some(ref map) = self.hir_map {
409 pprust_hir::PpAnn::nested(map, state, nested)
414 fn pre(&self, s: &mut pprust_hir::State, node: pprust_hir::AnnNode) -> io::Result<()> {
416 pprust_hir::NodeExpr(_) => s.popen(),
420 fn post(&self, s: &mut pprust_hir::State, node: pprust_hir::AnnNode) -> io::Result<()> {
422 pprust_hir::NodeName(_) => Ok(()),
423 pprust_hir::NodeItem(item) => {
425 s.synth_comment(format!("node_id: {} hir local_id: {}",
426 item.id, item.hir_id.local_id.0))
428 pprust_hir::NodeSubItem(id) => {
430 s.synth_comment(id.to_string())
432 pprust_hir::NodeBlock(blk) => {
434 s.synth_comment(format!("block node_id: {} hir local_id: {}",
435 blk.id, blk.hir_id.local_id.0))
437 pprust_hir::NodeExpr(expr) => {
439 s.synth_comment(format!("node_id: {} hir local_id: {}",
440 expr.id, expr.hir_id.local_id.0))?;
443 pprust_hir::NodePat(pat) => {
445 s.synth_comment(format!("pat node_id: {} hir local_id: {}",
446 pat.id, pat.hir_id.local_id.0))
452 struct HygieneAnnotation<'a> {
456 impl<'a> PrinterSupport for HygieneAnnotation<'a> {
457 fn sess(&self) -> &Session {
461 fn pp_ann(&self) -> &pprust::PpAnn {
466 impl<'a> pprust::PpAnn for HygieneAnnotation<'a> {
467 fn post(&self, s: &mut pprust::State, node: pprust::AnnNode) -> io::Result<()> {
469 pprust::NodeIdent(&ast::Ident { name, span }) => {
471 // FIXME #16420: this doesn't display the connections
472 // between syntax contexts
473 s.synth_comment(format!("{}{:?}", name.as_u32(), span.ctxt()))
475 pprust::NodeName(&name) => {
477 s.synth_comment(name.as_u32().to_string())
485 struct TypedAnnotation<'a, 'tcx: 'a> {
486 tcx: TyCtxt<'a, 'tcx, 'tcx>,
487 tables: Cell<&'a ty::TypeckTables<'tcx>>,
490 impl<'b, 'tcx> HirPrinterSupport<'tcx> for TypedAnnotation<'b, 'tcx> {
491 fn sess<'a>(&'a self) -> &'a Session {
495 fn hir_map<'a>(&'a self) -> Option<&'a hir_map::Map<'tcx>> {
499 fn pp_ann<'a>(&'a self) -> &'a pprust_hir::PpAnn {
503 fn node_path(&self, id: ast::NodeId) -> Option<String> {
504 Some(self.tcx.node_path_str(id))
508 impl<'a, 'tcx> pprust_hir::PpAnn for TypedAnnotation<'a, 'tcx> {
509 fn nested(&self, state: &mut pprust_hir::State, nested: pprust_hir::Nested)
511 let old_tables = self.tables.get();
512 if let pprust_hir::Nested::Body(id) = nested {
513 self.tables.set(self.tcx.body_tables(id));
515 pprust_hir::PpAnn::nested(&self.tcx.hir, state, nested)?;
516 self.tables.set(old_tables);
519 fn pre(&self, s: &mut pprust_hir::State, node: pprust_hir::AnnNode) -> io::Result<()> {
521 pprust_hir::NodeExpr(_) => s.popen(),
525 fn post(&self, s: &mut pprust_hir::State, node: pprust_hir::AnnNode) -> io::Result<()> {
527 pprust_hir::NodeExpr(expr) => {
531 s.s.word(&self.tables.get().expr_ty(expr).to_string())?;
539 fn gather_flowgraph_variants(sess: &Session) -> Vec<borrowck_dot::Variant> {
540 let print_loans = sess.opts.debugging_opts.flowgraph_print_loans;
541 let print_moves = sess.opts.debugging_opts.flowgraph_print_moves;
542 let print_assigns = sess.opts.debugging_opts.flowgraph_print_assigns;
543 let print_all = sess.opts.debugging_opts.flowgraph_print_all;
544 let mut variants = Vec::new();
545 if print_all || print_loans {
546 variants.push(borrowck_dot::Loans);
548 if print_all || print_moves {
549 variants.push(borrowck_dot::Moves);
551 if print_all || print_assigns {
552 variants.push(borrowck_dot::Assigns);
557 #[derive(Clone, Debug)]
558 pub enum UserIdentifiedItem {
559 ItemViaNode(ast::NodeId),
560 ItemViaPath(Vec<String>),
563 impl FromStr for UserIdentifiedItem {
565 fn from_str(s: &str) -> Result<UserIdentifiedItem, ()> {
567 .map(ast::NodeId::new)
569 .unwrap_or_else(|_| ItemViaPath(s.split("::").map(|s| s.to_string()).collect())))
573 enum NodesMatchingUII<'a, 'hir: 'a> {
574 NodesMatchingDirect(option::IntoIter<ast::NodeId>),
575 NodesMatchingSuffix(hir_map::NodesMatchingSuffix<'a, 'hir>),
578 impl<'a, 'hir> Iterator for NodesMatchingUII<'a, 'hir> {
579 type Item = ast::NodeId;
581 fn next(&mut self) -> Option<ast::NodeId> {
583 &mut NodesMatchingDirect(ref mut iter) => iter.next(),
584 &mut NodesMatchingSuffix(ref mut iter) => iter.next(),
588 fn size_hint(&self) -> (usize, Option<usize>) {
590 &NodesMatchingDirect(ref iter) => iter.size_hint(),
591 &NodesMatchingSuffix(ref iter) => iter.size_hint(),
596 impl UserIdentifiedItem {
597 fn reconstructed_input(&self) -> String {
599 ItemViaNode(node_id) => node_id.to_string(),
600 ItemViaPath(ref parts) => parts.join("::"),
604 fn all_matching_node_ids<'a, 'hir>(&'a self,
605 map: &'a hir_map::Map<'hir>)
606 -> NodesMatchingUII<'a, 'hir> {
608 ItemViaNode(node_id) => NodesMatchingDirect(Some(node_id).into_iter()),
609 ItemViaPath(ref parts) => NodesMatchingSuffix(map.nodes_matching_suffix(&parts)),
613 fn to_one_node_id(self, user_option: &str, sess: &Session, map: &hir_map::Map) -> ast::NodeId {
614 let fail_because = |is_wrong_because| -> ast::NodeId {
615 let message = format!("{} needs NodeId (int) or unique path suffix (b::c::d); got \
618 self.reconstructed_input(),
623 let mut saw_node = ast::DUMMY_NODE_ID;
625 for node in self.all_matching_node_ids(map) {
629 fail_because("does not resolve uniquely");
633 fail_because("does not resolve to any item");
641 // Note: Also used by librustdoc, see PR #43348. Consider moving this struct elsewhere.
643 // FIXME: Currently the `everybody_loops` transformation is not applied to:
644 // * `const fn`, due to issue #43636 that `loop` is not supported for const evaluation. We are
645 // waiting for miri to fix that.
646 // * `impl Trait`, due to issue #43869 that functions returning impl Trait cannot be diverging.
647 // Solving this may require `!` to implement every trait, which relies on the an even more
648 // ambitious form of the closed RFC #1637. See also [#34511].
650 // [#34511]: https://github.com/rust-lang/rust/issues/34511#issuecomment-322340401
651 pub struct ReplaceBodyWithLoop<'a> {
652 within_static_or_const: bool,
656 impl<'a> ReplaceBodyWithLoop<'a> {
657 pub fn new(sess: &'a Session) -> ReplaceBodyWithLoop<'a> {
658 ReplaceBodyWithLoop { within_static_or_const: false, sess }
661 fn run<R, F: FnOnce(&mut Self) -> R>(&mut self, is_const: bool, action: F) -> R {
662 let old_const = mem::replace(&mut self.within_static_or_const, is_const);
663 let ret = action(self);
664 self.within_static_or_const = old_const;
668 fn should_ignore_fn(ret_ty: &ast::FnDecl) -> bool {
669 if let ast::FunctionRetTy::Ty(ref ty) = ret_ty.output {
670 fn involves_impl_trait(ty: &ast::Ty) -> bool {
672 ast::TyKind::ImplTrait(_) => true,
673 ast::TyKind::Slice(ref subty) |
674 ast::TyKind::Array(ref subty, _) |
675 ast::TyKind::Ptr(ast::MutTy { ty: ref subty, .. }) |
676 ast::TyKind::Rptr(_, ast::MutTy { ty: ref subty, .. }) |
677 ast::TyKind::Paren(ref subty) => involves_impl_trait(subty),
678 ast::TyKind::Tup(ref tys) => any_involves_impl_trait(tys.iter()),
679 ast::TyKind::Path(_, ref path) => path.segments.iter().any(|seg| {
680 match seg.parameters.as_ref().map(|p| &**p) {
682 Some(&ast::PathParameters::AngleBracketed(ref data)) =>
683 any_involves_impl_trait(data.types.iter()) ||
684 any_involves_impl_trait(data.bindings.iter().map(|b| &b.ty)),
685 Some(&ast::PathParameters::Parenthesized(ref data)) =>
686 any_involves_impl_trait(data.inputs.iter()) ||
687 any_involves_impl_trait(data.output.iter()),
694 fn any_involves_impl_trait<'a, I: Iterator<Item = &'a P<ast::Ty>>>(mut it: I) -> bool {
695 it.any(|subty| involves_impl_trait(subty))
698 involves_impl_trait(ty)
705 impl<'a> fold::Folder for ReplaceBodyWithLoop<'a> {
706 fn fold_item_kind(&mut self, i: ast::ItemKind) -> ast::ItemKind {
707 let is_const = match i {
708 ast::ItemKind::Static(..) | ast::ItemKind::Const(..) => true,
709 ast::ItemKind::Fn(ref decl, _, ref constness, _, _, _) =>
710 constness.node == ast::Constness::Const || Self::should_ignore_fn(decl),
713 self.run(is_const, |s| fold::noop_fold_item_kind(i, s))
716 fn fold_trait_item(&mut self, i: ast::TraitItem) -> SmallVector<ast::TraitItem> {
717 let is_const = match i.node {
718 ast::TraitItemKind::Const(..) => true,
719 ast::TraitItemKind::Method(ast::MethodSig { ref decl, ref constness, .. }, _) =>
720 constness.node == ast::Constness::Const || Self::should_ignore_fn(decl),
723 self.run(is_const, |s| fold::noop_fold_trait_item(i, s))
726 fn fold_impl_item(&mut self, i: ast::ImplItem) -> SmallVector<ast::ImplItem> {
727 let is_const = match i.node {
728 ast::ImplItemKind::Const(..) => true,
729 ast::ImplItemKind::Method(ast::MethodSig { ref decl, ref constness, .. }, _) =>
730 constness.node == ast::Constness::Const || Self::should_ignore_fn(decl),
733 self.run(is_const, |s| fold::noop_fold_impl_item(i, s))
736 fn fold_block(&mut self, b: P<ast::Block>) -> P<ast::Block> {
737 fn expr_to_block(rules: ast::BlockCheckMode,
739 e: Option<P<ast::Expr>>,
740 sess: &Session) -> P<ast::Block> {
744 id: sess.next_node_id(),
746 node: ast::StmtKind::Expr(e),
752 id: sess.next_node_id(),
753 span: syntax_pos::DUMMY_SP,
758 if !self.within_static_or_const {
760 let empty_block = expr_to_block(BlockCheckMode::Default, false, None, self.sess);
761 let loop_expr = P(ast::Expr {
762 node: ast::ExprKind::Loop(empty_block, None),
763 id: self.sess.next_node_id(),
764 span: syntax_pos::DUMMY_SP,
765 attrs: ast::ThinVec::new(),
768 expr_to_block(b.rules, b.recovered, Some(loop_expr), self.sess)
771 fold::noop_fold_block(b, self)
775 // in general the pretty printer processes unexpanded code, so
776 // we override the default `fold_mac` method which panics.
777 fn fold_mac(&mut self, mac: ast::Mac) -> ast::Mac {
778 fold::noop_fold_mac(mac, self)
782 fn print_flowgraph<'a, 'tcx, W: Write>(variants: Vec<borrowck_dot::Variant>,
783 tcx: TyCtxt<'a, 'tcx, 'tcx>,
784 code: blocks::Code<'tcx>,
785 mode: PpFlowGraphMode,
788 let body_id = match code {
789 blocks::Code::Expr(expr) => {
790 // Find the function this expression is from.
791 let mut node_id = expr.id;
793 let node = tcx.hir.get(node_id);
794 if let Some(n) = hir::map::blocks::FnLikeNode::from_node(node) {
797 let parent = tcx.hir.get_parent_node(node_id);
798 assert!(node_id != parent);
802 blocks::Code::FnLike(fn_like) => fn_like.body(),
804 let body = tcx.hir.body(body_id);
805 let cfg = cfg::CFG::new(tcx, &body);
806 let labelled_edges = mode != PpFlowGraphMode::UnlabelledEdges;
807 let lcfg = LabelledCFG {
810 name: format!("node_{}", code.id()),
815 _ if variants.is_empty() => {
816 let r = dot::render(&lcfg, &mut out);
817 return expand_err_details(r);
819 blocks::Code::Expr(_) => {
820 tcx.sess.err("--pretty flowgraph with -Z flowgraph-print annotations requires \
824 blocks::Code::FnLike(fn_like) => {
825 let (bccx, analysis_data) =
826 borrowck::build_borrowck_dataflow_data_for_fn(tcx, fn_like.body(), &cfg);
828 let lcfg = borrowck_dot::DataflowLabeller {
831 borrowck_ctxt: &bccx,
832 analysis_data: &analysis_data,
834 let r = dot::render(&lcfg, &mut out);
835 return expand_err_details(r);
839 fn expand_err_details(r: io::Result<()>) -> io::Result<()> {
841 io::Error::new(io::ErrorKind::Other,
842 format!("graphviz::render failed: {}", ioerr))
847 pub fn fold_crate(sess: &Session, krate: ast::Crate, ppm: PpMode) -> ast::Crate {
848 if let PpmSource(PpmEveryBodyLoops) = ppm {
849 let mut fold = ReplaceBodyWithLoop::new(sess);
850 fold.fold_crate(krate)
856 fn get_source(input: &Input, sess: &Session) -> (Vec<u8>, FileName) {
857 let src_name = driver::source_name(input);
858 let src = sess.codemap()
859 .get_filemap(&src_name)
869 fn write_output(out: Vec<u8>, ofile: Option<&Path>) {
871 None => print!("{}", String::from_utf8(out).unwrap()),
873 match File::create(p) {
874 Ok(mut w) => w.write_all(&out).unwrap(),
875 Err(e) => panic!("print-print failed to open {} due to {}", p.display(), e),
881 pub fn print_after_parsing(sess: &Session,
885 ofile: Option<&Path>) {
886 let (src, src_name) = get_source(input, sess);
889 let mut out = Vec::new();
891 if let PpmSource(s) = ppm {
892 // Silently ignores an identified node.
893 let out: &mut Write = &mut out;
894 s.call_with_pp_support(sess, None, move |annotation| {
895 debug!("pretty printing source code {:?}", s);
896 let sess = annotation.sess();
897 pprust::print_crate(sess.codemap(),
911 write_output(out, ofile);
914 pub fn print_after_hir_lowering<'tcx, 'a: 'tcx>(sess: &'a Session,
915 cstore: &'tcx CrateStore,
916 hir_map: &hir_map::Map<'tcx>,
917 analysis: &ty::CrateAnalysis,
918 resolutions: &Resolutions,
923 arenas: &'tcx AllArenas<'tcx>,
924 output_filenames: &OutputFilenames,
925 opt_uii: Option<UserIdentifiedItem>,
926 ofile: Option<&Path>) {
927 if ppm.needs_analysis() {
928 print_with_analysis(sess,
942 let (src, src_name) = get_source(input, sess);
944 let mut rdr = &src[..];
945 let mut out = Vec::new();
947 match (ppm, opt_uii) {
948 (PpmSource(s), _) => {
949 // Silently ignores an identified node.
950 let out: &mut Write = &mut out;
951 s.call_with_pp_support(sess, Some(hir_map), move |annotation| {
952 debug!("pretty printing source code {:?}", s);
953 let sess = annotation.sess();
954 pprust::print_crate(sess.codemap(),
965 (PpmHir(s), None) => {
966 let out: &mut Write = &mut out;
967 s.call_with_pp_support_hir(sess,
975 move |annotation, krate| {
976 debug!("pretty printing source code {:?}", s);
977 let sess = annotation.sess();
978 pprust_hir::print_crate(sess.codemap(),
989 (PpmHirTree(s), None) => {
990 let out: &mut Write = &mut out;
991 s.call_with_pp_support_hir(sess,
999 move |_annotation, krate| {
1000 debug!("pretty printing source code {:?}", s);
1001 write!(out, "{:#?}", krate)
1005 (PpmHir(s), Some(uii)) => {
1006 let out: &mut Write = &mut out;
1007 s.call_with_pp_support_hir(sess,
1015 move |annotation, _| {
1016 debug!("pretty printing source code {:?}", s);
1017 let sess = annotation.sess();
1018 let hir_map = annotation.hir_map().expect("-Z unpretty missing HIR map");
1019 let mut pp_state = pprust_hir::State::new_from_input(sess.codemap(),
1024 annotation.pp_ann(),
1026 for node_id in uii.all_matching_node_ids(hir_map) {
1027 let node = hir_map.get(node_id);
1028 pp_state.print_node(node)?;
1029 pp_state.s.space()?;
1030 let path = annotation.node_path(node_id)
1031 .expect("-Z unpretty missing node paths");
1032 pp_state.synth_comment(path)?;
1033 pp_state.s.hardbreak()?;
1039 (PpmHirTree(s), Some(uii)) => {
1040 let out: &mut Write = &mut out;
1041 s.call_with_pp_support_hir(sess,
1049 move |_annotation, _krate| {
1050 debug!("pretty printing source code {:?}", s);
1051 for node_id in uii.all_matching_node_ids(hir_map) {
1052 let node = hir_map.get(node_id);
1053 write!(out, "{:#?}", node)?;
1059 _ => unreachable!(),
1063 write_output(out, ofile);
1066 // In an ideal world, this would be a public function called by the driver after
1067 // analsysis is performed. However, we want to call `phase_3_run_analysis_passes`
1068 // with a different callback than the standard driver, so that isn't easy.
1069 // Instead, we call that function ourselves.
1070 fn print_with_analysis<'tcx, 'a: 'tcx>(sess: &'a Session,
1071 cstore: &'a CrateStore,
1072 hir_map: &hir_map::Map<'tcx>,
1073 analysis: &ty::CrateAnalysis,
1074 resolutions: &Resolutions,
1076 arenas: &'tcx AllArenas<'tcx>,
1077 output_filenames: &OutputFilenames,
1079 uii: Option<UserIdentifiedItem>,
1080 ofile: Option<&Path>) {
1081 let nodeid = if let Some(uii) = uii {
1082 debug!("pretty printing for {:?}", uii);
1083 Some(uii.to_one_node_id("-Z unpretty", sess, &hir_map))
1085 debug!("pretty printing for whole crate");
1089 let mut out = Vec::new();
1091 let control = &driver::CompileController::basic();
1092 let trans = ::get_trans(sess);
1093 abort_on_err(driver::phase_3_run_analysis_passes(&*trans,
1099 resolutions.clone(),
1105 PpmMir | PpmMirCFG => {
1106 if let Some(nodeid) = nodeid {
1107 let def_id = tcx.hir.local_def_id(nodeid);
1109 PpmMir => write_mir_pretty(tcx, Some(def_id), &mut out),
1110 PpmMirCFG => write_mir_graphviz(tcx, Some(def_id), &mut out),
1111 _ => unreachable!(),
1115 PpmMir => write_mir_pretty(tcx, None, &mut out),
1116 PpmMirCFG => write_mir_graphviz(tcx, None, &mut out),
1117 _ => unreachable!(),
1122 PpmFlowGraph(mode) => {
1124 nodeid.expect("`pretty flowgraph=..` needs NodeId (int) or unique path \
1126 let node = tcx.hir.find(nodeid).unwrap_or_else(|| {
1127 tcx.sess.fatal(&format!("--pretty flowgraph couldn't find id: {}", nodeid))
1130 match blocks::Code::from_node(&tcx.hir, nodeid) {
1132 let variants = gather_flowgraph_variants(tcx.sess);
1134 let out: &mut Write = &mut out;
1136 print_flowgraph(variants, tcx, code, mode, out)
1139 let message = format!("--pretty=flowgraph needs block, fn, or method; \
1143 tcx.sess.span_fatal(tcx.hir.span(nodeid), &message)
1147 _ => unreachable!(),
1153 write_output(out, ofile);