// Copyright 1998-2016 Epic Games, Inc. All Rights Reserved.
using System;
using System.Collections.Generic;
using System.Text;
using System.IO;
using AutomationTool;
using UnrealBuildTool;
using System.Reflection;
using System.Xml;
using System.Linq;
using System.Diagnostics;
namespace AutomationTool
{
///
/// Options for how the graph should be printed
///
enum GraphPrintOptions
{
///
/// Includes the list of dependencies for each node
///
ShowDependencies = 0x1,
///
/// Includes the list of notifiers for each node
///
ShowNotifications = 0x2,
}
///
/// Definition of a graph.
///
class Graph
{
///
/// List of nodes grouped by the agent they will be executed on
///
public List Groups = new List();
///
/// All manual triggers that are part of this graph
///
public Dictionary NameToTrigger = new Dictionary(StringComparer.InvariantCultureIgnoreCase);
///
/// Mapping of names to the corresponding node.
///
public Dictionary NameToNode = new Dictionary(StringComparer.InvariantCultureIgnoreCase);
///
/// Mapping of output names to their respective node
///
public Dictionary OutputNameToNode = new Dictionary(StringComparer.InvariantCultureIgnoreCase);
///
/// Mapping of aggregate names to their respective nodes
///
public Dictionary AggregateNameToNodes = new Dictionary(StringComparer.InvariantCultureIgnoreCase);
///
/// Default constructor
///
public Graph()
{
}
///
/// Tries to resolve the given name to one or more nodes. Checks for output names, aggregates, and actual nodes.
///
/// The name to search for
/// If the name is a match, receives the corresponding array of nodes
/// True if the name was found, false otherwise.
public bool TryResolveReference(string Name, out Node[] OutNodes)
{
// Check if it's a regular node or output name
Node Node;
if(NameToNode.TryGetValue(Name, out Node) || OutputNameToNode.TryGetValue(Name, out Node))
{
OutNodes = new Node[]{ Node };
return true;
}
// Check if it's an aggregate name
Node[] Nodes;
if(AggregateNameToNodes.TryGetValue(Name, out Nodes))
{
OutNodes = Nodes;
return true;
}
// Otherwise fail
OutNodes = null;
return false;
}
///
/// Cull the graph to only include the given nodes and their dependencies
///
/// A set of target nodes to build
public void Select(IEnumerable TargetNodes)
{
// Find this node and all its dependencies
HashSet RetainNodes = new HashSet(TargetNodes);
foreach(Node TargetNode in TargetNodes)
{
RetainNodes.UnionWith(TargetNode.InputDependencies);
}
// Remove all the nodes which are not marked to be kept
foreach(AgentGroup Group in Groups)
{
Group.Nodes = Group.Nodes.Where(x => RetainNodes.Contains(x)).ToList();
}
// Remove all the empty groups
Groups.RemoveAll(x => x.Nodes.Count == 0);
// Remove all the order dependencies which are no longer part of the graph. Since we don't need to build them, we don't need to wait for them
foreach(Node Node in RetainNodes)
{
Node.OrderDependencies = Node.OrderDependencies.Where(x => RetainNodes.Contains(x)).ToArray();
}
// Create a new list of triggers from all the nodes which are left
NameToTrigger = RetainNodes.Where(x => x.ControllingTrigger != null).Select(x => x.ControllingTrigger).Distinct().ToDictionary(x => x.Name, x => x, StringComparer.InvariantCultureIgnoreCase);
}
///
/// Export the build graph to a Json file, for parallel execution by the build system
///
/// Output file to write
/// Set of triggers which have been activated
/// Set of nodes which have been completed
public void Export(FileReference File, HashSet ActivatedTriggers, HashSet CompletedNodes)
{
// Find all the nodes which we're actually going to execute. We'll use this to filter the graph.
HashSet NodesToExecute = new HashSet();
foreach(Node Node in Groups.SelectMany(x => x.Nodes))
{
if(!CompletedNodes.Contains(Node))
{
if(Node.ControllingTrigger == null || ActivatedTriggers.Contains(Node.ControllingTrigger))
{
NodesToExecute.Add(Node);
}
}
}
// Open the output file
using(JsonWriter JsonWriter = new JsonWriter(File.FullName))
{
JsonWriter.WriteObjectStart();
// Write all the agent groups
JsonWriter.WriteArrayStart("Groups");
foreach(AgentGroup Group in Groups)
{
Node[] Nodes = Group.Nodes.Where(x => NodesToExecute.Contains(x)).ToArray();
if(Nodes.Length > 0)
{
JsonWriter.WriteObjectStart();
JsonWriter.WriteValue("Name", Group.Name);
JsonWriter.WriteArrayStart("Agent Types");
foreach(string AgentType in Group.AgentTypes)
{
JsonWriter.WriteValue(AgentType);
}
JsonWriter.WriteArrayEnd();
JsonWriter.WriteArrayStart("Nodes");
foreach(Node Node in Nodes)
{
JsonWriter.WriteObjectStart();
JsonWriter.WriteValue("Name", Node.Name);
JsonWriter.WriteValue("DependsOn", String.Join(";", Node.GetDirectOrderDependencies().Where(x => !CompletedNodes.Contains(x))));
JsonWriter.WriteObjectStart("Notify");
JsonWriter.WriteValue("Default", String.Join(";", Node.NotifyUsers));
JsonWriter.WriteValue("Submitters", String.Join(";", Node.NotifySubmitters));
JsonWriter.WriteValue("Warnings", Node.bNotifyOnWarnings);
JsonWriter.WriteObjectEnd();
JsonWriter.WriteObjectEnd();
}
JsonWriter.WriteArrayEnd();
JsonWriter.WriteObjectEnd();
}
}
JsonWriter.WriteArrayEnd();
// Write all the triggers
JsonWriter.WriteArrayStart("Triggers");
foreach (ManualTrigger Trigger in NameToTrigger.Values)
{
if(!ActivatedTriggers.Contains(Trigger) && NodesToExecute.Any(x => x.ControllingTrigger == Trigger.Parent))
{
// Find all the nodes that this trigger is dependent on
HashSet Dependencies = new HashSet();
foreach(Node Node in Groups.SelectMany(x => x.Nodes))
{
for(ManualTrigger ControllingTrigger = Node.ControllingTrigger; ControllingTrigger != null; ControllingTrigger = ControllingTrigger.Parent)
{
if(ControllingTrigger == Trigger)
{
Dependencies.UnionWith(Node.InputDependencies.Where(x => x.ControllingTrigger != Trigger && NodesToExecute.Contains(x)));
break;
}
}
}
// Reduce that list to the smallest subset of direct dependencies
HashSet DirectDependencies = new HashSet(Dependencies);
foreach(Node Dependency in Dependencies)
{
DirectDependencies.ExceptWith(Dependency.InputDependencies);
}
// Write out the object
JsonWriter.WriteObjectStart();
JsonWriter.WriteValue("Name", Trigger.Name);
JsonWriter.WriteValue("AllDependencies", String.Join(";", Groups.SelectMany(x => x.Nodes).Where(x => Dependencies.Contains(x)).Select(x => x.Name)));
JsonWriter.WriteValue("DirectDependencies", String.Join(";", Dependencies.Where(x => DirectDependencies.Contains(x)).Select(x => x.Name)));
JsonWriter.WriteValue("Notify", String.Join(";", Trigger.NotifyUsers));
JsonWriter.WriteObjectEnd();
}
}
JsonWriter.WriteArrayEnd();
JsonWriter.WriteObjectEnd();
}
}
///
/// Print the contents of the graph
///
/// Mapping of node to its current state
/// Options for how to print the graph
public void Print(HashSet CompletedNodes, GraphPrintOptions Options)
{
// Get a list of all the triggers, including the null global one
List AllTriggers = new List();
AllTriggers.Add(null);
AllTriggers.AddRange(NameToTrigger.Values.OrderBy(x => x.QualifiedName));
// Output all the triggers in order
CommandUtils.Log("");
CommandUtils.Log("Graph:");
foreach(ManualTrigger Trigger in AllTriggers)
{
// Filter everything by this trigger
Dictionary FilteredGroupToNodes = new Dictionary();
foreach(AgentGroup Group in Groups)
{
Node[] Nodes = Group.Nodes.Where(x => x.ControllingTrigger == Trigger).ToArray();
if(Nodes.Length > 0)
{
FilteredGroupToNodes[Group] = Nodes;
}
}
// Skip this trigger if there's nothing to display
if(FilteredGroupToNodes.Count == 0)
{
continue;
}
// Print the trigger name
CommandUtils.Log(" Trigger: {0}", (Trigger == null)? "None" : Trigger.QualifiedName);
if(Trigger != null && Options.HasFlag(GraphPrintOptions.ShowNotifications))
{
foreach(string User in Trigger.NotifyUsers)
{
CommandUtils.Log(" notify> {0}", User);
}
}
// Output all the groups for this trigger
foreach(AgentGroup Group in Groups)
{
Node[] Nodes;
if(FilteredGroupToNodes.TryGetValue(Group, out Nodes))
{
CommandUtils.Log(" Group: {0} ({1})", Group.Name, String.Join(";", Group.AgentTypes));
foreach(Node Node in Nodes)
{
CommandUtils.Log(" Node: {0}{1}", Node.Name, CompletedNodes.Contains(Node)? " (completed)" : "");
if(Options.HasFlag(GraphPrintOptions.ShowDependencies))
{
HashSet InputDependencies = new HashSet(Node.GetDirectInputDependencies());
foreach(Node InputDependency in InputDependencies)
{
CommandUtils.Log(" input> {0}", InputDependency.Name);
}
HashSet OrderDependencies = new HashSet(Node.GetDirectOrderDependencies());
foreach(Node OrderDependency in OrderDependencies.Except(InputDependencies))
{
CommandUtils.Log(" after> {0}", OrderDependency.Name);
}
}
if(Options.HasFlag(GraphPrintOptions.ShowNotifications))
{
string Label = Node.bNotifyOnWarnings? "warnings" : "errors";
foreach(string User in Node.NotifyUsers)
{
CommandUtils.Log(" {0}> {1}", Label, User);
}
foreach(string Submitter in Node.NotifySubmitters)
{
CommandUtils.Log(" {0}> submitters to {1}", Label, Submitter);
}
}
}
}
}
}
CommandUtils.Log("");
// Print out all the aggregates
string[] AggregateNames = AggregateNameToNodes.Keys.OrderBy(x => x).ToArray();
if(AggregateNames.Length > 0)
{
CommandUtils.Log("Aggregates:");
foreach(string AggregateName in AggregateNames)
{
CommandUtils.Log(" {0}", AggregateName);
}
CommandUtils.Log("");
}
}
}
}