How can I skip the rest of a script without exiting the invoking shell, when sourcing the script?

Question

I have a bash script, where I call exit somewhere to skip the rest of the script when getopts doesn't recognize an option or doesn't find an expected option argument.

while getopts ":t:" opt; do
    case $opt in
        t)
            timelen="$OPTARG"
            ;;
        \?) printf "illegal option: -%s\n" "$OPTARG" >&2
            echo "$usage" >&2
            exit 1
            ;;
        :) printf "missing argument for -%s\n" "$OPTARG" >&2
           echo "$usage" >&2
           exit 1
           ;;
    esac
done

# reset of the script

I source the script in a bash shell. When something is wrong, the shell exits.

Is there some way other than exit to skip the rest of the script but without exiting the invoking shell?

Replacing exit with return doesn't work like for a function call, and the rest of the script will runs.

Thanks.

Answer 1

Use return.

The return bash builtin will exit the sourced script without stopping the calling (parent/sourcing) script.

From man bash:

return [n]
Causes a function to stop executing and return the value specified by n to its caller. If n is omitted, the return status is that of the last command executed in the function body. … If return is used outside a function, but during execution of a script by the . (source) command, it causes the shell to stop executing that script and return either n or the exit status of the last command executed within the script as the exit status of the script. …

Answer 2

You could simply wrap your script in a function and then use return the way you describe.

#!/bin/bash
main () {
    # Start of script
    if [ <condition> ]; then
        return
    fi
    # Rest of the script will not run if returned
}

main "$@"

Answer 3

return exits sourced scripts (and functions).

In your case:

while getopts ":t:" opt; do
    case $opt in
        t)
            timelen="$OPTARG"
            ;;
        \?) printf "illegal option: -%s\n" "$OPTARG" >&2
            echo "$usage" >&2
            return 1
            ;;
        :) printf "missing argument for -%s\n" "$OPTARG" >&2
           echo "$usage" >&2
           return 1
           ;;
    esac
done

Example test:

$ cat script1.sh
echo script1
source ./script2.sh
echo script1 ends

$ cat script2.sh
echo script2

while true; do
    return
done

echo script2 ends

$ bash script1.sh
script1
script2
script1 ends

Also sourcing script2.sh directly does the correct thing (without exiting from the current shell session):

$ source script2.sh
script2

Answer 4

In some cases I will want to allow exit except if I'm at the first shell, so I use this:

if [[ $SHLVL -gt 1 ]]; then exit 0; fi