From 370ef5a7e804471e265f2289f2885b855a1c8a59 Mon Sep 17 00:00:00 2001 From: Ryan Kavanagh Date: Sat, 26 Sep 2020 18:04:59 -0400 Subject: git-subrepo --- .local/lib/git-core/git-subrepo | 1897 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 1897 insertions(+) create mode 100755 .local/lib/git-core/git-subrepo (limited to '.local/lib/git-core') diff --git a/.local/lib/git-core/git-subrepo b/.local/lib/git-core/git-subrepo new file mode 100755 index 0000000..3865570 --- /dev/null +++ b/.local/lib/git-core/git-subrepo @@ -0,0 +1,1897 @@ +#!/usr/bin/env bash +# +# +# Copyright 2013-2020 - Ingy döt Net +# + + +# Exit on any errors: +set -e + +# Import Bash+ helper functions: +SOURCE="$BASH_SOURCE" +while [[ -h $SOURCE ]]; do + DIR="$( cd -P "$( dirname "$SOURCE" )" && pwd )" + SOURCE="$(readlink "$SOURCE")" + [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE" +done +SOURCE_DIR="$(dirname "$SOURCE")" + +if [[ -z "$GIT_SUBREPO_ROOT" ]]; then + # If `make install` installation used: + source "${SOURCE_DIR}/git-subrepo.d/bash+.bash" +else + # If `source .rc` method used: + source "${SOURCE_DIR}/../ext/bashplus/lib/bash+.bash" +fi +bash+:import :std can + +VERSION=0.4.1 +REQUIRED_GIT_VERSION=2.7.0 +GIT_TMP="$(git rev-parse --git-common-dir 2> /dev/null || echo .git)/tmp" + +# `git rev-parse` turns this into a getopt parser and a command usage message: +GETOPT_SPEC="\ +git subrepo + +Commands: + clone Clone a remote repository into a local subdirectory + init Turn a current subdirectory into a subrepo + pull Pull upstream changes to the subrepo + push Push local subrepo changes upstream + + fetch Fetch a subrepo's remote branch (and create a ref for it) + branch Create a branch containing the local subrepo commits + commit Commit a merged subrepo branch into the mainline + + status Get status of a subrepo (or all of them) + clean Remove branches, remotes and refs for a subrepo + config Set subrepo configuration properties + + help Documentation for git-subrepo (or specific command) + version Display git-subrepo version info + upgrade Upgrade the git-subrepo software itself + +See 'git help subrepo' for complete documentation and usage of each command. + +Options: +-- +h Show the command summary +help Help overview +version Print the git-subrepo version number + +a,all Perform command on all current subrepos +A,ALL Perform command on all subrepos and subsubrepos +b,branch= Specify the upstream branch to push/pull/fetch +e,edit Edit commit message +f,force Force certain operations +F,fetch Fetch the upstream content first +M,method= Method when you join, valid options are 'merge' or 'rebase' + Default is 'merge' +m,message= Specify a commit message +r,remote= Specify the upstream remote to push/pull/fetch +s,squash Squash commits on push +u,update Add the --branch and/or --remote overrides to .gitrepo + +q,quiet Show minimal output +v,verbose Show verbose output +d,debug Show the actual commands used +x,DEBUG Turn on -x Bash debugging +" + +#------------------------------------------------------------------------------ +# Top level function: +#------------------------------------------------------------------------------ +main() { + # Define global variables: + local command= # Subrepo subcommand to run + local command_arguments=() # Command args after getopt parsing + local commit_msg_args=() # Arguments to show in the commit msg + local subrepos=() # List of multiple subrepos + + local all_wanted=false # Apply command to all subrepos + local ALL_wanted=false # Apply command to all subrepos and subsubrepos + local force_wanted=false # Force certain operations + local fetch_wanted=false # Fetch requested before a command + local squash_wanted=false # Squash commits on push + local update_wanted=false # Update .gitrepo with --branch and/or --remote + + local quiet_wanted=false # Output should be quiet + local verbose_wanted=false # Output should be verbose + local debug_wanted=false # Show debug messages + + local subdir= # Subdirectory of the subrepo being used + local subref= # Valid git ref format of subdir + local gitrepo= # Path to .gitrepo file + local worktree= # Worktree created by 'git worktree' + local start_pwd=$(pwd) # Store the original directory + + local original_head_commit= # HEAD commit id at start of command + local original_head_branch= # HEAD ref at start of command + local upstream_head_commit= # HEAD commit id from a subrepo fetch + + local subrepo_remote= # Remote url for subrepo's upstream repo + local subrepo_branch= # Upstream branch to clone/push/pull + local subrepo_commit= # Upstream HEAD from previous clone/pull + local subrepo_parent= # Local commit from before previous clone/pull + local subrepo_former= # A retired gitrepo key that might still exist + + local refs_subrepo_branch= # A subrepo ref -> commit of branch/pull command + local refs_subrepo_commit= # A subrepo ref -> commit last merged + local refs_subrepo_fetch= # A subrepo ref -> FETCH_HEAD after fetch + local refs_subrepo_push= # A subrepo ref -> branch after push + + local override_remote= # Remote specified with -r + local override_branch= # Remote specified with -b + + local edit_wanted=false # Edit commit message using -e + local wanted_commit_message= # Custom commit message using -m + + local join_method= # Current join method (rebase/merge) + + local FAIL=true # Flag for RUN: fail on error + local OUT=false # Flag for RUN: put output in $output + local TTY=false # Flag for RUN: print output directly + local SAY=true # Flag for RUN: print command for verbose + local EXEC=false # Flag for RUN: run subprocess + local OK=true # Flag that commands have succeeded + local CODE=0 # Failure reason code + local INDENT= # Verbose indentation + + local git_version= # Git version in use + + # Check environment and parse CLI options: + assert-environment-ok + + # Parse and validate command options: + get-command-options "$@" + + # Make sure repo is in the proper state: + assert-repo-is-ready + + command-init + + if $all_wanted && [[ ! $command =~ ^(help|status)$ ]]; then + # Run the command on all subrepos + local args=( "${command_arguments[@]}" ) + get-all-subrepos + for subdir in ${subrepos[*]}; do + command-prepare + subrepo_remote= + subrepo_branch= + command_arguments=( "$subdir" "${args[@]}" ) + "command:$command" + done + else + # Run the command on a specific subrepo + command-prepare + "command:$command" + fi +} + +#------------------------------------------------------------------------------ +# API command functions. +# +# Most of these commands call a subrepo:$command function to do the actual +# work. The user facing output (via `say`) is done up here. The +# subrepo:* worker functions are meant to be called internally and don't print +# info to the user. +#------------------------------------------------------------------------------ + +# `git subrepo clone []` command: +command:clone() { + command-setup +subrepo_remote subdir:guess-subdir + + # Clone (or reclone) the subrepo into the subdir: + local reclone_up_to_date=false + subrepo:clone + if "$reclone_up_to_date"; then + say "Subrepo '$subdir' is up to date." + return + fi + + # Successful command output: + local re= + $force_wanted && re=re + local remote="$subrepo_remote" + say "Subrepo '$remote' ($subrepo_branch) ${re}cloned into '$subdir'." +} + +# `git subrepo init ` command: +command:init() { + command-setup +subdir + local remote="${subrepo_remote:=none}" + local branch="${subrepo_branch:=master}" + + # Init new subrepo from the subdir: + subrepo:init + if OK; then + if [[ $remote == none ]]; then + say "Subrepo created from '$subdir' (with no remote)." + else + say "Subrepo created from '$subdir' with remote '$remote' ($branch)." + fi + else + die "Unknown init error code: '$CODE'" + fi + return 0 +} + +# `git subrepo pull ` command: +command:pull() { + command-setup +subdir + + subrepo:pull + if OK; then + say "Subrepo '$subdir' pulled from '$subrepo_remote' ($subrepo_branch)." + elif [[ $CODE -eq -1 ]]; then + say "Subrepo '$subdir' is up to date." + elif [[ $CODE -eq 1 ]]; then + error-join + return "$CODE" + else + die "Unknown pull error code: '$CODE'" + fi + return 0 +} + +# `git subrepo push ` command: +command:push() { + local branch= + command-setup +subdir branch + + subrepo:push + if OK; then + say "Subrepo '$subdir' pushed to '$subrepo_remote' ($subrepo_branch)." + elif [[ $CODE -eq -2 ]]; then + say "Subrepo '$subdir' has no new commits to push." + elif [[ $CODE -eq 1 ]]; then + error-join + return "$CODE" + else + die "Unknown push error code: '$CODE'" + fi + return 0 +} + +# `git subrepo fetch ` command +command:fetch() { + command-setup +subdir + if [[ $subrepo_remote == "none" ]]; then + say "Ignored '$subdir', no remote." + else + subrepo:fetch + say "Fetched '$subdir' from '$subrepo_remote' ($subrepo_branch)." + fi +} + +# `git subrepo branch ` command: +command:branch() { + command-setup +subdir + if $fetch_wanted; then + CALL subrepo:fetch + fi + + local branch="subrepo/$subref" + if $force_wanted; then + # We must make sure that the worktree is removed as well + worktree="$GIT_TMP/$branch" + git:delete-branch "$branch" + fi + + if git:branch-exists "$branch"; then + error "Branch '$branch' already exists. Use '--force' to override." + fi + + # Create the subrepo branch: + subrepo:branch + + say "Created branch '$branch' and worktree '$worktree'." +} + +# `git subrepo commit ` command +command:commit() { + command-setup +subdir subrepo_commit_ref + + if "$fetch_wanted"; then + CALL subrepo:fetch + fi + git:rev-exists "$refs_subrepo_fetch" || + error "Can't find ref '$refs_subrepo_fetch'. Try using -F." + upstream_head_commit="$(git rev-parse "$refs_subrepo_fetch")" + + [[ -n $subrepo_commit_ref ]] || + subrepo_commit_ref="subrepo/$subref" + subrepo:commit + + say "Subrepo commit '$subrepo_commit_ref' committed as" + say "subdir '$subdir/' to branch '$original_head_branch'." +} + +# `git subrepo status []` command: +command:status() { + subrepo:status | ${GIT_SUBREPO_PAGER} +} + +status-refs() { + local output= + while read line; do + [[ $line =~ ^([0-9a-f]+)\ refs/subrepo/$subref/([a-z]+) ]] || continue + local sha1=; sha1="$(git rev-parse --short "${BASH_REMATCH[1]}")" + local type="${BASH_REMATCH[2]}" + local ref="refs/subrepo/$subref/$type" + if [[ $type == branch ]]; then + output+=" Branch Ref: $sha1 ($ref)"$'\n' + elif [[ $type == commit ]]; then + output+=" Commit Ref: $sha1 ($ref)"$'\n' + elif [[ $type == fetch ]]; then + output+=" Fetch Ref: $sha1 ($ref)"$'\n' + elif [[ $type == pull ]]; then + output+=" Pull Ref: $sha1 ($ref)"$'\n' + elif [[ $type == push ]]; then + output+=" Push Ref: $sha1 ($ref)"$'\n' + fi + done < <(git show-ref) + if [[ -n $output ]]; then + printf " Refs:\n$output" + fi +} + +# `git subrepo clean ` command +command:clean() { + command-setup +subdir + local clean_list=() + subrepo:clean + for item in "${clean_list[@]}"; do + say "Removed $item." + done +} + +# Wrap git config $gitrepo +command:config() { + command-setup +subdir +config_option config_value + o "Update '$subdir' configuration with $config_option=$config_value" + + if [[ ! $config_option =~ ^(branch|cmdver|commit|method|remote|version)$ ]]; then + error "Option $config_option not recognized" + fi + + if [[ -z $config_value ]]; then + OUT=true RUN git config --file="$gitrepo" "subrepo.$config_option" + say "Subrepo '$subdir' option '$config_option' has value '$output'." + return + fi + + if ! $force_wanted; then + # Only allow changing method without force + if [[ ! $config_option == "method" ]]; then + error "This option is autogenerated, use '--force' to override." + fi + fi + + if [[ $config_option == "method" ]]; then + if [[ ! $config_value =~ ^(merge|rebase)$ ]]; then + error "Not a valid method. Valid options are 'merge' or 'rebase'." + fi + fi + + RUN git config --file="$gitrepo" "subrepo.$config_option" "$config_value" + say "Subrepo '$subdir' option '$config_option' set to '$config_value'." +} + + +# Launch the manpage viewer: +command:help() { + source "${SOURCE_DIR}/git-subrepo.d/help-functions.bash" + local cmd="${command_arguments[0]}" + if [[ -n $cmd ]]; then + if can "help:$cmd"; then + "help:$cmd" + echo + else + err "No help found for '$cmd'" + fi + elif $all_wanted; then + help:all + else + exec git help subrepo + fi + msg_ok=0 +} + +# Print version info. +# TODO: Add short commit id after version. +# Will need to get it from repo or make install can put it somewhere. +command:version() { + cat <<... +git-subrepo Version: $VERSION +Copyright 2013-2020 Ingy döt Net +https://github.com/ingydotnet/git-subrepo +$BASH_SOURCE +Git Version: $git_version + +... + : +} + +command:upgrade() { + local path="$0" + if [[ $path =~ ^/ && $path =~ ^(.*/git-subrepo)/lib/git-subrepo$ ]]; then + local subrepo_root="${BASH_REMATCH[1]}" + ( + o "Change directory to '$subrepo_root'." + cd "${BASH_REMATCH[1]}" + + local branch="$(git rev-parse --abbrev-ref HEAD)" + if [[ $branch != master ]]; then + error "git-subrepo repo is not on the 'master' branch" + fi + + o "'git pull' latest version." + RUN git pull --ff-only + + say "git-subrepo is up to date." + ) + else + die "\ + +Sorry. Your installation can't use the 'git subrepo upgrade' command. The +command only works if you installed git subrepo by adding +'/path/to/git-subrepo' to your PATH. + +If you used 'make install' to install git-subrepo, then just do this: + + cd /path/to/git-subrepo + git pull + make install + +" + fi +} + +#------------------------------------------------------------------------------ +# Subrepo command worker functions. +#------------------------------------------------------------------------------ + +# Clone by fetching remote content into our subdir: +subrepo:clone() { + re="$1" + + FAIL=false RUN git rev-parse HEAD + if ! OK; then + error "You can't clone into an empty repository" + fi + + # Turn off force unless really a reclone: + if $force_wanted && [[ ! -f $gitrepo ]]; then + force_wanted=false + fi + + if $force_wanted; then + o "--force indicates a reclone." + CALL subrepo:fetch + read-gitrepo-file + o "Check if we already are up to date." + if [[ $upstream_head_commit == $subrepo_commit ]]; then + reclone_up_to_date=true + return + fi + o "Remove the old subdir." + RUN git rm -r -- "$subdir" + else + assert-subdir-empty + if [[ -z $subrepo_branch ]]; then + o "Determine the upstream head branch." + get-upstream-head-branch + subrepo_branch="$output" + fi + + CALL subrepo:fetch + fi + + o "Make the directory '$subdir/' for the clone." + RUN mkdir -p -- "$subdir" + + o "Commit the new '$subdir/' content." + subrepo_commit_ref="$upstream_head_commit" + CALL subrepo:commit +} + +# Init a new subrepo from current repo: +subrepo:init() { + local branch_name="subrepo/${subref:??}" + # Check if subdir is proper candidate for this init: + assert-subdir-ready-for-init + + o "Put info into '$subdir/.gitrepo' file." + update-gitrepo-file + + o "Add the new '$subdir/.gitrepo' file." + # -f from pull request #219. TODO needs test. + RUN git add -f -- "$gitrepo" + + o "Commit new subrepo to the '$original_head_branch' branch." + subrepo_commit_ref="$original_head_commit" + RUN git commit -m "$(get-commit-message)" + + o "Create ref '$refs_subrepo_commit'." + git:make-ref "$refs_subrepo_commit" "$subrepo_commit_ref" +} + +# Properly merge a local subrepo branch with upstream and commit to mainline: +subrepo:pull() { + CALL subrepo:fetch + + # Check if we already are up to date + # If the -u flag is present, always perform the operation + if [[ $upstream_head_commit == $subrepo_commit ]] && ! $update_wanted; then + OK=false; CODE=-1; return + fi + + local branch_name="subrepo/$subref" + git:delete-branch "$branch_name" + + subrepo_commit_ref="$branch_name" + + o "Create subrepo branch '$branch_name'." + CALL subrepo:branch + cd "$worktree"; + + if [[ "$join_method" == "rebase" ]]; then + o "Rebase changes to $refs_subrepo_fetch" + FAIL=false OUT=true RUN git rebase "$refs_subrepo_fetch" "$branch_name" + if ! OK; then + say "The \"git rebase\" command failed:" + say + say " ${output//$'\n'/$'\n' }" + CODE=1 + return + fi + else + o "Merge in changes from $refs_subrepo_fetch" + FAIL=false OUT=true RUN git merge "$refs_subrepo_fetch" + if ! OK; then + say "The \"git merge\" command failed:" + say + say " ${output//$'\n'/$'\n' }" + CODE=1 + return + fi + fi + + o "Back to $start_pwd" + cd "$start_pwd"; + + o "Create ref '$refs_subrepo_branch' for branch '$branch_name'." + git:make-ref "$refs_subrepo_branch" "$branch_name" + + o "Commit the new '$subrepo_commit_ref' content." + CALL subrepo:commit +} + +# Push a properly merged subrepo branch upstream: +subrepo:push() { + local branch_name="$branch" + local new_upstream=false + local branch_created=false + + if [[ -z $branch_name ]]; then + FAIL=false OUT=false CALL subrepo:fetch + + if ! OK; then + # Check if we are pushing to a new upstream repo (or branch) and just + # push the commit directly. This is common after a `git subrepo init`: + # Force to case in + local re="(^|"$'\n'")fatal: couldn't find remote ref " + if [[ ${output,,} =~ $re ]]; then + o "Pushing to new upstream: $subrepo_remote ($subrepo_branch)." + new_upstream=true + else + error "Fetch for push failed: $output" + fi + else + # Check that we are up to date: + o "Check upstream head against .gitrepo commit." + if ! $force_wanted; then + if [[ $upstream_head_commit != $subrepo_commit ]]; then + error "There are new changes upstream, you need to pull first." + fi + fi + fi + + branch_name="subrepo/$subref" + git:delete-branch "$branch_name" + + if $squash_wanted; then + o "Squash commits" + subrepo_parent="HEAD^" + fi + + o "Create subrepo branch '$branch_name'." + CALL subrepo:branch "$branch_name" + cd "$worktree"; + + if [[ "$join_method" == "rebase" ]]; then + o "Rebase changes to $refs_subrepo_fetch" + FAIL=false OUT=true RUN git rebase "$refs_subrepo_fetch" "$branch_name" + if ! OK; then + say "The \"git rebase\" command failed:" + say + say " ${output//$'\n'/$'\n' }" + CODE=1 + return + fi + fi + branch_created=true + cd "$start_pwd" + else + if $squash_wanted; then + error "Squash option (-s) can't be used with branch parameter" + fi + fi + + o "Make sure that '$branch_name' exists." + git:branch-exists "$branch_name" || + error "No subrepo branch '$branch_name' to push." + + o "Check if we have something to push" + new_upstream_head_commit="$(git rev-parse "$branch_name")" + if ! $new_upstream; then + if [[ $upstream_head_commit == $new_upstream_head_commit ]]; then + OK=false + CODE=-2 + return + fi + fi + + if ! $force_wanted; then + o "Make sure '$branch_name' contains the '$refs_subrepo_fetch' HEAD." + if ! git:commit-in-rev-list "$upstream_head_commit" "$branch_name"; then + error "Can't commit: '$branch_name' doesn't contain upstream HEAD: " \ + "$upstream_head_commit" + fi + fi + + local force='' + "$force_wanted" && force=' --force' + + o "Push$force branch '$branch_name' to '$subrepo_remote' ($subrepo_branch)." + RUN git push$force "$subrepo_remote" "$branch_name":"$subrepo_branch" + + o "Create ref '$refs_subrepo_push' for branch '$branch_name'." + git:make-ref "$refs_subrepo_push" "$branch_name" + + if $branch_created; then + o "Remove branch '$branch_name'." + git:delete-branch "$branch_name" + fi + + o "Put updates into '$subdir/.gitrepo' file." + upstream_head_commit="$new_upstream_head_commit" + subrepo_commit_ref="$upstream_head_commit" + update-gitrepo-file + RUN git commit -m "$(get-commit-message)" +} + +# Fetch the subrepo's remote branch content: +subrepo:fetch() { + if [[ $subrepo_remote == none ]]; then + error "Can't fetch subrepo. Remote is 'none' in '$subdir/.gitrepo'." + fi + + o "Fetch the upstream: $subrepo_remote ($subrepo_branch)." + RUN git fetch --no-tags --quiet "$subrepo_remote" "$subrepo_branch" + OK || return + + o "Get the upstream subrepo HEAD commit." + OUT=true RUN git rev-parse FETCH_HEAD^0 + upstream_head_commit="$output" + + o "Create ref '$refs_subrepo_fetch'." + git:make-ref "$refs_subrepo_fetch" FETCH_HEAD^0 +} + +# Create a subrepo branch containing all changes +subrepo:branch() { + local branch="${1:-"subrepo/$subref"}" + o "Check if the '$branch' branch already exists." + git:branch-exists "$branch" && return + + local last_gitrepo_commit= + local first_gitrepo_commit= + + o "Subrepo parent: $subrepo_parent" + if [[ -n "$subrepo_parent" ]]; then + local prev_commit= + local ancestor= + o "Create new commits with parents into the subrepo fetch" + OUT=true RUN git rev-list --reverse --ancestry-path --topo-order "$subrepo_parent..HEAD" + local commit_list="$output" + for commit in $commit_list; do + o "Working on $commit" + + FAIL=false OUT=true RUN git config --blob \ + "$commit":"$subdir/.gitrepo" "subrepo.commit" + if [[ -z "$output" ]]; then + o "Ignore commit, no .gitrepo file" + continue + fi + + local gitrepo_commit="$output" + o ".gitrepo reference commit: $gitrepo_commit" + + + # Only include the commit if it's a child of the previous commit + # This way we create a single path between $subrepo_parent..HEAD + if [[ -n "$ancestor" ]]; then + local is_direct_child=$(git show -s --pretty=format:"%P" $commit | grep "$ancestor") + o "is child: $is_direct_child" + if [[ -z "$is_direct_child" ]]; then + o "Ignore $commit, it's not in the selected path" + continue + fi + fi + + # Remember the previous commit from the parent repo path + ancestor="$commit" + + o "Check for rebase" + if git:rev-exists "$refs_subrepo_fetch"; then + if ! git:commit-in-rev-list "$gitrepo_commit" "$refs_subrepo_fetch"; then + error "Local repository does not contain $gitrepo_commit. Try to 'git subrepo fetch $subref' or add the '-F' flag to always fetch the latest content." + fi + fi + + o "Find parents" + local first_parent= + [[ -n $prev_commit ]] && first_parent="-p $prev_commit" + local second_parent= + if [[ -z "$first_gitrepo_commit" ]]; then + first_gitrepo_commit="$gitrepo_commit" + second_parent="-p $gitrepo_commit" + fi + + if [[ "$join_method" != "rebase" ]]; then + # In the rebase case we don't create merge commits + if [[ "$gitrepo_commit" != "$last_gitrepo_commit" ]]; then + second_parent="-p $gitrepo_commit" + last_gitrepo_commit="$gitrepo_commit" + fi + fi + + o "Create a new commit $first_parent $second_parent" + FAIL=false RUN git cat-file -e "$commit":"$subdir" + if OK; then + o "Create with content" + local PREVIOUS_IFS=$IFS + IFS=$'\n' + local author_info=( $(git log -1 --format=%ad%n%ae%n%an "$commit") ) + IFS=$PREVIOUS_IFS + + # When we create new commits we leave the author information unchanged + # the committer will though be updated to the current user + # This should be analog how cherrypicking is handled allowing git + # to store both the original author but also the responsible committer + # that created the local version of the commit and pushed it. + prev_commit=$(git log -n 1 --format=%B "$commit" | + GIT_AUTHOR_DATE="${author_info[0]}" \ + GIT_AUTHOR_EMAIL="${author_info[1]}" \ + GIT_AUTHOR_NAME="${author_info[2]}" \ + git commit-tree -F - $first_parent $second_parent "$commit":"$subdir") + else + o "Create empty placeholder" + prev_commit=$(git commit-tree -m "EMPTY" \ + $first_parent $second_parent "4b825dc642cb6eb9a060e54bf8d69288fbee4904") + fi + done + + o "Create branch '$branch' for this new commit set $prev_commit." + RUN git branch "$branch" "$prev_commit" + else + o "No parent setting, use the subdir content." + RUN git branch "$branch" HEAD + TTY=true FAIL=false RUN git filter-branch -f --subdirectory-filter \ + "$subref" "$branch" + fi + + o "Remove the .gitrepo file from $first_gitrepo_commit..$branch" + local filter="$branch" + [[ -n "$first_gitrepo_commit" ]] && filter="$first_gitrepo_commit..$branch" + FAIL=false RUN git filter-branch -f --prune-empty --tree-filter \ + "rm -f .gitrepo" "$filter" + + git:create-worktree "$branch" + + o "Create ref '$refs_subrepo_branch'." + git:make-ref "$refs_subrepo_branch" "$branch" +} + +# Commit a merged subrepo branch: +subrepo:commit() { + o "Check that '$subrepo_commit_ref' exists." + git:rev-exists "$subrepo_commit_ref" || + error "Commit ref '$subrepo_commit_ref' does not exist." + + if ! "$force_wanted"; then + local upstream="$upstream_head_commit" + o "Make sure '$subrepo_commit_ref' contains the upstream HEAD." + if ! git:commit-in-rev-list "$upstream" "$subrepo_commit_ref"; then + error \ + "Can't commit: '$subrepo_commit_ref' doesn't contain upstream HEAD." + fi + fi + + if git ls-files -- "$subdir" | grep -q .; then + o "Remove old content of the subdir." + RUN git rm -r -- "$subdir" + fi + + o "Put remote subrepo content into '$subdir/'." + RUN git read-tree --prefix="$subdir" -u "$subrepo_commit_ref" + + o "Put info into '$subdir/.gitrepo' file." + update-gitrepo-file + RUN git add -f -- "$gitrepo" + + local commit_message + if [[ -n "$wanted_commit_message" ]]; then + commit_message="$wanted_commit_message" + else + commit_message="$(get-commit-message)" + fi + + local edit_flag= + $edit_wanted && edit_flag=--edit + + [[ -n $commit_message ]] || commit_message="$(get-commit-message)" + + local edit_flag= + $edit_wanted && edit_flag=--edit + + o "Commit to the '$original_head_branch' branch." + if [[ $original_head_commit != none ]]; then + RUN git commit $edit_flag -m "$commit_message" + else + # We had cloned into an empty repo, side effect of prior git reset --mixed + # command is that subrepo's history is now part of the index. Commit + # without that history. + OUT=true RUN git write-tree + OUT=true RUN git commit-tree $edit_flag -m "$commit_message" "$output" + RUN git reset --hard "$output" + fi + + # Clean up worktree to indicate that we are ready + git:remove-worktree + + o "Create ref '$refs_subrepo_commit'." + git:make-ref "$refs_subrepo_commit" "$subrepo_commit_ref" +} + +subrepo:status() { + if [[ ${#command_arguments[@]} -eq 0 ]]; then + get-all-subrepos + local count=${#subrepos[@]} + if ! "$quiet_wanted"; then + if [[ $count -eq 0 ]]; then + echo "No subrepos." + return + else + local s=; [[ $count -eq 1 ]] || s=s + echo "$count subrepo$s:" + echo + fi + fi + else + subrepos=("${command_arguments[@]}") + fi + + for subdir in "${subrepos[@]}"; do + check-and-normalize-subdir + encode-subdir + + if [[ ! -f $subdir/.gitrepo ]]; then + echo "'$subdir' is not a subrepo" + echo + continue + fi + + refs_subrepo_fetch="refs/subrepo/$subref/fetch" + upstream_head_commit="$( + git rev-parse --short "$refs_subrepo_fetch" 2> /dev/null || true + )" + subrepo_remote= + subrepo_branch= + + read-gitrepo-file + if $fetch_wanted; then + subrepo:fetch + fi + + if $quiet_wanted; then + echo "$subdir" + continue + fi + + echo "Git subrepo '$subdir':" + git:branch-exists "subrepo/$subref" && + echo " Subrepo Branch: subrepo/$subref" + local remote="subrepo/$subref" + FAIL=false OUT=true RUN git config "remote.$remote.url" + [[ -n $output ]] && + echo " Remote Name: subrepo/$subref" + echo " Remote URL: $subrepo_remote" + [[ -n $upstream_head_commit ]] && + echo " Upstream Ref: $upstream_head_commit" + echo " Tracking Branch: $subrepo_branch" + [[ -z $subrepo_commit ]] || + echo " Pulled Commit: $(git rev-parse --short $subrepo_commit)" + if [[ -n $subrepo_parent ]]; then + echo " Pull Parent: $(git rev-parse --short $subrepo_parent)" + # TODO Remove this eventually: + elif [[ -n $subrepo_former ]]; then + printf " Former Commit: $(git rev-parse --short $subrepo_former)" + echo " *** DEPRECATED ***" + fi + + # Grep for directory, branch can be in detached state due to conflicts + local _worktree=$(git worktree list | grep "$GIT_TMP/subrepo/$subdir") + if [[ -n $_worktree ]]; then + echo " Worktree: $_worktree" + fi + + if "$verbose_wanted"; then + status-refs + fi + + echo + done +} + +subrepo:clean() { + # Remove subrepo branches if exist: + local branch="subrepo/$subref" + local ref="refs/heads/$branch" + local worktree="$GIT_TMP/$branch" + + o "Clean $subdir" + git:remove-worktree + if [[ -e .git/$ref ]]; then + o "Remove branch '$branch'." + RUN git update-ref -d "$ref" + clean_list+=("branch '$branch'") + fi + + if "$force_wanted"; then + o "Remove all subrepo refs." + local suffix="" + if ! $all_wanted; then + suffix="$subref/" + fi + git show-ref | while read hash ref; do + if [[ "$ref" == refs/subrepo/$suffix* ]]; then + git update-ref -d "$ref" + fi + done + fi +} + +#------------------------------------------------------------------------------ +# Support functions: +#------------------------------------------------------------------------------ + + +# TODO: +# Collect original options and arguments into an array for commit message +# They should be normalized and pruned + +# Parse command line options: +get-command-options() { + [[ $# -eq 0 ]] && set -- --help + + [[ -n $GIT_SUBREPO_QUIET ]] && quiet_wanted=true + [[ -n $GIT_SUBREPO_VERBOSE ]] && verbose_wanted=true + [[ -n $GIT_SUBREPO_DEBUG ]] && debug_wanted=true + + eval "$( + echo "$GETOPT_SPEC" | + git rev-parse --parseopt -- "$@" || + echo exit $? + )" + + while [[ $# -gt 0 ]]; do + local option="$1"; shift + case "$option" in + --) break ;; + -a) all_wanted=true ;; + -A) ALL_wanted=true + all_wanted=true ;; + -b) subrepo_branch="$1" + override_branch="$1" + commit_msg_args+=("--branch=$1") + shift ;; + -e) edit_wanted=true ;; + -f) force_wanted=true + commit_msg_args+=("--force") ;; + -F) fetch_wanted=true ;; + -m) wanted_commit_message="$1" + shift;; + -M) join_method="$1" + shift;; + -M) join_method="$1" + shift;; + -r) subrepo_remote="$1" + override_remote="$1" + commit_msg_args+=("--remote=$1") + shift ;; + -s) squash_wanted=true ;; + -u) update_wanted=true + commit_msg_args+=("--update") ;; + -q) quiet_wanted=true ;; + -v) verbose_wanted=true ;; + -d) debug_wanted=true ;; + -x) set -x ;; + --version) + echo "$VERSION" + exit ;; + *) usage-error "Unexpected option: '$option'." ;; + esac + done + + # Set subrepo command: + command="$1"; shift + + # Make sure command exists: + can "command:$command" || + usage-error "'$command' is not a command. See 'git subrepo help'." + + command_arguments=("$@") + if [[ ${#command_arguments} -gt 0 ]]; then + local first="${command_arguments[0]}" + first="${first%/}" + command_arguments[0]="$first" + fi + commit_msg_args+=("${command_arguments[@]}") + + for option in all ALL edit fetch force squash; do + var="${option}_wanted" + if ${!var}; then + check_option $option + fi + done + + if [[ -n $override_branch ]]; then + check_option branch + fi + if [[ -n $override_remote ]]; then + check_option remote + fi + if [[ -n $wanted_commit_message ]]; then + check_option message + fi + if $update_wanted; then + check_option update + if [[ -z $subrepo_branch && -z $subrepo_remote ]]; then + usage-error "Can't use '--update' without '--branch' or '--remote'." + fi + fi +} + +options_help='all' +options_branch='all fetch force' +options_clean='ALL all force' +options_clone='branch edit force message method' +options_config='force' +options_commit='edit fetch force message' +options_fetch='all branch remote' +options_init='branch remote method' +options_pull='all branch edit force message remote update' +options_push='all branch force remote squash update' +options_status='ALL all fetch' +check_option() { + local var="options_${command//-/_}" + [[ ${!var} =~ $1 ]] || + usage-error "Invalid option '--$1' for '$command'." +} + +#------------------------------------------------------------------------------ +# Command argument validation: +#------------------------------------------------------------------------------ + +command-init() { + # Export variable to let other processes (possibly git hooks) know that they + # are running under git-subrepo. Set to current process pid, so it can be + # further verified if need be: + export GIT_SUBREPO_RUNNING="$$" + export GIT_SUBREPO_COMMAND="$command" + + : "${GIT_SUBREPO_PAGER:=${PAGER:-less}}" + if [[ $GIT_SUBREPO_PAGER == less ]]; then + GIT_SUBREPO_PAGER='less -FRX' + fi +} + +command-prepare() { + local output= + if git:rev-exists HEAD; then + git:get-head-branch-commit + fi + original_head_commit="${output:-none}" +} + +# Do the setup steps needed by most of the subrepo subcommands: +command-setup() { + get-params "$@" + + check-and-normalize-subdir + encode-subdir + gitrepo="$subdir/.gitrepo" + + if ! $force_wanted; then + o "Check for worktree with branch subrepo/$subdir" + local _worktree=$(git worktree list | grep "\[subrepo/$subdir\]" | cut -d ' ' -f1) + if [[ $command =~ ^(commit)$ && -z $_worktree ]]; then + error "There is no worktree available, use the branch command first" + elif [[ ! $command =~ ^(branch|clean|commit|push)$ && -n $_worktree ]]; then + if [[ -e $gitrepo ]]; then + error "There is already a worktree with branch subrepo/$subdir. +Use the --force flag to override this check or perform a subrepo clean +to remove the worktree." + else + error "There is already a worktree with branch subrepo/$subdir. +Use the --force flag to override this check or remove the worktree with +1. rm -rf $_worktree +2. git worktree prune +" + fi + fi + fi + + # Set refs_ variables: + refs_subrepo_branch="refs/subrepo/$subref/branch" + refs_subrepo_commit="refs/subrepo/$subref/commit" + refs_subrepo_fetch="refs/subrepo/$subref/fetch" + refs_subrepo_push="refs/subrepo/$subref/push" + + # Read/parse the .gitrepo file (unless clone/init; doesn't exist yet) + if [[ ! $command =~ ^(clone|init)$ ]]; then + read-gitrepo-file + fi + + true +} + +# Parse command line args according to a simple dsl spec: +get-params() { + local i=0 + local num=${#command_arguments[@]} + for arg in $@; do + local value="${command_arguments[i]}" + value="${value//%/%%}" + value="${value//\\/\\\\}" + # If arg starts with '+' then it is required + if [[ $arg == +* ]]; then + if [[ $i -ge $num ]]; then + usage-error "Command '$command' requires arg '${arg#+}'." + fi + printf -v ${arg#+} -- "$value" + # Look for function name after ':' to provide a default value + else + if [[ $i -lt $num ]]; then + printf -v ${arg%:*} -- "$value" + elif [[ $arg =~ : ]]; then + "${arg#*:}" + fi + fi + let i=$((i+1)) + done + + # Check for extra arguments: + if [[ $num -gt $i ]]; then + set -- ${command_arguments[@]} + for ((j = 1; j <= i; j++)); do shift; done + error "Unknown argument(s) '$*' for '$command' command." + fi +} + +check-and-normalize-subdir() { + # Sanity check subdir: + [[ -n $subdir ]] || + die "subdir not set" + [[ $subdir =~ ^/ || $subdir =~ ^[A-Z]: ]] && + usage-error "The subdir '$subdir' should not be absolute path." + subdir="${subdir#./}" + subdir="${subdir%/}" + [[ $subdir != *//* ]] || subdir=$(tr -s / <<< "$subdir") +} + +# Determine the correct subdir path to use: +guess-subdir() { + local dir="$subrepo_remote" + dir="${dir%.git}" + dir="${dir%/}" + dir="${dir##*/}" + [[ $dir =~ ^[-_a-zA-Z0-9]+$ ]] || + error "Can't determine subdir from '$subrepo_remote'." + subdir="$dir" + check-and-normalize-subdir + encode-subdir +} + +# Encode the subdir as a valid git ref format +# +# Input: env $subdir +# Output: env $subref +# +# For detail rules about valid git refs, see the manual of git-check-ref-format: +# URL: https://www.kernel.org/pub/software/scm/git/docs/git-check-ref-format.html +# Shell: git check-ref-format --help +# +encode-subdir() { + subref=$subdir + if [[ ! $subref ]] || git check-ref-format "subrepo/$subref"; then + return + fi + + ## 0. escape %, ensure the subref can be (almost) decoded back to subdir + subref=${subref//%/%25} + + ## 1. They can include slash / for hierarchical (directory) grouping, + ## but no slash-separated component can begin with a dot . or + ## end with the sequence .lock. + subref=/$subref/ + subref=${subref//\/.//%2e} + subref=${subref//.lock\//%2elock/} + subref=${subref#/} + subref=${subref%/} + + ## 2. They must contain at least one /. + ## Note: 'subrepo/' be will prefixed, so this is always true. + ## 3. They cannot have two consecutive dots .. anywhere. + subref=${subref//../%2e%2e} + subref=${subref//%2e./%2e%2e} + subref=${subref//.%2e/%2e%2e} + + ## 4. They cannot have ASCII control characters + ## (i.e. bytes whose values are lower than \040, or \177 DEL), space, + ## tilde ~, caret ^, or colon : anywhere. + ## 5. They cannot have question-mark ?, asterisk *, + ## or open bracket [ anywhere. + local i + for (( i = 1; i < 32; ++i )); do + # skip substitute NUL char (i=0), as bash will skip NUL in env + local x=$(printf "%02x" $i) + subref=${subref//$(printf "%b" "\x$x")/%$x} + done + subref=${subref//$'\177'/%7f} + subref=${subref// /%20} + subref=${subref//\~/%7e} + subref=${subref//^/%5e} + subref=${subref//:/%3a} + subref=${subref//\?/%3f} + subref=${subref//\*/%2a} + subref=${subref//\[/%5b} + subref=${subref//$'\n'/%0a} + + ## 6. They cannot begin or end with a slash / or contain multiple + ## consecutive slashes. + ## Note: This rule is not revertable. + [[ $subref != *//* ]] || subref=$(tr -s / <<< "$subref") + + ## 7. They cannot end with a dot .. + case "$subref" in + *.) subref=${subref%.} + subref+=%2e + ;; + esac + + ## 8. They cannot contain a sequence @\{. + subref=${subref//@\{/%40\{} + + ## 9. They cannot be the single character @. + ## Note: 'subrepo/' be will prefixed, so this is always true. + + ## 10. They cannot contain a \. + subref=${subref//\\/%5c} + + subref=$(git check-ref-format --normalize --allow-onelevel "$subref") || + error "Can't determine valid subref from '$subdir'." +} + +#------------------------------------------------------------------------------ +# State file (`.gitrepo`) functions: +#------------------------------------------------------------------------------ + +# Set subdir and gitrepo vars: +read-gitrepo-file() { + gitrepo="$subdir/.gitrepo" + + if [[ ! -f $gitrepo ]]; then + error "No '$gitrepo' file." + fi + + # Read .gitrepo values: + if [[ -z $subrepo_remote ]]; then + SAY=false OUT=true RUN git config --file="$gitrepo" subrepo.remote + subrepo_remote="$output" + fi + + if [[ -z $subrepo_branch ]]; then + SAY=false OUT=true RUN git config --file="$gitrepo" subrepo.branch + subrepo_branch="$output" + fi + + SAY=false OUT=true RUN git config --file="$gitrepo" subrepo.commit + subrepo_commit="$output" + + FAIL=false \ + SAY=false OUT=true RUN git config --file="$gitrepo" subrepo.parent + subrepo_parent="$output" + + FAIL=false \ + SAY=false OUT=true RUN git config --file="$gitrepo" subrepo.method + if [[ $output == "rebase" ]]; then + join_method="rebase" + else + # This is the default method + join_method="merge" + fi + + if [[ -z $subrepo_parent ]]; then + FAIL=false \ + SAY=false OUT=true RUN git config --file="$gitrepo" subrepo.former + subrepo_former="$output" + fi +} + + +# Update the subdir/.gitrepo state file: +update-gitrepo-file() { + local short_commit= + + local newfile=false + if [[ ! -e $gitrepo ]]; then + + FAIL=false RUN git cat-file -e "$original_head_commit":"$gitrepo" + + if OK; then + o "Try to recreate gitrepo file from $original_head_commit" + git cat-file -p "$original_head_commit":"$gitrepo" > "$gitrepo" + else + newfile=true + cat <<... > "$gitrepo" +; DO NOT EDIT (unless you know what you are doing) +; +; This subdirectory is a git "subrepo", and this file is maintained by the +; git-subrepo command. See https://github.com/git-commands/git-subrepo#readme +; +... + fi + fi + + + # TODO: only update remote and branch if supplied and $update_wanted + if $newfile || [[ $update_wanted && -n $override_remote ]]; then + RUN git config --file="$gitrepo" subrepo.remote "$subrepo_remote" + fi + + if $newfile || [[ $update_wanted && -n $override_branch ]]; then + RUN git config --file="$gitrepo" subrepo.branch "$subrepo_branch" + fi + + RUN git config --file="$gitrepo" subrepo.commit "$upstream_head_commit" + # Only write new parent when we are at the head of upstream + if [[ -n $upstream_head_commit && -n $subrepo_commit_ref ]]; then + OUT=true RUN git rev-parse "$subrepo_commit_ref" + o "$upstream_head_commit == $output" + if [[ $upstream_head_commit == $output ]]; then + RUN git config --file="$gitrepo" subrepo.parent "$original_head_commit" + fi + fi + + [[ -z $join_method ]] && join_method="merge" + RUN git config --file="$gitrepo" subrepo.method "$join_method" + + RUN git config --file="$gitrepo" subrepo.cmdver "$VERSION" + + RUN git add -f -- "$gitrepo" +} + +#------------------------------------------------------------------------------ +# Enviroment checks: +#------------------------------------------------------------------------------ + +# Check that system is ok for this command: +assert-environment-ok() { + type git &> /dev/null || + error "Can't find your 'git' command in '$PATH'." + + git_version=$(git --version | cut -d ' ' -f3) + + if [[ $( + printf "$REQUIRED_GIT_VERSION\n$git_version" | + sort -t. -k 1,1n -k 2,2n -k 3,3n | + head -n1 + ) == "$git_version" && + $git_version != "$REQUIRED_GIT_VERSION" + ]]; then + error "Requires git version $REQUIRED_GIT_VERSION or higher; "` + `"you have '$git_version'." + fi + + if [[ ${BASH_VERSINFO[0]} -lt 4 ]] ; then + echo "The git-subrepo command requires that 'Bash 4+' is installed." + echo "It doesn't need to be your shell, but it must be in your PATH." + if [[ $OSTYPE == darwin* ]]; then + echo "You appear to be on macOS." + echo "Try: 'brew install bash'." + echo "This will not change your user shell, it just installs 'Bash 5.x'." + fi + exit 1 + fi +} + +# Make sure git repo is ready: +assert-repo-is-ready() { + # Skip this for trivial info commands: + [[ $command =~ ^(help|version|upgrade)$ ]] && return + + # We must be inside a git repo: + git rev-parse --git-dir &> /dev/null || + error "Not inside a git repository." + + # Get the original branch and commit: + git:get-head-branch-name + original_head_branch="$output" + + # If a subrepo branch is currently checked out, then note it: + if [[ $original_head_branch =~ ^subrepo/(.*) ]]; then + error "Can't '$command' while subrepo branch is checked out." + fi + + # Make sure we are on a branch: + [[ $original_head_branch == HEAD || -z $original_head_branch ]] && + error "Must be on a branch to run this command." + + # In a work-tree: + SAY=false OUT=true RUN git rev-parse --is-inside-work-tree + [[ $output == true ]] || + error "Can't 'subrepo $command' outside a working tree." + + # HEAD exists: + [[ $command == clone ]] || + RUN git rev-parse --verify HEAD + + assert-working-copy-is-clean + + # For now, only support actions from top of repo: + if [[ -n "$(git rev-parse --show-prefix)" ]]; then + error "Need to run subrepo command from top level directory of the repo." + fi +} + +assert-working-copy-is-clean() { + # Repo is in a clean state: + if [[ $command =~ ^(clone|init|pull|push|branch|commit)$ ]]; then + # TODO: Should we check for untracked files? + local pwd=$(pwd) + o "Assert that working copy is clean: $pwd" + git update-index -q --ignore-submodules --refresh + git diff-files --quiet --ignore-submodules || + error "Can't $command subrepo. Unstaged changes. ($pwd)" + if [[ $command != clone ]] || git:rev-exists HEAD; then + git diff-index --quiet --ignore-submodules HEAD || + error "Can't $command subrepo. Working tree has changes. ($pwd)" + git diff-index --quiet --cached --ignore-submodules HEAD || + error "Can't $command subrepo. Index has changes. ($pwd)" + else + # Repo has no commits and we're cloning a subrepo. Working tree won't + # possibly have changes as there was nothing initial to change. + [[ -z $(git ls-files) ]] || + error "Can't $command subrepo. Index has changes. ($pwd)" + fi + fi +} + +# If subdir exists, make sure it is empty: +assert-subdir-ready-for-init() { + if [[ ! -e $subdir ]]; then + error "The subdir '$subdir' does not exist." + fi + if [[ -e $subdir/.gitrepo ]]; then + error "The subdir '$subdir' is already a subrepo." + fi + # Check that subdir is part of the repo + if [[ -z $(git log -1 -- $subdir) ]]; then + error "The subdir '$subdir' is not part of this repo." + fi +} + +# If subdir exists, make sure it is empty: +assert-subdir-empty() { + if [[ -e $subdir ]] && [[ -n $(ls -A $subdir) ]]; then + error "The subdir '$subdir' exists and is not empty." + fi +} + +#------------------------------------------------------------------------------ +# Getters of various information: +#------------------------------------------------------------------------------ + +# Find all the current subrepos by looking for all the subdirectories that +# contain a `.gitrepo` file. +get-all-subrepos() { + local paths=($(git ls-files | sed -n 's!/\.gitrepo$!!p' | sort)) + subrepos=() + local path + for path in "${paths[@]}"; do + add-subrepo "$path" + done +} + +add-subrepo() { + if ! $ALL_wanted; then + for path in "${subrepos[@]}"; do + [[ $1 =~ ^$path ]] && return + done + fi + subrepos+=("$1") +} + +# Determine the upstream's default head branch: +get-upstream-head-branch() { + OUT=true RUN git ls-remote $subrepo_remote + local remotes="$output" + [[ -n $remotes ]] || + error "Failed to 'git ls-remote $subrepo_remote'." + local commit="$( + echo "$remotes" | + grep HEAD | + cut -f1 + )" + local branch="$( + echo "$remotes" | + grep -E "$commit[[:space:]]+refs/heads/" | + grep -v HEAD | + head -n1 | + cut -f2 + )" + [[ $branch =~ refs/heads/ ]] || + error "Problem finding remote default head branch." + output="${branch#refs/heads/}" +} + +# Commit msg for an action commit: +# Don't use RUN here as it will pollute commit message +get-commit-message() { + local commit="none" + if git:rev-exists "$upstream_head_commit"; then + commit=$(git rev-parse --short "$upstream_head_commit") + fi + + local args=() debug_wanted=false + if $all_wanted; then + args+=("$subdir") + fi + args+=(${commit_msg_args[@]}) + + # Find the specific git-subrepo code used: + local command_remote='???' + local command_commit='???' + get-command-info + + local merged="none" + if git:rev-exists "$subrepo_commit_ref"; then + merged=$(git rev-parse --short "$subrepo_commit_ref") + fi + + local is_merge="" + if [[ $command != push ]]; then + if git:is_merge_commit "$subrepo_commit_ref"; then + is_merge=" (merge)" + fi + fi + + # TODO: Consider output for push! + + # Format subrepo commit message: + cat <<... +git subrepo $command$is_merge ${args[@]} + +subrepo: + subdir: "$subdir" + merged: "$merged" +upstream: + origin: "$subrepo_remote" + branch: "$subrepo_branch" + commit: "$commit" +git-subrepo: + version: "$VERSION" + origin: "$command_remote" + commit: "$command_commit" +... +} + +# Get location and version info about the git-subrepo command itself. This +# info goes into commit messages, so we can find out exactly how the commits +# were done. +get-command-info() { + local bin="$0" + if [[ $bin =~ / ]]; then + local lib="$(dirname "$bin")" + # XXX Makefile needs to install these symlinks: + # If `git-subrepo` was system-installed (`make install`): + if [[ -e $lib/git-subrepo.d/upstream ]] && + [[ -e $lib/git-subrepo.d/commit ]]; then + command_remote=$(readlink "$lib/git-subrepo.d/upstream") + command_commit=$(readlink "$lib/git-subrepo.d/commit") + elif [[ $lib =~ / ]]; then + lib="$(dirname "$lib")" + if [[ -d $lib/.git ]]; then + local remote="$( + GIT_DIR=$lib/.git git remote -v | + grep '^origin' | + head -n1 | + cut -f2 | + cut -d ' ' -f1 + )" + if [[ -n $remote ]]; then + command_remote="$remote" + else + local remote="$( + GIT_DIR=$lib/.git git remote -v | + head -n1 | + cut -f2 | + cut -d ' ' -f1 + )" + if [[ -n $remote ]]; then + command_remote="$remote" + fi + fi + local commit="$(GIT_DIR="$lib/.git" git rev-parse --short HEAD)" + if [[ -n $commit ]]; then + command_commit="$commit" + fi + fi + fi + fi +} + +#------------------------------------------------------------------------------ +# Instructional errors: +#------------------------------------------------------------------------------ + +error-join() { + cat <<... + +You will need to finish the $command by hand. A new working tree has been +created at $worktree so that you can resolve the conflicts +shown in the output above. + +This is the common conflict resolution workflow: + + 1. cd $worktree + 2. Resolve the conflicts (see "git status"). + 3. "git add" the resolved files. +... + + if [[ "$join_method" == "rebase" ]]; then + cat <<... + 4. git rebase --continue +... + else + cat <<... + 4. git commit +... + fi + + cat <<... + 5. If there are more conflicts, restart at step 2. + 6. cd $start_pwd +... + local branch_name="${branch:=subrepo/$subdir}" + if [[ "$command" == "push" ]]; then + cat <<... + 7. git subrepo push $subdir $branch_name +... + else + cat <<... + 7. git subrepo commit $subdir +... + fi + + if [[ "$command" == "pull" && "$join_method" == "rebase" ]]; then + cat <<... + +After you have performed the steps above you can push your local changes +without repeating the rebase by: + 1. git subrepo push $subdir $branch_name + +... + fi + +cat <<... +See "git help $join_method" for details. + +Alternatively, you can abort the $command and reset back to where you started: + + 1. git subrepo clean $subdir + +See "git help subrepo" for more help. + +... +} + +#------------------------------------------------------------------------------ +# Git command wrappers: +#------------------------------------------------------------------------------ + +git:branch-exists() { + git:rev-exists "refs/heads/$1" +} + +git:rev-exists() { + git rev-list "$1" -1 &> /dev/null +} + +git:ref-exists() { + test -n "$(git for-each-ref "$1")" +} + +git:get-head-branch-name() { + output= + local name="$(git symbolic-ref --short --quiet HEAD)" + [[ $name == HEAD ]] && return + output="$name" +} + +git:get-head-branch-commit() { + output="$(git rev-parse HEAD)" +} + +git:commit-in-rev-list() { + local commit="$1" + local list_head="$2" + git rev-list "$list_head" | grep -q "^$commit" +} + +git:make-ref() { + local ref_name="$1" + local commit="$(git rev-parse "$2")" + RUN git update-ref "$ref_name" "$commit" +} + +git:is_merge_commit() { + local commit="$1" + git show --summary "$commit" | grep -q ^Merge: +} + +git:create-worktree() { + local branch="$1" + worktree="$GIT_TMP/$branch" + RUN git worktree add "$worktree" "$branch" +} + +git:remove-worktree() { + o "Remove worktree: $worktree" + if [[ -d "$worktree" ]]; then + o "Check worktree for unsaved changes" + cd "$worktree" + assert-working-copy-is-clean + cd "$start_pwd" + + o "Clean up worktree $worktree" + rm -rf "$worktree" + RUN git worktree prune + fi +} + +git:delete-branch() { + local branch="$1" + o "Deleting old '$branch' branch." + # Remove worktree first, otherwise you can't delete the branch + git:remove-worktree + FAIL=false RUN git branch -D "$branch" +} + + +#------------------------------------------------------------------------------ +# Low level sugar commands: +#------------------------------------------------------------------------------ + +# Smart command runner: +RUN() { + $debug_wanted && $SAY && say '>>>' $* + if $EXEC; then + "$@" + return $? + fi + + OK=true + set +e + local rc= + local out= + if $debug_wanted && $TTY && interactive; then + "$@" + else + if $OUT; then + out="$("$@" 2>/dev/null)" + else + out="$("$@" 2>&1)" + fi + fi + rc=$? + set -e + + if [[ $rc -ne 0 ]]; then + OK=false + $FAIL && error "Command failed: '$*'.\n$out" + fi + output="$out" +} + + +interactive() { + if [[ -t 0 && -t 1 ]]; then + return 0 + else + return 1 + fi +} + +# Call a function with indent increased: +CALL() { + local INDENT=" $INDENT" + "$@" || true +} + +# Print verbose steps for commands with steps: +o() { + if $verbose_wanted; then + echo "$INDENT* $@" + fi +} + +# Print unless quiet mode: +say() { + $quiet_wanted || echo "$@" +} + +# Print to stderr: +err() { + echo "$@" >&2 +} + +# Check if OK: +OK() { + $OK +} + +# Nicely report common error messages: +usage-error() { + local msg="git-subrepo: $1" usage= + if [[ $GIT_SUBREPO_TEST_ERRORS != true ]]; then + source "${SOURCE_DIR}/git-subrepo.d/help-functions.bash" + if can "help:$command"; then + msg=$'\n'"$msg"$'\n'"$("help:$command")"$'\n' + fi + fi + echo "$msg" >&2 + exit 1 +} + +# Nicely report common error messages: +error() { + local msg="git-subrepo: $1" usage= + echo -e "$msg" >&2 + exit 1 +} + +# Start at the end: +[[ $BASH_SOURCE != "$0" ]] || main "$@" + +# Local Variables: +# tab-width: 2 +# sh-indentation: 2 +# sh-basic-offset: 2 +# End: +# vim: set ft=sh sw=2 lisp: -- cgit v1.2.3