https://github.com/tummychow/git-absorb Skip to content Navigation Menu Toggle navigation Sign in * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + GitHub Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions By size + Enterprise + Teams + Startups By industry + Healthcare + Financial services + Manufacturing By use case + CI/CD & Automation + DevOps + DevSecOps * Resources Topics + AI + DevOps + Security + Software Development + View all Explore + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Enterprise + Enterprise platform AI-powered developer platform Available add-ons + Advanced Security Enterprise-grade security features + GitHub Copilot Enterprise-grade AI features + Premium Support Enterprise-grade 24/7 support * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up Reseting focus You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} tummychow / git-absorb Public * Notifications You must be signed in to change notification settings * Fork 62 * Star 4k git commit --fixup, but automatic crates.io/crates/git-absorb License BSD-3-Clause license 4k stars 62 forks Branches Tags Activity Star Notifications You must be signed in to change notification settings * Code * Issues 26 * Pull requests 2 * Actions * Projects 0 * Security * Insights Additional navigation options * Code * Issues * Pull requests * Actions * Projects * Security * Insights tummychow/git-absorb This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. master BranchesTags Go to file Code Folders and files Name Name Last commit Last commit message date Latest commit History 251 Commits .cargo .cargo .github/workflows .github/ workflows Documentation Documentation src src .gitignore .gitignore Cargo.lock Cargo.lock Cargo.toml Cargo.toml LICENSE.md LICENSE.md README.md README.md View all files Repository files navigation * README * BSD-3-Clause license git absorb This is a port of Facebook's hg absorb, which I first read about on mozilla.dev.version-control: + Facebook demoed hg absorb which is probably the coolest workflow enhancement I've seen to version control in years. Essentially, when your working directory has uncommitted changes on top of draft changesets, you can run hg absorb and the uncommitted modifications are automagically folded ("absorbed") into the appropriate draft ancestor changesets. This is essentially doing hg histedit + "roll" actions without having to make a commit or manually make history modification rules. The command essentially looks at the lines that were modified, finds a changeset modifying those lines, and amends that changeset to include your uncommitted changes. If the changes can't be made without conflicts, they remain uncommitted. This workflow is insanely useful for things like applying review feedback. You just make file changes, run hg absorb and the mapping of changes to commits sorts itself out. It is magical. Elevator Pitch You have a feature branch with a few commits. Your teammate reviewed the branch and pointed out a few bugs. You have fixes for the bugs, but you don't want to shove them all into an opaque commit that says fixes, because you believe in atomic commits. Instead of manually finding commit SHAs for git commit --fixup, or running a manual interactive rebase, do this: git add $FILES_YOU_FIXED git absorb --and-rebase git absorb will automatically identify which commits are safe to modify, and which staged changes belong to each of those commits. It will then write fixup! commits for each of those changes. With the --and-rebase flag, these fixup commits will be automatically integrated into the corresponding ones. Alternatively, you can check its output manually if you don't trust it, and then fold the fixups into your feature branch with git's built-in autosquash functionality: git add $FILES_YOU_FIXED git absorb git log # check the auto-generated fixup commits git rebase -i --autosquash master Installing The easiest way to install git absorb is to download an artifact from the latest tagged release. Artifacts are available for Windows, MacOS, and Linux (built on Ubuntu with statically linked libgit2). If you need a commit that hasn't been released yet, check the latest CI artifact or file an issue. Alternatively, git absorb is available in the following system package managers: Packaging status Repository Command Arch Linux pacman -S git-absorb Debian apt install git-absorb DPorts pkg install git-absorb Fedora dnf install git-absorb FreeBSD Ports pkg install git-absorb Homebrew and Linuxbrew brew install git-absorb MacPorts sudo port install git-absorb nixpkgs stable and unstable nix-env -iA nixpkgs.git-absorb openSUSE zypper install git-absorb Ubuntu apt install git-absorb Void Linux xbps-install -S git-absorb GNU Guix guix install git-absorb Compiling from Source crates.io badge Build You will need the following: * cargo Then cargo install git-absorb. Make sure that $CARGO_HOME/bin is on your $PATH so that git can find the command. ($CARGO_HOME defaults to ~/.cargo.) Note that git absorb does not use the system libgit2. This means you do not need to have libgit2 installed to build or run it. However, this does mean you have to be able to build libgit2. (Due to recent changes in the git2 crate, CMake is no longer needed to build it.) Note: cargo install does not currently know how to install manpages ( cargo#2729), so if you use cargo for installation then git absorb --help will not work. Here is a manual workaround, assuming your system has a ~/.local/share/man/man1 directory that man --path knows about: wget https://raw.githubusercontent.com/tummychow/git-absorb/master/Documentation/git-absorb.1 mv git-absorb.1 ~/.local/share/man/man1 Usage 1. git add any changes that you want to absorb. By design, git absorb will only consider content in the git index (staging area). 2. git absorb. This will create a sequence of commits on HEAD. Each commit will have a fixup! message indicating the message (if unique) or SHA of the commit it should be squashed into. 3. If you are satisfied with the output, git rebase -i --autosquash to squash the fixup! commits into their predecessors. You can set the GIT_SEQUENCE_EDITOR environment variable if you don't need to edit the rebase TODO file. 4. If you are not satisfied (or if something bad happened), git reset --soft to the pre-absorption commit to recover your old state. (You can find the commit in question with git reflog.) And if you think git absorb is at fault, please file an issue. How it works (roughly) git absorb works by checking if two patches P1 and P2 commute, that is, if applying P1 before P2 gives the same result as applying P2 before P1. git absorb considers a range of commits ending at HEAD. The first commit can be specified explicitly with --base . By default the last 10 commits will be considered (see Configuration below for how to change this). For each hunk in the index, git absorb will check if that hunk commutes with the last commit, then the one before that, etc. When it finds a commit that does not commute with the hunk, it infers that this is the right parent commit for this change, and the hunk is turned into a fixup commit. If the hunk commutes with all commits in the range, it means we have not found a suitable parent commit for this change; a warning is displayed, and this hunk remains uncommitted in the index. Configuration Stack size When run without --base, git-absorb will only search for candidate commits to fixup within a certain range (by default 10). If you get an error like this: WARN stack limit reached, limit: 10 edit your local or global .gitconfig and add the following section [absorb] maxStack=50 # Or any other reasonable value for your project One fixup per fixable commit By default, git-absorb will generate separate fixup commits for every absorbable hunk. Instead, can use the -F flag to create only 1 fixup commit for all hunks that absorb into the same commit. To always have this behavior, set [absorb] oneFixupPerCommit = true Auto-stage all changes if nothing staged By default, git-absorb will only consider files that you've staged to the index via git add. However, sometimes one wants to try and absorb from all changes, which would require to stage them first via git add .. To avoid this extra step, set [absorb] autoStageIfNothingStaged = true which tells git-absorb, when no changes are staged, to auto-stage them all, create fixup commits where possible, and unstage remaining changes from the index. Fixup target always SHA By default, git-absorb will create fixup commits with their messages pointing to the target commit's summary, and if there are duplicate summaries, will fallback to pointing to the target's SHA. Instead, can always point to the target's SHA via: [absorb] fixupTargetAlwaysSHA = true TODO * implement force flag * implement remote default branch check * add smaller force flags to disable individual safety checks * stop using failure::err_msg and ensure all error output is actionable by the user * slightly more log output in the success case * more tests (esp main module and integration tests) * document stack and commute details * more commutation cases (esp copy/rename detection) * don't load all hunks in memory simultaneously because they could be huge * implement some kind of index locking to protect against concurrent modifications About git commit --fixup, but automatic crates.io/crates/git-absorb Topics git rebase Resources Readme License BSD-3-Clause license Activity Stars 4k stars Watchers 21 watching Forks 62 forks Report repository Releases 17 0.6.15 Latest Jul 8, 2024 + 16 releases Packages 0 No packages published Contributors 33 * @tummychow * @nickolay * @alexmaco * @waldyrious * @kiprasmel * @Pi-Cla * @rbartlensky * @theaquamarine * @gasche * @nilbus * @ErichDonGubler * @dependabot[bot] * @nightscape * @jankatins + 19 contributors Languages * Rust 100.0% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.