public void TryCreateTooltip_Attribute_MultipleAssociatedAttributes_ReturnsTrue()
{
// Arrange
var descriptionFactory = new DefaultTagHelperTooltipFactory(LanguageServer);
var associatedAttributeDescriptions = new[]
{
new BoundAttributeDescriptionInfo(
returnTypeName: "System.String",
typeName: "Microsoft.AspNetCore.SomeTagHelpers.SomeTypeName",
propertyName: "SomeProperty",
documentation: "<summary>Uses <see cref=\"T:System.Collections.List{System.String}\" />s</summary>"),
new BoundAttributeDescriptionInfo(
propertyName: "AnotherProperty",
typeName: "Microsoft.AspNetCore.SomeTagHelpers.AnotherTypeName",
returnTypeName: "System.Boolean?",
documentation: "<summary>\nUses <see cref=\"T:System.Collections.List{System.String}\" />s\n</summary>"),
};
var attributeDescription = new AggregateBoundAttributeDescription(associatedAttributeDescriptions);
// Act
var result = descriptionFactory.TryCreateTooltip(attributeDescription, out var markdown);
// Assert
Assert.True(result);
Assert.Equal(@"**string** SomeTypeName.**SomeProperty**
Uses `List<System.String>`s
---
**Boolean?** AnotherTypeName.**AnotherProperty**
Uses `List<System.String>`s", markdown.Value);
Assert.Equal(MarkupKind.Markdown, markdown.Kind);
}
public void TryCreateTooltip_Element_MultipleAssociatedTagHelpers_ReturnsTrue()
{
// Arrange
var descriptionFactory = new DefaultTagHelperTooltipFactory(LanguageServer);
var associatedTagHelperInfos = new[]
{
new BoundElementDescriptionInfo("Microsoft.AspNetCore.SomeTagHelper", "<summary>\nUses <see cref=\"T:System.Collections.List{System.String}\" />s\n</summary>"),
new BoundElementDescriptionInfo("Microsoft.AspNetCore.OtherTagHelper", "<summary>\nAlso uses <see cref=\"T:System.Collections.List{System.String}\" />s\n\r\n\r\r</summary>"),
};
var elementDescription = new AggregateBoundElementDescription(associatedTagHelperInfos);
// Act
var result = descriptionFactory.TryCreateTooltip(elementDescription, out var markdown);
// Assert
Assert.True(result);
Assert.Equal(@"**SomeTagHelper**
Uses `List<System.String>`s
---
**OtherTagHelper**
Also uses `List<System.String>`s", markdown.Value);
Assert.Equal(MarkupKind.Markdown, markdown.Kind);
}
public void TryCreateTooltip_Attribute_PlainText_NoBold()
{
// Arrange
var languageServer = LanguageServer;
languageServer.ClientSettings.Capabilities.TextDocument.Completion.Value.CompletionItem.DocumentationFormat = new Container <MarkupKind>(MarkupKind.PlainText);
var descriptionFactory = new DefaultTagHelperTooltipFactory(languageServer);
var associatedAttributeDescriptions = new[]
{
new BoundAttributeDescriptionInfo(
returnTypeName: "System.String",
typeName: "Microsoft.AspNetCore.SomeTagHelpers.SomeTypeName",
propertyName: "SomeProperty",
documentation: "<summary>Uses <see cref=\"T:System.Collections.List{System.String}\" />s</summary>")
};
var attributeDescription = new AggregateBoundAttributeDescription(associatedAttributeDescriptions);
// Act
var result = descriptionFactory.TryCreateTooltip(attributeDescription, out var markdown);
// Assert
Assert.True(result);
Assert.Equal(@"string SomeTypeName.SomeProperty
Uses `List<System.String>`s", markdown.Value);
Assert.Equal(MarkupKind.PlainText, markdown.Kind);
}
public void ReduceMemberName_UnbalancedDocs_NotRecoverable_ReturnsOriginalContent(string content)
{
// Arrange
// Act
var reduced = DefaultTagHelperTooltipFactory.ReduceMemberName(content);
// Assert
Assert.Equal(content, reduced);
}
public void ReduceCrefValue_Member()
{
// Arrange
var content = "P:Microsoft.AspNetCore.SometTagHelpers.SomeType.SomeMember";
// Act
var value = DefaultTagHelperTooltipFactory.ReduceCrefValue(content);
// Assert
Assert.Equal("SomeType.SomeMember", value);
}
public void ReduceCrefValue_InvalidUnknownIdentifierValue_ReturnsEmptyString()
{
// Arrange
var content = "X:";
// Act
var value = DefaultTagHelperTooltipFactory.ReduceCrefValue(content);
// Assert
Assert.Equal(string.Empty, value);
}
public void CleanSummaryContent_ReplacesSeeAlsoCrefs()
{
// Arrange
var summary = "Accepts <seealso cref=\"T:System.Collections.List{System.String}\" />s";
// Act
var cleanedSummary = DefaultTagHelperTooltipFactory.CleanSummaryContent(summary);
// Assert
Assert.Equal("Accepts `List<System.String>`s", cleanedSummary);
}
public void ReduceTypeName_NestedGenerics()
{
// Arrange
var content = "Microsoft.AspNetCore.SometTagHelpers.SomeType<Foo.Bar<Baz.Phi>>";
// Act
var reduced = DefaultTagHelperTooltipFactory.ReduceTypeName(content);
// Assert
Assert.Equal("SomeType<Foo.Bar<Baz.Phi>>", reduced);
}
public void ReduceTypeName_CrefGenerics()
{
// Arrange
var content = "System.Collections.Generic.List{System.String}";
// Act
var reduced = DefaultTagHelperTooltipFactory.ReduceTypeName(content);
// Assert
Assert.Equal("List{System.String}", reduced);
}
public void ReduceMemberName_CrefGenerics()
{
// Arrange
var content = "Microsoft.AspNetCore.SometTagHelpers.SomeType{Foo.Bar}.SomeProperty{Foo.Bar}";
// Act
var reduced = DefaultTagHelperTooltipFactory.ReduceMemberName(content);
// Assert
Assert.Equal("SomeType{Foo.Bar}.SomeProperty{Foo.Bar}", reduced);
}
public void ReduceTypeName_Plain()
{
// Arrange
var content = "Microsoft.AspNetCore.SomeTagHelpers.SomeTypeName";
// Act
var reduced = DefaultTagHelperTooltipFactory.ReduceTypeName(content);
// Assert
Assert.Equal("SomeTypeName", reduced);
}
public void ReduceMemberName_NestedGenericsMethodsTypes()
{
// Arrange
var content = "Microsoft.AspNetCore.SometTagHelpers.SomeType<Foo.Bar<Baz,Fi>>.SomeMethod(Foo.Bar<System.String>,Baz<Something>.Fi)";
// Act
var reduced = DefaultTagHelperTooltipFactory.ReduceMemberName(content);
// Assert
Assert.Equal("SomeType<Foo.Bar<Baz,Fi>>.SomeMethod(Foo.Bar<System.String>,Baz<Something>.Fi)", reduced);
}
public void TryCreateTooltip_NoAssociatedTagHelperDescriptions_ReturnsFalse()
{
// Arrange
var descriptionFactory = new DefaultTagHelperTooltipFactory(LanguageServer);
var elementDescription = AggregateBoundElementDescription.Default;
// Act
var result = descriptionFactory.TryCreateTooltip(elementDescription, out var markdown);
// Assert
Assert.False(result);
Assert.Null(markdown);
}
public void TryExtractSummary_NoXml_ReturnsTrue()
{
// Arrange
var documentation = @"
There is no xml, but I got you this < and the >.
";
// Act
var result = DefaultTagHelperTooltipFactory.TryExtractSummary(documentation, out var summary);
// Assert
Assert.True(result);
Assert.Equal("There is no xml, but I got you this < and the >.", summary);
}
public void TryExtractSummary_XMLButNoSummary_ReturnsFalse()
{
// Arrange
var documentation = @"
<param type=""stuff"">param1</param>
<return>Result</return>
";
// Act
var result = DefaultTagHelperTooltipFactory.TryExtractSummary(documentation, out var summary);
// Assert
Assert.False(result);
Assert.Null(summary);
}
public void CleanSummaryContent_TrimsSurroundingWhitespace()
{
// Arrange
var summary = @"
Hello
World
";
// Act
var cleanedSummary = DefaultTagHelperTooltipFactory.CleanSummaryContent(summary);
// Assert
Assert.Equal(@"Hello
World", cleanedSummary);
}
public void TryExtractSummary_ExtractsSummary_ReturnsTrue()
{
// Arrange
var expectedSummary = " Hello World ";
var documentation = $@"
Prefixed invalid content
<summary>{expectedSummary}</summary>
Suffixed invalid content";
// Act
var result = DefaultTagHelperTooltipFactory.TryExtractSummary(documentation, out var summary);
// Assert
Assert.True(result);
Assert.Equal(expectedSummary, summary);
}
public void TryExtractSummary_NoEndSummary_ReturnsTrue()
{
// Arrange
var documentation = @"
Prefixed invalid content
<summary>
Suffixed invalid content";
// Act
var result = DefaultTagHelperTooltipFactory.TryExtractSummary(documentation, out var summary);
// Assert
Assert.True(result);
Assert.Equal(@"Prefixed invalid content
<summary>
Suffixed invalid content", summary);
}
public void TryCreateTooltip_Element_BothPlainTextAndMarkdown_IsBold()
{
// Arrange
var languageServer = LanguageServer;
languageServer.ClientSettings.Capabilities.TextDocument.Completion.Value.CompletionItem.DocumentationFormat = new Container <MarkupKind>(MarkupKind.PlainText, MarkupKind.Markdown);
var descriptionFactory = new DefaultTagHelperTooltipFactory(languageServer);
var associatedTagHelperInfos = new[]
{
new BoundElementDescriptionInfo("Microsoft.AspNetCore.SomeTagHelper", "<summary>Uses <see cref=\"T:System.Collections.List{System.String}\" />s</summary>"),
};
var elementDescription = new AggregateBoundElementDescription(associatedTagHelperInfos);
// Act
var result = descriptionFactory.TryCreateTooltip(elementDescription, out var markdown);
// Assert
Assert.True(result);
Assert.Equal(@"**SomeTagHelper**
Uses `List<System.String>`s", markdown.Value);
Assert.Equal(MarkupKind.Markdown, markdown.Kind);
}
