git-smartmv - A tool that can decide whether to use git mv or mv

The git-smartmv command-line tool allows moving files and/or directories without having to worry about manually choosing whether to use git mv or mv.

It can determines whether to use git mv or mv based on the source and the destination path:

• If the files/directories are being moved within a Git repository, git-smartmv uses git mv.
• If the files/directories are being moved between a Git repository and a non-Git directory or a different Git repository, git-smartmv uses mv.

Installation

Here is how to install git-smartmv system-wide using pip:

sudo pip install git-smartmv

Shell alias

To simplify the usage of this tool, you can add the following line to your ~/.bashrc:

alias mv="git-smartmv"

Usage

The git-smartmv command-line tool accepts similar arguments as the mv command, including the source file or directory to be moved, and the destination file or directory.

usage: git-smartmv [--option] <SOURCE>... <DEST>

options:
  -w WARNING_THRESHOLD, --warning-threshold WARNING_THRESHOLD
                        This will raise a warning if the number of files or directories being moved
                        exceeds the specified amount
  -v, --verbose         Report the names of the files and/or directories as they are being moved.
  -f, --force           Force renaming or moving of files and/or directories even if the destination
                        exists.
  -p, --non-interactive
                        Do not prompt the user to confirm before executing 'mv' and/or 'git mv'
                        commands.

First example:

git smartmv file1 file2

Second example:

git smartmv file1 dir1/ file2 file3 directory/

Third example (non-interactive):

git smartmv --non-interactive dir1/ dir2/

License

Copyright (C) James Cherti

Distributed under terms of the GNU General Public License version 3.

Links

• Git-smartmv @PyPI
• Git-smartmv @GitHub