mcs/class/System/Test/System.CodeDom.Compiler/CodeGeneratorGenerateFromCompileUnitTest.cs

   1 //
   2 // CodeGenerator.GenerateFromCompileUnit Tests
   3 //
   4 // Authors:
   5 // Ilker Cetinkaya (mail@ilker.de)
   6 //
   7 // This is a specific test for an issue on GenerateFromCompileUnit.
   8 // Up until 2012 (version 2.10.n) the method emits attribute first
   9 // and imports afterwards on global namespace scope. Example:
  10 //
  11 // ~~~~
  12 // [assembly: AssemblyVersion("1.0")]
  13 // using System.Reflection;
  14 // ~~~~
  15 //
  16 // This in particular causes compiler to bail with CS1529.
  17 // Albeit well aware that this is a _language specific_ issue
  18 // (or requirement), the actual fix is aimed on CodeGenerator since
  19 // the wrong emit order is as well in GenerateFromCompileUnit of abstract
  20 // base. The probability to harm any other language generators
  21 // is very low. It's near common sense to have imports on top
  22 // on global namespace / file level.
  23 //
  24 // The test is being repeated for the internal `CSharpCodeGenerator`.
  25 // See `Microsoft.CSharp` (Mono.CSharp namespace) for details.
  26 //
  27 // This test verifies the issue as well as describes correct expectation.
  28
  29 using System;
  30 using System.CodeDom;
  31 using System.CodeDom.Compiler;
  32 using Microsoft.CSharp;
  33 using System.IO;
  34
  35 using NUnit.Framework;
  36
  37 namespace MonoTests.System.CodeDom.Compiler
  38 {
  39         [TestFixture]
  40         public class CodeGeneratorGenerateFromCompileUnitTest {
  41                 [Test]
  42                 public void When_Having_AssemblyAttribute_And_Using_Namespace_It_Should_Generate_Namespace_First_And_Attribute_Afterwards () {
  43                         ICodeGenerator generator = new SampleCodeGenerator ();
  44                         var compileUnit = ACompileUnitWithAttributeAndNamespace ();
  45                         var writer = new StringWriter ();
  46                         var options = new CodeGeneratorOptions ();
  47
  48                         generator.GenerateCodeFromCompileUnit (compileUnit, writer, options);
  49
  50                         string result = writer.ToString ();
  51
  52                         int importPosition = result.IndexOf (IMPORT);
  53                         int attributePosition = result.IndexOf (ATTRIBUTE);
  54
  55                         Assert.Greater (attributePosition, importPosition, "Actual order: " + result);
  56                 }
  57
  58                 [Test]
  59                 public void CodeSnippetBlankLines ()
  60                 {
  61                         var opt = new CodeGeneratorOptions () {
  62                                 BlankLinesBetweenMembers = false,
  63                                 VerbatimOrder = false
  64                         };
  65
  66                         var ccu = new CodeCompileUnit ();
  67                         var ns = new CodeNamespace ("Foo");
  68                         ccu.Namespaces.Add (ns);
  69                         var t = new CodeTypeDeclaration ("Bar");
  70                         ns.Types.Add (t);
  71
  72                         t.Members.Add (new CodeSnippetTypeMember ("#line hidden"));
  73                         t.Members.Add (new CodeSnippetTypeMember ("#line hidden2"));
  74
  75                         t.Members.Add (new CodeMemberMethod () { Name = "Foo" });
  76
  77                         using (var sw = new StringWriter ()) {
  78                                 new CSharpCodeProvider ().GenerateCodeFromCompileUnit (ccu, sw, opt);
  79                                 var str = sw.ToString ();
  80
  81                                 Assert.IsFalse (str.Contains ("hidden2private"), "#0");
  82                                 Assert.IsTrue (str.Contains( "#line hidden#line hidden2"), "#1");
  83                         }
  84                 }
  85
  86                 [Test]
  87                 public void CodeSnippetBlankLinesVerbatimOrder ()
  88                 {
  89                         var opt = new CodeGeneratorOptions () {
  90                                 BlankLinesBetweenMembers = false,
  91                                 VerbatimOrder = true
  92                         };
  93
  94                         var ccu = new CodeCompileUnit ();
  95                         var ns = new CodeNamespace ("Foo");
  96                         ccu.Namespaces.Add (ns);
  97                         var t = new CodeTypeDeclaration ("Bar");
  98                         ns.Types.Add (t);
  99
 100                         t.Members.Add (new CodeSnippetTypeMember ("#line hidden"));
 101                         t.Members.Add (new CodeSnippetTypeMember ("#line hidden2"));
 102
 103                         t.Members.Add (new CodeMemberMethod () { Name = "Foo" });
 104
 105                         using (var sw = new StringWriter ()) {
 106                                 new CSharpCodeProvider ().GenerateCodeFromCompileUnit (ccu, sw, opt);
 107                                 var str = sw.ToString ();
 108
 109                                 Assert.IsFalse (str.Contains ("hidden2private"), "#0");
 110                                 Assert.IsFalse (str.Contains( "#line hidden#line hidden2"), "#1");
 111                                 Assert.IsTrue (str.Contains( "#line hidden" + Environment.NewLine), "#2");
 112                                 Assert.IsTrue (str.Contains( "#line hidden2" + Environment.NewLine), "#3");
 113                         }
 114                 }
 115
 116                 private const string ATTRIBUTE = "ATTRIBUTE";
 117                 private const string IMPORT = "IMPORT";
 118
 119                 private CodeCompileUnit ACompileUnitWithAttributeAndNamespace () {
 120                         var compileUnit = new CodeCompileUnit ();
 121                         var importNs = new CodeNamespace ();
 122
 123                         importNs.Imports.Add (new CodeNamespaceImport (IMPORT));
 124
 125                         compileUnit.AssemblyCustomAttributes.Add (new CodeAttributeDeclaration (ATTRIBUTE));
 126                         compileUnit.Namespaces.Add (importNs);
 127
 128                         return compileUnit;
 129                 }
 130
 131                 private class SampleCodeGenerator : CodeGenerator {
 132                         /* test overrides */
 133                         protected override void GenerateAttributeDeclarationsStart (CodeAttributeDeclarationCollection attributes) { Output.Write ("ATTRIBUTE"); }
 134                         protected override void GenerateAttributeDeclarationsEnd (CodeAttributeDeclarationCollection attributes) {}
 135                         protected override void GenerateNamespaceImport (CodeNamespaceImport i) { Output.Write ("IMPORT"); }
 136                         /* must overrides */
 137                         protected override string NullToken { get { return string.Empty; } }
 138                         protected override void GenerateArgumentReferenceExpression (CodeArgumentReferenceExpression e) {}
 139                         protected override void GenerateArrayCreateExpression (CodeArrayCreateExpression e) {}
 140                         protected override void GenerateArrayIndexerExpression (CodeArrayIndexerExpression e) {}
 141                         protected override void GenerateAssignStatement (CodeAssignStatement s) {}
 142                         protected override void GenerateAttachEventStatement (CodeAttachEventStatement s) {}
 143                         protected override void GenerateBaseReferenceExpression (CodeBaseReferenceExpression e) {}
 144                         protected override void GenerateCastExpression (CodeCastExpression e) {}
 145                         protected override void GenerateComment (CodeComment comment) {}
 146                         protected override void GenerateConditionStatement (CodeConditionStatement s) {}
 147                         protected override void GenerateConstructor (CodeConstructor x, CodeTypeDeclaration d) {}
 148                         protected override void GenerateDelegateCreateExpression (CodeDelegateCreateExpression e) {}
 149                         protected override void GenerateDelegateInvokeExpression (CodeDelegateInvokeExpression e) {}
 150                         protected override void GenerateEntryPointMethod (CodeEntryPointMethod m, CodeTypeDeclaration d) {}
 151                         protected override void GenerateEvent (CodeMemberEvent ev, CodeTypeDeclaration d) {}
 152                         protected override void GenerateEventReferenceExpression (CodeEventReferenceExpression e) {}
 153                         protected override void GenerateExpressionStatement (CodeExpressionStatement statement) {}
 154                         protected override void GenerateField (CodeMemberField f) {}
 155                         protected override void GenerateFieldReferenceExpression (CodeFieldReferenceExpression e) {}
 156                         protected override void GenerateGotoStatement (CodeGotoStatement statement) {}
 157                         protected override void GenerateIndexerExpression (CodeIndexerExpression e) {}
 158                         protected override void GenerateIterationStatement (CodeIterationStatement s) {}
 159                         protected override void GenerateLabeledStatement (CodeLabeledStatement statement) {}
 160                         protected override void GenerateLinePragmaStart (CodeLinePragma p) {}
 161                         protected override void GenerateLinePragmaEnd (CodeLinePragma p) {}
 162                         protected override void GenerateMethod (CodeMemberMethod m, CodeTypeDeclaration d) {}
 163                         protected override void GenerateMethodInvokeExpression (CodeMethodInvokeExpression e) {}
 164                         protected override void GenerateMethodReferenceExpression (CodeMethodReferenceExpression e) {}
 165                         protected override void GenerateMethodReturnStatement (CodeMethodReturnStatement e) {}
 166                         protected override void GenerateNamespaceStart (CodeNamespace ns) {}
 167                         protected override void GenerateNamespaceEnd (CodeNamespace ns) {}
 168                         protected override void GenerateObjectCreateExpression (CodeObjectCreateExpression e) {}
 169                         protected override void GenerateProperty (CodeMemberProperty p, CodeTypeDeclaration d) {}
 170                         protected override void GeneratePropertyReferenceExpression (CodePropertyReferenceExpression e) {}
 171                         protected override void GeneratePropertySetValueReferenceExpression (CodePropertySetValueReferenceExpression e) {}
 172                         protected override void GenerateRemoveEventStatement (CodeRemoveEventStatement statement) {}
 173                         protected override void GenerateSnippetExpression (CodeSnippetExpression e) {}
 174                         protected override void GenerateSnippetMember (CodeSnippetTypeMember m) {}
 175                         protected override void GenerateThisReferenceExpression (CodeThisReferenceExpression e) {}
 176                         protected override void GenerateThrowExceptionStatement (CodeThrowExceptionStatement s) {}
 177                         protected override void GenerateTryCatchFinallyStatement (CodeTryCatchFinallyStatement s) {}
 178                         protected override void GenerateTypeEnd (CodeTypeDeclaration declaration) {}
 179                         protected override void GenerateTypeConstructor (CodeTypeConstructor constructor) {}
 180                         protected override void GenerateTypeStart (CodeTypeDeclaration declaration) {}
 181                         protected override void GenerateVariableDeclarationStatement (CodeVariableDeclarationStatement e) {}
 182                         protected override void GenerateVariableReferenceExpression (CodeVariableReferenceExpression e) {}
 183                         protected override void OutputType (CodeTypeReference t) {}
 184                         protected override string QuoteSnippetString (string value) { return string.Empty; }
 185                         protected override string CreateEscapedIdentifier (string value) { return string.Empty; }
 186                         protected override string CreateValidIdentifier (string value) { return string.Empty; }
 187                         protected override string GetTypeOutput (CodeTypeReference type) { return string.Empty; }
 188                         protected override bool IsValidIdentifier (string value) { return false; }
 189                         protected override bool Supports (GeneratorSupport supports) { return false; }
 190                 }
 191         }
 192 }