5 // Leszek Ciesielski (skolima@gmail.com)
6 // Rolf Bjarne Kvinge (rolf@xamarin.com)
7 // Atsushi Enomoto (atsushi@xamarin.com)
9 // (C) 2011 Leszek Ciesielski
10 // Copyright (C) 2011,2013 Xamarin Inc. (http://www.xamarin.com)
12 // Permission is hereby granted, free of charge, to any person obtaining
13 // a copy of this software and associated documentation files (the
14 // "Software"), to deal in the Software without restriction, including
15 // without limitation the rights to use, copy, modify, merge, publish,
16 // distribute, sublicense, and/or sell copies of the Software, and to
17 // permit persons to whom the Software is furnished to do so, subject to
18 // the following conditions:
20 // The above copyright notice and this permission notice shall be
21 // included in all copies or substantial portions of the Software.
23 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
24 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
25 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
26 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
27 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
28 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
29 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
33 using System.Collections.Generic;
34 using System.Diagnostics;
39 using Microsoft.Build.Construction;
40 using Microsoft.Build.Exceptions;
41 using Microsoft.Build.Execution;
42 using Microsoft.Build.Framework;
43 using Microsoft.Build.Internal;
44 using Microsoft.Build.Logging;
45 using System.Collections;
47 namespace Microsoft.Build.Evaluation
49 [DebuggerDisplay ("{FullPath} EffectiveToolsVersion={ToolsVersion} #GlobalProperties="
50 + "{data.globalProperties.Count} #Properties={data.Properties.Count} #ItemTypes="
51 + "{data.ItemTypes.Count} #ItemDefinitions={data.ItemDefinitions.Count} #Items="
52 + "{data.Items.Count} #Targets={data.Targets.Count}")]
55 public Project (XmlReader xml)
56 : this (ProjectRootElement.Create (xml))
60 public Project (XmlReader xml, IDictionary<string, string> globalProperties,
62 : this (ProjectRootElement.Create (xml), globalProperties, toolsVersion)
66 public Project (XmlReader xml, IDictionary<string, string> globalProperties,
67 string toolsVersion, ProjectCollection projectCollection)
68 : this (ProjectRootElement.Create (xml), globalProperties, toolsVersion, projectCollection)
72 public Project (XmlReader xml, IDictionary<string, string> globalProperties,
73 string toolsVersion, ProjectCollection projectCollection,
74 ProjectLoadSettings loadSettings)
75 : this (ProjectRootElement.Create (xml), globalProperties, toolsVersion, projectCollection, loadSettings)
79 public Project (ProjectRootElement xml) : this (xml, null, null)
83 public Project (ProjectRootElement xml, IDictionary<string, string> globalProperties,
85 : this (xml, globalProperties, toolsVersion, ProjectCollection.GlobalProjectCollection)
89 public Project (ProjectRootElement xml, IDictionary<string, string> globalProperties,
90 string toolsVersion, ProjectCollection projectCollection)
91 : this (xml, globalProperties, toolsVersion, projectCollection, ProjectLoadSettings.Default)
95 public Project (ProjectRootElement xml, IDictionary<string, string> globalProperties,
96 string toolsVersion, ProjectCollection projectCollection,
97 ProjectLoadSettings loadSettings)
99 if (projectCollection == null)
100 throw new ArgumentNullException ("projectCollection");
102 this.GlobalProperties = globalProperties ?? new Dictionary<string, string> ();
103 this.ToolsVersion = toolsVersion;
104 this.ProjectCollection = projectCollection;
105 this.load_settings = loadSettings;
110 Project (ProjectRootElement imported, Project parent)
113 this.GlobalProperties = parent.GlobalProperties;
114 this.ToolsVersion = parent.ToolsVersion;
115 this.ProjectCollection = parent.ProjectCollection;
116 this.load_settings = parent.load_settings;
121 public Project (string projectFile)
122 : this (projectFile, null, null)
126 public Project (string projectFile, IDictionary<string, string> globalProperties,
128 : this (projectFile, globalProperties, toolsVersion, ProjectCollection.GlobalProjectCollection, ProjectLoadSettings.Default)
132 public Project (string projectFile, IDictionary<string, string> globalProperties,
133 string toolsVersion, ProjectCollection projectCollection)
134 : this (projectFile, globalProperties, toolsVersion, projectCollection, ProjectLoadSettings.Default)
138 public Project (string projectFile, IDictionary<string, string> globalProperties,
139 string toolsVersion, ProjectCollection projectCollection,
140 ProjectLoadSettings loadSettings)
141 : this (ProjectRootElement.Create (projectFile), globalProperties, toolsVersion, projectCollection, loadSettings)
145 ProjectLoadSettings load_settings;
147 public IDictionary<string, string> GlobalProperties { get; private set; }
149 public ProjectCollection ProjectCollection { get; private set; }
151 public string ToolsVersion { get; private set; }
153 public ProjectRootElement Xml { get; private set; }
156 Dictionary<string, ProjectItemDefinition> item_definitions;
157 List<ResolvedImport> raw_imports;
158 List<ProjectItem> raw_items;
159 List<ProjectItem> all_evaluated_items;
160 List<ProjectProperty> properties;
161 Dictionary<string, ProjectTargetInstance> targets;
163 void Initialize (Project parent)
165 dir_path = Directory.GetCurrentDirectory ();
166 raw_imports = new List<ResolvedImport> ();
167 item_definitions = new Dictionary<string, ProjectItemDefinition> ();
168 targets = new Dictionary<string, ProjectTargetInstance> ();
169 raw_items = new List<ProjectItem> ();
171 // FIXME: this is likely hack. Test ImportedProject.Properties to see what exactly should happen.
172 if (parent != null) {
173 properties = parent.properties;
175 properties = new List<ProjectProperty> ();
177 foreach (DictionaryEntry p in Environment.GetEnvironmentVariables ())
178 this.properties.Add (new EnvironmentProjectProperty (this, (string)p.Key, (string)p.Value));
179 foreach (var p in GlobalProperties)
180 this.properties.Add (new GlobalProjectProperty (this, p.Key, p.Value));
181 var tools = ProjectCollection.GetToolset (this.ToolsVersion) ?? ProjectCollection.GetToolset (this.ProjectCollection.DefaultToolsVersion);
182 foreach (var p in ProjectCollection.GetReservedProperties (tools, this))
183 this.properties.Add (p);
184 foreach (var p in ProjectCollection.GetWellKnownProperties (this))
185 this.properties.Add (p);
190 ProjectCollection.AddProject (this);
193 static readonly char [] item_sep = {';'};
195 void ProcessXml (Project parent)
197 // this needs to be initialized here (regardless of that items won't be evaluated at property evaluation;
198 // Conditions could incorrectly reference items and lack of this list causes NRE.
199 all_evaluated_items = new List<ProjectItem> ();
201 // property evaluation happens couple of times.
202 // At first step, all non-imported properties are evaluated TOO, WHILE those properties are being evaluated.
203 // This means, Include and IncludeGroup elements with Condition attribute MAY contain references to
204 // properties and they will be expanded.
205 var elements = EvaluatePropertiesAndImports (Xml.Children).ToArray (); // ToArray(): to not lazily evaluate elements.
207 // next, evaluate items
208 EvaluateItems (elements);
211 IEnumerable<ProjectElement> EvaluatePropertiesAndImports (IEnumerable<ProjectElement> elements)
213 // First step: evaluate Properties
214 foreach (var child in elements) {
216 var pge = child as ProjectPropertyGroupElement;
217 if (pge != null && Evaluate (pge.Condition))
218 foreach (var p in pge.Properties)
219 // do not allow overwriting reserved or well-known properties by user
220 if (!this.properties.Any (_ => (_.IsReservedProperty || _.IsWellKnownProperty) && _.Name.Equals (p.Name, StringComparison.InvariantCultureIgnoreCase)))
221 if (Evaluate (p.Condition))
222 this.properties.Add (new XmlProjectProperty (this, p, PropertyType.Normal, ProjectCollection.OngoingImports.Any ()));
224 var ige = child as ProjectImportGroupElement;
225 if (ige != null && Evaluate (ige.Condition)) {
226 foreach (var incc in ige.Imports) {
227 foreach (var e in Import (incc))
231 var inc = child as ProjectImportElement;
232 if (inc != null && Evaluate (inc.Condition))
233 foreach (var e in Import (inc))
238 void EvaluateItems (IEnumerable<ProjectElement> elements)
240 foreach (var child in elements) {
241 var ige = child as ProjectItemGroupElement;
243 foreach (var p in ige.Items) {
244 if (!Evaluate (ige.Condition) || !Evaluate (p.Condition))
246 var includes = ExpandString (p.Include).Split (item_sep, StringSplitOptions.RemoveEmptyEntries);
247 var excludes = ExpandString (p.Exclude).Split (item_sep, StringSplitOptions.RemoveEmptyEntries);
249 if (includes.Length == 0)
251 if (includes.Length == 1 && includes [0].IndexOf ('*') < 0 && excludes.Length == 0) {
252 // for most case - shortcut.
253 var item = new ProjectItem (this, p, includes [0]);
254 this.raw_items.Add (item);
255 all_evaluated_items.Add (item);
257 var ds = new Microsoft.Build.BuildEngine.DirectoryScanner () {
258 BaseDirectory = new DirectoryInfo (DirectoryPath),
259 Includes = includes.Select (i => new ProjectTaskItem (p, i)).ToArray (),
260 Excludes = excludes.Select (e => new ProjectTaskItem (p, e)).ToArray (),
263 foreach (var taskItem in ds.MatchedItems) {
264 if (all_evaluated_items.Any (i => i.EvaluatedInclude == taskItem.ItemSpec && i.ItemType == p.ItemType))
265 continue; // skip duplicate
266 var item = new ProjectItem (this, p, taskItem.ItemSpec);
267 string recurse = taskItem.GetMetadata ("RecursiveDir");
268 if (!string.IsNullOrEmpty (recurse))
269 item.RecursiveDir = recurse;
270 this.raw_items.Add (item);
271 all_evaluated_items.Add (item);
276 var def = child as ProjectItemDefinitionGroupElement;
278 foreach (var p in def.ItemDefinitions) {
279 if (Evaluate (p.Condition)) {
280 ProjectItemDefinition existing;
281 if (!item_definitions.TryGetValue (p.ItemType, out existing))
282 item_definitions.Add (p.ItemType, (existing = new ProjectItemDefinition (this, p.ItemType)));
283 existing.AddItems (p);
288 all_evaluated_items.Sort ((p1, p2) => string.Compare (p1.ItemType, p2.ItemType, StringComparison.OrdinalIgnoreCase));
291 IEnumerable<ProjectElement> Import (ProjectImportElement import)
293 string dir = ProjectCollection.GetEvaluationTimeThisFileDirectory (() => FullPath);
294 string path = Path.IsPathRooted (import.Project) ? import.Project : dir != null ? Path.Combine (dir, import.Project) : Path.GetFullPath (import.Project);
295 if (ProjectCollection.OngoingImports.Contains (path)) {
296 switch (load_settings) {
297 case ProjectLoadSettings.RejectCircularImports:
298 throw new InvalidProjectFileException (import.Location, null, string.Format ("Circular imports was detected: {0} is already on \"importing\" stack", path));
300 return new ProjectElement [0]; // do not import circular references
302 ProjectCollection.OngoingImports.Push (path);
304 using (var reader = XmlReader.Create (path)) {
305 var root = ProjectRootElement.Create (reader, ProjectCollection);
306 raw_imports.Add (new ResolvedImport (import, root, true));
307 return this.EvaluatePropertiesAndImports (root.Children).ToArray ();
310 ProjectCollection.OngoingImports.Pop ();
314 public ICollection<ProjectItem> GetItemsIgnoringCondition (string itemType)
316 return new CollectionFromEnumerable<ProjectItem> (raw_items.Where (p => p.ItemType.Equals (itemType, StringComparison.OrdinalIgnoreCase)));
319 public void RemoveItems (IEnumerable<ProjectItem> items)
321 var removal = new List<ProjectItem> (items);
322 foreach (var item in removal) {
323 var parent = item.Xml.Parent;
324 parent.RemoveChild (item.Xml);
325 if (parent.Count == 0)
326 parent.Parent.RemoveChild (parent);
330 static readonly Dictionary<string, string> empty_metadata = new Dictionary<string, string> ();
332 public IList<ProjectItem> AddItem (string itemType, string unevaluatedInclude)
334 return AddItem (itemType, unevaluatedInclude, empty_metadata);
337 public IList<ProjectItem> AddItem (string itemType, string unevaluatedInclude,
338 IEnumerable<KeyValuePair<string, string>> metadata)
340 // FIXME: needs several check that AddItemFast() does not process (see MSDN for details).
342 return AddItemFast (itemType, unevaluatedInclude, metadata);
345 public IList<ProjectItem> AddItemFast (string itemType, string unevaluatedInclude)
347 return AddItemFast (itemType, unevaluatedInclude, empty_metadata);
350 public IList<ProjectItem> AddItemFast (string itemType, string unevaluatedInclude,
351 IEnumerable<KeyValuePair<string, string>> metadata)
353 throw new NotImplementedException ();
358 return Build (Xml.DefaultTargets.Split (';'));
361 public bool Build (IEnumerable<ILogger> loggers)
363 return Build (Xml.DefaultTargets.Split (';'), loggers);
366 public bool Build (string target)
368 return string.IsNullOrWhiteSpace (target) ? Build () : Build (new string [] {target});
371 public bool Build (string[] targets)
373 return Build (targets, new ILogger [0]);
376 public bool Build (ILogger logger)
378 return Build (Xml.DefaultTargets.Split (';'), new ILogger [] {logger});
381 public bool Build (string[] targets, IEnumerable<ILogger> loggers)
383 return Build (targets, loggers, new ForwardingLoggerRecord [0]);
386 public bool Build (IEnumerable<ILogger> loggers, IEnumerable<ForwardingLoggerRecord> remoteLoggers)
388 return Build (Xml.DefaultTargets.Split (';'), loggers, remoteLoggers);
391 public bool Build (string target, IEnumerable<ILogger> loggers)
393 return Build (new string [] { target }, loggers);
396 public bool Build (string[] targets, IEnumerable<ILogger> loggers, IEnumerable<ForwardingLoggerRecord> remoteLoggers)
398 // Unlike ProjectInstance.Build(), there is no place to fill outputs by targets, so ignore them
399 // (i.e. we don't use the overload with output).
401 // This does not check FullPath, so don't call GetProjectInstanceForBuild() directly.
402 return new BuildManager ().GetProjectInstanceForBuildInternal (this).Build (targets, loggers, remoteLoggers);
405 public bool Build (string target, IEnumerable<ILogger> loggers, IEnumerable<ForwardingLoggerRecord> remoteLoggers)
407 return Build (new string [] { target }, loggers, remoteLoggers);
410 public ProjectInstance CreateProjectInstance ()
412 var ret = new ProjectInstance (Xml, GlobalProperties, ToolsVersion, ProjectCollection);
413 // FIXME: maybe fill other properties to the result.
417 bool Evaluate (string unexpandedValue)
419 return string.IsNullOrWhiteSpace (unexpandedValue) || new ExpressionEvaluator (this, null).EvaluateAsBoolean (unexpandedValue);
422 public string ExpandString (string unexpandedValue)
424 return ExpandString (unexpandedValue, null);
427 string ExpandString (string unexpandedValue, string replacementForMissingStuff)
429 return new ExpressionEvaluator (this, replacementForMissingStuff).Evaluate (unexpandedValue);
432 public static string GetEvaluatedItemIncludeEscaped (ProjectItem item)
434 return ProjectCollection.Escape (item.EvaluatedInclude);
437 public static string GetEvaluatedItemIncludeEscaped (ProjectItemDefinition item)
439 // ?? ItemDefinition does not have Include attribute. What's the point here?
440 throw new NotImplementedException ();
443 public ICollection<ProjectItem> GetItems (string itemType)
445 return new CollectionFromEnumerable<ProjectItem> (Items.Where (p => p.ItemType.Equals (itemType, StringComparison.OrdinalIgnoreCase)));
448 public ICollection<ProjectItem> GetItemsByEvaluatedInclude (string evaluatedInclude)
450 return new CollectionFromEnumerable<ProjectItem> (Items.Where (p => p.EvaluatedInclude.Equals (evaluatedInclude, StringComparison.OrdinalIgnoreCase)));
453 public IEnumerable<ProjectElement> GetLogicalProject ()
455 throw new NotImplementedException ();
458 public static string GetMetadataValueEscaped (ProjectMetadata metadatum)
460 return ProjectCollection.Escape (metadatum.EvaluatedValue);
463 public static string GetMetadataValueEscaped (ProjectItem item, string name)
465 var md = item.GetMetadata (name);
466 return md != null ? ProjectCollection.Escape (md.EvaluatedValue) : null;
469 public static string GetMetadataValueEscaped (ProjectItemDefinition item, string name)
471 var md = item.Metadata.FirstOrDefault (m => m.Name == name);
472 return md != null ? ProjectCollection.Escape (md.EvaluatedValue) : null;
475 public string GetPropertyValue (string name)
477 var prop = GetProperty (name);
478 return prop != null ? prop.EvaluatedValue : string.Empty;
481 public static string GetPropertyValueEscaped (ProjectProperty property)
484 return property.EvaluatedValue;
487 public ProjectProperty GetProperty (string name)
489 return properties.FirstOrDefault (p => p.Name.Equals (name, StringComparison.OrdinalIgnoreCase));
492 public void MarkDirty ()
494 if (!DisableMarkDirty)
498 public void ReevaluateIfNecessary ()
500 throw new NotImplementedException ();
503 public bool RemoveGlobalProperty (string name)
505 throw new NotImplementedException ();
508 public bool RemoveItem (ProjectItem item)
510 throw new NotImplementedException ();
513 public bool RemoveProperty (ProjectProperty property)
515 var removed = properties.FirstOrDefault (p => p.Name.Equals (property.Name, StringComparison.OrdinalIgnoreCase));
518 properties.Remove (removed);
527 public void Save (TextWriter writer)
532 public void Save (string path)
534 Save (path, Encoding.Default);
537 public void Save (Encoding encoding)
539 Save (FullPath, encoding);
542 public void Save (string path, Encoding encoding)
544 using (var writer = new StreamWriter (path, false, encoding))
548 public void SaveLogicalProject (TextWriter writer)
550 throw new NotImplementedException ();
553 public bool SetGlobalProperty (string name, string escapedValue)
555 throw new NotImplementedException ();
558 public ProjectProperty SetProperty (string name, string unevaluatedValue)
560 var p = new ManuallyAddedProjectProperty (this, name, unevaluatedValue);
565 public ICollection<ProjectMetadata> AllEvaluatedItemDefinitionMetadata {
566 get { throw new NotImplementedException (); }
569 public ICollection<ProjectItem> AllEvaluatedItems {
570 get { return all_evaluated_items; }
573 public ICollection<ProjectProperty> AllEvaluatedProperties {
574 get { return properties; }
577 public IDictionary<string, List<string>> ConditionedProperties {
579 // this property returns different instances every time.
580 var dic = new Dictionary<string, List<string>> ();
582 // but I dunno HOW this evaluates
584 throw new NotImplementedException ();
588 public string DirectoryPath {
589 get { return dir_path; }
592 public bool DisableMarkDirty { get; set; }
594 public int EvaluationCounter {
595 get { throw new NotImplementedException (); }
598 public string FullPath {
599 get { return Xml.FullPath; }
600 set { Xml.FullPath = value; }
603 class ResolvedImportComparer : IEqualityComparer<ResolvedImport>
605 public static ResolvedImportComparer Instance = new ResolvedImportComparer ();
607 public bool Equals (ResolvedImport x, ResolvedImport y)
609 return x.ImportedProject.FullPath.Equals (y.ImportedProject.FullPath);
611 public int GetHashCode (ResolvedImport obj)
613 return obj.ImportedProject.FullPath.GetHashCode ();
617 public IList<ResolvedImport> Imports {
618 get { return raw_imports.Distinct (ResolvedImportComparer.Instance).ToList (); }
621 public IList<ResolvedImport> ImportsIncludingDuplicates {
622 get { return raw_imports; }
625 public bool IsBuildEnabled {
626 get { return ProjectCollection.IsBuildEnabled; }
630 public bool IsDirty {
631 get { return is_dirty; }
634 public IDictionary<string, ProjectItemDefinition> ItemDefinitions {
635 get { return item_definitions; }
638 [MonoTODO ("should be different from AllEvaluatedItems")]
639 public ICollection<ProjectItem> Items {
640 get { return AllEvaluatedItems; }
643 public ICollection<ProjectItem> ItemsIgnoringCondition {
644 get { return raw_items; }
647 public ICollection<string> ItemTypes {
648 get { return new CollectionFromEnumerable<string> (raw_items.Select (i => i.ItemType).Distinct ()); }
651 [MonoTODO ("should be different from AllEvaluatedProperties")]
652 public ICollection<ProjectProperty> Properties {
653 get { return AllEvaluatedProperties; }
656 public bool SkipEvaluation { get; set; }
663 IDictionary<string, ProjectTargetInstance> Targets {
664 get { return targets; }
667 // These are required for reserved property, represents dynamically changing property values.
668 // This should resolve to either the project file path or that of the imported file.
669 internal string GetEvaluationTimeThisFileDirectory ()
671 var file = GetEvaluationTimeThisFile ();
672 var dir = Path.IsPathRooted (file) ? Path.GetDirectoryName (file) : Directory.GetCurrentDirectory ();
673 return dir + Path.DirectorySeparatorChar;
676 internal string GetEvaluationTimeThisFile ()
678 return ProjectCollection.OngoingImports.Count > 0 ? ProjectCollection.OngoingImports.Peek () : FullPath ?? string.Empty;
681 internal string GetFullPath (string pathRelativeToProject)
683 if (Path.IsPathRooted (pathRelativeToProject))
684 return pathRelativeToProject;
685 return Path.GetFullPath (Path.Combine (DirectoryPath, pathRelativeToProject));