A nice to look variable list

[leviska]

I have a justfile like this

# name of the binary to run
strategy := env("STRATEGY_NAME", "main")
export STRATEGY_NAME := strategy

# cmake, ninja, none, sanitize
mode := env("BUILD_MODE", "cmake")
export BUILD_MODE := mode

# slack channel
channel := env("SLACK_CHANNEL", "test")
export SLACK_CHANNEL := channel

# use remote or local cluster
remote := env("RAY_REMOTE", "true")
export RAY_REMOTE := remote

# restore the previous run
restore := env("RESTORE", "false")
export RESTORE := restore

# which runner to use
runner := env("RUNNER", "suite")
export RUNNER := runner

# print all commands
default:
    #!/usr/bin/env zsh
    echo "{{ NORMAL }}Current variables:"
    echo "\t{{ YELLOW }}strategy{{ BLUE }} := {{ CYAN }}{{ strategy }}{{ BLUE }}"
    echo "\t{{ YELLOW }}mode{{ BLUE }} := {{ CYAN }}{{ mode }}{{ BLUE }} [cmake|ninja|sanitize|none]"
    echo "\t{{ YELLOW }}channel{{ BLUE }} := {{ CYAN }}{{ channel }}{{ BLUE }}"
    echo "\t{{ YELLOW }}remote{{ BLUE }} := {{ CYAN }}{{ remote }}{{ BLUE }}"
    echo "\t{{ YELLOW }}restore{{ BLUE }} := {{ CYAN }}{{ restore }}{{ BLUE }}"
    echo "\t{{ YELLOW }}runner{{ BLUE }} := {{ CYAN }}{{ runner }}{{ BLUE }} [suite|bt]"
    echo "{{ NORMAL }}Use {{ YELLOW }}just foo=\"bar\" cmd args{{ NORMAL }} to override variables"
    echo "E.x. {{ YELLOW }}just mode=\"ninja\" build main{{ NORMAL }}"
    echo "{{ NORMAL }}"
    just --list --unsorted

[...] commands

Which prints a nice to view variable list, with colors, and with additional help for people who never used just

I think it would be nice to have something like that built in just

There is a just --evaluate, but that doesn't have color output.
Also it shows all variables, including exports, so all my variables are doubled

(but may be I'm doing something wrong with variables, basically i want a nice short alias for a long env variable)

[awoimbee]

I would like something similar.
My makefiles have:

help: _force ## Show this help.
    @perl -e '$(_HELP_FUN)' $(MAKEFILE_LIST)
    @printf "Configurable variables:\n"
    @cat $(MAKEFILE_LIST) | sort | perl -ne '$(_CONFIGURABLE_FUN)'

_HELP_FUN = %help; \
    while(<>) { push @{$$help{$$2 // "Other"}}, [$$1, $$3] if /^([a-zA-Z\-._%]+)\s*:.*\#\#(?:@([a-zA-Z\-_]+))?\s(.*)$$/ }; \
    print "$(RESET)project: $(PURPLE)$(NAME)$(RESET)\n"; \
    print "usage: make [target] [VAR=value]\n\n"; \
    for (sort keys %help) { \
    print "$$_:\n"; \
    for (@{$$help{$$_}}) { \
    $$sep = " " x (25 - length $$_->[0]); \
    print " ${YELLOW}$$_->[0]${RESET}$$sep${GREEN}$$_->[1]${RESET}\n"; \
    }; \
    print "\n"; }

_CONFIGURABLE_FUN = \
    /(^[A-Z_0-9-]+)\s*\?=\s*(.*?)\s*\#\#\s*(.*)/ \
    && printf(" %-35s $(GREEN)%s$(RESET)\n", sprintf("$(YELLOW)%s$(RESET): %s", $$1, $$2), $$3)

Which looks like:

project: my-project 
usage: make [target] [VAR=value]

Clean:
 clean-python             Rm python bytecode, tox, ...
 clean                    

Other:
 submodules               Update git submodules.
 help                     Show this help.
 probe-%                  Print the value of a variable (e.g. print-ECR_URI)

Configurable variables:
 TAG: latest              Image tag (image -> image:latest).