GitHub

WIAI - Webinaires de l’Informatique pour l’Archéométrie à l’IRAMAT

Thomas Huet

IRAMAT-CNRS

Introduction générale

La série WIAI

Webinaires dédiés aux technologies de l’information pour l’archéométrie:
GitHub , Python , R , API , IIIF , etc.

Note

📅 Le 2^e Mardi matin de chaque mois sur ZOOM entre 10h00 et 10h50 (50 minutes)

Charles Babbage, “I wish God these calculations had been done by stream” – 1821 Wikipedia

Découvrir – ou approfondir – une solution logicielle open-source en revenant sur l’histoire de ce logiciel, sa logique interne, … Avec des citations rigolotes

Plan de la présentation

1. Git
2. GitHub
3. GitHub à l’IRAMAT
4. Et GitLab ?
5. Discussion

Git

Intro

Git : logiciel de gestion de versions décentralisé¹ originallement créé par Linus Torvalds pour le contrôle de version dans le développement du noyau Linux .

Linus Torvalds en 2018 (c) Lf Asia

Schéma

Mettre la copie du dépôt distant² à jour (push) :

git add .
git commit -m 'varia'
git push 

Mettre la copie du dépôt local³ à jour (pull) :

git pull
git checkout

---

Dépôt local⁴ ou distant⁵ : système de dossiers et fichiers⁶ conservant son propre historique (dossier .git) et un lien vers le dépôt (local ou distant).

Logique

• Décentralisé
• Versionnage
• Copies locales

Historique des commit⁷

Capture d’écran de mon environnement de développement⁸ (Microsoft VS Code):

• à gauche: arborescence du dépôt local⁹ IRAMAT-DEV

• au centre: fichier .gitignore listant les dossiers credentials et doc, exclus du téléversement au dépôt distant¹⁰ (push)

• à droite: fichier pg_credentials.json avec les paramètres de connexion à la BDD chips_d, exclu du téléversement au dépôt distant¹¹ (push)

Git en résumé

“Git is not designed to make you happy. It’s designed to make other people happy after you’ve screwed things up” – Linus Torvalds

GitHub

Intro

GitHub une des principales plate-forme web (propriétaire 🔒¹²) pour les projets open source de développement d’applications informatiques utilisant Git

• 📁 Repositories
• 🙍 Users
• Organisations
• 🧵 Issues

Repositories

Users

Organisations

Issues

GitHub à l’IRAMAT

Warning

Le GitHub a été pensé pour être public: ne pas partager de mots de passe, données personnelles, confidentielles, sous embargo, etc.

GitHub à l’IRAMAT

Avoir une “belle” (i.e., courte) adresse: https://github.com/iramat et échanger des URLs

Afficher du Markdown et des fichiers structurés: CSV, TSV, PDF, GeoJSON, HTML (fichier et site web statique)

Visibilité du développement logiciel et des données de référence (d’après Batist & Roe, 2024¹³)

Pour proposer une bibliothèque Python (ex: PyMca), ou un package R, il est fortement recommandé d’utiliser GitHub en raison de sa visibilité, de ses outils de collaboration et de son intégration avec les flux de travail de packaging

Et GitLab?

GitLab

GitLab : plateforme indépendante (🔓, GitLab Inc.) avec un hébergement cloud ou un auto-hébergement, pour les projets open source de développement d’applications informatiques utilisant Git .

Projet BDD Terrifer/Sideros à l’IRAMAT Belfort

Projet BDD Atmoce/AeMA à l’IRAMAT Orléans

Pour aller plus loin

• Tutoriel sur Git et GitHub https://github.com/sslarch/caa2022_GitGitHub_workshop/tree/main par Clemens Schmid, Sophie C. Schmidt et Florian Thierry
• Computational Open Archaeology, dont GitHub https://intarch.ac.uk/journal/issue67/13/full-text.html par Zachary Batist et Joe Roe

Discussion

Discussion

d’après (c) www.furygoat.com

Footnotes

1. distributed version control system

2. remote repo ou remote repository

3. local repo ou local repository

4. remote repo ou remote repository

5. local repo ou local repository

6. file/folder structure

7. commit history

8. Integrated Development Environment (IDE)

9. remote repo ou remote repository

10. remote repo ou remote repository

11. remote repo ou remote repository

12. hébergement cloud Microsoft

13. Batist, Z., & Roe, J. A. (2024). Open Archaeology, Open Source? Collaborative practices in an emerging community of archaeological software engineers. Internet Archaeology, 67.