Skip to content

Commit

Permalink
Merge branch 'dl/pipx'
Browse files Browse the repository at this point in the history
Signed-off-by: Elijah Newren <[email protected]>
  • Loading branch information
newren committed Nov 30, 2024
2 parents 05c7dfb + caf849e commit 34295ef
Showing 1 changed file with 18 additions and 1 deletion.
19 changes: 18 additions & 1 deletion INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@
* [Installation via Package Manager](#installation-via-package-manager)
* [Detailed installation explanation for
packagers](#detailed-installation-explanation-for-packagers)
* [Installation as Python Package from
PyPI](#installation-as-python-package-from-pypi)
* [Installation via Makefile](#installation-via-makefile)
* [Notes for Windows Users](#notes-for-windows-users)

Expand Down Expand Up @@ -132,10 +134,21 @@ So, installation might look something like the following:

or you can use the provided Makefile, as noted below.

# Installation as Python Package from PyPI

`git-filter-repo` is also available as
[PyPI-package](https://pypi.org/project/git-filter-repo/).

Therefore, it can be installed with [pipx](https://pypa.github.io/pipx/)
or [uv tool](https://docs.astral.sh/uv/concepts/tools/).
Command example for pipx:

`pipx install git-filter-repo`

# 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
that prefer it. However, usage of the Makefile really requires overriding
at least a couple of the directories with sane values, e.g.

$ make prefix=/usr pythondir=/usr/lib64/python3.8/site-packages install
Expand All @@ -146,6 +159,10 @@ you'll still need to do that yourself.

# Notes for Windows Users

git-filter-repo can be installed with multiple tools, such as
[pipx](https://pypa.github.io/pipx/) or a Windows-specific package manager
like Scoop (both of which were covered above).

Sadly, Windows sometimes makes things difficult. Common and historical issues:

* **Non-functional Python stub**: Windows apparently ships with a
Expand Down

0 comments on commit 34295ef

Please sign in to comment.