feat: Add shuffle command to change color randomly (#239)

Author: marcelarie

README.md

@@ -170,6 +170,7 @@ You can also use command `Colorbox` to control the player with below subcommands
 - `update`: Update all git submodules.
 - `info`: Show detailed information and configured status.
   - **Note:** use `scale=0.7` to specify popup window's size in range `(0, 1]`, by default is `scale=0.7`.
+- `shuffle`: Change to a random color.
 
 > [!NOTE]
 >

lua/colorbox/controller.lua

@@ -4,6 +4,8 @@ local logging = require("colorbox.commons.logging")
 local LogLevels = require("colorbox.commons.logging").LogLevels
 local uv = require("colorbox.commons.uv")
 local async = require("colorbox.commons.async")
+local track = require("colorbox.track")
+local loader = require("colorbox.loader")
 
 local runtime = require("colorbox.runtime")
 local db = require("colorbox.db")
@@ -138,6 +140,26 @@ M._parse_args = function(args)
   return opts
 end
 
+M.shuffle = function()
+  local ColorNamesList = runtime.colornames()
+  if #ColorNamesList > 0 then
+    local logger = logging.get("colorbox")
+    local random_index = num.random(1, #ColorNamesList)
+    local color = ColorNamesList[random_index]
+
+    logger:debug(
+      string.format(
+        "|shuffle| color:%s, random_index:%d, ColorNamesList(%d):%s",
+        vim.inspect(color),
+        random_index,
+        #ColorNamesList,
+        vim.inspect(ColorNamesList)
+      )
+    )
+    loader.load(color)
+  end
+end
+
 --- @param args string?
 M.info = function(args)
   local logger = logging.get("colorbox")

spec/colorbox/controller_spec.lua

@@ -53,5 +53,10 @@ describe("colorbox.controller", function()
         controller.info("")
       end
     end)
+    it("shuffle", function()
+      if not github_actions then
+        controller.shuffle()
+      end
+    end)
   end)
 end)