How to extract a git subdirectory and make a submodule out of it?

by

Nowadays there’s a much easier way to do it than manually using git filter-branch: git subtree

Installation

NOTE git-subtree is now part of git (if you install contrib) as of 1.7.11, so you might already have it installed. You may check by executing git subtree.

To install git-subtree from source (for older versions of git):

git clone https://github.com/apenwarr/git-subtree.git

cd git-subtree
sudo rsync -a ./git-subtree.sh /usr/local/bin/git-subtree

Or if you want the man pages and all

make doc
make install

Usage

Split a larger into smaller chunks:

# Go into the project root
cd ~/my-project

# Create a branch which only contains commits for the children of 'foo'
git subtree split --prefix=foo --branch=foo-only

# Remove 'foo' from the project
git rm -rf ./foo

# Create a git repo for 'foo' (assuming we already created it on github)
mkdir foo
pushd foo
git init
git remote add origin [email protected]:my-user/new-project.git
git pull ../ foo-only
git push origin -u master
popd

# Add 'foo' as a git submodule to `my-project`
git submodule add [email protected]:my-user/new-project.git foo

For detailed documentation (man page), please read git-subtree.txt.

More Related Contents:

  1. How do I remove a submodule?
  2. How to “git clone” including submodules?
  3. How can I specify a branch/tag when adding a Git submodule?
  4. How to change the remote repository for a git submodule?
  5. Git submodules in .gitmodules not initialized
  6. How do I pull from a Git repository through an HTTP proxy?
  7. Why is my Git Submodule HEAD detached from master?
  8. How to make shallow git submodules?
  9. Differences between git submodule and subtree
  10. Git submodule head ‘reference is not a tree’ error
  11. Is there a way to make git pull automatically update submodules?
  12. Pull latest changes for all git submodules
  13. Update Git submodule to latest commit on origin
  14. List submodules in a Git repository
  15. how exactly does git submodule work
  16. Git: can I suppress listing of ‘modified content’/dirty submodule entries in status, diff, etc?
  17. Convert a Git folder to a submodule retrospectively?
  18. Git: track branch in submodule but commit in other submodule (possibly nested)
  19. Git submodules workflow
  20. Git submodule URL not including username?
  21. How do I move an existing Git submodule within a Git repository?
  22. Git submodules not updating in Jenkins build
  23. How can I get a git submodule’s associated commit ID from a past commit in the parent clone?
  24. How do I revert my changes to a git submodule?
  25. Where does Git store the SHA1 of the commit for a submodule?
  26. Git commit to common submodule (master branch)
  27. How to convert a Git repo to a submodule, which is nested in another (parent) Git repo?
  28. Rewrite history git filter-branch create / split into submodules / subprojects
  29. Git diff says subproject is dirty
  30. Unable to track files within Git submodules

Leave a Comment