From 87dfb308db0a83a3443fe71127716411474b0b69 Mon Sep 17 00:00:00 2001 From: "Joseph K. Strauss" Date: Wed, 8 Aug 2018 09:36:17 -0400 Subject: Visualize Plan (#404) * Make necessary import changes * Refactor to allow calling internally w/o println * Refactor to allow multiple visualize modes * Add new visualizaPlan grap entire plan * Remove and alphabetize imports * Document visualizePlan --- docs/pages/1 - Intro to Mill.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) (limited to 'docs/pages') diff --git a/docs/pages/1 - Intro to Mill.md b/docs/pages/1 - Intro to Mill.md index a3300595..49ac64da 100644 --- a/docs/pages/1 - Intro to Mill.md +++ b/docs/pages/1 - Intro to Mill.md @@ -558,6 +558,29 @@ compilation output: ![VisualizeCompile.svg](VisualizeCompile.svg) +### visualizePlan + +```bash +$ mill show visualizePlan moduledefs.allSourceFiles +[ + ".../out/visualizePlan/dest/out.txt", + ".../out/visualizePlan/dest/out.dot", + ".../out/visualizePlan/dest/out.json", + ".../out/visualizePlan/dest/out.png", + ".../out/visualizePlan/dest/out.svg" +] +``` + +`mill show visualizePlan` is similar except that it shows a graph of the entire +build plan, including dependencies not directly resolved by the query. Targets +directly resolved are shown with a solid border, and dependencies are shown with +a dotted border. + +The above command generates the following diagram: + +![VisualizePlan.svg](VisualizePlan.svg) + +Currently, visualizePlan does not support graphs that contain external modules. ### clean -- cgit v1.2.3