Est git semi-secret arbre vide d'objet fiable, et pourquoi n'est-il pas un nom symbolique pour elle?

Git a bien connu, ou au moins un peu-de-bien-connu, arbre vide dont le SHA1 est:

4b825dc642cb6eb9a060e54bf8d69288fbee4904

(vous pouvez les voir dans toute repo, même un nouveau, avec git cat-file -t et git cat-file -p).

Si vous travaillez dur et sont très prudent, vous pouvez sorte de l'utilisation de cet arbre vide pour stocker un répertoire qui n'a pas de fichiers (voir réponse à Comment puis-je ajouter un répertoire vide dans un dépôt git), bien qu'il n'est pas vraiment une bonne idée.

Il est plus utile comme un argument pour git diff-tree, dont l'un des exemples les crochets ne.

Ce que je me demande,

  1. quelle est la fiabilité de ce—c'est à dire, certaines future version de git pas un git objet numéroté 4b825dc642cb6eb9a060e54bf8d69288fbee4904?
  2. Pourquoi n'est-il pas le nom symbolique de l'arbre vide (ou est-il un?).

(D'une façon rapide et sale pour créer un nom symbolique est de mettre le SHA1, par exemple, .git/Nulltree. Malheureusement, vous avez à faire cela pour toutes les pensions. Semble mieux de mettre juste le nombre magique dans les scripts, etc. J'ai une aversion générale à la magie des nombres.)

  • juste pour se souvenir de la valeur de hachage 😉 utiliser SHA1("l'arbre 0\0") = 4b825dc642cb6eb9a060e54bf8d69288fbee4904 (\0 est NUL personnage)
  • le git hash-object -t tree /dev/null méthode (à partir de VonC la réponse ci-dessous) a l'avantage de ne pas coder en dur SHA-1, dans le cas ou une future version de git commutateurs à SHA-2, par exemple. (Je ne vais pas tenter de prédire quand cela pourrait se produire. 🙂 Il serait plus facile de passer Mercurial SHA-2, depuis qu'ils ont quitté la place.)
  • de la cause, vous avez raison, mais c'est un bon morceau de "la Connaissance Inutile" et qu'elle est utile en tout cas pour quelqu'un d'autre?!
  • ressemble à l'algorithme de hachage de basculement peut se produire plus tôt que prévu. 🙂
  • En parlant de "l'avenir de la version de Git", je pense que vous serez intéressé dans mon dernier (Déc. 2017) modifier pour mon 2012 réponse: stackoverflow.com/revisions/9766506/7
InformationsquelleAutor torek | 2012-03-19
  1. 96

    Ce fil mentionne:

    Si vous ne vous souvenez pas de l'arbre vide sha1, vous pouvez toujours tirer avec:

    git hash-object -t tree /dev/null

    Ou, comme Ciro Santilli propose dans les commentaires:

    printf '' | git hash-object --stdin -t tree

    Ou, comme vu ici, de Colin Schimmelfing:

    git hash-object -t tree --stdin < /dev/null

    Donc je suppose qu'il est plus sûr de définir une variable avec le résultat de cette commande comme votre vide sha1 de l'arbre (au lieu de dépendre d'un "bien connu de la valeur").

    Remarque, vous verrez que SHA1 pop-up sur certains dépôt GitHub quand l'auteur veut d'abord s'engager à être vide (voir le post de blog "Comment j'initialise mon dépôts Git"):

    $ GIT_AUTHOR_DATE="Thu, 01 Jan 1970 00:00:00 +0000" GIT_COMMITTER_DATE="Thu, 01 Jan 1970 00:00:00 +0000" git commit --allow-empty -m 'Initial commit'

    Vous donnera:

    Est git semi-secret arbre vide d'objet fiable, et pourquoi n'est-il pas un nom symbolique pour elle?

    (Voir l'arbre SHA1?)

    Vous pouvez même rebase votre histoire sur le dessus de ce vide s'engager (voir "git: comment insérer un commit comme la première, fait passer tous les autres?")

    Dans les deux cas, vous ne comptez pas sur l'exacte valeur SHA1 de l'arbre vide.

    Il vous suffit de suivre un les meilleures pratiques, l'initialisation de votre pension avec un premier vide commettre.

    À faire:

    git init my_new_repo
cd my_new_repo
git config user.name username
git config user.email email@com

git commit --allow-empty -m "initial empty commit"

    Qui permettra de générer un commit avec un SHA1 spécifiques à votre repo, nom d'utilisateur, e-mail, date de la création (ce qui signifie le SHA1 de la livraison lui-même sera différent à chaque fois).

    Mais l'arbre référencé par ce commit sera 4b825dc642cb6eb9a060e54bf8d69288fbee4904, l'arbre vide SHA1.

    git log --pretty=raw

commit 9ed4ff9ac204f20f826ddacc3f85ef7186d6cc14
tree 4b825dc642cb6eb9a060e54bf8d69288fbee4904      <====
author VonC <[email protected]> 1381232247 +0200
committer VonC <[email protected]> 1381232247 +0200

    initial empty commit

    À afficher l'arborescence d'un commit (affichage de la validation de l'arbre SHA1):

    git show --pretty=format:%T 9ed4ff9ac204f20f826ddacc3f85ef7186d6cc14
4b825dc642cb6eb9a060e54bf8d69288fbee4904

    Si ce commit, le référencement d'un arbre vide, est en effet votre première engager, vous pouvez montrer que l'arbre vide SHA1 avec:

    git log --pretty=format:%h --reverse | head -1 | xargs git show --pretty=format:%T
4b825dc642cb6eb9a060e54bf8d69288fbee4904

    (et qui fonctionne même sur Windows, avec Gnu Sous Windows commandes)

    Comme commenté ci-dessous, à l'aide de git diff <valider> HEAD, cela permettra de montrer à tous vos fichiers dans le CHEF de la direction générale:

    git diff --name-only 4b825dc642cb6eb9a060e54bf8d69288fbee4904 HEAD

    Note: arbre vide valeur est officiellement défini dans cache.h.

    #define EMPTY_TREE_SHA1_HEX \
    "4b825dc642cb6eb9a060e54bf8d69288fbee4904"

    Depuis Git 2.16 (T1 2018), il est utilisé dans une structure qui n'est plus liée à (seulement) SHA1, comme on le voit dans s'engager eb0ccfd:

    Commutateur arbre vide et blob recherches pour utiliser hachage abstraction

    Basculer l'utilise de empty_tree_oid et empty_blob_oid d'utiliser le current_hash abstraction qui représente l'algorithme de hachage en
    utiliser.

    Voir plus à "Pourquoi ne pas utiliser Git plus moderne SHA?": il est SHA-2, depuis Git 2.19 (T3 2018)

    Avec Git 2.25 (T1 2020), les tests sont en préparation pour un SHA-2 transition, et impliquant l'arbre vide.

    Voir s'engager fa26d5e, s'engager cf02be8, s'engager 38ee26b, s'engager 37ab8eb, s'engager 0370b35, s'engager 0253e12, s'engager 45e2ef2, s'engager 79b0edc, s'engager 840624f, s'engager 32a6707, s'engager 440bf91, s'engager 0b408ca, s'engager 2eabd38 (28 Oct 2019), et s'engager 1bcef51, s'engager ecde49b (05 Oct 2019) par brian m. carlson (bk2204).

    (Fusionnés par Junio C Hamano -- gitster -- dans s'engager 28014c1, 10 Novembre 2019)

    t/oid-info: ajouter arbre vide et vide de valeurs blob

    Signed-off-by: brian m. carlson

    De la suite de tests finira par apprendre à exécuter à l'aide d'un algorithme autre que SHA-1. En préparation pour ce faire, enseigner la test_oid famille de fonctions de la façon de regarder le vide blob et arbre vide, de sorte qu'ils peuvent être utilisés.

    Donc t/oid-info/hash-info comprend maintenant:

    rawsz sha1:20
rawsz sha256:32

hexsz sha1:40
hexsz sha256:64

zero sha1:0000000000000000000000000000000000000000
zero sha256:0000000000000000000000000000000000000000000000000000000000000000

algo sha1:sha1
algo sha256:sha256

empty_blob sha1:e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
empty_blob sha256:473a0f4c3be8a93681a267e3b1e9a7dcda1185436fe141f7749120a303721813

empty_tree sha1:4b825dc642cb6eb9a060e54bf8d69288fbee4904
empty_tree sha256:6ef19b41225c5369f1c104d45d8d85efa9b057b53b14b4b9b939dd74decc5321

    La SHA2 "6ef19b41225c5369f1c104d45d8d85efa9b057b53b14b4b9b939dd74decc5321" est le nouveau SHA1 "4b825dc642cb6eb9a060e54bf8d69288fbee4904" arbre vide.

    • J'ai ajouté quelques exemples arund le premier vide commettre des meilleures pratiques pour illustrer que l'arbre vide SHA1.
    • Ainsi, l'un des objectifs est d'utiliser le "vide arbre de hachage comme un argument de git diff-tree dans certains scripts je suis en train d'écrire. Il n'y a aucune garantie qu'il y a un vide initial s'engager dans l'opération. Donc, je me demandais simplement si ces scripts peuvent finissent par rompre un jour.
    • Si vous passer -w à git hash-object, il va créer l'objet dans le référentiel il est dirigé contre l', et qui permettrait de recréer l'arbre vide dans le référentiel, vous êtes en cours d'exécution contre, s'il devait jamais aller aussi loin dans l'avenir.
    • Si vous voulez aller de l'avant de la première valider à l'aide de cela, vous pouvez utiliser git rebase --root
    • en effet: je le mentionne dans stackoverflow.com/a/598788/6309, avec git 1.7.12+.
    • Ou si vous préférez la magie de tubes à la place de la magie de /dev/null: printf '' | git hash-object --stdin -t tree 🙂
    • Je ne suis pas ajouter beaucoup pour votre réponse, mais juste un avis, une autre façon de tirer, il serait git mktree < /dev/null. Les deux git hash-object et cela donne le même résultat final.
    • Cela signifierait donc si je fais un git diff entre une succursale et les commit - il m'indiquer ce que l'opération ressemble à la branche?
    • Oui. Un git diff --name-only 4b825dc642cb6eb9a060e54bf8d69288fbee4904 serait d'afficher la liste de tous les fichiers présents de l'onu, l'actuel CHEF de la direction générale.
    • Ah, je vous remercie. Mon seul problème est qu'il me donne tous les fichiers qui ont existé dans le repo. Je veux seulement les fichiers qui existent actuellement. Par exemple, si vous ajoutez un fichier, puis de le retirer dans un avenir commit - cette commande diff continue à afficher le fichier ajouté.
    • diff <options> <hash> compare la donnée de hachage, ce qui peut être l'arbre vide, à la travail actuel-tree, de ne pas le HEAD commettre. Vous devez git diff <options> <hash> HEAD pour le second.
    • Vrai. J'ai ajouté la commande complète dans la réponse pour plus de visibilité.

    InformationsquelleAutor VonC
  2. 3

    J'ai écrit un billet de blog avec deux différentes façons de trouver le hash: http://colinschimmelfing.com/blog/gits-empty-tree/

    Si elle devait jamais changer pour une raison quelconque, vous pouvez l'utiliser de deux manières ci-dessous pour trouver. Cependant, que je me sens assez confiant dans l'utilisation du hachage .bashrc alias, etc., et je ne pense pas qu'il va changer de sitôt. À tout le moins, il serait probablement une version majeure de git.

    Les deux façons de faire sont:

    1. La réponse ci-dessus: git hash-object -t tree --stdin < /dev/null
    2. Simplement initing un vide repo, puis en exécutant git write-tree dans ce nouveau repo - le hachage sera sortie par git écriture de l'arbre.
    • L'exécution de la commande avec –-stdin me donne fatal: Cannot open '–-stdin': No such file or directory avec git 2.7.2. Toutefois, l'exécution sans --stdin comme dans VonC réponse que donne la valeur de hachage
    • Cette réponse n'est pas très utile maintenant, le blog-post est mort. C'est pourquoi nous n'avons généralement pas approuver de ces réponses, DONC.
    • le blog n'est pas mort, mais en tout emballé, j'inclus les deux façons de faire dans ma réponse - je suis d'accord que sans y compris ceux de deux façons, il ne serait pas une bonne réponse.
    InformationsquelleAutor schimmy
  3. 3

    Voici la réponse sur la façon de créer arbre vide s'engager, même dans le cas où le référentiel n'est pas déjà vide.
    https://stackoverflow.com/a/14623458/9361507

    Mais je préfère le "vide" à la balise, mais pas une branche. Moyen Simple est:

    git tag empty $(git hash-object -t tree /dev/null)

    Parce que la balise peut pointer vers l'arbre-ish directement, sans commettre.
    Maintenant, pour obtenir tous les fichiers dans l'arbre de travail:

    git diff --name-only empty

    Ou même avec stat:

    git diff --stat empty

    Tous les fichiers que diff:

    git diff empty

    Case d'url dans tous les fichiers:

    git diff --check empty
    • ...mais à l'aide de la magie dans votre balise de création est juste un brossage sous le tapis le sujet de la question (pas à l'aide de magie nombre SHA-1)
    • Pas vrai. J'ai utilisé la balise point de l'arbre-ish objet. En maintenant cet arbre-ish est défini par l'algorithme SHA-1, dans l'avenir, il peut être modifié, par exemple, SHA-256 et ainsi de suite (avec migration du référentiel). Mais tag sera le même. 🙂 La principale caractéristique d'une balise est à un point de l'objet. Une balise peut utiliser SHA-1 en interne ou quelque chose d'autre, c'est une question de Git internes seulement.
    • Je le conçois. Mais si vous (ou quelqu'un de cette lecture)(ou un script, encore pire) essaie de l'appliquer (première ligne) à un moment plus tard, il risque d'échouer sur un nouvel algorithme de hachage, où le remplacement de votre première ligne avec une expression exécutée (la production de ce hash) serait de réussir.
    • Si vous combinez cela avec l'une des méthodes de génération de l'arbre vide de hachage automatiquement, vous pouvez l'avenir (comme @RomainValeri l'indique). Toutefois, si cela ne tenait qu'à moi, git rev-parse aurait la création de nouveaux indicateurs ou de mots clés ou quelque chose le long de ces lignes, à produire (a) le vide de l'arbre de hachage et (b) la valeur null validation de hachage. Ces deux serait utile dans les scripts et les protéger contre le projet de SHA-256 changements.
    • Okey, a changé. Mais ce ne sera pas "la manière la plus simple". 🙂
    • De toute façon, votre balise à base de raccourcis semblent très pratique pour moi. Upvoted pour le pragmatisme.
    • Btw, tels drapeau existe en: git lire-arbre-vide, Cela va créer un arbre vide dans la scène. Mais je ne sais pas comment cela peut être utile.
    • oui, le problème est que git read-tree ne pas l'exporter n'importe où. Depuis la rev-parse est une sorte de l'entreprise de programmation de l'API pour hash Id, je pense que c'est là où ils appartiennent.

    InformationsquelleAutor Olleg