add: opt in color log output

resolves #275

Author: 2bndy5

README.md

@@ -37,6 +37,11 @@ workflow [`step-summary`][step-summary], and Pull Request reviews (with
 
 Create a new GitHub Actions workflow in your project, e.g. at [.github/workflows/cpp-linter.yml](https://github.com/cpp-linter/cpp-linter-action/blob/main/.github/workflows/cpp-linter.yml)
 
+> [!TIP]
+> To enable color output in the workflow logs,
+> set the environment variable `CPP_LINTER_COLOR` to a
+> value of `on`, `true`, or `1`.
+
 The content of the file should be in the following format.
 
 ```yaml
@@ -46,6 +51,7 @@ The content of the file should be in the following format.
         id: linter
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          CPP_LINTER_COLOR: on # off by default
         with:
           style: 'file'  # Use .clang-format config file
           tidy-checks: '' # Use .clang-tidy config file

action.yml

@@ -367,12 +367,20 @@ runs:
           or ($gh_action_debug == true)
           or ($gh_action_debug == 'true')
         )
+        let color_enabled = (
+          $env
+          | get --optional 'CPP_LINTER_COLOR'
+          | ($in == true or $in == 'true' or $in == 1 or $in == '1' or $in == 'on')
+        )
 
         print $"\n(ansi purple)Installing workflow dependencies(ansi reset)"
         mut uv_args = [sync --project $action_path --group action --no-dev --link-mode=copy]
         if $verbosity {
           $uv_args = $uv_args | append '-v'
         }
+        if $color_enabled {
+          $uv_args = $uv_args | append [--extra color]
+        }
         ^$'($env.UV_INSTALL_DIR)/uv' ...$uv_args
 
         print $"\n(ansi purple)Ensuring clang-format and clang-tidy ${{ inputs.version }} are present(ansi reset)"
@@ -437,5 +445,14 @@ runs:
           $env.PATH = $env.PATH | append $local_bin
         }
 
+        let color_enabled = (
+          $env
+          | get --optional 'CPP_LINTER_COLOR'
+          | ($in == true or $in == 'true' or $in == 1 or $in == '1' or $in == 'on')
+        )
+        if $color_enabled {
+          $env.FORCE_COLOR = 1
+        }
+
         print $"\n(ansi purple)Running cpp-linter(ansi reset)"
         ^$'($env.UV_INSTALL_DIR)/uv' ...$uv_args cpp-linter ...$args

pyproject.toml

@@ -4,6 +4,11 @@ version = "0.0.0+private_virtual"
 requires-python = ">=3.9"
 dependencies = []
 
+[project.optional-dependencies]
+color = [
+    "rich==14.1.0"
+]
+
 [dependency-groups]
 action = [
     "clang-tools==0.15.2",