JezK
Edit File: git-submodule
#!/usr/bin/sh # # git-submodule.sh: add, init, update or list git submodules # # Copyright (c) 2007 Lars Hjemli dashless=$(basename "$0" | sed -e 's/-/ /') USAGE="[--quiet] [--cached] or: $dashless [--quiet] add [-b <branch>] [-f|--force] [--name <name>] [--reference <repository>] [--] <repository> [<path>] or: $dashless [--quiet] status [--cached] [--recursive] [--] [<path>...] or: $dashless [--quiet] init [--] [<path>...] or: $dashless [--quiet] deinit [-f|--force] (--all| [--] <path>...) or: $dashless [--quiet] update [--init [--filter=<filter-spec>]] [--remote] [-N|--no-fetch] [-f|--force] [--checkout|--merge|--rebase] [--[no-]recommend-shallow] [--reference <repository>] [--recursive] [--[no-]single-branch] [--] [<path>...] or: $dashless [--quiet] set-branch (--default|--branch <branch>) [--] <path> or: $dashless [--quiet] set-url [--] <path> <newurl> or: $dashless [--quiet] summary [--cached|--files] [--summary-limit <n>] [commit] [--] [<path>...] or: $dashless [--quiet] foreach [--recursive] <command> or: $dashless [--quiet] sync [--recursive] [--] [<path>...] or: $dashless [--quiet] absorbgitdirs [--] [<path>...]" OPTIONS_SPEC= SUBDIRECTORY_OK=Yes . git-sh-setup require_work_tree wt_prefix=$(git rev-parse --show-prefix) cd_to_toplevel # Tell the rest of git that any URLs we get don't come # directly from the user, so it can apply policy as appropriate. GIT_PROTOCOL_FROM_USER=0 export GIT_PROTOCOL_FROM_USER command= quiet= branch= force= reference= cached= recursive= init= require_init= files= remote= no_fetch= rebase= merge= checkout= name= depth= progress= dissociate= single_branch= jobs= recommend_shallow= filter= all= default= summary_limit= for_status= # # Add a new submodule to the working tree, .gitmodules and the index # # $@ = repo path # # optional branch is stored in global branch variable # cmd_add() { # parse $args after "submodule ... add". while test $# -ne 0 do case "$1" in -b | --branch) case "$2" in '') usage ;; esac branch="--branch=$2" shift ;; -b* | --branch=*) branch="$1" ;; -f | --force) force=$1 ;; -q|--quiet) quiet=$1 ;; --progress) progress=$1 ;; --reference) case "$2" in '') usage ;; esac reference="--reference=$2" shift ;; --reference=*) reference="$1" ;; --ref-format) case "$2" in '') usage ;; esac ref_format="--ref-format=$2" shift ;; --ref-format=*) ref_format="$1" ;; --dissociate) dissociate=$1 ;; --name) case "$2" in '') usage ;; esac name="--name=$2" shift ;; --name=*) name="$1" ;; --depth) case "$2" in '') usage ;; esac depth="--depth=$2" shift ;; --depth=*) depth="$1" ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done if test -z "$1" then usage fi git ${wt_prefix:+-C "$wt_prefix"} submodule--helper add \ $quiet \ $force \ $progress \ ${branch:+"$branch"} \ ${reference:+"$reference"} \ ${ref_format:+"$ref_format"} \ $dissociate \ ${name:+"$name"} \ ${depth:+"$depth"} \ -- \ "$@" } # # Execute an arbitrary command sequence in each checked out # submodule # # $@ = command to execute # cmd_foreach() { # parse $args after "submodule ... foreach". while test $# -ne 0 do case "$1" in -q|--quiet) quiet=$1 ;; --recursive) recursive=$1 ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper foreach \ $quiet \ $recursive \ -- \ "$@" } # # Register submodules in .git/config # # $@ = requested paths (default to all) # cmd_init() { # parse $args after "submodule ... init". while test $# -ne 0 do case "$1" in -q|--quiet) quiet=$1 ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper init \ $quiet \ -- \ "$@" } # # Unregister submodules from .git/config and remove their work tree # cmd_deinit() { # parse $args after "submodule ... deinit". while test $# -ne 0 do case "$1" in -f|--force) force=$1 ;; -q|--quiet) quiet=$1 ;; --all) all=$1 ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper deinit \ $quiet \ $force \ $all \ -- \ "$@" } # # Update each submodule path to correct revision, using clone and checkout as needed # # $@ = requested paths (default to all) # cmd_update() { # parse $args after "submodule ... update". while test $# -ne 0 do case "$1" in -q|--quiet) quiet=$1 ;; -v|--verbose) quiet= ;; --progress) progress=$1 ;; -i|--init) init=$1 ;; --require-init) require_init=$1 ;; --remote) remote=$1 ;; -N|--no-fetch) no_fetch=$1 ;; -f|--force) force=$1 ;; -r|--rebase) rebase=$1 ;; --ref-format) case "$2" in '') usage ;; esac ref_format="--ref-format=$2" shift ;; --ref-format=*) ref_format="$1" ;; --reference) case "$2" in '') usage ;; esac reference="--reference=$2" shift ;; --reference=*) reference="$1" ;; --dissociate) dissociate=$1 ;; -m|--merge) merge=$1 ;; --recursive) recursive=$1 ;; --checkout) checkout=$1 ;; --recommend-shallow|--no-recommend-shallow) recommend_shallow=$1 ;; --depth) case "$2" in '') usage ;; esac depth="--depth=$2" shift ;; --depth=*) depth="$1" ;; -j|--jobs) case "$2" in '') usage ;; esac jobs="--jobs=$2" shift ;; -j*|--jobs=*) jobs="$1" ;; --single-branch|--no-single-branch) single_branch=$1 ;; --filter) case "$2" in '') usage ;; esac filter="--filter=$2" shift ;; --filter=*) filter="$1" ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper update \ $quiet \ $force \ $progress \ $remote \ $recursive \ $init \ $no_fetch \ $rebase \ $merge \ $checkout \ ${ref_format:+"$ref_format"} \ ${reference:+"$reference"} \ $dissociate \ ${depth:+"$depth"} \ $require_init \ $single_branch \ $recommend_shallow \ $jobs \ $filter \ -- \ "$@" } # # Configures a submodule's default branch # # $@ = requested path # cmd_set_branch() { # parse $args after "submodule ... set-branch". while test $# -ne 0 do case "$1" in -q|--quiet) # we don't do anything with this but we need to accept it ;; -d|--default) default=$1 ;; -b|--branch) case "$2" in '') usage ;; esac branch="--branch=$2" shift ;; -b*|--branch=*) branch="$1" ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper set-branch \ $quiet \ ${branch:+"$branch"} \ $default \ -- \ "$@" } # # Configures a submodule's remote url # # $@ = requested path, requested url # cmd_set_url() { # parse $args after "submodule ... set-url". while test $# -ne 0 do case "$1" in -q|--quiet) quiet=$1 ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper set-url \ $quiet \ -- \ "$@" } # # Show commit summary for submodules in index or working tree # # If '--cached' is given, show summary between index and given commit, # or between working tree and given commit # # $@ = [commit (default 'HEAD'),] requested paths (default all) # cmd_summary() { # parse $args after "submodule ... summary". while test $# -ne 0 do case "$1" in --cached) cached=$1 ;; --files) files=$1 ;; --for-status) for_status=$1 ;; -n|--summary-limit) case "$2" in '') usage ;; esac summary_limit="--summary-limit=$2" shift ;; -n*|--summary-limit=*) summary_limit="$1" ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper summary \ $files \ $cached \ $for_status \ ${summary_limit:+"$summary_limit"} \ -- \ "$@" } # # List all submodules, prefixed with: # - submodule not initialized # + different revision checked out # # If --cached was specified the revision in the index will be printed # instead of the currently checked out revision. # # $@ = requested paths (default to all) # cmd_status() { # parse $args after "submodule ... status". while test $# -ne 0 do case "$1" in -q|--quiet) quiet=$1 ;; --cached) cached=$1 ;; --recursive) recursive=$1 ;; --) shift break ;; -*) usage ;; *) break ;; esac shift done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper status \ $quiet \ $cached \ $recursive \ -- \ "$@" } # # Sync remote urls for submodules # This makes the value for remote.$remote.url match the value # specified in .gitmodules. # cmd_sync() { # parse $args after "submodule ... sync". while test $# -ne 0 do case "$1" in -q|--quiet) quiet=$1 shift ;; --recursive) recursive=$1 shift ;; --) shift break ;; -*) usage ;; *) break ;; esac done git ${wt_prefix:+-C "$wt_prefix"} submodule--helper sync \ $quiet \ $recursive \ -- \ "$@" } cmd_absorbgitdirs() { git ${wt_prefix:+-C "$wt_prefix"} submodule--helper absorbgitdirs "$@" } # This loop parses the command line arguments to find the # subcommand name to dispatch. Parsing of the subcommand specific # options are primarily done by the subcommand implementations. # Subcommand specific options such as --branch and --cached are # parsed here as well, for backward compatibility. while test $# != 0 && test -z "$command" do case "$1" in add | foreach | init | deinit | update | set-branch | set-url | status | summary | sync | absorbgitdirs) command=$1 ;; -q|--quiet) quiet=$1 ;; --cached) cached=$1 ;; --) break ;; -*) usage ;; *) break ;; esac shift done # No command word defaults to "status" if test -z "$command" then if test $# = 0 then command=status else usage fi fi # "--cached" is accepted only by "status" and "summary" if test -n "$cached" && test "$command" != status && test "$command" != summary then usage fi "cmd_$(echo $command | sed -e s/-/_/g)" "$@"