yunohost/data/helpers.d/user

#!/bin/bash

# Check if a YunoHost user exists
#
# example: ynh_user_exists 'toto' || exit 1
#
# usage: ynh_user_exists --username=username
# | arg: -u, --username - the username to check
#
# Requires YunoHost version 2.2.4 or higher.
ynh_user_exists() {
    # Declare an array to define the options of this helper.
    local legacy_args=u
    declare -Ar args_array=( [u]=username= )
    local username
    # Manage arguments with getopts
    ynh_handle_getopts_args "$@"

    sudo yunohost user list --output-as json | grep -q "\"username\": \"${username}\""
}

# Retrieve a YunoHost user information
#
# example: mail=$(ynh_user_get_info 'toto' 'mail')
#
# usage: ynh_user_get_info --username=username --key=key
# | arg: -u, --username - the username to retrieve info from
# | arg: -k, --key - the key to retrieve
# | ret: string - the key's value
#
# Requires YunoHost version 2.2.4 or higher.
ynh_user_get_info() {
    # Declare an array to define the options of this helper.
    local legacy_args=uk
    declare -Ar args_array=( [u]=username= [k]=key= )
    local username
    local key
    # Manage arguments with getopts
    ynh_handle_getopts_args "$@"

    sudo yunohost user info "$username" --output-as plain | ynh_get_plain_key "$key"
}

# Get the list of YunoHost users
#
# example: for u in $(ynh_user_list); do ...
#
# usage: ynh_user_list
# | ret: string - one username per line
#
# Requires YunoHost version 2.4.0 or higher.
ynh_user_list() {
    sudo yunohost user list --output-as plain --quiet \
      | awk '/^##username$/{getline; print}'
}

# Check if a user exists on the system
#
# usage: ynh_system_user_exists --username=username
# | arg: -u, --username - the username to check
#
# Requires YunoHost version 2.2.4 or higher.
ynh_system_user_exists() {
    # Declare an array to define the options of this helper.
    local legacy_args=u
    declare -Ar args_array=( [u]=username= )
    local username
    # Manage arguments with getopts
    ynh_handle_getopts_args "$@"

    getent passwd "$username" &>/dev/null
}

# Check if a group exists on the system
#
# usage: ynh_system_group_exists --group=group
# | arg: -g, --group - the group to check
ynh_system_group_exists() {
    # Declare an array to define the options of this helper.
    local legacy_args=g
    declare -Ar args_array=( [g]=group= )
    local group
    # Manage arguments with getopts
    ynh_handle_getopts_args "$@"

    getent group "$group" &>/dev/null
}

# Create a system user
#
# examples:
#   # Create a nextcloud user with no home directory and /usr/sbin/nologin login shell (hence no login capability)
#   ynh_system_user_create --username=nextcloud
#   # Create a discourse user using /var/www/discourse as home directory and the default login shell
#   ynh_system_user_create --username=discourse --home_dir=/var/www/discourse --use_shell 
#
# usage: ynh_system_user_create --username=user_name [--home_dir=home_dir] [--use_shell]
# | arg: -u, --username - Name of the system user that will be create
# | arg: -h, --home_dir - Path of the home dir for the user. Usually the final path of the app. If this argument is omitted, the user will be created without home
# | arg: -s, --use_shell - Create a user using the default login shell if present. If this argument is omitted, the user will be created with /usr/sbin/nologin shell
#
# Requires YunoHost version 2.6.4 or higher.
ynh_system_user_create () {
	# Declare an array to define the options of this helper.
	local legacy_args=uhs
	declare -Ar args_array=( [u]=username= [h]=home_dir= [s]=use_shell )
	local username
	local home_dir
	local use_shell
	# Manage arguments with getopts
	ynh_handle_getopts_args "$@"
 	use_shell="${use_shell:-0}"
 	home_dir="${home_dir:-}"

	if ! ynh_system_user_exists "$username"	# Check if the user exists on the system
	then	# If the user doesn't exist
		if [ -n "$home_dir" ]; then	# If a home dir is mentioned
			local user_home_dir="-d $home_dir"
		else
			local user_home_dir="--no-create-home"
		fi
		if [ $use_shell -eq 1 ]; then	# If we want a shell for the user
			local shell="" # Use default shell
		else
			local shell="--shell /usr/sbin/nologin"
		fi
		useradd $user_home_dir --system --user-group $username $shell || ynh_die "Unable to create $username system account"
	fi
}

# Delete a system user
#
# usage: ynh_system_user_delete --username=user_name
# | arg: -u, --username - Name of the system user that will be create
#
# Requires YunoHost version 2.6.4 or higher.
ynh_system_user_delete () {
    # Declare an array to define the options of this helper.
    local legacy_args=u
    declare -Ar args_array=( [u]=username= )
    local username
    # Manage arguments with getopts
    ynh_handle_getopts_args "$@"

    # Check if the user exists on the system
    if ynh_system_user_exists "$username"
    then
		deluser $username
	else
		ynh_print_warn --message="The user $username was not found"
    fi

    # Check if the group exists on the system
    if ynh_system_group_exists "$username"
    then
		delgroup $username
    fi
}