feat(manager/cake): Support extracting nuget packages from InstallTools helper methods (#40070)

* Support InstallTools methods for cake build files

* Allow dotnet tool extraction in  single file cake sdk build scripts

* Fix dependency parsing for InstallTools methods

* Remove unused import

* Fix readme for cake manager

* Add test case to improve coverage

* Update lib/modules/manager/cake/index.ts

Co-authored-by: Michael Kriese <michael.kriese@gmx.de>

---------

Co-authored-by: Michael Kriese <michael.kriese@visualon.de>
Co-authored-by: Michael Kriese <michael.kriese@gmx.de>

Author: papauorg

lib/modules/manager/cake/index.spec.ts

@@ -1,3 +1,4 @@
+import { codeBlock } from 'common-tags';
 import { Fixtures } from '~test/fixtures.ts';
 import { extractPackageFile } from './index.ts';
 
@@ -19,4 +20,79 @@ describe('modules/manager/cake/index', () => {
       ],
     });
   });
+
+  it('extracts dotnet tools from single sdk style build file', () => {
+    const content = codeBlock`
+    #:sdk Cake.Sdk
+
+    // Install single tool
+    InstallTool("dotnet:https://api.nuget.org/v3/index.json?package=SingleTool.Install.First&version=1.0.0");
+    InstallTool("dotnet:?package=SingleTool.Install.Second&version=1.2.0");
+
+    // Install multiple tools at once
+    InstallTools(
+        "dotnet:https://api.nuget.org/v3/index.json?package=MultipleTools.Install.First&version=2.0.0",
+        "dotnet:?package=MultipleTools.Install.Second&version=2.1.1"
+    );
+
+    var target = Argument("target", "Default");
+
+    Task("Default")
+        .Does(() =>
+    {
+        Information("Hello from Cake.Sdk!");
+    });
+
+    var installTools = "dotnet:?Should.Not.Match&version=1.0.0";
+
+    RunTarget(target);
+    `;
+    expect(extractPackageFile(content)).toMatchObject({
+      deps: [
+        {
+          depName: 'SingleTool.Install.First',
+          currentValue: '1.0.0',
+          datasource: 'nuget',
+          registryUrls: ['https://api.nuget.org/v3/index.json'],
+        },
+        {
+          depName: 'SingleTool.Install.Second',
+          currentValue: '1.2.0',
+          datasource: 'nuget',
+        },
+        {
+          depName: 'MultipleTools.Install.First',
+          currentValue: '2.0.0',
+          datasource: 'nuget',
+          registryUrls: ['https://api.nuget.org/v3/index.json'],
+        },
+        {
+          depName: 'MultipleTools.Install.Second',
+          currentValue: '2.1.1',
+          datasource: 'nuget',
+        },
+      ],
+    });
+  });
+
+  it('skips invalid entries in InstallTools', () => {
+    const content = codeBlock`
+    #:sdk Cake.Sdk
+
+    // One invalid and one valid tool entry
+    InstallTools(
+      "dotnet:bad uri",
+      "dotnet:?package=Good.Tool&version=1.2.3"
+    );
+    `;
+    expect(extractPackageFile(content)).toMatchObject({
+      deps: [
+        {
+          depName: 'Good.Tool',
+          currentValue: '1.2.3',
+          datasource: 'nuget',
+        },
+      ],
+    });
+  });
 });

lib/modules/manager/cake/index.ts

@@ -25,6 +25,10 @@ const lexer = moo.states({
       match: /^#(?:addin|tool|module|load|l)\s+"(?:nuget|dotnet):[^"]+"\s*$/, // TODO #12870
       value: (s: string) => s.trim().slice(1, -1),
     },
+    dependencyFromInstallTools: {
+      match: /(?:InstallTools?\s*\()[^)]+(?:\s*\)\s*;)/,
+      lineBreaks: true,
+    },
     unknown: moo.fallback,
   },
 });
@@ -74,6 +78,15 @@ export function extractPackageFile(content: string): PackageFileContent {
       if (dep) {
         deps.push(dep);
       }
+    } else if (type === 'dependencyFromInstallTools') {
+      const matches = value.matchAll(regEx(/"dotnet:[^"]+"/g));
+      for (const match of matches) {
+        const withoutQuote = match.toString().slice(1, -1);
+        const dep = parseDependencyLine(withoutQuote);
+        if (dep) {
+          deps.push(dep);
+        }
+      }
     }
     token = lexer.next();
   }

lib/modules/manager/cake/readme.md

@@ -1 +1,3 @@
 Extracts dependencies from `*.cake` files.
+
+It can also extract `dotnet:` tool packages when used in .NET single file builds, when they are used with the `InstallTool` or `InstallTools` method. Keep in mind that those files are usually not `*.cake` files but C# code files. Those are not included in the `managerFilePatterns` per default - make sure to include them manually in your configuration if you want to use this feature.`#:package`or`#:sdk` directives are not handled by the cake manager as this is a dotnet feature. Those are separately handled by the nuget manager.