Remove vim.lang from syntax

Point users of Cylc Get Resources to the new cylc.vim plugin.

changes.d/6549.fix.md

@@ -0,0 +1 @@
+Removed cylc.vim - you should use https://github.com/cylc/cylc.vim instead.

cylc/flow/resources.py

@@ -16,6 +16,7 @@
 
 """Extract named resources from the cylc.flow package."""
 
+from ansimarkup import parse
 from contextlib import suppress
 from pathlib import Path
 from random import choice
@@ -39,10 +40,10 @@
 RESOURCE_NAMES = {
     'syntax/cylc-mode.el': 'Emacs syntax highlighting.',
     'syntax/cylc.lang': 'Gedit (gtksourceview) syntax highlighting.',
-    'syntax/cylc.vim': 'Vim syntax highlighting.',
     'syntax/cylc.xml': 'Kate syntax highlighting.',
     'cylc-completion.bash': 'Bash auto-completion for Cylc commands.',
     'cylc': 'Cylc wrapper script.',
+    '!syntax/cylc.vim': 'Deprecated - use https://github.com/cylc/cylc.vim',
 }
 API_KEY = 'api-key'
 
@@ -63,7 +64,15 @@ def list_resources(write=print, headers=True):
         write('Resources:')
     max_len = max(len(res) for res in RESOURCE_NAMES)
     for resource, desc in RESOURCE_NAMES.items():
-        write(f'  {resource}  {" " * (max_len - len(resource))}  # {desc}')
+        if resource[0] == '!':
+            # Use ! to indicated that resource is deprecated:
+            resource = resource[1:]
+            write(parse(
+                f'<yellow>  {resource}  {" " * (max_len - len(resource))}'
+                f'  # {desc}</yellow>'
+            ))
+        else:
+            write(f'  {resource}  {" " * (max_len - len(resource))}  # {desc}')
     if headers:
         write('\nTutorials:')
     for tutorial in tutorials:

cylc/flow/scripts/get_resources.py

@@ -42,6 +42,7 @@
 import sys
 
 from cylc.flow import LOG
+from cylc.flow.exceptions import CylcError
 import cylc.flow.flags
 from cylc.flow.loggingutil import set_timestamps
 from cylc.flow.option_parsers import CylcOptionParser as COP
@@ -74,6 +75,14 @@ def get_option_parser():
 
 @cli_function(get_option_parser)
 def main(parser, opts, resource=None, tgt_dir=None):
+
+    # Intercept requests for syntax/cylc.vim:
+    if resource == "syntax/cylc.vim":
+        raise CylcError(
+            'syntax/cylc.vim has been replaced by '
+            'https://github.com/cylc/cylc.vim'
+        )
+
     if cylc.flow.flags.verbosity < 2:
         set_timestamps(LOG, False)
     if not resource or opts.list: