typo

add Shell Completion section to README

add pdm script completion

add pre-commit config

.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  pypi-publish:
+    name: upload release to PyPI
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # This permission is needed for private repositories.
+      contents: read
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pdm-project/setup-pdm@v4
+
+      - name: Publish package distributions to PyPI
+        run: pdm publish

.github/workflows/ruff.yml

@@ -0,0 +1,19 @@
+name: Ruff
+
+on:
+  push:
+    branches: [main]
+
+  pull_request:
+    branches: [main]
+
+  workflow_dispatch:
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: 'format --check --diff'

.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v2.3.0
+    hooks:
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace

README.md

@@ -14,14 +14,16 @@ For an outline of past/future changes refer to: [CHANGELOG](CHANGELOG.md)
 
 - [Installation](#installation)
 - [Configuration](#configuration)
+- [Style](#style)
 - [Commands](#commands)
+- [Shell Completion](#shell-completion)
 - [License](#license)
 
 ## Requirements
 
 -   Python 3.11 or greater
 -   [Streamlabs Desktop][sl-desktop]
--   A websocket token: Settings > Remote Control > API Token
+-   A websocket token: Settings > Mobile > Third Party Connections > API Token
 
 ## Installation
 
@@ -68,6 +70,37 @@ Flags can be used to override environment variables.
 
 [sl-desktop]: https://streamlabs.com/streamlabs-live-streaming-software?srsltid=AfmBOopnswGBgEyvVSi2DIc_vsGovKn2HQZyLw1Cg6LEo51OJhONXnAX
 
+## Style
+
+Styling is opt-in, by default you will get a colourless output:
+
+![colourless](./img/colourless.png)
+
+You may enable styling with the --style/-s flag:
+
+```console
+slobs-cli --style="yellow" audio list
+```
+
+Available styles: _red, magenta, purple, blue, cyan, green, yellow, orange, white, grey, navy, black_
+
+![coloured](./img/coloured-border.png)
+
+Optionally you may disable border colouring with the --no-border flag:
+
+![coloured-no-border](./img/coloured-no-border.png)
+
+```console
+slobs-cli --style="yellow" --no-border audio list
+```
+
+Or with environment variables:
+
+```env
+SLOBS_STYLE=yellow
+SLOBS_STYLE_NO_BORDER=true
+```
+
 ## Commands
 
 #### Scene
@@ -293,32 +326,64 @@ slobs-cli scenecollection load "ExistingCollection"
 slobs-cli scenecollection rename "ExistingCollection" "NewName"
 ```
 
-## Style
+## Shell Completion
 
-By default styling is disabled but you may enable it with:
+Shell completion scripts are available for *bash*, *zsh*, and *fish*, you can find them in the [completions directory](./completions/).
 
--   --style/-s: Style used in output.
+#### Bash
-    -  SLOBS_STYLE
--   --no-border/-b: Disable table border styling in output.
-    -  SLOBS_STYLE_NO_BORDER
 
-Available styles:
+Save the script in a completions directory of your choice.
-
-- red
-- magenta
-- purple
-- blue
-- cyan
-- green
-- yellow
-- orange
-- white
-- grey
-- navy
-- black
 
 ```console
-slobs-cli --style=cyan --no-border scene list
+cp -v ./completions/_slobs-cli.bash ~/.completions/_slobs-cli
+```
+
+Source the file in `~/.bashrc`
+
+```bash
+. ~/.completions/_slobs-cli
+```
+
+Restart the shell
+
+```console
+exec "$SHELL"
+```
+
+#### Fish
+
+Save the script to `~/.config/fish/completions`
+
+```fish
+cp -v ./completions/_slobs-cli.fish ~/.config/fish/completions/_slobs-cli
+```
+
+Restart the shell
+
+```console
+exec "$SHELL"
+```
+
+#### Zsh
+
+Save the script in a completions directory of your choice.
+
+```console
+cp -v ./completions/_slobs-cli.zsh ~/.completions/_slobs-cli
+```
+
+Source the file in `~/.zshrc`
+
+```zsh
+. ~/.completions/_slobs-cli
+```
+
+> Note: If you're using a framework like oh-my-zsh you can copy the completion script straight into $ZSH_CUSTOM/completions and skip modifying ~/.zshrc
+
+Restart the shell
+
+```console
+exec "$SHELL"
 ```
 
 ## Special Thanks

Taskfile.yaml

@@ -0,0 +1,33 @@
+version: '3'
+
+tasks:
+  default:
+    desc: Generate completion scripts for supported shells
+    cmds:
+      - task: generate-completion-scripts
+
+  generate-completion-scripts:
+    desc: Generate completion scripts for supported shells
+    cmds:
+      - for:
+          matrix:
+            SHELL: [bash, fish, zsh]
+        task: generate-completion-script-{{.ITEM.SHELL}}
+
+  generate-completion-script-bash:
+    desc: Generate bash completion script
+    cmds:
+      - bash -c '_SLOBS_CLI_COMPLETE=bash_source slobs-cli > ./completions/_slobs-cli.bash'
+    internal: true
+
+  generate-completion-script-fish:
+    desc: Generate fish completion script
+    cmds:
+      - fish -c '_SLOBS_CLI_COMPLETE=fish_source slobs-cli > ./completions/_slobs-cli.fish'
+    internal: true
+
+  generate-completion-script-zsh:
+    desc: Generate zsh completion script
+    cmds:
+      - zsh -c '_SLOBS_CLI_COMPLETE=zsh_source slobs-cli > ./completions/_slobs-cli.zsh'
+    internal: true

completions/_slobs-cli.bash

@@ -0,0 +1,28 @@
+_slobs_cli_completion() {
+    local IFS=$'\n'
+    local response
+
+    response=$(env COMP_WORDS="${COMP_WORDS[*]}" COMP_CWORD=$COMP_CWORD _SLOBS_CLI_COMPLETE=bash_complete $1)
+
+    for completion in $response; do
+        IFS=',' read type value <<< "$completion"
+
+        if [[ $type == 'dir' ]]; then
+            COMPREPLY=()
+            compopt -o dirnames
+        elif [[ $type == 'file' ]]; then
+            COMPREPLY=()
+            compopt -o default
+        elif [[ $type == 'plain' ]]; then
+            COMPREPLY+=($value)
+        fi
+    done
+
+    return 0
+}
+
+_slobs_cli_completion_setup() {
+    complete -o nosort -F _slobs_cli_completion slobs-cli
+}
+
+_slobs_cli_completion_setup;

completions/_slobs-cli.fish

@@ -0,0 +1,17 @@
+function _slobs_cli_completion;
+    set -l response (env _SLOBS_CLI_COMPLETE=fish_complete COMP_WORDS=(commandline -cp) COMP_CWORD=(commandline -t) slobs-cli);
+
+    for completion in $response;
+        set -l metadata (string split "," $completion);
+
+        if test $metadata[1] = "dir";
+            __fish_complete_directories $metadata[2];
+        else if test $metadata[1] = "file";
+            __fish_complete_path $metadata[2];
+        else if test $metadata[1] = "plain";
+            echo $metadata[2];
+        end;
+    end;
+end;
+
+complete --no-files --command slobs-cli --arguments "(_slobs_cli_completion)";

completions/_slobs-cli.zsh

@@ -0,0 +1,40 @@
+#compdef slobs-cli
+
+_slobs_cli_completion() {
+    local -a completions
+    local -a completions_with_descriptions
+    local -a response
+    (( ! $+commands[slobs-cli] )) && return 1
+
+    response=("${(@f)$(env COMP_WORDS="${words[*]}" COMP_CWORD=$((CURRENT-1)) _SLOBS_CLI_COMPLETE=zsh_complete slobs-cli)}")
+
+    for type key descr in ${response}; do
+        if [[ "$type" == "plain" ]]; then
+            if [[ "$descr" == "_" ]]; then
+                completions+=("$key")
+            else
+                completions_with_descriptions+=("$key":"$descr")
+            fi
+        elif [[ "$type" == "dir" ]]; then
+            _path_files -/
+        elif [[ "$type" == "file" ]]; then
+            _path_files -f
+        fi
+    done
+
+    if [ -n "$completions_with_descriptions" ]; then
+        _describe -V unsorted completions_with_descriptions -U
+    fi
+
+    if [ -n "$completions" ]; then
+        compadd -U -V unsorted -a completions
+    fi
+}
+
+if [[ $zsh_eval_context[-1] == loadautofunc ]]; then
+    # autoload from fpath, call function directly
+    _slobs_cli_completion "$@"
+else
+    # eval/source/. command, register function for later
+    compdef _slobs_cli_completion slobs-cli
+fi

pdm.lock

@@ -5,53 +5,50 @@
 groups = ["default", "dev"]
 strategy = ["inherit_metadata"]
 lock_version = "4.5.0"
-content_hash = "sha256:9be0832aae27a9da3f885900d367836aa05a12e9c0459d751c319d1bd329c33c"
+content_hash = "sha256:657780adc251e4b26f1c7798388f7e7442549af2cbdac53fa23b39c40acb28ba"
 
 [[metadata.targets]]
 requires_python = ">=3.11"
 
 [[package]]
 name = "anyio"
-version = "4.9.0"
+version = "4.12.0"
 requires_python = ">=3.9"
-summary = "High level compatibility layer for multiple asynchronous event loop implementations"
+summary = "High-level concurrency and networking framework on top of asyncio or Trio"
 groups = ["default"]
 dependencies = [
     "exceptiongroup>=1.0.2; python_version < \"3.11\"",
     "idna>=2.8",
-    "sniffio>=1.1",
     "typing-extensions>=4.5; python_version < \"3.13\"",
 ]
 files = [
-    {file = "anyio-4.9.0-py3-none-any.whl", hash = "sha256:9f76d541cad6e36af7beb62e978876f3b41e3e04f2c1fbf0884604c0a9c4d93c"},
+    {file = "anyio-4.12.0-py3-none-any.whl", hash = "sha256:dad2376a628f98eeca4881fc56cd06affd18f659b17a747d3ff0307ced94b1bb"},
-    {file = "anyio-4.9.0.tar.gz", hash = "sha256:673c0c244e15788651a4ff38710fea9675823028a6f08a5eda409e0c9840a028"},
+    {file = "anyio-4.12.0.tar.gz", hash = "sha256:73c693b567b0c55130c104d0b43a9baf3aa6a31fc6110116509f27bf75e21ec0"},
 ]
 
 [[package]]
 name = "asyncclick"
-version = "8.1.8"
+version = "8.3.0.7"
-requires_python = ">=3.9"
+requires_python = ">=3.11"
-summary = "Composable command line interface toolkit, "
+summary = "Composable command line interface toolkit, async fork"
 groups = ["default"]
 dependencies = [
-    "anyio~=4.0",
     "colorama; platform_system == \"Windows\"",
 ]
 files = [
-    {file = "asyncclick-8.1.8-py3-none-any.whl", hash = "sha256:eb1ccb44bc767f8f0695d592c7806fdf5bd575605b4ee246ffd5fadbcfdbd7c6"},
+    {file = "asyncclick-8.3.0.7-py3-none-any.whl", hash = "sha256:7607046de39a3f315867cad818849f973e29d350c10d92f251db3ff7600c6c7d"},
-    {file = "asyncclick-8.1.8.0-py3-none-any.whl", hash = "sha256:be146a2d8075d4fe372ff4e877f23c8b5af269d16705c1948123b9415f6fd678"},
+    {file = "asyncclick-8.3.0.7.tar.gz", hash = "sha256:8a80d8ac613098ee6a9a8f0248f60c66c273e22402cf3f115ed7f071acfc71d3"},
-    {file = "asyncclick-8.1.8.tar.gz", hash = "sha256:0f0eb0f280e04919d67cf71b9fcdfb4db2d9ff7203669c40284485c149578e4c"},
 ]
 
 [[package]]
 name = "cachetools"
-version = "6.1.0"
+version = "6.2.4"
 requires_python = ">=3.9"
 summary = "Extensible memoizing collections and decorators"
 groups = ["dev"]
 files = [
-    {file = "cachetools-6.1.0-py3-none-any.whl", hash = "sha256:1c7bb3cf9193deaf3508b7c5f2a79986c13ea38965c5adcff1f84519cf39163e"},
+    {file = "cachetools-6.2.4-py3-none-any.whl", hash = "sha256:69a7a52634fed8b8bf6e24a050fb60bff1c9bd8f6d24572b99c32d4e71e62a51"},
-    {file = "cachetools-6.1.0.tar.gz", hash = "sha256:b4c4f404392848db3ce7aac34950d17be4d864da4b8b66911008e430bc544587"},
+    {file = "cachetools-6.2.4.tar.gz", hash = "sha256:82c5c05585e70b6ba2d3ae09ea60b79548872185d2f24ae1f2709d37299fd607"},
 ]
 
 [[package]]
@@ -78,59 +75,59 @@ files = [
 
 [[package]]
 name = "distlib"
-version = "0.3.9"
+version = "0.4.0"
 summary = "Distribution utilities"
 groups = ["dev"]
 files = [
-    {file = "distlib-0.3.9-py2.py3-none-any.whl", hash = "sha256:47f8c22fd27c27e25a65601af709b38e4f0a45ea4fc2e710f65755fa8caaaf87"},
+    {file = "distlib-0.4.0-py2.py3-none-any.whl", hash = "sha256:9659f7d87e46584a30b5780e43ac7a2143098441670ff0a49d5f9034c54a6c16"},
-    {file = "distlib-0.3.9.tar.gz", hash = "sha256:a60f20dea646b8a33f3e7772f74dc0b2d0772d2837ee1342a00645c81edf9403"},
+    {file = "distlib-0.4.0.tar.gz", hash = "sha256:feec40075be03a04501a973d81f633735b4b69f98b05450592310c0f401a4e0d"},
 ]
 
 [[package]]
 name = "filelock"
-version = "3.18.0"
+version = "3.20.1"
-requires_python = ">=3.9"
+requires_python = ">=3.10"
 summary = "A platform independent file lock."
 groups = ["dev"]
 files = [
-    {file = "filelock-3.18.0-py3-none-any.whl", hash = "sha256:c401f4f8377c4464e6db25fff06205fd89bdd83b65eb0488ed1b160f780e21de"},
+    {file = "filelock-3.20.1-py3-none-any.whl", hash = "sha256:15d9e9a67306188a44baa72f569d2bfd803076269365fdea0934385da4dc361a"},
-    {file = "filelock-3.18.0.tar.gz", hash = "sha256:adbc88eabb99d2fec8c9c1b229b171f18afa655400173ddc653d5d01501fb9f2"},
+    {file = "filelock-3.20.1.tar.gz", hash = "sha256:b8360948b351b80f420878d8516519a2204b07aefcdcfd24912a5d33127f188c"},
 ]
 
 [[package]]
 name = "idna"
-version = "3.10"
+version = "3.11"
-requires_python = ">=3.6"
+requires_python = ">=3.8"
 summary = "Internationalized Domain Names in Applications (IDNA)"
 groups = ["default"]
 files = [
-    {file = "idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3"},
+    {file = "idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea"},
-    {file = "idna-3.10.tar.gz", hash = "sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9"},
+    {file = "idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902"},
 ]
 
 [[package]]
 name = "iniconfig"
-version = "2.1.0"
+version = "2.3.0"
-requires_python = ">=3.8"
+requires_python = ">=3.10"
 summary = "brain-dead simple config-ini parsing"
 groups = ["dev"]
 files = [
-    {file = "iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760"},
+    {file = "iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12"},
-    {file = "iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7"},
+    {file = "iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730"},
 ]
 
 [[package]]
 name = "markdown-it-py"
-version = "3.0.0"
+version = "4.0.0"
-requires_python = ">=3.8"
+requires_python = ">=3.10"
 summary = "Python port of markdown-it. Markdown parsing, done right!"
 groups = ["default"]
 dependencies = [
     "mdurl~=0.1",
 ]
 files = [
-    {file = "markdown-it-py-3.0.0.tar.gz", hash = "sha256:e3f60a94fa066dc52ec76661e37c851cb232d92f9886b15cb560aaada2df8feb"},
+    {file = "markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147"},
-    {file = "markdown_it_py-3.0.0-py3-none-any.whl", hash = "sha256:355216845c60bd96232cd8d8c40e8f9765cc86f46880e43a8fd22dc1a1a8cab1"},
+    {file = "markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3"},
 ]
 
 [[package]]
@@ -157,13 +154,13 @@ files = [
 
 [[package]]
 name = "platformdirs"
-version = "4.3.8"
+version = "4.5.1"
-requires_python = ">=3.9"
+requires_python = ">=3.10"
 summary = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`."
 groups = ["dev"]
 files = [
-    {file = "platformdirs-4.3.8-py3-none-any.whl", hash = "sha256:ff7059bb7eb1179e2685604f4aaf157cfd9535242bd23742eadc3c13542139b4"},
+    {file = "platformdirs-4.5.1-py3-none-any.whl", hash = "sha256:d03afa3963c806a9bed9d5125c8f4cb2fdaf74a55ab60e5d59b3fde758104d31"},
-    {file = "platformdirs-4.3.8.tar.gz", hash = "sha256:3d512d96e16bcb959a814c9f348431070822a6496326a4be0911c40b5a74c2bc"},
+    {file = "platformdirs-4.5.1.tar.gz", hash = "sha256:61d5cdcc6065745cdd94f0f878977f8de9437be93de97c1c12f853c9c0cdcbda"},
 ]
 
 [[package]]
@@ -179,13 +176,13 @@ files = [
 
 [[package]]
 name = "pyenv-inspect"
-version = "0.4.0"
+version = "0.5.0"
-requires_python = ">=3.8"
+requires_python = ">=3.9"
 summary = "An auxiliary library for the virtualenv-pyenv and tox-pyenv-redux plugins"
 groups = ["dev"]
 files = [
-    {file = "pyenv-inspect-0.4.0.tar.gz", hash = "sha256:ec429d1d81b67ab0b08a0408414722a79d24fd1845a5b264267e44e19d8d60f0"},
+    {file = "pyenv_inspect-0.5.0-py3-none-any.whl", hash = "sha256:ada3d3ea49b8604ff330d06a39ffe46df120d31c0bc9796392a41f2c3b34b08e"},
-    {file = "pyenv_inspect-0.4.0-py3-none-any.whl", hash = "sha256:618683ae7d3e6db14778d58aa0fc6b3170180d944669b5d35a8aa4fb7db550d2"},
+    {file = "pyenv_inspect-0.5.0.tar.gz", hash = "sha256:acaec63227577ac6edd3e775036d7bb0077d8ed2ebce5021e176a732e20c84d3"},
 ]
 
 [[package]]
@@ -201,56 +198,56 @@ files = [
 
 [[package]]
 name = "pyproject-api"
-version = "1.9.1"
+version = "1.10.0"
-requires_python = ">=3.9"
+requires_python = ">=3.10"
 summary = "API to interact with the python pyproject.toml based projects"
 groups = ["dev"]
 dependencies = [
     "packaging>=25",
-    "tomli>=2.2.1; python_version < \"3.11\"",
+    "tomli>=2.3; python_version < \"3.11\"",
 ]
 files = [
-    {file = "pyproject_api-1.9.1-py3-none-any.whl", hash = "sha256:7d6238d92f8962773dd75b5f0c4a6a27cce092a14b623b811dba656f3b628948"},
+    {file = "pyproject_api-1.10.0-py3-none-any.whl", hash = "sha256:8757c41a79c0f4ab71b99abed52b97ecf66bd20b04fa59da43b5840bac105a09"},
-    {file = "pyproject_api-1.9.1.tar.gz", hash = "sha256:43c9918f49daab37e302038fc1aed54a8c7a91a9fa935d00b9a485f37e0f5335"},
+    {file = "pyproject_api-1.10.0.tar.gz", hash = "sha256:40c6f2d82eebdc4afee61c773ed208c04c19db4c4a60d97f8d7be3ebc0bbb330"},
 ]
 
 [[package]]
 name = "pyslobs"
-version = "2.0.5"
+version = "2.1.0"
-requires_python = ">=3.9"
+requires_python = ">=3.10"
 summary = "Python wrapper to StreamLabs Desktop API"
 groups = ["default"]
 dependencies = [
     "websocket-client",
 ]
 files = [
-    {file = "pyslobs-2.0.5-py3-none-any.whl", hash = "sha256:b33d774dda484ffe48e63592a3cdf66c79f77d04947a6e8c8b6da58db13ab156"},
+    {file = "pyslobs-2.1.0-py3-none-any.whl", hash = "sha256:b0fe85dce75a8faae5dfd8ee717971a732d45602d97cc5eaa653a116878d5e92"},
-    {file = "pyslobs-2.0.5.tar.gz", hash = "sha256:53cb083cbe71e37f3604ad0e5ca9712b3f26a29824ce0d437fd66e3d7937fee6"},
+    {file = "pyslobs-2.1.0.tar.gz", hash = "sha256:244c67563cffd56fd1b39a03552d125ad7c2c8fefff6b42c4153bbfe29984fa1"},
 ]
 
 [[package]]
 name = "pytest"
-version = "8.4.1"
+version = "9.0.2"
-requires_python = ">=3.9"
+requires_python = ">=3.10"
 summary = "pytest: simple powerful testing with Python"
 groups = ["dev"]
 dependencies = [
     "colorama>=0.4; sys_platform == \"win32\"",
     "exceptiongroup>=1; python_version < \"3.11\"",
-    "iniconfig>=1",
+    "iniconfig>=1.0.1",
-    "packaging>=20",
+    "packaging>=22",
     "pluggy<2,>=1.5",
     "pygments>=2.7.2",
     "tomli>=1; python_version < \"3.11\"",
 ]
 files = [
-    {file = "pytest-8.4.1-py3-none-any.whl", hash = "sha256:539c70ba6fcead8e78eebbf1115e8b589e7565830d7d006a8723f19ac8a0afb7"},
+    {file = "pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b"},
-    {file = "pytest-8.4.1.tar.gz", hash = "sha256:7c67fd69174877359ed9371ec3af8a3d2b04741818c51e5e99cc1742251fa93c"},
+    {file = "pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11"},
 ]
 
 [[package]]
 name = "pytest-randomly"
-version = "3.16.0"
+version = "4.0.1"
 requires_python = ">=3.9"
 summary = "Pytest plugin to randomly order tests and control random.seed."
 groups = ["dev"]
@@ -259,86 +256,75 @@ dependencies = [
     "pytest",
 ]
 files = [
-    {file = "pytest_randomly-3.16.0-py3-none-any.whl", hash = "sha256:8633d332635a1a0983d3bba19342196807f6afb17c3eef78e02c2f85dade45d6"},
+    {file = "pytest_randomly-4.0.1-py3-none-any.whl", hash = "sha256:e0dfad2fd4f35e07beff1e47c17fbafcf98f9bf4531fd369d9260e2f858bfcb7"},
-    {file = "pytest_randomly-3.16.0.tar.gz", hash = "sha256:11bf4d23a26484de7860d82f726c0629837cf4064b79157bd18ec9d41d7feb26"},
+    {file = "pytest_randomly-4.0.1.tar.gz", hash = "sha256:174e57bb12ac2c26f3578188490bd333f0e80620c3f47340158a86eca0593cd8"},
 ]
 
 [[package]]
 name = "rich"
-version = "14.0.0"
+version = "14.2.0"
 requires_python = ">=3.8.0"
 summary = "Render rich text, tables, progress bars, syntax highlighting, markdown and more to the terminal"
 groups = ["default"]
 dependencies = [
     "markdown-it-py>=2.2.0",
     "pygments<3.0.0,>=2.13.0",
-    "typing-extensions<5.0,>=4.0.0; python_version < \"3.11\"",
 ]
 files = [
-    {file = "rich-14.0.0-py3-none-any.whl", hash = "sha256:1c9491e1951aac09caffd42f448ee3d04e58923ffe14993f6e83068dc395d7e0"},
+    {file = "rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd"},
-    {file = "rich-14.0.0.tar.gz", hash = "sha256:82f1bc23a6a21ebca4ae0c45af9bdbc492ed20231dcb63f297d6d1021a9d5725"},
+    {file = "rich-14.2.0.tar.gz", hash = "sha256:73ff50c7c0c1c77c8243079283f4edb376f0f6442433aecb8ce7e6d0b92d1fe4"},
 ]
 
 [[package]]
 name = "ruff"
-version = "0.12.0"
+version = "0.14.10"
 requires_python = ">=3.7"
 summary = "An extremely fast Python linter and code formatter, written in Rust."
 groups = ["dev"]
 files = [
-    {file = "ruff-0.12.0-py3-none-linux_armv6l.whl", hash = "sha256:5652a9ecdb308a1754d96a68827755f28d5dfb416b06f60fd9e13f26191a8848"},
+    {file = "ruff-0.14.10-py3-none-linux_armv6l.whl", hash = "sha256:7a3ce585f2ade3e1f29ec1b92df13e3da262178df8c8bdf876f48fa0e8316c49"},
-    {file = "ruff-0.12.0-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:05ed0c914fabc602fc1f3b42c53aa219e5736cb030cdd85640c32dbc73da74a6"},
+    {file = "ruff-0.14.10-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:674f9be9372907f7257c51f1d4fc902cb7cf014b9980152b802794317941f08f"},
-    {file = "ruff-0.12.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:07a7aa9b69ac3fcfda3c507916d5d1bca10821fe3797d46bad10f2c6de1edda0"},
+    {file = "ruff-0.14.10-py3-none-macosx_11_0_arm64.whl", hash = "sha256:d85713d522348837ef9df8efca33ccb8bd6fcfc86a2cde3ccb4bc9d28a18003d"},
-    {file = "ruff-0.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e7731c3eec50af71597243bace7ec6104616ca56dda2b99c89935fe926bdcd48"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6987ebe0501ae4f4308d7d24e2d0fe3d7a98430f5adfd0f1fead050a740a3a77"},
-    {file = "ruff-0.12.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:952d0630eae628250ab1c70a7fffb641b03e6b4a2d3f3ec6c1d19b4ab6c6c807"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:16a01dfb7b9e4eee556fbfd5392806b1b8550c9b4a9f6acd3dbe6812b193c70a"},
-    {file = "ruff-0.12.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c021f04ea06966b02614d442e94071781c424ab8e02ec7af2f037b4c1e01cc82"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7165d31a925b7a294465fa81be8c12a0e9b60fb02bf177e79067c867e71f8b1f"},
-    {file = "ruff-0.12.0-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:7d235618283718ee2fe14db07f954f9b2423700919dc688eacf3f8797a11315c"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:c561695675b972effb0c0a45db233f2c816ff3da8dcfbe7dfc7eed625f218935"},
-    {file = "ruff-0.12.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0c0758038f81beec8cc52ca22de9685b8ae7f7cc18c013ec2050012862cc9165"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4bb98fcbbc61725968893682fd4df8966a34611239c9fd07a1f6a07e7103d08e"},
-    {file = "ruff-0.12.0-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:139b3d28027987b78fc8d6cfb61165447bdf3740e650b7c480744873688808c2"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f24b47993a9d8cb858429e97bdf8544c78029f09b520af615c1d261bf827001d"},
-    {file = "ruff-0.12.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:68853e8517b17bba004152aebd9dd77d5213e503a5f2789395b25f26acac0da4"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:59aabd2e2c4fd614d2862e7939c34a532c04f1084476d6833dddef4afab87e9f"},
-    {file = "ruff-0.12.0-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:3a9512af224b9ac4757f7010843771da6b2b0935a9e5e76bb407caa901a1a514"},
+    {file = "ruff-0.14.10-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:213db2b2e44be8625002dbea33bb9c60c66ea2c07c084a00d55732689d697a7f"},
-    {file = "ruff-0.12.0-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:b08df3d96db798e5beb488d4df03011874aff919a97dcc2dd8539bb2be5d6a88"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:b914c40ab64865a17a9a5b67911d14df72346a634527240039eb3bd650e5979d"},
-    {file = "ruff-0.12.0-py3-none-musllinux_1_2_i686.whl", hash = "sha256:6a315992297a7435a66259073681bb0d8647a826b7a6de45c6934b2ca3a9ed51"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:1484983559f026788e3a5c07c81ef7d1e97c1c78ed03041a18f75df104c45405"},
-    {file = "ruff-0.12.0-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:1e55e44e770e061f55a7dbc6e9aed47feea07731d809a3710feda2262d2d4d8a"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_i686.whl", hash = "sha256:c70427132db492d25f982fffc8d6c7535cc2fd2c83fc8888f05caaa248521e60"},
-    {file = "ruff-0.12.0-py3-none-win32.whl", hash = "sha256:7162a4c816f8d1555eb195c46ae0bd819834d2a3f18f98cc63819a7b46f474fb"},
+    {file = "ruff-0.14.10-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:5bcf45b681e9f1ee6445d317ce1fa9d6cba9a6049542d1c3d5b5958986be8830"},
-    {file = "ruff-0.12.0-py3-none-win_amd64.whl", hash = "sha256:d00b7a157b8fb6d3827b49d3324da34a1e3f93492c1f97b08e222ad7e9b291e0"},
+    {file = "ruff-0.14.10-py3-none-win32.whl", hash = "sha256:104c49fc7ab73f3f3a758039adea978869a918f31b73280db175b43a2d9b51d6"},
-    {file = "ruff-0.12.0-py3-none-win_arm64.whl", hash = "sha256:8cd24580405ad8c1cc64d61725bca091d6b6da7eb3d36f72cc605467069d7e8b"},
+    {file = "ruff-0.14.10-py3-none-win_amd64.whl", hash = "sha256:466297bd73638c6bdf06485683e812db1c00c7ac96d4ddd0294a338c62fdc154"},
-    {file = "ruff-0.12.0.tar.gz", hash = "sha256:4d047db3662418d4a848a3fdbfaf17488b34b62f527ed6f10cb8afd78135bc5c"},
+    {file = "ruff-0.14.10-py3-none-win_arm64.whl", hash = "sha256:e51d046cf6dda98a4633b8a8a771451107413b0f07183b2bef03f075599e44e6"},
-]
+    {file = "ruff-0.14.10.tar.gz", hash = "sha256:9a2e830f075d1a42cd28420d7809ace390832a490ed0966fe373ba288e77aaf4"},
-
-[[package]]
-name = "sniffio"
-version = "1.3.1"
-requires_python = ">=3.7"
-summary = "Sniff out which async library your code is running under"
-groups = ["default"]
-files = [
-    {file = "sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2"},
-    {file = "sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc"},
 ]
 
 [[package]]
 name = "tox"
-version = "4.27.0"
+version = "4.32.0"
-requires_python = ">=3.9"
+requires_python = ">=3.10"
 summary = "tox is a generic virtualenv management and test command line tool"
 groups = ["dev"]
 dependencies = [
-    "cachetools>=5.5.1",
+    "cachetools>=6.2",
     "chardet>=5.2",
     "colorama>=0.4.6",
-    "filelock>=3.16.1",
+    "filelock>=3.20",
-    "packaging>=24.2",
+    "packaging>=25",
-    "platformdirs>=4.3.6",
+    "platformdirs>=4.5",
-    "pluggy>=1.5",
+    "pluggy>=1.6",
-    "pyproject-api>=1.8",
+    "pyproject-api>=1.9.1",
-    "tomli>=2.2.1; python_version < \"3.11\"",
+    "tomli>=2.3; python_version < \"3.11\"",
-    "typing-extensions>=4.12.2; python_version < \"3.11\"",
+    "typing-extensions>=4.15; python_version < \"3.11\"",
-    "virtualenv>=20.31",
+    "virtualenv>=20.34",
 ]
 files = [
-    {file = "tox-4.27.0-py3-none-any.whl", hash = "sha256:2b8a7fb986b82aa2c830c0615082a490d134e0626dbc9189986da46a313c4f20"},
+    {file = "tox-4.32.0-py3-none-any.whl", hash = "sha256:451e81dc02ba8d1ed20efd52ee409641ae4b5d5830e008af10fe8823ef1bd551"},
-    {file = "tox-4.27.0.tar.gz", hash = "sha256:b97d5ecc0c0d5755bcc5348387fef793e1bfa68eb33746412f4c60881d7f5f57"},
+    {file = "tox-4.32.0.tar.gz", hash = "sha256:1ad476b5f4d3679455b89a992849ffc3367560bbc7e9495ee8a3963542e7c8ff"},
 ]
 
 [[package]]
@@ -358,19 +344,19 @@ files = [
 
 [[package]]
 name = "typing-extensions"
-version = "4.14.0"
+version = "4.15.0"
 requires_python = ">=3.9"
 summary = "Backported and Experimental Type Hints for Python 3.9+"
 groups = ["default"]
 marker = "python_version < \"3.13\""
 files = [
-    {file = "typing_extensions-4.14.0-py3-none-any.whl", hash = "sha256:a1514509136dd0b477638fc68d6a91497af5076466ad0fa6c338e44e359944af"},
+    {file = "typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548"},
-    {file = "typing_extensions-4.14.0.tar.gz", hash = "sha256:8676b788e32f02ab42d9e7c61324048ae4c6d844a399eebace3d4979d75ceef4"},
+    {file = "typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466"},
 ]
 
 [[package]]
 name = "virtualenv"
-version = "20.31.2"
+version = "20.35.4"
 requires_python = ">=3.8"
 summary = "Virtual Python Environment builder"
 groups = ["dev"]
@@ -379,34 +365,35 @@ dependencies = [
     "filelock<4,>=3.12.2",
     "importlib-metadata>=6.6; python_version < \"3.8\"",
     "platformdirs<5,>=3.9.1",
+    "typing-extensions>=4.13.2; python_version < \"3.11\"",
 ]
 files = [
-    {file = "virtualenv-20.31.2-py3-none-any.whl", hash = "sha256:36efd0d9650ee985f0cad72065001e66d49a6f24eb44d98980f630686243cf11"},
+    {file = "virtualenv-20.35.4-py3-none-any.whl", hash = "sha256:c21c9cede36c9753eeade68ba7d523529f228a403463376cf821eaae2b650f1b"},
-    {file = "virtualenv-20.31.2.tar.gz", hash = "sha256:e10c0a9d02835e592521be48b332b6caee6887f332c111aa79a09b9e79efc2af"},
+    {file = "virtualenv-20.35.4.tar.gz", hash = "sha256:643d3914d73d3eeb0c552cbb12d7e82adf0e504dbf86a3182f8771a153a1971c"},
 ]
 
 [[package]]
 name = "virtualenv-pyenv"
-version = "0.5.0"
+version = "0.6.0"
-requires_python = ">=3.8"
+requires_python = ">=3.9"
 summary = "A virtualenv Python discovery plugin for pyenv-installed interpreters"
 groups = ["dev"]
 dependencies = [
-    "pyenv-inspect<0.5,>=0.4",
+    "pyenv-inspect<0.6,>=0.5",
-    "virtualenv",
+    "virtualenv>=20.29.0",
 ]
 files = [
-    {file = "virtualenv-pyenv-0.5.0.tar.gz", hash = "sha256:7b0e5fe3dfbdf484f4cf9b01e1f98111e398db6942237910f666356e6293597f"},
+    {file = "virtualenv_pyenv-0.6.0-py3-none-any.whl", hash = "sha256:182fc36893dbf731ccdbc762d2172091f43dab90136c7755520c459054342195"},
-    {file = "virtualenv_pyenv-0.5.0-py3-none-any.whl", hash = "sha256:21750247e36c55b3c547cfdeb08f51a3867fe7129922991a4f9c96980c0a4a5d"},
+    {file = "virtualenv_pyenv-0.6.0.tar.gz", hash = "sha256:d85a1d73349203ec6605a75b596ae494263c6c32fcdafcf74c9ddfbcfdcd9094"},
 ]
 
 [[package]]
 name = "websocket-client"
-version = "1.8.0"
+version = "1.9.0"
-requires_python = ">=3.8"
+requires_python = ">=3.9"
 summary = "WebSocket client for Python with low level API options"
 groups = ["default"]
 files = [
-    {file = "websocket_client-1.8.0-py3-none-any.whl", hash = "sha256:17b44cc997f5c498e809b22cdf2d9c7a9e71c02c8cc2b6c56e7c2d1239bfa526"},
+    {file = "websocket_client-1.9.0-py3-none-any.whl", hash = "sha256:af248a825037ef591efbf6ed20cc5faa03d3b47b9e5a2230a529eeee1c1fc3ef"},
-    {file = "websocket_client-1.8.0.tar.gz", hash = "sha256:3239df9f44da632f96012472805d40a23281a991027ce11d2f45a6f24ac4c3da"},
+    {file = "websocket_client-1.9.0.tar.gz", hash = "sha256:9e813624b6eb619999a97dc7958469217c3176312b3a16a4bd1bc7e08a46ec98"},
 ]

pyproject.toml

@@ -2,7 +2,12 @@
 name = "slobs-cli"
 description = "A command line application for Streamlabs Desktop"
 authors = [{ name = "onyx-and-iris", email = "code@onyxandiris.online" }]
-dependencies = ["pyslobs>=2.0.5", "asyncclick>=8.1.8", "rich>=14.0.0"]
+dependencies = [
+    "pyslobs>=2.0.5",
+    "asyncclick>=8.1.8",
+    "rich>=14.0.0",
+    "anyio>=4.12.0",
+]
 requires-python = ">=3.11"
 readme = "README.md"
 license = { text = "MIT" }
@@ -36,6 +41,8 @@ test.keep_going = true
 fmt.cmd = "ruff format {args}"
 post_fmt.cmd = "ruff check {args}"
 
+completion.cmd = "task generate-completion-scripts"
+
 [dependency-groups]
 dev = [
     "tox-pdm>=0.7.2",

src/slobs_cli/__about__.py

@@ -1,3 +1,3 @@
 """module for package metadata."""
 
-__version__ = '0.11.0'
+__version__ = '0.11.5'

src/slobs_cli/audio.py

@@ -47,8 +47,8 @@ async def list(ctx: click.Context, id: bool = False):
                 ('Audio Source Name', 'left'),
                 ('Muted', 'center'),
             ]
-        for col_name, col_justify in columns:
+        for heading, justify in columns:
-            table.add_column(Text(col_name, justify='center'), justify=col_justify)
+            table.add_column(Text(heading, justify='center'), justify=justify)
 
         for source in sources:
             model = await source.get_model()

src/slobs_cli/cli.py

@@ -8,7 +8,21 @@ from . import styles
 from .__about__ import __version__ as version
 
 
-@click.group()
+def validate_style(ctx: click.Context, param: click.Parameter, value: str) -> str:
+    """Validate the style option."""
+    if value not in styles.registry:
+        raise click.BadParameter(
+            f"Invalid style '{value}'. Available styles: {', '.join(styles.registry.keys())}"
+        )
+    return value
+
+
+CONTEXT_SETTINGS = dict(help_option_names=['-h', '--help'])
+
+
+@click.group(
+    context_settings=CONTEXT_SETTINGS,
+)
 @click.option(
     '-d',
     '--domain',
@@ -16,7 +30,7 @@ from .__about__ import __version__ as version
     envvar='SLOBS_DOMAIN',
     show_default=True,
     show_envvar=True,
-    help='The domain of the SLOBS server.',
+    help='\b\nStreamlabs Desktop WebSocket domain or IP address.\t',
 )
 @click.option(
     '-p',
@@ -25,7 +39,7 @@ from .__about__ import __version__ as version
     envvar='SLOBS_PORT',
     show_default=True,
     show_envvar=True,
-    help='The port of the SLOBS server.',
+    help='\b\nStreamlabs Desktop WebSocket port.\t\t\t',
 )
 @click.option(
     '-t',
@@ -33,7 +47,7 @@ from .__about__ import __version__ as version
     envvar='SLOBS_TOKEN',
     show_envvar=True,
     required=True,
-    help='The token for the SLOBS server.',
+    help='\b\nStreamlabs Desktop WebSocket authentication token.\t',
 )
 @click.option(
     '-s',
@@ -42,7 +56,8 @@ from .__about__ import __version__ as version
     envvar='SLOBS_STYLE',
     show_default=True,
     show_envvar=True,
-    help='The style to use for output.',
+    help='\b\nThe style to use for output.\t\t\t\t',
+    callback=validate_style,
 )
 @click.option(
     '-b',
@@ -52,7 +67,7 @@ from .__about__ import __version__ as version
     envvar='SLOBS_STYLE_NO_BORDER',
     show_default=True,
     show_envvar=True,
-    help='Disable borders in the output.',
+    help='\b\nDisable borders in the output.\t\t\t\t',
 )
 @click.version_option(
     version, '-v', '--version', message='%(prog)s version: %(version)s'

src/slobs_cli/console.py

@@ -9,13 +9,9 @@ err = Console(stderr=True, style='bold red')
 
 def highlight(ctx: click.Context, text: str) -> str:
     """Highlight text for console output."""
-    if ctx.obj['style'].name == 'no_colour':
-        return text
     return f'[{ctx.obj["style"].highlight}]{text}[/{ctx.obj["style"].highlight}]'
 
 
 def warning(ctx: click.Context, text: str) -> str:
     """Format warning text for console output."""
-    if ctx.obj['style'].name == 'no_colour':
+    return f'[{ctx.obj["style"].warning}]{text}[/{ctx.obj["style"].warning}]'
-        return text
-    return f'[magenta]{text}[/magenta]'

src/slobs_cli/scene.py

@@ -52,8 +52,8 @@ async def list(ctx: click.Context, id: bool = False):
                 ('Active', 'center'),
             ]
 
-        for col_name, col_justify in columns:
+        for heading, justify in columns:
-            table.add_column(Text(col_name, justify='center'), justify=col_justify)
+            table.add_column(Text(heading, justify='center'), justify=justify)
 
         for scene in scenes:
             to_append = [Text(scene.name, style=style.cell)]

src/slobs_cli/scenecollection.py

@@ -52,8 +52,8 @@ async def list(ctx: click.Context, id: bool):
                 ('Active', 'center'),
             ]
 
-        for col_name, col_justify in columns:
+        for heading, justify in columns:
-            table.add_column(Text(col_name, justify='center'), justify=col_justify)
+            table.add_column(Text(heading, justify='center'), justify=justify)
 
         for collection in collections:
             to_append = [Text(collection.name, style=style.cell)]

src/slobs_cli/styles.py

@@ -3,15 +3,15 @@
 import os
 from dataclasses import dataclass
 
-_registry = {}
+registry = {}
 
 
 def register_style(cls):
     """Register a style class."""
     key = cls.__name__.lower()
-    if key in _registry:
+    if key in registry:
         raise ValueError(f'Style {key} is already registered.')
-    _registry[key] = cls
+    registry[key] = cls
     return cls
 
 
@@ -19,11 +19,12 @@ def register_style(cls):
 class Style:
     """Base class for styles."""
 
-    name: str = 'no_colour'
+    name: str
-    border: str | None = None
+    border: str
-    header: str | None = None
+    header: str
-    cell: str | None = None
+    cell: str
-    highlight: str | None = None
+    highlight: str
+    warning: str
     no_border: bool = False
 
     def __post_init__(self):
@@ -33,6 +34,19 @@ class Style:
             self.border = None
 
 
+@register_style
+@dataclass
+class Disabled(Style):
+    """Disabled style."""
+
+    name: str = 'disabled'
+    header: str = ''
+    border: str = 'none'
+    cell: str = 'none'
+    highlight: str = 'none'
+    warning: str = 'none'
+
+
 @register_style
 @dataclass
 class Red(Style):
@@ -43,6 +57,7 @@ class Red(Style):
     border: str = 'dark_red'
     cell: str = 'red'
     highlight: str = 'red3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -55,6 +70,7 @@ class Magenta(Style):
     border: str = 'dark_magenta'
     cell: str = 'magenta'
     highlight: str = 'magenta3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -67,6 +83,7 @@ class Purple(Style):
     border: str = 'purple'
     cell: str = 'medium_orchid'
     highlight: str = 'medium_orchid'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -79,6 +96,7 @@ class Blue(Style):
     border: str = 'dark_blue'
     cell: str = 'blue'
     highlight: str = 'blue3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -91,6 +109,7 @@ class Cyan(Style):
     border: str = 'dark_cyan'
     cell: str = 'cyan'
     highlight: str = 'cyan3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -103,6 +122,7 @@ class Green(Style):
     border: str = 'dark_green'
     cell: str = 'green'
     highlight: str = 'green3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -115,6 +135,7 @@ class Yellow(Style):
     border: str = 'yellow3'
     cell: str = 'wheat1'
     highlight: str = 'yellow3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -127,6 +148,7 @@ class Orange(Style):
     border: str = 'dark_orange'
     cell: str = 'orange'
     highlight: str = 'orange3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -139,6 +161,7 @@ class White(Style):
     border: str = 'white'
     cell: str = 'white'
     highlight: str = 'white'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -151,6 +174,7 @@ class Grey(Style):
     border: str = 'grey50'
     cell: str = 'grey70'
     highlight: str = 'grey90'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -163,6 +187,7 @@ class Navy(Style):
     border: str = 'deep_sky_blue4'
     cell: str = 'light_sky_blue3'
     highlight: str = 'light_sky_blue3'
+    warning: str = 'magenta'
 
 
 @register_style
@@ -175,12 +200,12 @@ class Black(Style):
     border: str = 'black'
     cell: str = 'grey30'
     highlight: str = 'grey30'
+    warning: str = 'magenta'
 
 
 def request_style_obj(style_name: str, no_border: bool) -> Style:
     """Request a style object by name."""
-    key = style_name.lower()
+    if style_name == 'disabled':
-    if key not in _registry:
+        os.environ['NO_COLOR'] = '1'
-        os.environ['NO_COLOR'] = '1'  # Disable colour output
+
-        return Style(no_border=no_border)
+    return registry[style_name.lower()](no_border=no_border)
-    return _registry[key](no_border=no_border)

src/slobs_cli/util.py

@@ -10,6 +10,10 @@ def check_mark(ctx: click.Context, value: bool, empty_if_false: bool = False) ->
     if empty_if_false and not value:
         return ''
 
-    if os.getenv('NO_COLOR', '') != '' or ctx.obj['style'].name == 'no_colour':
+    # rich gracefully handles the absence of colour throughout the rest of the application,
+    # but here we must handle it manually.
+    # If NO_COLOR is set, we return plain text symbols.
+    # Otherwise, we return coloured symbols.
+    if os.getenv('NO_COLOR', '') != '':
         return '✓' if value else '✗'
     return '✅' if value else '❌'