Ambiguous ReportGenerator alias when upgrading to Cake 1.0.0

[Jericho]

This is intended as a heads-up to other devs who might face the same problem I did when upgrading build script to run with Cake 1.0.0. Scroll down for solution.

My build script contains the following task which worked fine up to Cake 0.38.5 but no longer works in Cake 1.0.0

Task("Generate-Code-Coverage-Report")
    .IsDependentOn("Run-Code-Coverage")
    .Does(() =>
{
    ReportGenerator(
        "C:\Path\to\my\coverage.xml",
        codeCoverageDir,
        new ReportGeneratorSettings() {
            ClassFilters = new[] { "*.UnitTests*" }
        }
    );
});

In fact, my build script does not even build due to the following exception:

Error: Error(s) occurred when compiling build script:
D:/_build/ZoomNet/build.cake(232,2): error CS0121: The call is ambiguous between the following methods or properties: 'ReportGenerator(GlobPattern, DirectoryPath, ReportGeneratorSettings)' and 'ReportGenerator(FilePath, DirectoryPath, ReportGeneratorSettings)'

This problem appears to be due to the combination of multiple factors.

1. Cake no longer provides a alias for ReportGenerator that accepts a string parameter (as a result of feature Add GlobPattern class #2199) and instead provides a new alias that accepts a GlobPattern parameter in addition to the alias that accepts a FilePath parameter
2. Both GlobPattern and FilePath define an implicit convertor from string
3. My build script provides a string parameter when invoking the ReportGenerator alias (which incidentally still appears to be the recommendation in the XML documentation here and here. I will submit a PR to improve the code sample in XML documentation to avoid this problem).

Solution
The solution, turns out to be quite simple. We simply need to specify a FilePath parameter when invoking the ReportGenerator alias. Like so:

Task("Generate-Code-Coverage-Report")
    .IsDependentOn("Run-Code-Coverage")
    .Does(() =>
{
    ReportGenerator(
        new FilePath("C:\Path\to\my\coverage.xml"),
        codeCoverageDir,
        new ReportGeneratorSettings() {
            ClassFilters = new[] { "*.UnitTests*" }
        }
    );
});

[garywoodfine]

Thanks this post helped me resolve an issue with was experiencing trying to make use of the Glob. This post helped me to figure out I needed to use

var directory = Directory(TEST_COVERAGE_OUTPUT_DIR);
 var outputDirectory = Directory("./reports");

    var reportSettings = new ReportGeneratorSettings
    {
        ArgumentCustomization = args => args.Append($"-reportTypes:HtmlInline_AzurePipelines")
    };
    
     ReportGenerator(new GlobPattern($"./{ directory}/*.cobertura.xml") , outputDirectory, reportSettings);