feat: show human readable format for cron

Author: KristofersOzolinsMagebit

package-lock.json

@@ -427,6 +427,7 @@
     "@xml-tools/parser": "^1.0.11",
     "@xml-tools/simple-schema": "^3.0.5",
     "@xml-tools/validation": "^1.0.16",
+    "cronstrue": "^2.59.0",
     "fast-xml-parser": "^4.5.1",
     "formik": "^2.4.6",
     "glob": "^11.0.1",

package.json

@@ -2,10 +2,11 @@ import { CancellationToken, Hover, Position, TextDocument } from 'vscode';
 import { XmlSuggestionProviderProcessor } from 'common/xml/XmlSuggestionProviderProcessor';
 import { AclHoverProvider } from 'hover/xml/AclHoverProvider';
 import { ModuleHoverProvider } from 'hover/xml/ModuleHoverProvider';
+import { CronHoverProvider } from 'hover/xml/CronHoverProvider';
 
 export class XmlHoverProviderProcessor extends XmlSuggestionProviderProcessor<Hover> {
   public constructor() {
-    super([new AclHoverProvider(), new ModuleHoverProvider()]);
+    super([new AclHoverProvider(), new ModuleHoverProvider(), new CronHoverProvider()]);
   }
 
   public async provideHover(

src/hover/XmlHoverProviderProcessor.ts

@@ -0,0 +1,31 @@
+import { Hover, MarkdownString, Range } from 'vscode';
+import { CombinedCondition, XmlSuggestionProvider } from 'common/xml/XmlSuggestionProvider';
+import { ElementNameMatches } from 'common/xml/suggestion/condition/ElementNameMatches';
+import cronstrue from 'cronstrue';
+
+export class CronHoverProvider extends XmlSuggestionProvider<Hover> {
+  public getElementContentMatches(): CombinedCondition[] {
+    return [[new ElementNameMatches('schedule')]];
+  }
+
+  public getConfigKey(): string | undefined {
+    return 'provideXmlHovers';
+  }
+
+  public getFilePatterns(): string[] {
+    return ['**/etc/crontab.xml'];
+  }
+
+  public getSuggestionItems(value: string, range: Range): Hover[] {
+    const readable = cronstrue.toString(value);
+
+    if (!readable) {
+      return [];
+    }
+
+    const markdown = new MarkdownString();
+    markdown.appendMarkdown(`**Cron**: ${readable}`);
+
+    return [new Hover(markdown, range)];
+  }
+}