File: DocumentationComments\OmniSharpDocumentationCommentsSnippetService.cs
Web Access
Project: src\src\Features\ExternalAccess\OmniSharp\Microsoft.CodeAnalysis.ExternalAccess.OmniSharp.csproj (Microsoft.CodeAnalysis.ExternalAccess.OmniSharp)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
using System.Threading;
using Microsoft.CodeAnalysis.DocumentationComments;
using Microsoft.CodeAnalysis.Host;
using Microsoft.CodeAnalysis.Shared.Extensions;
using Microsoft.CodeAnalysis.Text;
 
namespace Microsoft.CodeAnalysis.ExternalAccess.OmniSharp.DocumentationComments;
 
internal static class OmniSharpDocumentationCommentsSnippetService
{
#pragma warning disable IDE0060 // Remove unused parameter
    public static OmniSharpDocumentationCommentSnippet? GetDocumentationCommentSnippetOnCharacterTyped(
        Document document,
        SyntaxTree syntaxTree,
        SourceText text,
        int position,
        OmniSharpDocumentationCommentOptionsWrapper options,
        CancellationToken cancellationToken)
    {
        var service = document.GetRequiredLanguageService<IDocumentationCommentSnippetService>();
        return Translate(service.GetDocumentationCommentSnippetOnCharacterTyped(ParsedDocument.CreateSynchronously(document, cancellationToken), position, options.UnderlyingObject, cancellationToken));
    }
 
    public static OmniSharpDocumentationCommentSnippet? GetDocumentationCommentSnippetOnEnterTyped(
        Document document,
        SyntaxTree syntaxTree,
        SourceText text,
        int position,
        OmniSharpDocumentationCommentOptionsWrapper options,
        CancellationToken cancellationToken)
    {
        var service = document.GetRequiredLanguageService<IDocumentationCommentSnippetService>();
        return Translate(service.GetDocumentationCommentSnippetOnEnterTyped(ParsedDocument.CreateSynchronously(document, cancellationToken), position, options.UnderlyingObject, cancellationToken));
    }
 
    private static OmniSharpDocumentationCommentSnippet? Translate(DocumentationCommentSnippet? result)
        => result == null ? null : new(result.SpanToReplace, result.SnippetText, result.CaretOffset);
}