UnrealEngineUWP/Engine/Source/Programs/Shared/EpicGames.BuildGraph/BgAgent.cs

// Copyright Epic Games, Inc. All Rights Reserved.

using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Xml;

namespace EpicGames.BuildGraph
{
	/// <summary>
	/// Stores a list of nodes which can be executed on a single agent
	/// </summary>
	[DebuggerDisplay("{Name}")]
	public class BgAgent
	{
		/// <summary>
		/// Name of this agent. Used for display purposes in a build system.
		/// </summary>
		public string Name { get; }

		/// <summary>
		/// Array of valid agent types that these nodes may run on. When running in the build system, this determines the class of machine that should
		/// be selected to run these nodes. The first defined agent type for this branch will be used.
		/// </summary>
		public string[] PossibleTypes { get; }

		/// <summary>
		/// List of nodes in this agent group.
		/// </summary>
		public List<BgNode> Nodes { get; set; } = new List<BgNode>();

		/// <summary>
		/// Constructor
		/// </summary>
		/// <param name="InName">Name of this agent group</param>
		/// <param name="InPossibleTypes">Array of valid agent types. See comment for AgentTypes member.</param>
		public BgAgent(string InName, string[] InPossibleTypes)
		{
			Name = InName;
			PossibleTypes = InPossibleTypes;
		}

		/// <summary>
		/// Writes this agent group out to a file, filtering nodes by a controlling trigger
		/// </summary>
		/// <param name="Writer">The XML writer to output to</param>
		public void Write(XmlWriter Writer)
		{
			Writer.WriteStartElement("Agent");
			Writer.WriteAttributeString("Name", Name);
			Writer.WriteAttributeString("Type", String.Join(";", PossibleTypes));
			foreach (BgNode Node in Nodes)
			{
				Node.Write(Writer);
			}
			Writer.WriteEndElement();
		}
	}
}