Como posso baixar apenas uma pasta ou diretório específico de um repositório Git remoto hospedado no GitHub?

Digamos que o exemplo do repositório GitHub mora aqui:

git@github.com:foobar/Test.git

Sua estrutura de diretórios:

Test/
├── foo/ 
│   ├── a.py
│   └── b.py   
└── bar/
    ├── c.py
    └── d.py

Quero baixar apenas a pasta foo e não clonar todo o projeto de teste.

Atualização em setembro de 2016: existem algumas ferramentas criadas pela comunidade que podem fazer isso por você:

• GitZip (Créditos ao Kino - atualize sua resposta aqui! )
• DownGit (Créditos a Minhas Kamal - faça um voto positivo aqui! )

O Git não suporta isso, mas o Github via SVN. Se você fizer o checkout do seu código com o subversion, o Github basicamente converterá o repositório do git para o subversion no back-end, servindo o diretório solicitado.

Veja como você pode usar esse recurso para baixar uma pasta específica. Vou usar a popular biblioteca javascript lodashcomo exemplo.

1. Navegue até a pasta que deseja baixar . Vamos fazer o download /testda masterfilial.

2. Modifique a URL para subversão . Substitua tree/masterpor trunk.

   https://github.com/lodash/lodash/tree/master/test ➜

   https://github.com/lodash/lodash/trunk/test

3. Baixar a pasta . Vá para a linha de comando e pegue a pasta com SVN.

svn checkout https://github.com/lodash/lodash/trunk/test

Você pode não ver nenhuma atividade imediatamente, porque o Github leva até 30 segundos para converter repositórios maiores, portanto, seja paciente.

Explicação completa do formato do URL:

• Se você estiver interessado na masterfilial, use trunk. Portanto, o caminho completo étrunk/foldername
• Se você estiver interessado na foofilial, use branches/foo. O caminho completo parecebranches/foo/foldername
• Protip: você pode usar svn lspara ver as tags e ramificações disponíveis antes de fazer o download, se desejar

Isso é tudo! O Github também suporta mais recursos de subversão , incluindo suporte para confirmar e enviar alterações.

Duas opções para esse recurso:

Opção 1: extensão do navegador GitZip

Extensão do Chrome , Firefox Addon

Uso:

1. Em qualquer página de repositórios do GitHub.
2. Basta clicar duas vezes na parte em branco dos itens necessários.
3. Clique no botão de download no canto inferior direito.
4. Veja o painel de progresso e aguarde o download do acionador do navegador.
5. Obtenha o arquivo ZIP.

Obter token:

1. Clique no ícone da extensão GitZip no seu navegador.
2. Clique no link "Normal" ou "Privado", além de "Obter token".
3. Autorize a permissão GitZip na página de autenticação do Github.
4. Voltar à página de repo do início.
5. Continue a usar.

Opção 2: Github gh-page

http://kinolien.github.io/gitzip usando as bibliotecas API GitHub e JSZip, FileSaver.js.

Etapa 1: insira o URL do github no campo no canto superior direito.
Etapa 2: pressione enter ou clique em download para zip de download diretamente ou clique em pesquisar para exibir a lista de subpastas e arquivos.
Passo 3: Clique em "Download Zip File" ou "Get File" para obter arquivos.

Na maioria dos casos, funciona bem, exceto que a pasta contém mais de 1.000 arquivos, devido à limitação da API do Github Trees. (refere-se ao conteúdo da API do Github )

E também pode oferecer suporte a repositórios públicos / privados e atualizar o limite de taxa, se você tiver uma conta do GitHub e usar o link "obter token" neste site.

Vá para DownGit > Digite seu URL> Download!

Agora, você pode BAIXAR DIRETAMENTE ou criar LINK DE DOWNLOAD para qualquer diretório ou arquivo público do GitHub (arquivo especialmente grande ) do DownGit ! Aqui está uma demonstração simples -

Você também pode configurar o uso detalhado da propriedade do arquivo baixado .

Se você tiver svn, pode svn exportfazer isso:

svn export https://github.com/foobar/Test.git/trunk/foo

Observe o formato do URL:

• O URL base é https://github.com/
• /trunk anexado no final

Antes de executar svn export, é bom verificar primeiro o conteúdo do diretório com:

svn ls https://github.com/foobar/Test.git/trunk/foo

Para um repositório genérico do git:

Se você deseja baixar arquivos, não clonar o repositório com histórico, você pode fazer isso com git-archive.

git-archivecria um arquivo compactado zip ou tar de um repositório git. Algumas coisas que o tornam especial:

1. Você pode escolher quais arquivos ou diretórios no repositório git arquivar.
2. Ele não arquiva a .git/pasta ou nenhum arquivo não rastreado no repositório em que é executado.
3. Você pode arquivar uma ramificação, marca ou confirmação específica. Os projetos gerenciados com o git geralmente usam isso para gerar arquivos de versões do projeto (beta, release, 2.0, etc.) para download dos usuários.

Um exemplo de criação de um arquivo morto do docs/usagediretório a partir de um repositório remoto ao qual você está conectado com o ssh:

# in terminal
$ git archive --format tar --remote ssh://server.org/path/to/git HEAD docs/usage > /tmp/usage_docs.tar

Mais informações nesta postagem do blog e na documentação do git .

Nota sobre os repositórios do GitHub:

O GitHub não permite git-archiveacesso . ☹️

Eu criei um projeto de código aberto, chamado GitHubFolderDownloader . Permite baixar uma única pasta de um repositório sem clonar ou baixar o repositório inteiro.

Não há nada de errado com outras respostas, mas pensei em compartilhar instruções passo a passo para aqueles que vagam por esse processo pela primeira vez.

Como baixar uma única pasta de um repositório do github (Mac OS X):

~ Para abrir o Terminal, clique em holofotes e digite terminal e pressione enter

1. Em um Mac, você provavelmente já possui SVN (para testar apenas abra o terminal e digite "svn" ou "which svn" ~ sem as aspas)
2. No Github: Localize o caminho do Github para sua pasta git (não para o repositório) clicando no nome da pasta específica em um repositório
3. Copie o caminho da barra de endereço do navegador
4. Abra Terminal e digite: svn export
5. Em seguida, cole o endereço (por exemplo): https://github.com/mingsai/Sample-Code/tree/master/HeadsUpUI
6. Substitua as palavras: árvore / mestre
7. com a palavra: tronco
8. Digite a pasta de destino para os arquivos (neste exemplo, eu armazeno a pasta de destino dentro da pasta Downloads para o usuário atual)
9. Aqui o espaço é apenas a barra de espaço e não a palavra (espaço) ~ / Downloads / HeadsUpUI
10. O comando final do terminal mostra o comando completo para baixar a pasta (compare o endereço com a etapa 5) svn export https://github.com/mingsai/Sample-Code/trunk/HeadsUpUI ~ / Downloads / HeadsUpUI

BTW - Se você estiver no Windows ou em alguma outra plataforma, poderá encontrar um download binário do subversion (svn) em http://subversion.apache.org

~ Se você quiser fazer o checkout da pasta em vez de simplesmente fazer o download, tente usar a ajuda do svn (tldr: substitua a exportação pelo checkout )

Atualizar

Sobre o comentário sobre a retomada de um download / checkout interrompido. Eu tentaria correr svn cleanupseguido por svn update. Por favor, pesquise SO para opções adicionais.

Quem estiver trabalhando em uma pasta específica, precisará clonar a própria pasta em particular. Para isso, siga as etapas abaixo usando a verificação esparsa.

1. Crie um diretório

2. Inicialize um repositório Git. ( git init)

3. Ativar verificações esparsas. ( git config core.sparsecheckout true)

4. Diga ao Git quais diretórios você deseja (eco 2015 / brand / May (consulte a pasta na qual você deseja trabalhar) >> .git/info/sparse-checkout)

5. Adicione o controle remoto ( git remote add -f origin https://jafartke.com/mkt-imdev/DVM.git)

6. Busque os arquivos ( git pull origin master)

Você não pode; Diferentemente do Subversion, onde cada subdiretório pode ser retirado individualmente, o Git opera com base em todo o repositório.

Para projetos em que o acesso mais refinado é necessário, você pode usar submódulos - cada submódulo é um projeto Git separado e, portanto, pode ser clonado individualmente.

É concebível que um front-end do Git (por exemplo, a interface da web do GitHub ou gitweb) possa optar por fornecer uma interface para você extrair uma determinada pasta, mas que eu saiba, nenhum deles faz isso (embora eles permitam baixar arquivos individuais , portanto, se a pasta não contiver muitos arquivos, isso é uma opção)

Editar - o GitHub realmente oferece acesso via SVN, o que permitiria fazer exatamente isso (conforme comentário). Consulte https://github.com/blog/1438-improved-svn-here-to-stay-old-svn-going-away para obter instruções mais recentes sobre como fazer isso

Se você realmente deseja apenas "baixar" a pasta e não "cloná- la " (para desenvolvimento), a maneira mais fácil de obter uma cópia da versão mais recente do repositório (e, portanto, de uma pasta / arquivo), sem a necessidade de clonar o repositório inteiro ou instalar o git em primeiro lugar, é fazer o download de um arquivo zip (para qualquer repositório, bifurcação, ramificação, confirmação, etc.) acessando o repositório desejado / fork / branch / commit no GitHub (por exemplo, http(s)://github.com/<user>/<repo>/commit/<Sha1>para uma cópia dos arquivos como estavam após uma confirmação específica) e selecionar o Downloadsbotão próximo ao canto superior direito.

Esse formato de arquivo não contém nenhuma mágica do git-repo, apenas os arquivos rastreados (e talvez alguns arquivos .gitignore, se eles foram rastreados, mas você pode ignorá-los: p) - isso significa que, se o código for alterado e você desejar fique por dentro, você terá que fazer o download novamente manualmente, e também significa que você não poderá usá-lo como um repositório git ...

Não tenho certeza se é isso que você está procurando neste caso (novamente, "download" / view vs "clone" / develop), mas ainda assim pode ser útil ...

2019 Resumo

Existem várias maneiras de lidar com isso, dependendo se você deseja ou não fazer isso manual ou programaticamente.

Existem quatro opções resumidas abaixo. E para aqueles que preferem uma explicação mais prática, montei um vídeo do YouTube: Baixe arquivos e pastas individuais do GitHub .

Também publiquei uma resposta semelhante no StackOverflow para aqueles que precisam baixar arquivos únicos do GitHub (em vez de pastas).

1. Interface de usuário do GitHub

• Há um botão de download na página inicial do repositório. Obviamente, isso faz o download de todo o repositório, após o qual você precisa descompactar o download e arrastar manualmente a pasta específica necessária.

2. Ferramentas de terceiros

• Há uma variedade de extensões de navegador e aplicativos da web que podem lidar com isso, sendo o DownGit um deles. Basta colar o URL do GitHub na pasta (por exemplo https://github.com/babel/babel-eslint/tree/master/lib) e pressionar o botão "Download".

3. Subversão

• O GitHub não suporta git-archive (o recurso git que nos permitiria baixar pastas específicas). O GitHub, no entanto, suporta uma variedade de recursos do Subversion, um dos quais podemos usar para esse fim. O Subversion é um sistema de controle de versão (uma alternativa ao git). Você precisará do Subversion instalado. Pegue a URL do GitHub para a pasta que você deseja baixar. Você precisará modificar esse URL. Você deseja o link para o repositório, seguido pela palavra "tronco" e terminando com o caminho para a pasta aninhada. Em outras palavras, usando o mesmo exemplo de link de pasta que mencionei acima, substituiríamos "tree / master" por "trunk". Por fim, abra um terminal, navegue até o diretório em que deseja baixar o conteúdo e digite o seguinte comando (substituindo o URL pelo URL que você construiu):svn export https://github.com/babel/babel-eslint/trunk/libe pressione enter.

4. API do GitHub

• Esta é a solução que você precisará se desejar realizar esta tarefa programaticamente. E é isso que o DownGit está usando sob o capô. Usando a API REST do GitHub , escreva um script que faça uma solicitação GET no terminal de conteúdo. O ponto final pode ser construído como se segue: https://api.github.com/repos/:owner/:repo/contents/:path. Depois de substituir os espaços reservados, um exemplo de terminal é:https://api.github.com/repos/babel/babel-eslint/contents/lib. Isso fornece dados JSON para todo o conteúdo existente nessa pasta. Os dados têm tudo o que você precisa, incluindo se o conteúdo é ou não uma pasta ou arquivo, um URL de download, se for um arquivo, e um ponto de extremidade da API, se for uma pasta (para que você possa obter os dados dessa pasta). Usando esses dados, o script pode percorrer recursivamente todo o conteúdo da pasta de destino, criar pastas para pastas aninhadas e baixar todos os arquivos de cada pasta. Confira o código do DownGit para se inspirar.

Outro exemplo específico:

Como eu quero baixar a pasta 'iOS Pro Geo' a partir do URL

https://github.com/alokc83/APRESS-Books-Source-Code-/ tree / master /% 20Pro% 20iOS% 20Geo

e eu posso fazer isso via

svn checkout https://github.com/alokc83/APRESS-Books-Source-Code-/trunk/%20Pro%20iOS%20Geo

Observe o tronco no caminho

Editado: (conforme comentário de Tommie C)

Sim, usar a exportação em vez do checkout daria uma cópia limpa sem arquivos extras do repositório git.

svn export https://github.com/alokc83/APRESS-Books-Source-Code-/trunk/%20Pro%20iOS%20Geo

Editado: se a árvore / mestre não estiver no URL, bifurque-o e ele estará lá no URL bifurcado.

Existe um pacote pip Python3 chamado githubdlque pode fazer isso *:

export GIT_TOKEN=1234567890123456789012345678901234567890123
pip install githubdl
githubdl -u http://github.com/foobar/test -d foo

A página do projeto está aqui

* Aviso: eu escrevi este pacote.

É um dos poucos lugares onde o SVN é melhor que o Git.

No final, gravitamos em direção a três opções:

1. Use o wget para obter os dados do GitHub (usando a visualização de arquivo bruto).
2. Faça com que os projetos upstream publiquem o subconjunto de dados necessário como artefatos de construção.
3. Desista e use o checkout completo. É um grande sucesso na primeira compilação, mas, a menos que você tenha muito tráfego, não há muita dificuldade nas compilações a seguir.

Se você se sente confortável com os comandos unix, não precisa de dependências especiais ou aplicativos da web para isso. Você pode fazer o download do repositório como um tarball e descompactar apenas o necessário.

Exemplo (arquivos woff2 de um subdiretório em fontawesome):

curl -L https://api.github.com/repos/FortAwesome/Font-Awesome/tarball | tar xz --wildcards "*/web-fonts-with-css/webfonts/*.woff2" --strip-components=3

• Mais sobre o formato do link: https://developer.github.com/v3/repos/contents/#get-archive-link (incluindo como obter um arquivo zip ou ramificações / refs específicas)
• Mantenha a parte inicial do caminho ( */) para corresponder a qualquer diretório. O Github cria um diretório de wrapper com o commit ref no nome, portanto ele não pode ser conhecido.
• Você provavelmente quer --strip-componentsser igual à quantidade de barras ( /) no caminho (argumento anterior).

Isso fará o download do pacote completo. Use o método SVN mencionado nas outras respostas se isso tiver que ser evitado ou se você quiser ser legal com os servidores GitHub.

Você pode fazer um download simples da árvore de diretórios:

git archive --remote git@github.com:foobar/Test.git HEAD:foo | tar xf -

Mas se você quiser dar uma olhada e conseguir fazer commit e empurrá-los de volta, não, não pode fazer isso.

Apenas para amplificar as respostas acima, um exemplo real de um repositório GitHub real para um diretório local seria:

svn ls https://github.com/rdcarp/playing-cards/trunk/PumpkinSoup.PlayingCards.Interfaces

svn export https://github.com/rdcarp/playing-cards/trunk/PumpkinSoup.PlayingCards.Interfaces  /temp/SvnExport/Washburn

Às vezes, um exemplo concreto ajuda a esclarecer as substituições propostas.

Nenhuma das respostas ajudou na minha situação. Se você está desenvolvendo para o Windows, provavelmente não possui o svn. Em muitas situações, não é possível contar com os usuários para que o Git esteja instalado ou não desejar baixar repositórios inteiros por outros motivos. Algumas das pessoas que responderam a essa pergunta, como Willem van Ketwich e aztack, criaram ferramentas para realizar essa tarefa. No entanto, se a ferramenta não foi escrita para o idioma que você está usando ou se não deseja instalar uma biblioteca de terceiros, elas não funcionam.

No entanto, existe uma maneira muito mais fácil. O GitHub possui uma API que permite baixar um único arquivo ou o conteúdo de um diretório inteiro usando solicitações GET . Você pode acessar um diretório usando https://api.github.com/repos/:owner/:repo_name/contents/:pathque retorna um objeto JSON enumerando todos os arquivos no diretório Incluído na enumeração, há um link para o conteúdo bruto do arquivo, o download_urlparâmetro O arquivo pode ser baixado usando esse URL.

É um processo de duas etapas que requer a capacidade de fazer solicitações GET, mas isso pode ser implementado em praticamente qualquer idioma, em qualquer plataforma. Pode ser usado para obter arquivos ou diretórios.

Nossa equipe escreveu um script bash para fazer isso porque não queríamos instalar o SVN em nosso servidor bare bones.

https://github.com/ojbc/docker/blob/master/java8-karaf3/files/git-download.sh

Ele usa a API do github e pode ser executado na linha de comando da seguinte maneira:

git-download.sh https://api.github.com/repos/ojbc/main/contents/shared/ojb-certs

Eu uso o linux, coloque isso em ~ / .bashrc, chamado even: D $ HOME / .bashrc

git-dowloadfolder(){
a="$1"
svn checkout ${a/tree\/master/trunk}

}

atualize o shell com

source ~/.bashrc 

use-o com o git-downloadfolder blablabla: D

Eu trabalho com servidores CentOS 7 nos quais não tenho acesso root, nem git, svn, etc (nem quero!), Então criei um script python para baixar qualquer pasta do github: https://github.com/andrrrl/github -folder-downloader

O uso é simples, basta copiar a parte relevante de um projeto do github, digamos que o projeto seja https://github.com/MaxCDN/php-maxcdn/ , e você deseja uma pasta em que apenas alguns arquivos de origem sejam necessários, é necessário faça algo como:

$ python gdownload.py "/MaxCDN/php-maxcdn/tree/master/src" /my/target/dir/
(criará a pasta de destino se não existir)

Requer biblioteca lxml , pode ser instalado com easy_install lxml
Se você não tiver acesso root (como eu), poderá criar um .pydistutils.pyarquivo no seu $HOMEdiretório com o seguinte conteúdo: [install] user=1 E easy_install lxmlfuncionará apenas (ref: https://stackoverflow.com/a/ 33464597/591257 ).

Apenas 5 etapas a seguir

1) Baixar SVN partir de aqui .
2) Abra o CMD e vá para o diretório bin SVN como abaixo:

cd %ProgramFiles%\SlikSvn\bin

3) Vamos supor que eu wan para baixar este diretório URL 4) Agora Substituir Com 5) Agora disparar este último comando à pasta de download no mesmo diretório.

https://github.com/ZeBobo5/Vlc.DotNet/tree/develop/src/Samples

tree/develop
or
tree/master

trunk

svn export https://github.com/ZeBobo5/Vlc.DotNet/trunk/src/Samples

Para exportar um diretório do GitHub, substitua "/ tree / master /" na URL do diretório por "/ trunk /".

Por exemplo, para exportar o diretório da seguinte URL:

https://github.com/liferay/liferay-plugins/tree/master/portlets/sample-hibernate-portlet

execute o seguinte comando:

svn export https://github.com/liferay/liferay-plugins/trunk/portlets/sample-hibernate-portlet

Uma resposta direta a isso é primeiro tortoise svn a partir do link a seguir.

https://tortoisesvn.net/downloads.html

durante a instalação, ative a opção CLI, para que possa ser usada na interface da linha de comandos.

copie o link do subdiretório git hub.

Exemplo

https://github.com/tensorflow/models/tree/master/research/deeplab

substituir árvore / mestre por tronco

https://github.com/tensorflow/models/trunk/research/deeplab

e fazer

svn checkout https://github.com/tensorflow/models/trunk/research/deeplab

os arquivos serão baixados para a pasta deeplab no diretório atual.

você pode usar o git svn da seguinte maneira.

git svn clone https://github.com/lodash/lodash/trunk/test

Dessa forma, você não precisa se preocupar em definir o svn, especificamente para usuários do Windows.

Se você precisar fazer isso de forma programática e não quiser confiar no SVN, poderá usar a API do GitHub para baixar todo o conteúdo recursivamente.

Para inspiração, aqui está a minha essência do ruby: https://gist.github.com/cvengros/b2a7e82f66519d423b6f

Use esta função, o primeiro argumento é o URL da pasta, o segundo é o local para o qual a pasta será baixada:

function github-dir() {
    svn export "$(sed 's/tree\/master/trunk/' <<< "$1")" "$2"  
}

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

Foi feita uma extensão ao protocolo remoto Git para suportar esse recurso na v2.19.0, mas não há suporte para o servidor no momento. Mas já pode ser testado localmente.

Eu cobri isso com mais detalhes em: Como clonar um subdiretório apenas de um repositório Git?

Por qualquer motivo, a svnsolução não funciona para mim e, como não preciso de svnmais nada, não fazia sentido gastar tempo tentando fazê-lo, então procurei uma solução simples usando as ferramentas que já possuía. Este script usa apenas curle awkpara baixar todos os arquivos em um diretório do GitHub descrito como "/:user:repo/contents/:path".

O corpo retornado de uma chamada para o "GET /repos/:user:repo/contents/:path"comando API REST do GitHub retorna um objeto que inclui um "download_url"link para cada arquivo em um diretório.

Esse script de linha de comando chama a API REST usando curle envia o resultado por meio do AWK, que filtra todas as linhas, exceto as "download_url", apaga aspas e vírgulas dos links e baixa os links usando outra chamada para curl.

curl -s https://api.github.com/repos/:user/:repo/contents/:path | awk \
     '/download_url/ { gsub("\"|,", "", $2); system("curl -O "$2"); }'

git sparse-checkout

O Git 2.25.0 inclui um novo git sparse-checkoutcomando experimental que facilita o uso do recurso existente, além de alguns importantes benefícios de desempenho para grandes repositórios. ( O blog do GitHub )

Exemplo com versão atual :

git clone --filter=blob:none --sparse https://github.com/git/git.git
cd git
git sparse-checkout init --cone
git sparse-checkout add t

Mais notavelmente

• --sparseverifica apenas os arquivos de diretório de nível superior do gitrepositório na cópia de trabalho
• git sparse-checkout add tadiciona / verifica incrementalmente a tsubpasta degit

Outros elementos

• git sparse-checkout init faz alguns preparativos para permitir checkouts parciais
• --filter=blob:noneotimiza a busca de dados baixando apenas os objetos git necessários (veja o recurso de clone parcial para obter mais informações)
• --cone também acelera o desempenho aplicando padrões de inclusão de arquivo mais restritos

Status do GitHub

O GitHub ainda está avaliando esse recurso internamente, enquanto está ativado em alguns poucos repositórios [...]. À medida que o recurso se estabiliza e amadurece, manteremos você atualizado com seu progresso. ( docs )