Как клонировать только подкаталог репозитория Git?

То, что вы пытаетесь сделать, называется разреженной проверкой , и эта функция была добавлена ​​в git 1.7.0 (февраль 2012 г.). Шаги по созданию разреженного клона следующие:

mkdir <repo>
cd <repo>
git init
git remote add -f origin <url>

Это создает пустой репозиторий с вашим пультом дистанционного управления и извлекает все объекты, но не извлекает их. Затем сделайте:

git config core.sparseCheckout true

Теперь вам нужно определить, какие файлы / папки вы хотите проверить. Это делается путем их перечисления .git/info/sparse-checkout, например:

echo "some/dir/" >> .git/info/sparse-checkout
echo "another/sub/tree" >> .git/info/sparse-checkout

И последнее, но не менее важное: обновите пустое репо, указав состояние с пульта дистанционного управления:

git pull origin master

Теперь у вас будут файлы, "проверенные" для вашей файловой системы some/dir и another/sub/tree в вашей файловой системе (с сохранением этих путей), и никаких других путей не будет.

Возможно, вы захотите взглянуть на расширенное руководство и, вероятно, должны прочитать официальную документацию для разреженной проверки .

Как функция:

function git_sparse_clone() (
  rurl="$1" localdir="$2" && shift 2

  mkdir -p "$localdir"
  cd "$localdir"

  git init
  git remote add -f origin "$rurl"

  git config core.sparseCheckout true

  # Loops over remaining args
  for i; do
    echo "$i" >> .git/info/sparse-checkout
  done

  git pull origin master
)

Использование:

git_sparse_clone "http://github.com/tj/n" "./local/location" "/bin"

---

Обратите внимание, что при этом все равно будет загружен весь репозиторий с сервера - только касса уменьшится в размере. На данный момент невозможно клонировать только один каталог. Но если вам не нужна история репозитория, вы можете хотя бы сэкономить на пропускной способности, создав неглубокий клон. См . Ответ udondan ниже, чтобы узнать, как объединить неглубокий клон и разреженную проверку.

---

Начиная с git 2.25.0 (январь 2020 г.) в git добавлена экспериментальная команда разреженной проверки :

git sparse-checkout init
# same as: 
# git config core.sparseCheckout true

git sparse-checkout set "A/B"
# same as:
# echo "A/B" >> .git/info/sparse-checkout

git sparse-checkout list
# same as:
# cat .git/info/sparse-checkout

Это выглядит намного проще:

git archive --remote=<repo_url> <branch> <path> | tar xvf -

Вы можете комбинировать функции разреженного оформления заказа и неглубокого клонирования . В мелком клоне отрежет историю и разреженной проверка тянет только файлы , которые соответствуют вашей модели.

git init <repo>
cd <repo>
git remote add origin <url>
git config core.sparsecheckout true
echo "finisht/*" >> .git/info/sparse-checkout
git pull --depth=1 origin master

Вам понадобится как минимум git 1.9, чтобы это работало. Сам тестировал только с 2.2.0 и 2.2.2.

Таким образом, вы все равно сможете толкать , что невозможно с git archive .

Клонировать подкаталог только с помощью Git невозможно, но ниже приведены несколько обходных путей.

Ветвь фильтра

Возможно, вы захотите переписать репозиторий, чтобы он выглядел так, как если бы trunk/public_html/ он был корнем его проекта, и отбросить всю остальную историю (используя filter-branch), попробуйте уже оформленную ветку:

git filter-branch --subdirectory-filter trunk/public_html -- --all

^{Примечания. Значок, --который отделяет параметры ветвей фильтра от параметров редакции, и --allзначок для перезаписи всех ветвей и тегов. Вся информация, включая исходное время фиксации или информацию о слиянии, будет сохранена . Эта команда учитывает .git/info/graftsфайл и ссылки в refs/replace/пространстве имен, поэтому, если у вас есть определенные графты или замены refs, выполнение этой команды сделает их постоянными.}

Предупреждение! Переписанная история будет иметь разные имена объектов для всех объектов и не будет совпадать с исходной ветвью. Вы не сможете легко разместить переписанную ветвь поверх исходной. Пожалуйста, не используйте эту команду, если вы не знаете всех последствий, и в любом случае избегайте ее использования, если для решения вашей проблемы будет достаточно простой одиночной фиксации.

---

Редкая касса

Вот простые шаги с методом разреженной проверки, при которых рабочий каталог будет заполняться разреженно, поэтому вы можете указать Git, какие папки или файлы в рабочем каталоге стоит проверить.

1. Клонировать репозиторий как обычно ( --no-checkoutнеобязательно):

   git clone --no-checkout [email protected]/bar.git
   cd bar
   

   ^{Вы можете пропустить этот шаг, если ваш репозиторий уже клонирован.}

   Подсказка: для больших репозиториев рассмотрите мелкую clone ( --depth 1) для извлечения только последней ревизии или / и --single-branchтолько.

2. Включить sparseCheckoutопцию:

   git config core.sparseCheckout true
   

3. Укажите папку (и) для разреженной проверки ( без пробела в конце):

   echo "trunk/public_html/*"> .git/info/sparse-checkout
   

   или редактировать .git/info/sparse-checkout.

4. Оформить заказ в филиале (например master):

   git checkout master
   

Теперь вы должны выбрать папки в вашем текущем каталоге.

Вы можете использовать символические ссылки, если у вас слишком много уровней каталогов или фильтрующих веток.

---

Я только что написал скрипт для GitHub .

Использование:

python get_git_sub_dir.py path/to/sub/dir <RECURSIVE>

Хотя я ненавижу использовать svn при работе с репозиториями git: / Я использую это все время;

function git-scp() (
  URL="$1" && shift 1
  svn export ${URL/blob\/master/trunk}
)

Это позволяет копировать URL-адрес github без изменений. Использование;

--- /tmp » git-scp https://github.com/dgraph-io/dgraph/blob/master/contrib/config/kubernetes/helm                                                                                                                  1 ↵
A    helm
A    helm/Chart.yaml
A    helm/README.md
A    helm/values.yaml
Exported revision 6367.

--- /tmp » ls | grep helm
Permissions Size User    Date Modified    Name
drwxr-xr-x     - anthony 2020-01-07 15:53 helm/

Если вас действительно интересуют файлы последней версии каталога, Github позволяет вам загрузить репозиторий в виде Zip-файла, который не содержит истории. Так что загрузка происходит намного быстрее.

Чтобы прояснить некоторые из замечательных ответов здесь, шаги, описанные во многих ответах, предполагают, что у вас уже есть удаленный репозиторий.

Дано: существующий репозиторий git, например [email protected]:some-user/full-repo.git, с одним или несколькими каталогами, которые вы хотите извлечь независимо от остальной части репозитория, например , каталоги с именами app1 и app2

Предполагая, что у вас есть репозиторий git, как указано выше ...

Затем: вы можете выполнить следующие шаги, чтобы извлечь только определенные каталоги из этого большего репо:

mkdir app1
cd app1
git init
git remote add origin [email protected]:some-user/full-repo.git
git config core.sparsecheckout true
echo "app1/" >> .git/info/sparse-checkout
git pull origin master

Я ошибочно подумал, что параметры разреженной проверки должны быть установлены в исходном репозитории, но это не так: вы определяете, какие каталоги хотите локально, до извлечения с пульта дистанционного управления. Удаленное репо не знает и не заботится о том, что вы хотите отслеживать только часть репо.

Надеюсь, это разъяснение поможет кому-то другому.

Итак, я попробовал все в этом протекторе, и у меня ничего не получилось ... Оказалось, что в версии 2.24 Git (той, которая поставляется с cpanel на момент этого ответа), вам не нужно этого делать

echo "wpm/*" >> .git/info/sparse-checkout

все, что вам нужно, это имя папки

wpm/*

Короче говоря, вы делаете это

git config core.sparsecheckout true

затем вы редактируете .git / info / sparse-checkout и добавляете имена папок (по одному на строку) с / * в конце, чтобы получить подпапки и файлы

wpm/*

Сохраните и запустите команду оформления заказа

git checkout master

Результатом была ожидаемая папка из моего репо и ничего больше Upvote, если это сработало для вас

Выше много хороших идей и скриптов. Я ничего не мог с собой поделать и объединил их в сценарий bash с помощью и проверкой ошибок:

#!/bin/bash

function help {
  printf "$1
Clones a specific directory from the master branch of a git repository.

Syntax:
  $(basename $0) [--delrepo] repoUrl sourceDirectory [targetDirectory]

If targetDirectory is not specified it will be set to sourceDirectory.
Downloads a sourceDirectory from a Git repository into targetdirectory.
If targetDirectory is not specified, a directory named after `basename sourceDirectory`
will be created under the current directory.

If --delrepo is specified then the .git subdirectory in the clone will be removed after cloning.


Example 1:
Clone the tree/master/django/conf/app_template directory from the master branch of
[email protected]:django/django.git into ./app_template:

\$ $(basename $0) [email protected]:django/django.git django/conf/app_template

\$ ls app_template/django/conf/app_template/
__init__.py-tpl  admin.py-tpl  apps.py-tpl  migrations  models.py-tpl  tests.py-tpl  views.py-tpl


Example 2:
Clone the django/conf/app_template directory from the master branch of
https://github.com/django/django/tree/master/django/conf/app_template into ~/test:

\$ $(basename $0) [email protected]:django/django.git django/conf/app_template ~/test

\$ ls test/django/conf/app_template/
__init__.py-tpl  admin.py-tpl  apps.py-tpl  migrations  models.py-tpl  tests.py-tpl  views.py-tpl

"
  exit 1
}

if [ -z "$1" ]; then help "Error: repoUrl was not specified.\n"; fi
if [ -z "$2" ]; then help "Error: sourceDirectory was not specified."; fi

if [ "$1" == --delrepo ]; then
  DEL_REPO=true
  shift
fi

REPO_URL="$1"
SOURCE_DIRECTORY="$2"
if [ "$3" ]; then
  TARGET_DIRECTORY="$3"
else
  TARGET_DIRECTORY="$(basename $2)"
fi

echo "Cloning into $TARGET_DIRECTORY"
mkdir -p "$TARGET_DIRECTORY"
cd "$TARGET_DIRECTORY"
git init
git remote add origin -f "$REPO_URL"
git config core.sparseCheckout true

echo "$SOURCE_DIRECTORY" > .git/info/sparse-checkout
git pull --depth=1 origin master

if [ "$DEL_REPO" ]; then rm -rf .git; fi

Здесь много замечательных отзывов, но я хотел бы добавить, что использование цитат вокруг имен каталогов не помогло мне в Windows Sever 2016. Файлы просто не загружались.

Вместо того

"mydir/myfolder"

Мне пришлось использовать

mydir/myfolder

Кроме того, если вы хотите просто загрузить все подкаталоги, просто используйте

git sparse-checkout set *

git clone --filter из git 2.19 теперь работает на GitHub (проверено 2021-01-14, git 2.30.0)

Эта опция была добавлена ​​вместе с обновлением удаленного протокола и действительно предотвращает загрузку объектов с сервера.

Например, чтобы клонировать только объекты, необходимые для d1 этого минимального тестового репозитория: https://github.com/cirosantilli/test-git-partial-clone, я могу:

git clone \
  --depth 1  \
  --filter=blob:none  \
  --sparse \
  https://github.com/cirosantilli/test-git-partial-clone \
;
cd test-git-partial-clone
git sparse-checkout set d1

Вот менее минимальная и более реалистичная версия на https://github.com/cirosantilli/test-git-partial-clone-big-small

git clone \
  --depth 1  \
  --filter=blob:none  \
  --sparse \
  https://github.com/cirosantilli/test-git-partial-clone-big-small \
;
cd test-git-partial-clone-big-small
git sparse-checkout set small

Этот репозиторий содержит:

• большой каталог с 10 файлами по 10 МБ
• небольшой каталог с 1000 файлов размером один байт

Все содержимое является псевдослучайным и, следовательно, несжимаемым.

Время клонирования в моем Интернете со скоростью 36,4 Мбит / с:

• полный: 24 с
• частичный: "мгновенный"

sparse-checkout Часть также необходима , к сожалению. Вы также можете загружать только определенные файлы с гораздо более понятным:

git clone \
  --depth 1  \
  --filter=blob:none  \
  --no-checkout \
  https://github.com/cirosantilli/test-git-partial-clone \
;
cd test-git-partial-clone
git checkout master -- di

но этот метод по какой-то причине загружает файлы один за другим очень медленно , что делает его непригодным для использования, если у вас не очень мало файлов в каталоге.

Анализ объектов в минимальном репозитории

Команда clone получает только:

• один объект фиксации с кончиком masterветки
• все 4 древовидных объекта репозитория:
  • каталог верхнего уровня фиксации
  • три директории d1, d2,master

Затем git sparse-checkout set команда извлекает с сервера только недостающие BLOB-объекты (файлы):

• d1/a
• d1/b

Более того, позже GitHub, скорее всего, начнет поддерживать:

  --filter=blob:none \
  --filter=tree:0 \

where --filter=tree:0from Git 2.20 предотвратит ненужную clone выборку всех объектов дерева и позволит отложить ее checkout . Но в моем тесте 2020-09-18, который не удался:

fatal: invalid filter-spec 'combine:blob:none+tree:0'

предположительно потому, что --filter=combine: составной фильтр (добавлен в Git 2.24, подразумевается множеством --filter ) еще не реализован.

Я наблюдал, какие объекты были получены с помощью:

git verify-pack -v .git/objects/pack/*.pack

как упоминалось в: Как перечислить ВСЕ объекты git в базе данных? Она не дает мне супер четкое представление о том , что каждый объект в точности, но это действительно говорит тип каждого объекта ( commit, tree, blob ), и так как есть очень мало объектов в этом минимальном репо, я могу однозначно вывести , что каждый объект .

git rev-list --objects --all действительно давал более четкий вывод с путями для дерева / капли, но, к сожалению, он извлекает некоторые объекты, когда я его запускаю, что затрудняет определение того, что было извлечено и когда, дайте мне знать, есть ли у кого-нибудь лучшая команда.

TODO находит объявление на GitHub, в котором говорится, когда они начали его поддерживать. https://github.blog/2020-01-17-bring-your-monorepo-down-to-size-with-sparse-checkout/ от 2020-01-17 уже упоминается --filter blob:none .

git sparse-checkout

Я думаю, что эта команда предназначена для управления файлом настроек, который говорит: «Меня интересуют только эти поддеревья», так что будущие команды будут влиять только на эти поддеревья. Но в этом немного сложно быть уверенным, потому что текущая документация немного ... скудна ;-)

Само по себе это не предотвращает получение капель.

Если это понимание верно, то это будет хорошим дополнением к git clone --filter описанному выше, поскольку это предотвратит непреднамеренную выборку большего количества объектов, если вы намереваетесь выполнять операции git в частичном клонированном репозитории.

Когда я попробовал Git 2.25.1:

git clone \
  --depth 1 \
  --filter=blob:none \
  --no-checkout \
  https://github.com/cirosantilli/test-git-partial-clone \
;
cd test-git-partial-clone
git sparse-checkout init

это не сработало, потому что init фактически были извлечены все объекты.

Однако в Git 2.28 он не извлекал объекты должным образом. Но если я это сделаю:

git sparse-checkout set d1

d1 не извлекается и не извлекается, хотя здесь явно сказано, что это необходимо: https://github.blog/2020-01-17-bring-your-monorepo-down-to-size-with-sparse-checkout/#sparse- checkout-and-partial-clones С отказом от ответственности:

Следите за тем, чтобы функция частичного клонирования стала общедоступной [1].

[1]: GitHub все еще оценивает эту функцию внутри компании, хотя она включена в нескольких избранных репозиториях (включая пример, использованный в этом сообщении). По мере того, как функция стабилизируется и развивается, мы будем держать вас в курсе ее прогресса.

Так что да, на данный момент в этом слишком сложно быть уверенным, отчасти благодаря тому, что GitHub радует закрытым исходным кодом. Но давайте следить за этим.

Разбивка команд

Сервер должен быть настроен с:

git config --local uploadpack.allowfilter 1
git config --local uploadpack.allowanysha1inwant 1

Разбивка команд:

• --filter=blob:noneпропускает все капли, но по-прежнему выбирает все объекты дерева

• --filter=tree:0пропускает ненужные деревья: https://www.spinics.net/lists/git/msg342006.html

• --depth 1уже подразумевается --single-branch, см. также: Как клонировать отдельную ветку в Git?

• file://$(path)требуется для преодоления git cloneмахинаций протокола: как неглубоко клонировать локальный репозиторий git с относительным путем?

• --filter=combine:FILTER1+FILTER2- это синтаксис для одновременного использования нескольких фильтров, попытка пройти --filterпо какой-то причине не удалась: «несколько спецификаций фильтров не могут быть объединены». Это было добавлено в Git 2.24 по адресу e987df5fe62b8b29be4cdcdeb3704681ada2b29e «фильтр-список-объекты: реализовать составные фильтры».

  Изменить: в Git 2.28 я экспериментально вижу, что это --filter=FILTER1 --filter FILTER2также имеет тот же эффект, поскольку GitHub еще не реализован по combine:состоянию на 2020-09-18 и жалуется fatal: invalid filter-spec 'combine:blob:none+tree:0'. В какой версии введен TODO?

Формат --filter задокументирован man git-rev-list .

Документы по дереву Git:

• https://github.com/git/git/blob/v2.19.0/Documentation/technical/partial-clone.txt
• https://github.com/git/git/blob/v2.19.0/Documentation/rev-list-options.txt#L720
• https://github.com/git/git/blob/v2.19.0/t/t5616-partial-clone.sh

Проверить это на месте

Следующий скрипт воспроизводимо генерирует репозиторий https://github.com/cirosantilli/test-git-partial-clone локально, выполняет локальное клонирование и наблюдает за тем, что было клонировано:

#!/usr/bin/env bash
set -eu

list-objects() (
  git rev-list --all --objects
  echo "master commit SHA: $(git log -1 --format="%H")"
  echo "mybranch commit SHA: $(git log -1 --format="%H")"
  git ls-tree master
  git ls-tree mybranch | grep mybranch
  git ls-tree master~ | grep root
)

# Reproducibility.
export GIT_COMMITTER_NAME='a'
export GIT_COMMITTER_EMAIL='a'
export GIT_AUTHOR_NAME='a'
export GIT_AUTHOR_EMAIL='a'
export GIT_COMMITTER_DATE='2000-01-01T00:00:00+0000'
export GIT_AUTHOR_DATE='2000-01-01T00:00:00+0000'

rm -rf server_repo local_repo
mkdir server_repo
cd server_repo

# Create repo.
git init --quiet
git config --local uploadpack.allowfilter 1
git config --local uploadpack.allowanysha1inwant 1

# First commit.
# Directories present in all branches.
mkdir d1 d2
printf 'd1/a' > ./d1/a
printf 'd1/b' > ./d1/b
printf 'd2/a' > ./d2/a
printf 'd2/b' > ./d2/b
# Present only in root.
mkdir 'root'
printf 'root' > ./root/root
git add .
git commit -m 'root' --quiet

# Second commit only on master.
git rm --quiet -r ./root
mkdir 'master'
printf 'master' > ./master/master
git add .
git commit -m 'master commit' --quiet

# Second commit only on mybranch.
git checkout -b mybranch --quiet master~
git rm --quiet -r ./root
mkdir 'mybranch'
printf 'mybranch' > ./mybranch/mybranch
git add .
git commit -m 'mybranch commit' --quiet

echo "# List and identify all objects"
list-objects
echo

# Restore master.
git checkout --quiet master
cd ..

# Clone. Don't checkout for now, only .git/ dir.
git clone --depth 1 --quiet --no-checkout --filter=blob:none "file://$(pwd)/server_repo" local_repo
cd local_repo

# List missing objects from master.
echo "# Missing objects after --no-checkout"
git rev-list --all --quiet --objects --missing=print
echo

echo "# Git checkout fails without internet"
mv ../server_repo ../server_repo.off
! git checkout master
echo

echo "# Git checkout fetches the missing directory from internet"
mv ../server_repo.off ../server_repo
git checkout master -- d1/
echo

echo "# Missing objects after checking out d1"
git rev-list --all --quiet --objects --missing=print

GitHub вверх по течению .

Вывод в Git v2.19.0:

# List and identify all objects
c6fcdfaf2b1462f809aecdad83a186eeec00f9c1
fc5e97944480982cfc180a6d6634699921ee63ec
7251a83be9a03161acde7b71a8fda9be19f47128
62d67bce3c672fe2b9065f372726a11e57bade7e
b64bf435a3e54c5208a1b70b7bcb0fc627463a75 d1
308150e8fddde043f3dbbb8573abb6af1df96e63 d1/a
f70a17f51b7b30fec48a32e4f19ac15e261fd1a4 d1/b
84de03c312dc741d0f2a66df7b2f168d823e122a d2
0975df9b39e23c15f63db194df7f45c76528bccb d2/a
41484c13520fcbb6e7243a26fdb1fc9405c08520 d2/b
7d5230379e4652f1b1da7ed1e78e0b8253e03ba3 master
8b25206ff90e9432f6f1a8600f87a7bd695a24af master/master
ef29f15c9a7c5417944cc09711b6a9ee51b01d89
19f7a4ca4a038aff89d803f017f76d2b66063043 mybranch
1b671b190e293aa091239b8b5e8c149411d00523 mybranch/mybranch
c3760bb1a0ece87cdbaf9a563c77a45e30a4e30e
a0234da53ec608b54813b4271fbf00ba5318b99f root
93ca1422a8da0a9effc465eccbcb17e23015542d root/root
master commit SHA: fc5e97944480982cfc180a6d6634699921ee63ec
mybranch commit SHA: fc5e97944480982cfc180a6d6634699921ee63ec
040000 tree b64bf435a3e54c5208a1b70b7bcb0fc627463a75    d1
040000 tree 84de03c312dc741d0f2a66df7b2f168d823e122a    d2
040000 tree 7d5230379e4652f1b1da7ed1e78e0b8253e03ba3    master
040000 tree 19f7a4ca4a038aff89d803f017f76d2b66063043    mybranch
040000 tree a0234da53ec608b54813b4271fbf00ba5318b99f    root

# Missing objects after --no-checkout
?f70a17f51b7b30fec48a32e4f19ac15e261fd1a4
?8b25206ff90e9432f6f1a8600f87a7bd695a24af
?41484c13520fcbb6e7243a26fdb1fc9405c08520
?0975df9b39e23c15f63db194df7f45c76528bccb
?308150e8fddde043f3dbbb8573abb6af1df96e63

# Git checkout fails without internet
fatal: '/home/ciro/bak/git/test-git-web-interface/other-test-repos/partial-clone.tmp/server_repo' does not appear to be a git repository
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

# Git checkout fetches the missing directory from internet
remote: Enumerating objects: 1, done.
remote: Counting objects: 100% (1/1), done.
remote: Total 1 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (1/1), 45 bytes | 45.00 KiB/s, done.
remote: Enumerating objects: 1, done.
remote: Counting objects: 100% (1/1), done.
remote: Total 1 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (1/1), 45 bytes | 45.00 KiB/s, done.

# Missing objects after checking out d1
?8b25206ff90e9432f6f1a8600f87a7bd695a24af
?41484c13520fcbb6e7243a26fdb1fc9405c08520
?0975df9b39e23c15f63db194df7f45c76528bccb

Выводы: все капли извне d1/ отсутствуют. Например 0975df9b39e23c15f63db194df7f45c76528bccb, которого d2/b нет после выезда d1/a .

Обратите внимание, что root/root и mybranch/mybranch также отсутствуют, но --depth 1 скрывают это из списка отсутствующих файлов. Если удалить --depth 1, то они отображаются в списке отсутствующих файлов.

У меня есть мечта

Эта функция может произвести революцию в Git.

Представьте себе, что у вас есть вся кодовая база вашего предприятия в одном репо без уродливых сторонних инструментов, таких какrepo .

Представьте, что вы храните огромные капли прямо в репозитории без каких-либо уродливых сторонних расширений .

Представьте, что GitHub разрешил бы метаданные для каждого файла / каталога, такие как звезды и разрешения, чтобы вы могли хранить все свои личные данные в одном репо.

Представьте, что подмодули обрабатывались точно так же, как обычные каталоги : просто запросите дерево SHA, и DNS-подобный механизм разрешит ваш запрос , сначала обращаясь к вашим локальным~/.git , затем сначала к ближайшим серверам (зеркало / кеш вашего предприятия) и в конечном итоге на GitHub.

Это приведет к клонированию определенной папки и удалению всей истории, не связанной с ней.

git clone --single-branch -b {branch} [email protected]:{user}/{repo}.git
git filter-branch --subdirectory-filter {path/to/folder} HEAD
git remote remove origin
git remote add origin [email protected]:{user}/{new-repo}.git
git push -u origin master

Я написал .gitconfig [alias] для выполнения «разреженной проверки». Проверьте это (без каламбура):

В Windows запустить в cmd.exe

git config --global alias.sparse-checkout "!f(){ [ $# -eq 2 ] && L=${1##*/} L=${L%.git} || L=$2; mkdir -p \"$L/.git/info\" && cd \"$L\" && git init --template= && git remote add origin \"$1\" && git config core.sparseCheckout 1; [ $# -eq 2 ] && echo \"$2\" >> .git/info/sparse-checkout || { shift 2; for i; do echo $i >> .git/info/sparse-checkout; done }; git pull --depth 1 origin master;};f"

Иначе:

git config --global alias.sparse-checkout '!f(){ [ $# -eq 2 ] && L=${1##*/} L=${L%.git} || L=$2; mkdir -p "$L/.git/info" && cd "$L" && git init --template= && git remote add origin "$1" && git config core.sparseCheckout 1; [ $# -eq 2 ] && echo "$2" >> .git/info/sparse-checkout || { shift 2; for i; do echo $i >> .git/info/sparse-checkout; done }; git pull --depth 1 origin master;};f'

Использование :

# Makes a directory ForStackExchange with Plug checked out
git sparse-checkout https://github.com/YenForYang/ForStackExchange Plug

# To do more than 1 directory, you have to specify the local directory:
git sparse-checkout https://github.com/YenForYang/ForStackExchange ForStackExchange Plug Folder

Эти git config команды «уменьшенные» для удобства и хранения, но здесь это псевдоним расширен:

# Note the --template= is for disabling templates.
# Feel free to remove it if you don't have issues with them (like I did)
# `mkdir` makes the .git/info directory ahead of time, as I've found it missing sometimes for some reason
f(){
    [ "$#" -eq 2 ] && L="${1##*/}" L=${L%.git} || L=$2;
    mkdir -p "$L/.git/info"
        && cd "$L"
        && git init --template=
        && git remote add origin "$1"
        && git config core.sparseCheckout 1;
    [ "$#" -eq 2 ]
        && echo "$2" >> .git/info/sparse-checkout
        || {
            shift 2;
            for i; do
                echo $i >> .git/info/sparse-checkout;
            done
        };
    git pull --depth 1 origin master;
};
f

Используете Linux? И хотите только легкого доступа и чистки рабочего дерева? не беспокоя остальной код на вашем компьютере. попробуйте символические ссылки !

git clone https://github.com:{user}/{repo}.git ~/my-project
ln -s ~/my-project/my-subfolder ~/Desktop/my-subfolder

Тестовое задание

cd ~/Desktop/my-subfolder
git status

Если вы никогда не планируете взаимодействовать с репозиторием, из которого вы клонировали, вы можете выполнить полное клонирование git и переписать репозиторий с помощью git filter-branch --subdirectory-filter . Так хоть история сохранится.

Git 1.7.0 имеет «разреженные проверки». Смотрите «core.sparseCheckout» в мерзавец конфигурации станицы руководство «разреженной проверке» в мерзавце чтение дерева справочной страницы , и «Skip-worktree бит» в мерзавец обновлении индекса- странице руководстве .

Интерфейс не так удобен, как у SVN (например, во время первоначального клона нет способа выполнить разреженную проверку), но базовая функциональность, на основе которой можно было бы построить более простые интерфейсы, теперь доступна.

Вот сценарий оболочки, который я написал для случая использования разреженной проверки одного подкаталога

coSubDir.sh

localRepo=$1
remoteRepo=$2
subDir=$3


# Create local repository for subdirectory checkout, make it hidden to avoid having to drill down to the subfolder
mkdir ./.$localRepo
cd ./.$localRepo
git init
git remote add -f origin $remoteRepo
git config core.sparseCheckout true

# Add the subdirectory of interest to the sparse checkout.
echo $subDir >> .git/info/sparse-checkout

git pull origin master

# Create convenience symlink to the subdirectory of interest
cd ..
ln -s ./.$localRepo/$subDir $localRepo

Для других пользователей, которые просто хотят загрузить файл / папку с github, просто используйте:

svn export <repo>/trunk/<folder>

например

svn export https://github.com/lodash/lodash.com/trunk/docs

(да, это svn. по-видимому, в 2016 году вам все еще понадобится svn, чтобы просто загрузить некоторые файлы github)

Предоставлено: загрузите одну папку или каталог из репозитория GitHub.

Важно! Убедитесь, что вы обновили URL-адрес github и заменили его /tree/master/ на / trunk /.

Как скрипт bash:

git-download(){
    folder=${@/tree\/master/trunk}
    folder=${folder/blob\/master/trunk}
    svn export $folder
}

Примечание. Этот метод загружает папку, а не клонирует ее или извлекает из нее. Вы не можете отправить изменения обратно в репозиторий. С другой стороны - это приводит к меньшему количеству скачиваний по сравнению с разреженной кассой или неглубокой кассой.