É possível clonar apenas parte de um projeto git?

Eu encontrei uma coleção de slackbuilds, alguns que eu preciso existem no GitHub. https://github.com/PhantomX/slackbuilds/ Não quero obter todo o git.

git clone https://github.com/PhantomX/slackbuilds.git

Mas só pegue um slackbuild, para este .

Como fazer isso? É possível?

Você terminará o download de todo o histórico, por isso não vejo muitos benefícios nele, mas é possível fazer o checkout de partes específicas usando um checkout "esparso". Citando esta postagem Stack Overflow :

As etapas para executar um clone esparso são as seguintes:

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

Isso cria um repositório vazio com seu controle remoto e busca todos os objetos, mas não os verifica. Então faça:

git config core.sparseCheckout true

Agora você precisa definir quais arquivos / pastas você deseja realmente fazer check-out. Isso é feito listando-os em .git/info/sparse-checkout, por exemplo:

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

Por último, mas não menos importante, atualize seu repositório vazio com o estado do controle remoto:

git pull origin master

Você pode dar uma olhada no tutorial estendido e provavelmente deve ler a documentação oficial para fazer uma verificação esparsa .

Você pode estar melhor usando um clone superficial também. Em vez do git pullcomando fornecido anteriormente, tente:

git pull --depth=1 origin master

Tente o seguinte:

svn export https://github.com/PhantomX/slackbuilds/trunk/${directory}

git clone --filter do Git 2.19

Essa opção realmente ignora a busca de objetos desnecessários do servidor:

git clone --depth 1 --no-checkout --filter=blob:none \
  "file://$(pwd)/server_repo" local_repo
cd local_repo
git checkout master -- mydir/

O servidor deve ser configurado com:

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

Não há suporte para servidor a partir da v2.19.0, mas ele já pode ser testado localmente.

TODO: --filter=blob:noneignora todos os blobs, mas ainda busca todos os objetos da árvore. Mas em um repositório normal, isso deve ser pequeno se comparado aos próprios arquivos, portanto, isso já é bom o suficiente. Perguntado em: https://www.spinics.net/lists/git/msg342006.html Os Devs responderam que um --filter=tree:0está sendo trabalhado para fazer isso.

Lembre-se de que isso --depth 1já implica --single-branch, consulte também: /programming/1778088/how-to-clone-a-single-branch-in-git

file://$(path)é necessário para superar as git clonetravessuras de protocolo: /programming/47307578/how-to-shallow-clone-a-local-git-repository-with-a-relative-path

O formato de --filterestá documentado em man git-rev-list.

Foi feita uma extensão ao protocolo remoto Git para suportar esse recurso.

Documentos na árvore 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

Teste

#!/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 upstream .

Saída no 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

Conclusões: todos os blobs de fora d1/estão ausentes. Por exemplo 0975df9b39e23c15f63db194df7f45c76528bccb, o que d2/bnão existe após o check-out d1/.

Note-se que root/roote mybranch/mybranchtambém estão desaparecidos, mas --depth 1esconde que a partir da lista de arquivos ausentes. Se você remover --depth 1, eles serão exibidos na lista de arquivos ausentes.

Finalmente consegui isso graças ao que foi dito acima. Eu estava editando o arquivo diretamente, obtendo erros acidentalmente incluindo as aspas. Seu arquivo .git / info / sparse-checkout deve incluir apenas o diretório, sem aspas. Aqui está um exemplo: Este projeto gigantesco: https://github.com/SharePoint/sp-dev-fx-webparts , eu queria apenas o react-script-editor no diretório samples. https://github.com/SharePoint/sp-dev-fx-webparts/tree/master/samples/react-script-editor

Segui as instruções acima e o fiz funcionar quando meu arquivo .git / info / sparse-checkout tinha exatamente isso

samples / react-script-editor

Isso clonará uma pasta específica e removerá todo o histórico não relacionado a ela.

git clone --single-branch -b {branch} git@github.com:{user}/{repo}.git
git filter-branch --subdirectory-filter {path/to/folder} HEAD
git remote remove origin
git remote add origin git@github.com:{user}/{new-repo}.git
git push -u origin master

Para repositórios GitHub, você pode clonar qualquer subdiretório de qualquer repositório GitHub (em qualquer referência) usando https://github.com/HR/github-clone