From 742a56483dfd7862257f83cce3743adb3d315f03 Mon Sep 17 00:00:00 2001 From: gwen Date: Fri, 25 Aug 2023 10:49:36 +0200 Subject: [PATCH] update git subtree --- source/data.rst | 27 ++++++++++++++++++++++----- 1 file changed, 22 insertions(+), 5 deletions(-) diff --git a/source/data.rst b/source/data.rst index 2f90e59..7b3af0e 100644 --- a/source/data.rst +++ b/source/data.rst @@ -140,7 +140,7 @@ Identifiants Les datas dans le projet `princely-acts` -------------------------------------------- -Les datas dans le projet `princely-acts` sont centralisées dans un seul projet, le projet +Les datas dans le projet `princely-acts` sont centralisées dans un seul projet, le projet nommé `data`. .. glossary:: @@ -150,12 +150,14 @@ Les datas dans le projet `princely-acts` sont centralisées dans un seul projet, .. note:: Dans le projet `princely-acts`, le référentiel de données s'appelle `princely-acts/data` et est un dépôt git. +Ce projet `data` **est la seule et unique source des datas**. -Pour réutilser les données par exemple dans le projet `princely-acts/datascience`, on peut : +.. important:: Ne jamais dupliquer les datas ! Elles sont dans un seul + et unique data registry. -- soit faire un lien symbolique si on est sous linux -- soit (cette pratique est préférable), utiliser la fonctionnalité - `git subtree `_ de git, puisque nous utilisons git comme data registry. +Pour réutilser les données **sans les dupliquer**, par exemple dans le projet `princely-acts/datascience`, il est proposé d'utiliser +la fonctionnalité + `git subtree `_ de git, puisque le choix a été fait d'utiliser git comme data registry. Git subtree ---------------- @@ -189,4 +191,19 @@ vers le dépot `princely-acts/datascience` par exemple : .. important:: Il faut que le dossier `actes-princiers/data/01_raw` n'existe pas (ne soint pas présent) dans le projet `datascience`, sinon le pull ne va fonctionner. +.. note:: l'option `--squash` permet de ne pas ajouter l'historique du projet `data` au projet `datascience` + - Vous pouvez ensuite utiliser les datas du projet `data` depuis le projet `datascience`. + +Data update +------------ + +Si une nouvelle version des datas a été releasée, pour récupérer ces datas depuis le projet `datascience`, lancer cette commande **à la racine du projet** : + +:: + + git subtree pull --prefix actes-princiers/data/01_raw data main --squash + X11 forwarding request failed on channel 0 + Depuis gitlab.huma-num.fr:medieval-acts/princely-acts/data + * branch main -> FETCH_HEAD +