feat(manager/asdf): add support for .tools-versions as used by asdf

.gitignore

@@ -26,3 +26,6 @@ test/datasource/nuget/_fixtures/obj
 
 # testing
 /docker-compose.yml
+
+# version management
+.tool-versions

lib/modules/manager/api.ts

@@ -1,6 +1,7 @@
 import * as ansible from './ansible';
 import * as ansibleGalaxy from './ansible-galaxy';
 import * as argoCD from './argocd';
+import * as asdf from './asdf';
 import * as azurePipelines from './azure-pipelines';
 import * as batect from './batect';
 import * as batectWrapper from './batect-wrapper';
@@ -80,6 +81,7 @@ export default api;
 api.set('ansible', ansible);
 api.set('ansible-galaxy', ansibleGalaxy);
 api.set('argocd', argoCD);
+api.set('asdf', asdf);
 api.set('azure-pipelines', azurePipelines);
 api.set('batect', batect);
 api.set('batect-wrapper', batectWrapper);

lib/modules/manager/asdf/extract.spec.ts

@@ -0,0 +1,87 @@
+import { extractPackageFile } from '.';
+
+describe('modules/manager/asdf/extract', () => {
+  describe('extractPackageFile()', () => {
+    it('returns a result', () => {
+      const res = extractPackageFile('nodejs 16.16.0\n');
+      expect(res.deps).toEqual([
+        {
+          currentValue: 'nodejs 16.16.0',
+          datasource: 'github-tags',
+          depName: 'node',
+          packageName: 'nodejs/node',
+        },
+      ]);
+    });
+
+    it('ignores lines with unsupported tooling', () => {
+      const res = extractPackageFile('yarn 1.22.5\n');
+      expect(res.deps).toEqual([]);
+    });
+
+    it('only captures the first version', () => {
+      const res = extractPackageFile('nodejs 16.16.0 16.15.1\n');
+      expect(res.deps).toEqual([
+        {
+          currentValue: 'nodejs 16.16.0',
+          datasource: 'github-tags',
+          depName: 'node',
+          packageName: 'nodejs/node',
+        },
+      ]);
+    });
+
+    it('ignores supported tooling with ref: versioning', () => {
+      const res = extractPackageFile('nodejs ref:234abc4\n');
+      expect(res.deps).toEqual([]);
+    });
+
+    it('ignores supported tooling with path: versioning', () => {
+      const res = extractPackageFile('nodejs path:/path/to/tooling\n');
+      expect(res.deps).toEqual([]);
+    });
+
+    it('ignores supported tooling with system versioning', () => {
+      const res = extractPackageFile('nodejs system\n');
+      expect(res.deps).toEqual([]);
+    });
+
+    describe('comment handling', () => {
+      it('ignores comments at the end of lines', () => {
+        const res = extractPackageFile('nodejs 16.16.0 # this is a comment\n');
+        expect(res.deps).toEqual([
+          {
+            currentValue: 'nodejs 16.16.0',
+            datasource: 'github-tags',
+            depName: 'node',
+            packageName: 'nodejs/node',
+          },
+        ]);
+      });
+
+      it('ignores lines that are just comments at the end of lines', () => {
+        const res = extractPackageFile('# this is a full line comment\n');
+        expect(res.deps).toEqual([]);
+      });
+
+      it('ignores comments across multiple lines', () => {
+        const res = extractPackageFile(
+          '# this is a full line comment\nnodejs 16.16.0 # this is a comment\n'
+        );
+        expect(res.deps).toEqual([
+          {
+            currentValue: 'nodejs 16.16.0',
+            datasource: 'github-tags',
+            depName: 'node',
+            packageName: 'nodejs/node',
+          },
+        ]);
+      });
+
+      it('ignores supported tooling with a renovate:ignore comment', () => {
+        const res = extractPackageFile('nodejs 16.16.0 # renovate:ignore\n');
+        expect(res.deps).toEqual([]);
+      });
+    });
+  });
+});

lib/modules/manager/asdf/extract.ts

@@ -0,0 +1,40 @@
+import { logger } from '../../../logger';
+import { isSkipComment } from '../../../util/ignore';
+import { GithubTagsDatasource } from '../../datasource/github-tags';
+import type { PackageDependency, PackageFile } from '../types';
+
+const upgradeableTooling: Record<
+  string,
+  Pick<PackageDependency, 'depName' | 'datasource' | 'packageName'>
+> = {
+  nodejs: {
+    depName: 'node',
+    datasource: GithubTagsDatasource.id,
+    packageName: 'nodejs/node',
+  },
+};
+
+export function extractPackageFile(content: string): PackageFile {
+  logger.trace('asdf.extractPackageFile()');
+
+  const regex =
+    /^(?<content>(?<toolname>(\w+))\s+(?<version>(\d[\d.]+\d)))([^#]*(#(?<comment>(.*))))?/gm;
+
+  const deps = [...content.matchAll(regex)]
+    .filter((match) => !!match.groups)
+    .map((match) => match.groups!)
+    .filter((groups) => upgradeableTooling[groups['toolname']])
+    .filter((groups) => !isSkipComment((groups['comment'] ?? '').trim()))
+    .map((groups) => {
+      const tool = upgradeableTooling[groups['toolname']];
+      const dep: PackageDependency = {
+        depName: tool.depName,
+        currentValue: groups['content'].trim(),
+        datasource: tool.datasource,
+        packageName: tool.packageName,
+      };
+      return dep;
+    });
+
+  return { deps };
+}

lib/modules/manager/asdf/index.ts

@@ -0,0 +1,11 @@
+import { GithubTagsDatasource } from '../../datasource/github-tags';
+
+export { extractPackageFile } from './extract';
+
+export const displayName = 'asdf';
+
+export const defaultConfig = {
+  fileMatch: ['(^|/)\\.tools-versions$'],
+};
+
+export const supportedDatasources = [GithubTagsDatasource.id];

lib/modules/manager/asdf/readme.md

@@ -0,0 +1,8 @@
+Keeps the [asdf](https://asdf-vm.com/manage/configuration.html#tool-versions)
+`.tools-versions` file updated.
+
+Because asdf supports the version management of many different tools, only a few of those that are also supported by renovate will be targeted by this manager.
+
+Currently, only the following is supported
+
+- [nodejs](https://github.com/asdf-vm/asdf-nodejs)