π Redistribution of Git for Windows's PortableGit via npm
npx -p portablegit git add --all
npx -p portablegit git commit --message "Hello world!"
npx -p portablegit bash -c "grep version package.json"
npx -p portablegit sh ./build.sh
npx -p portablegit git-bash
npx -p portablegit gitk HEAD |
πΆ Use Git for Windows via npm
π¨βπ» Provides bash
via Git Bash
πΎ Uses a portable installation of Git & Bash
π¦ Only works on Windows
π§° Useful when you need a specific Git version
π Only works on Windows x64 systems. Does not work on macOS or Linux.
You can install this package using npm or your favorite npm package manager. If possible you should use the user or global Git for Windows installation instead of this package.
npm install --save-dev portablegit
This package has a postinstall
script
βΉ There is no JavaScript component to this package; it's just a redistribution of the PortableGit files and binaries.
You can use this package just as you would any other npm package that provides binaries! PortableGit only provides binaries for Windows.
npx -p portablegit git --version
#=> git version 2.X.Y.windows.Z
Available binary commands exposed through this npm package are:
-
bash
: Git Bashbash.exe
. Useful for cross-platform scripting. You can run Bash scripts on Windows! -
sh
: Git Bashsh.exe
. Runsbash.exe
in POSIX mode. -
git
: The actualgit.exe
binary for Windows. See the Git website to learn more about Git. -
git-bash
: Launches a terminal emulator running Git Bash. Uses MinTTY. -
git-cmd
: Starts acmd.exe
subshell preloaded withgit.exe
and other things in$PATH
. Does not launch a new window. -
git-gui
: Starts the Git GUI. -
gitk
: Starts the GitK GUI. -
tig
,start-ssh-agent
,start-ssh-pagent
,scalar
,git-receive-pack
git-upload-pack
: Extra things that I'm not not smart enough to understand.
This portablegit
npm package is versioned to follow Git for Windows releases. For example, Git for Windows v2.45.1.windows.1
(derived from Git 2.45.1) would be released as portablegit@2.45.11
on npm. Note that there's a 1
suffix appended to the version number. Git for Windows v2.45.1.windows.2
would then be released as portablegit@2.45.12
on npm. The suffix is now a 2
just like .windows.2
. For X.Y.0.windows.1
releases the npm-ified X.Y.01
version specifier is invalid; we need to drop the leading zero to create an X.Y.1
release.
You can import.meta.resolve()
or require.resolve()
anything that would normally be in the extracted PortableGit/*
folder. Here's an example:
const cat = import.meta.resolve("portablegit/usr/bin/cat");
console.log(cat);
//=> 'file:///C:/myproject/node_modules/portablegit/out/portablegit/usr/bin/cat'
const cut = require.resolve("portablegit/usr/bin/cut");
console.log(cut);
//=> 'C:\\myproject\\node_modules\\portablegit\\out\\portablegit\\usr\\bin\\cut'
This can be useful if you need to resolve the path to a specific binary (cat.exe
, cut.exe
, etc.) that isn't exposed by default. Note that you don't need to use the .exe
suffix since Windows will helpfully add .exe
when attempting to run the file.
You'll need a Windows computer to test this package locally. You can run npm run build
to make sure everything looks good locally. npm run generate
redownloads the configured version of Git for Windows PortableGit as a 7zip self-extracting archive.
Each new upcoming release will first be tried as a prerelease -rc.N
first to make sure that everything is 99% guarenteed to work when autopublishing. Make sure to --tag next
!
This package currently relies on manual updates to bump the Git for Windows version. Make sure you update the version
field in package.json
and the gfwVersion
and filename
constants in scripts.js
generate()
.
You can publish a release to GitHub releases and npm using the npm publish GitHub actions workflow.