summaryrefslogtreecommitdiff
path: root/src/api/wix/WixToolset.Extensibility/IInspectorExtension.cs
diff options
context:
space:
mode:
Diffstat (limited to 'src/api/wix/WixToolset.Extensibility/IInspectorExtension.cs')
-rw-r--r--src/api/wix/WixToolset.Extensibility/IInspectorExtension.cs60
1 files changed, 0 insertions, 60 deletions
diff --git a/src/api/wix/WixToolset.Extensibility/IInspectorExtension.cs b/src/api/wix/WixToolset.Extensibility/IInspectorExtension.cs
deleted file mode 100644
index 7c488a89..00000000
--- a/src/api/wix/WixToolset.Extensibility/IInspectorExtension.cs
+++ /dev/null
@@ -1,60 +0,0 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Extensibility
4{
5 using System;
6 using System.IO;
7 using WixToolset.Data;
8
9 /// <summary>
10 /// Interface for inspector extensions.
11 /// </summary>
12 /// <remarks>
13 /// The inspector methods are stateless, but extensions are loaded once. If you want to maintain state, you should check
14 /// if your data is loaded for each method and, if not, load it.
15 /// </remarks>
16 public interface IInspectorExtension
17 {
18 /// <summary>
19 /// Gets or sets the <see cref="IInspectorCore"/> for inspector extensions to use.
20 /// </summary>
21 IInspectorCore Core { get; set; }
22
23 /// <summary>
24 /// Inspect the source before preprocessing.
25 /// </summary>
26 /// <param name="source">The source to preprocess.</param>
27 void InspectSource(Stream source);
28
29 /// <summary>
30 /// Inspect the compiled output.
31 /// </summary>
32 /// <param name="intermediate">The compiled output.</param>
33 void InspectIntermediate(Intermediate intermediate);
34
35#if REWRITE
36 /// <summary>
37 /// Inspect the output.
38 /// </summary>
39 /// <param name="output">The output. May be called after linking or binding.</param>
40 /// <remarks>
41 /// To inspect a patch's filtered transforms, enumerate <see cref="Output.SubStorages"/>.
42 /// Transforms where the <see cref="SubStorage.Name"/> begins with "#" are
43 /// called patch transforms and instruct Windows Installer how to apply the
44 /// authored transforms - those that do not begin with "#". The authored
45 /// transforms are the primary transforms you'll typically want to inspect
46 /// and contain your changes to target products.
47 /// </remarks>
48#endif
49 /// <summary />
50 void InspectOutput(Intermediate output);
51
52 /// <summary>
53 /// Inspect the final output after binding.
54 /// </summary>
55 /// <param name="filePath">The file path to the final bound output.</param>
56 /// <param name="pdb">The <see cref="Intermediate"/> that contains source line numbers
57 /// for the database and all rows.</param>
58 void InspectDatabase(string filePath, Intermediate pdb);
59 }
60}