@@ -148,6 +148,14 @@ Environment variables:

     is not defined, `pager` if it exists in `$PATH`, else `less` . The value is

     interpreted by the shell. If the `$LESS` environment variable is unset, it

     is set to `FR`.

+  GLREGISTRY_COLORS

+    If standard out is a terminal, the colors used in output of the `enums`,

+    `enums-tree`, `params`, `params-tree`, `audit,` and `audit-tree` commands.

+    It uses the same format (and defaults) as GREP_COLORS, i.e. a

+    colon-separated list of capabilties: `ms` (matching selected), `fn` (file

+    name), `ln` (line number), `se` (separators). Added custom capabilities

+    are: `ve` (version), `ex` (extension), `un` (unsupported). Defaults to

+    `ms=01;31:fn=35:ln=32:se=36:ve=01;34:ex=34:un=01;33`.

 ```

 ## References

@@ -105,6 +105,14 @@ Environment variables:

     is not defined, `pager` if it exists in `$PATH`, else `less` . The value is

     interpreted by the shell. If the `$LESS` environment variable is unset, it

     is set to `FR`.

+  GLREGISTRY_COLORS

+    If standard out is a terminal, the colors used in output of the `enums`,

+    `enums-tree`, `params`, `params-tree`, `audit,` and `audit-tree` commands.

+    It uses the same format (and defaults) as GREP_COLORS, i.e. a

+    colon-separated list of capabilties: `ms` (matching selected), `fn` (file

+    name), `ln` (line number), `se` (separators). Added custom capabilities

+    are: `ve` (version), `ex` (extension), `un` (unsupported). Defaults to

+    `ms=01;31:fn=35:ln=32:se=36:ve=01;34:ex=34:un=01;33`.

 """

@@ -151,6 +159,26 @@ CACHE  = ENV_XDG('CACHE',  os.path.join('~', '.cache'))

 EDITOR = ENV_PRG('EDITOR', 'vi')

 PAGER  = ENV_PRG('PAGER',  'less')

 LESS   = os.environ.get('LESS', 'FR')

+COLORS = collections.defaultdict(

+    str,

+    [

+        (color.split('=') + [''])[:2]

+        for color in

+        filter(

+            None,

+            os.environ.get(

+                'GLREGISTRY_COLORS',

+                (lambda x, y: ':'.join([x, x and y]))(

+                    os.environ.get(

+                        'GREP_COLORS',

+                        'ms=01;31:fn=35:ln=32:se=36',

+                    ),

+                    've=01;34:ex=34:un=01;33',

+                ),

+            ).split(':'),

+        )

+    ],

+)

 IN    = lambda a, v, s: f"contains(concat('{s}',@{a},'{s}'),'{s}{v}{s}')"

 MAYBE = lambda a, v:    f"(@{a}='{v}' or not(@{a}))"

 TYPES    = "/registry/types"

@@ -209,9 +237,27 @@ def page(lines):

         sys.stdout.write(lines)

+### `color`

+def color(capability, string):

+    if not sys.stdout.isatty():

+        return string

+    return f'\x1b[{COLORS[capability]}m{string}\x1b[m'

+

+

+### `color_supports`

+def color_supports(supports):

+    for support in supports:

+        if support == 'UNSUPPORTED' or support.startswith('<'):

+            yield color('un', support)

+        elif support.startswith('GL_'):

+            yield color('ex', support)

+        else:

+            yield color('ve', support)

+

+

 ### `indentjoin`

 def indentjoin(indent, sep, parts):

-    return ' ' * INDENT * indent + sep.join(map(str, parts))

+    return ' ' * INDENT * indent + color('se', sep).join(map(str, parts))

 ### `removeprefix`

@@ -456,9 +502,9 @@ def enums(xml, group=None):

 ### `enums_tree`

 def enums_tree(xml, group=None):

     for supports, enums in sorted(enums_(xml, group).items()):

-        yield indentjoin(0, ',', supports)

+        yield indentjoin(0, ',', color_supports(supports))

         for enum in sorted(enums):

-            yield indentjoin(1, '', [enum])

+            yield indentjoin(1, '', [color('ms', enum)])

 ### `params_`

@@ -490,13 +536,13 @@ def params(xml, group=None):

 def params_tree(xml, group=None):

     for (count, param), occurences in sorted(params_(xml, group).items()):

         yield indentjoin(0, ':', [

-            param,

-            -count,

+            color('ms', param),

+            color('ln', -count),

         ])

         for supports_, commands in sorted(occurences.items()):

-            yield indentjoin(1, ',', supports_)

+            yield indentjoin(1, ',', color_supports(supports_))

             for command in sorted(commands):

-                yield indentjoin(2, '', [command])

+                yield indentjoin(2, '', [color('fn', command)])

 ### `audit_`

@@ -519,23 +565,23 @@ def audit(xml, path=None):

         for file, line       in locations

     ):

         yield indentjoin(0, ':', [

-            file,

-            line,

-            indentjoin(0, ',', supports),

-            name

+            color('fn', file),

+            color('ln', line),

+            indentjoin(0, ',', color_supports(supports)),

+            color('ms', name),

         ])

 ### `audit_tree`

 def audit_tree(xml, path=None):

     for supports, names in sorted(audit_(xml, path).items()):

-        yield indentjoin(0, ',', supports)

+        yield indentjoin(0, ',', color_supports(supports))

         for name, locations in sorted(names.items()):

-            yield indentjoin(1, '', [name])

+            yield indentjoin(1, '', [color('ms', name)])

             for file, line in sorted(locations):

                 yield indentjoin(2, ':', [

-                    file,

-                    line,

+                    color('fn', file),

+                    color('ln', line),

                 ])

@@ -574,11 +620,11 @@ def refs(name):

 ### `refs_all`

 def refs_all(name):

     for support, locations in sorted(refs_(name).items()):

-        yield indentjoin(0, ',', [support])

+        yield indentjoin(0, ',', color_supports([support]))

         for name_, url in sorted(locations):

             yield indentjoin(1, ':', [

-                name_,

-                url,

+                color('ms', name_),

+                color('fn', url),

             ])