Archives
/
git-filter-repo
mirror of https://github.com/newren/git-filter-repo
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
main
doc-update
docs
use-mailmap-fix
debug-github-workflows
replace-text-limited-to-certain-files
pu
todo
rebase-i-autosquash-rebase-merges-fails
v2.38.0
v2.34.0
v2.33.0
v2.32.0
v2.29.0
v2.28.0
v2.27.1
v2.27.0
v2.26.0
v2.25.0
v2.24.0
v2.23.0
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '9928b7cb3e'
${ noResults }
git-filter-repo/INSTALL.md

3.1 KiB
Raw Blame History

What/why/where to install things

filter-repo only consists of a few files that need to be installed:

  • git-filter-repo

    This can be installed in the directory pointed to by git --exec-path, or placed anywhere in $PATH. This is the only thing needed for basic use.

    If your python3 executable is named "python" instead of "python3" (this particularly appears to affect a number of Windows users), then you'll also need to modify the first line of git-filter-repo to replace "python3" with "python".

  • git_filter_repo.py

    If you want to make use of one of the scripts in contrib/filter-repo-demos/, or want to write your own script making use of filter-repo as a python library, then you need to have a symlink to (or copy of) git-filter-repo named git_filter_repo.py in $PYTHONPATH.

  • git-filter-repo.1

    If you want git filter-repo --help to display the manpage, this needs to be copied into $MANDIR/man1/ where $MANDIR is some entry from $MANPATH. (Note that git filter-repo -h will show a more limited built-in set of instructions regardless of whether the manpage is installed.)

  • git-filter-repo.html

    The manpage is good enough for me and my systems, but an html-formatted version of the same page is provided for those who prefer it. Place it where ever you like; I have no idea where such a thing should go.

Installation via Makefile

Installing should be doable by hand, but a Makefile is provided for those that prefer it. However, usage of the Makefile really requires overridding at least a couple of the directories with sane values, e.g.

$ make prefix=/usr pythondir=/usr/lib64/python3.8/site-packages install

Also, the Makefile will not edit the shebang line (the first line) of git-filter-repo if your python executable is not named "python3"; you'll still need to do that yourself.

Installation via pip

For those who prefer to install python packages via pip, you merely need to run:

$ pip3 install git-filter-repo

Installation via Package Manager

For those who prefer to install software via a package manager for their operating system, there are many choices -- from dnf or yum or apt-get or whatever for Linux, to brew for Mac OS X, to scoop for Windows. Nearly any of these tools will reduce the installation instructions down to

$ PACKAGE_TOOL install git-filter-repo

I have no interest in tracking all these pre-built packages (nor whether those who packaged git-filter-repo have made modifications or left parts of it out), but apparently https://repology.org is willing to track who has packaged it. So, using repology's packaging status link, the following package managers have packaged git-filter-repo:

Packaging status