__fish_complete_users.fish

# This should be used where you want user names with a description. Such as in an argument
# completion. If you just want a list of user names use __fish_print_users.
# The string replace command takes into account GECOS-formatted description fields, by retaining
# only the first field, the relevant one, from the comma-separated list
function __fish_complete_users --description "Print a list of local users, with the real user name as a description"
    if command -sq getent
        command getent passwd | while read -l line
            string split -f 1,5 : -- $line | string join \t | string replace -r ',.*' ''
        end
    else if command -sq dscl
        # This is the "Directory Service command line utility" used on macOS in place of getent.
        command dscl . -list /Users RealName | string match -r -v '^_' | string replace -r ' {2,}' \t
    else
        string match -v -r '^\s*#' <?/etc/passwd | while read -l line
            string split -f 1,5 : -- $line | string join \t | string replace -r ',.*' ''
        end
    end
end