web-dev-qa-db-fra.com

Comment extraire de manière clairsemée un seul fichier d'un dépôt git?

Comment puis-je extraire un seul fichier d'un dépôt Git?

378
Arthur Ulfeldt

À l’origine, j’avais mentionné en 2012 git archive (voir Jared Forsyth - réponse et Robert Knight 's réponse ), depuis git1.7.9.5 (mars 2012) , Paul Brannan 's réponse :

_git archive --format=tar --remote=Origin HEAD:path/to/directory -- filename | tar -O -xf -
_

Mais: en 2013, ce n'était plus possible pour les URL https://github.com distantes .
Voir l'ancienne page " Puis-je archiver un référentiel? "

La page actuelle (2018) " À propos de l'archivage du contenu et des données sur GitHub " recommande d'utiliser des services tiers, tels que GHTorrent ou GH Archive .


Ainsi, vous pouvez également utiliser des copies/clones locaux:

Vous pouvez également procéder comme suit si vous avez une copie locale du référentiel nu, comme indiqué dans cette réponse ,

_git --no-pager --git-dir /path/to/bar/repo.git show branch:path/to/file >file
_

Ou vous devez d'abord cloner le référentiel, ce qui signifie que vous obtenez l'historique complet: - dans le référentiel .git - dans l'arborescence de travail.

  • Mais alors vous pouvez faire un contrôle clairsemé (si vous utilisez Git1.7 +),:
    • activer l'option de paiement fractionné (_git config core.sparsecheckout true_)
    • ajout de ce que vous voulez voir dans le fichier _.git/info/sparse-checkout_
    • relire l'arbre de travail pour n'afficher que ce dont vous avez besoin

Pour relire l’arbre de travail:

_$ git read-tree -m -u HEAD
_

De cette façon, vous vous retrouvez avec un arbre de travail incluant exactement ce que vous voulez (même s'il ne s'agit que d'un fichier)

241
VonC

Commencez par cloner le référentiel avec l'option -n, qui supprime l'extraction par défaut de tous les fichiers, et l'option --depth 1, ce qui signifie qu'il ne récupère que la révision la plus récente de chaque fichier.

git clone -n git://path/to/the_repo.git --depth 1

Ensuite, consultez uniquement le fichier que vous souhaitez:

cd the_repo
git checkout HEAD name_of_file
167
Nick Moore

Si vous avez déjà une copie du référentiel git, vous pouvez toujours extraire une version d'un fichier en utilisant un git log pour connaître l'id de hachage (par exemple, 3cdc61015724f9965575ba954c842dc32b42e4), puis tapez simplement:

git checkout hash-id path-to-file

Voici un exemple concret:

git checkout 3cdc61015724f9965575ba954c8cd4232c8b42e4 /var/www/css/page.css
100
techexpert

Normalement, il n'est pas possible de télécharger un seul fichier de git sans télécharger le référentiel entier comme suggéré dans la première réponse .. C'est parce que Git ne stocke pas les fichiers comme vous le pensez (comme le fait CVS/SVN), mais il les génère sur toute l'histoire du projet.

Mais il existe des solutions de contournement pour des cas spécifiques. Voir ci-dessous:

GitHub

Si ce fichier se trouve sur github.com, essayez par exemple:

wget https://raw.githubusercontent.com/user/project/master/README

GitWeb

Si vous utilisez Git sur le serveur - GitWeb , vous pouvez essayer par exemple (changez-le dans le bon chemin):

wget "http://example.com/gitweb/?p=example;a=blob_plain;f=README.txt;hb=HEAD"

GitWeb à drupalcode.org

Exemple:

wget "http://drupalcode.org/project/ads.git/blob_plain/refs/heads/master:/README.md"

googlesource.com

Il existe une fonctionnalité non documentée qui vous permet de télécharger des versions encodées en base64 de fichiers raw:

curl "https://chromium.googlesource.com/chromium/src/net/+/master/http/transport_security_state_static.json?format=TEXT" | base64 --decode

Dans d'autres cas, vérifiez si votre référentiel Git utilise des interfaces Web.

Si aucune interface Web n’est utilisée, vous pouvez envisager de transmettre votre code à des services externes tels que GitHub , Bitbucket , etc . et l'utiliser comme un miroir.

Si vous n'avez pas installé wget, essayez également curl -O (url).

45
kenorb

git checkout branch_or_version - chemin/fichier

exemple: git checkout HEAD -- main.c

36
36
Geoffrey Hale

Maintenant nous pouvons! Comme c'est le premier résultat sur google, j'ai pensé mettre à jour le tout à la dernière version. Avec l’arrivée de git 1.7.9.5, nous avons la commande git archive qui vous permettra de récupérer un fichier unique à partir d’un hôte distant.

git archive --remote=git://git.foo.com/project.git HEAD:path/in/repo filename | tar -x

Voir la réponse complète ici https://stackoverflow.com/a/5324532/290784

23
Jared Forsyth

Travailler dans GIT 1.7.2.2

Par exemple, vous avez un some_remote à distance avec des branches branche1 , branche32

donc pour extraire un fichier spécifique vous appelez cette commande:

git checkout remote/branch path/to/file

à titre d'exemple, ce sera quelque chose comme ça

git checkout some_remote/branch32 conf/en/myscript.conf
git checkout some_remote/branch1 conf/fr/load.wav

Cette commande va copier toute la structure de fichier conf/fr et conf/fr dans le répertoire courant où vous appelez ces commandes (bien sûr, je suppose que vous avez déjà exécuté git init à un moment donné)

21
anvk

Très simple:

git checkout from-branch-name -- path/to/the/file/you/want

Cela ne vérifiera pas la branche from-branch-name. Vous resterez sur la branche sur laquelle vous vous trouvez et seul ce fichier sera extrait de la branche spécifiée.

Voici la partie pertinente de la page de manuel pour git-checkout

git checkout [-p|--patch] [<tree-ish>] [--] <pathspec>...
       When <paths> or --patch are given, git checkout does not switch
       branches. It updates the named paths in the working tree from the
       index file or from a named <tree-ish> (most often a commit). In
       this case, the -b and --track options are meaningless and giving
       either of them results in an error. The <tree-ish> argument can be
       used to specify a specific tree-ish (i.e. commit, tag or tree) to
       update the index for the given paths before updating the working
       tree.

Chapeau de chapeau à Ariejan de Vroom qui m’a appris cela à partir de ce blog post .

12
broc.seib

Vous pouvez le faire par

git archive --format=tar --remote=Origin HEAD | tar xf -
git archive --format=tar --remote=Origin HEAD <file> | tar xf -
6
Fizer Khan

Deux variantes sur ce qui a déjà été donné:

git archive --format=tar --remote=git://git.foo.com/project.git HEAD:path/to/directory filename | tar -O -xf -

et:

git archive --format=Zip --remote=git://git.foo.com/project.git HEAD:path/to/directory filename | funzip

Ceux-ci écrivent le fichier sur la sortie standard.

5
Paul Brannan

Dites que le nom du fichier est 123.txt, cela fonctionne pour moi:

git checkout --theirs  123.txt

Si le fichier se trouve dans un répertoire A, assurez-vous de le spécifier correctement:

git checkout --theirs  "A/123.txt"
5
Joseph Wu

git clone --filter à partir de Git 2.19

En réalité, cette option évite d’extraire du serveur les objets les plus inutiles:

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

Le serveur doit être configuré avec:

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

À partir de la v2.19.0, le serveur ne prend pas en charge le serveur, mais il peut déjà être testé localement.

TODO: --filter=blob:none ignore tous les blobs, mais récupère tous les objets de l’arbre. Mais sur un repo normal, cela devrait être minuscule comparé aux fichiers eux-mêmes, donc c'est déjà assez bon. Interrogé à: https://www.spinics.net/lists/git/msg342006.html Devs a répondu qu'un --filter=tree:0 est en cours de réalisation.

Rappelez-vous que --depth 1 implique déjà --single-branch, voir aussi: Comment cloner une seule branche dans Git?

file://$(path) est nécessaire pour surmonter les shenanigans du protocole git clone: Comment cloner de manière superficielle un référentiel git local avec un chemin relatif?

Le format de --filter est documenté sur man git-rev-list

Une extension du protocole distant Git a été réalisée pour prendre en charge cette fonctionnalité.

Documents sur l'arbre Git:

Testez-le

#!/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 file from internet"
mv ../server_repo.off ../server_repo
git checkout master -- d1/a
echo

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

GitHub en amont .

Sortie dans 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
?f70a17f51b7b30fec48a32e4f19ac15e261fd1a4
?8b25206ff90e9432f6f1a8600f87a7bd695a24af
?41484c13520fcbb6e7243a26fdb1fc9405c08520
?0975df9b39e23c15f63db194df7f45c76528bccb

Conclusions: tous les blobs sauf d1/a sont manquants. Par exemple. f70a17f51b7b30fec48a32e4f19ac15e261fd1a4, qui est d1/b, n'est pas là après avoir extrait d1/.

Notez que root/root et mybranch/mybranch sont également manquants, mais --depth 1 le masque dans la liste des fichiers manquants. Si vous supprimez --depth 1, ils apparaissent dans la liste des fichiers manquants.

En général, vous ne «vérifiez» pas les fichiers avant de les mettre à jour - il semble que ce soit ce que vous recherchez.

De nombreux systèmes tels que clearcase, csv, etc. vous obligent à "extraire" un fichier avant de pouvoir le modifier. Git n'en a pas besoin. Vous clonez un référentiel, puis apportez des modifications à votre copie locale du référentiel.

Une fois que vous avez mis à jour les fichiers, vous pouvez faire:

git status

Pour voir quels fichiers ont été modifiés. Vous ajoutez d'abord ceux que vous voulez commettre à index avec (index est comme une liste à archiver):

git add .

ou

git add blah.c

Ensuite, do git status vous montrera quels fichiers ont été modifiés et lesquels sont dans index prêts à être validés ou archivés.

Pour valider des fichiers sur votre copie de référentiel, procédez comme suit:

git commit -a -m "commit message here"

Voir git website pour des liens vers des manuels et des guides.

4
stefanB

Voici la solution complète pour extraire et pousser uniquement un fichier particulier dans le référentiel git:

  1. Tout d’abord, vous devez cloner le dépôt git avec un indice spécial: pas de commande
git clone --no-checkout <git url>
  1. L'étape suivante consiste à supprimer les fichiers non mis en scène dans le référentiel à l'aide de la commande:
git reset
  1. Maintenant, vous êtes autorisé à extraire les fichiers que vous souhaitez modifier avec la commande:
git checkout Origin/master <path to file>
  1. Le dossier du référentiel contient maintenant des fichiers que vous pouvez commencer à modifier immédiatement. Après l’édition, vous devez exécuter une séquence de commandes simple et familière.
git add <path to file>
git commit -m <message text>
git Push

Voir aussi un link pour plus d’informations.

2
ripreal

Si vous avez besoin d’un fichier spécifique d’une branche spécifique d’un référentiel Git distant, la commande est la suivante:

git archive --remote=git://git.example.com/project.git refs/heads/mybranch path/to/myfile |tar xf -

Le reste peut être dérivé de la réponse de @VonC:

Si vous avez besoin d’un fichier spécifique de la branche principale, c’est:

git archive --remote=git://git.example.com/project.git HEAD path/to/myfile |tar xf -

Si vous avez besoin d'un fichier spécifique à partir d'une balise c'est:

git archive --remote=git://git.example.com/project.git mytag path/to/myfile |tar xf -
1
Alex Harvey

On dirait que vous essayez de transférer une idée du contrôle de version centralisé, ce que git ne fait pas par nature - elle est distribuée. Si vous souhaitez utiliser un référentiel git, vous le clonez. Vous avez alors all du contenu de l’arbre de travail et all de l’historique (enfin, tout du moins jusqu’à la pointe de la branche actuelle), et non pas un seul fichier ou un instantané à partir d'un seul commit.

 git clone /path/to/repo
 git clone git://url/of/repo
 git clone http://url/of/repo
1
Cascabel

Si vous avez seulement besoin de télécharger le fichier, pas besoin de vérifier avec Git.

GitHub Mate est beaucoup plus facile à faire, c’est une extension Chrome, vous permet de cliquer sur l’icône du fichier pour le télécharger. aussi open source

0
Cam Song

Je ne vois pas ce qui a fonctionné pour moi qui est répertorié ici, donc je vais l’inclure si quelqu'un se trouve dans ma situation.

Dans ma situation, j’ai un référentiel distant d’environ 10 000 fichiers et j’ai besoin de créer un fichier RPM pour mon système Linux. La construction du RPM inclut un clone git de tout. Tout ce dont j'ai besoin, c'est d'un fichier pour démarrer la compilation de RPM. Je peux cloner l'intégralité de l'arborescence des sources, ce qui correspond à mes besoins, mais le téléchargement de tous ces fichiers prend deux minutes de plus, alors qu'il ne me en faut qu'un. J'ai essayé d'utiliser l'option d'archivage git décrite et j'ai obtenu le message "fatal: opération non prise en charge par le protocole". il est difficile de faire avancer les choses.

Ce que j’ai finalement fait, c’est que je suis entré dans l’interface Web de bitbucket et que j’ai visualisé le fichier dont j’avais besoin. J'ai fait un clic droit sur le lien pour télécharger une copie brute du fichier et j'ai sélectionné le "raccourci de copie" dans la fenêtre contextuelle résultante. Je ne pouvais pas simplement télécharger le fichier brut car j’avais besoin d’automatiser les choses et je n’ai pas d’interface de navigateur sur mon serveur Linux.

À des fins de discussion, cela a abouti à l'URL:

https://ourArchive.ourCompany.com/projects/ThisProject/repos/data/raw/foo/bar.spec?at=refs%2Fheads%2FTheBranchOfInterest

Je ne pouvais pas télécharger directement ce fichier à partir du référentiel bitbucket car je devais d'abord me connecter. Après quelques recherches, j'ai trouvé que cela fonctionnait: Sous Linux:

echo "myUser:myPass123"| base64
bXlVc2VyOm15UGFzczEyMwo=

curl -H 'Authorization: Basic bXlVc2VyOm15UGFzczEyMwo=' 'https://ourArchive.ourCompany.com/projects/ThisProject/repos/data/raw/foo/bar.spec?at=refs%2Fheads%2FTheBranchOfInterest' > bar.spec

Cette combinaison m'a permis de télécharger le fichier dont j'avais besoin pour tout compiler.

0
user1683793

J'ajoute cette réponse au lieu de faire une vérification formelle ou une opération locale similaire. En supposant que vous ayez accès à l'interface Web de votre fournisseur Git, vous pourrez peut-être visualiser directement n'importe quel fichier à la validation souhaitée. Par exemple, sur GitHub, vous pouvez utiliser quelque chose comme:

https://github.com/hubotio/hubot/blob/ed25584f/src/adapter.coffee

Ici ed25584f sont les 8 premiers caractères du hachage SHA-1 du commit d'intérêt, suivis du chemin d'accès au fichier source.

De même, sur Bitbucket, nous pouvons essayer:

https://bitbucket.org/cofarrell/stash-browse-code-plugin/src/06befe08

Dans ce cas, nous plaçons le hash de commit à la fin de l'URL source.

0
Tim Biegeleisen