RFC for ArgumentCompleter base class

#269

Provide a base class, ArgumentCompleter, to simplify writing custom argument completers

Some common tasks need to be done almost every time a completer is written.

Things like quoting arguments if they contain spaces, matching against WordToComplete, and ensuring that the results are sorted is another such task.

Motivation

As a Developer,
I can use the base class when writing custom argument completers,
so that results are achieved faster, with high quality, and
so that users get a consistent completion experience.

User Experience

using namespace System.Management.Automation;

public class GetCommitCompleter : ArgumentCompleter
{
    // override simplified completer
    protected override CompletionResultSortKind AddCompletionsFor(string commandName, string parameterName, IDictionary fakeBoundParameters)
    {
        switch (parameterName)
        {
            case nameof(GitRebaseCommand.CommitHash):
                CompleteGitCommitHash();
                break;
        }

        return CompletionResultSortKind.Sorted;
    }

    private void CompleteGitCommitHash()
    {
        var user = GetFakeBoundParameter<string>("User");
        foreach(var commit in GitExe.Log())
        {
            if (user is { } u && commit.User != u){
                continue;
            }
            // use a function to complete if the text or tooltip matches WordToComplete
            CompleteMatching(text: commit.Hash, tooltip: $"{commit.User}\r\n{commit.Description}}": CompletionMatch.AnyContainsWithWordToComplete);
        }
    }
}

Bắt đầu bằng cách đọc issue được tham chiếu #269 và ví dụ ArgumentCompleter được đề xuất trong RFC này. Xem xét các hành vi chung được yêu cầu—đặt đối số trong dấu ngoặc kép, khớp với WordToComplete và sắp xếp kết quả—rồi xác định API của lớp cơ sở và ngữ nghĩa hoàn thành. Công việc được xem là hoàn tất khi RFC có thiết kế đã được thống nhất cho các ArgumentCompleter tùy chỉnh và hành vi hoàn thành nhất quán.