Softwareheritage-2020

Equipe

Membre	Rôles
Joachim Fontfreyde	Chef de projet
Léni Gauffier	Développeur/Correspondant privilégié avec la communauté open-source
Yann Gautier-Pignonblanc	Développeur
Nathan Dalaine	Développeur

Journal

Semaine 0: du 29/01 au 31/02

• Choix du projet software heritage: sauvegarde des codes sources provenant de différentes forges (github, gitlab), dans un but de sauvegarde du patrimoine.
• Lecture de la documentation du projet
  • https://docs.softwareheritage.org/devel/developer-setup.html
  • https://wiki.softwareheritage.org/wiki/Main_Page
• Tentative de compréhension de l’architecture du projet:
  • https://forge.softwareheritage.org/

Semaine 1 - Du 03/02 au 07/01

• Réalisation de plusieurs easyhack
• Installation de toutes les dépendances afin de pouvoir lancer les tests en local
• Prise de contact avec la communauté open-source via l’IRC afin de poser des questions relatives au lancement du projet
  • Documentation pas à jour, création et résolution d’issues afin de la mettre à jour.
  • https://forge.softwareheritage.org/D2635
• Début de réalisation de plusieurs easy-hacks afin de se familiariser avec le projet:
  • Ajout de type annotation au package swh.core.api
    • Les type annotations sont une nouvelle fonctionnalité de python permettant de donner des indications aux développeurs des types attendus
    • Bien qu ignorées par l'interpréteur à l'exécution ces informations permettent de faciliter grandement la compréhension du code par un nouveau développeur.
    • https://forge.softwareheritage.org/D2636
    • https://forge.softwareheritage.org/D2644

Semaine 2 - Du 10/02 au 14/01

• Maintenant que certains membres du groupe maîtrisent le projet et son architecture, recherche d’une issue un peu plus conséquente.
• Ajout d’un paramètre ?limit=N aux endpoints existants de l’api
  • Ping pong avec la communauté qui avait des attentes très précises, mais peu de détails donnés sur la tâche.
  • https://forge.softwareheritage.org/T2114
• Gros problèmes pendant la phase de tests avec le projet
• Identification d’une seconde tâche plus intéressante et complète: lister de projet launchpad:
  • Launchpad est un projet open source hébergeant plusieurs forges (github, bazaar).
  • Pas encore pris en charge par softwareheritage
  • Une bonne partie de la discussion a déjà été initié entre la communauté sans que toutefois aucun code ne soit publié.

Semaine 3 - Du 17/02 au 21/01

• Réalisation d’autres easyhacks de typage concernant les listers:
  • https://forge.softwareheritage.org/D2681
  • On se rend déjà compte de l'intérêt de ce typage dans le cadre du développement de notre lister
• Développement du lister launchpad
  • Tests compliqué à exécuter
  • Documentation sur la création de lister absolument pas à jour.
    • Plusieurs échanges avec la communauté afin de mieux comprendre
    • Nous documentons ce que nous faisons afin de proposer une documentation à jour à la fin du projet.
  • Découverte de l’API de launchpad permettant de récupérer l’ensemble des projets.
    • Encore une fois une documentation “floue”, certains paramètres ne sont pas détaillés

Semaine 4 - Du 02/03 au 06/03

• Prise de contact avec la communauté de launchpad
  • Echange concernant leur API (qui ne semble pas non plus être claire pour eux)
  • Proposition acceptée d'évolution de l'API afin de simplifier le crawling
  • Ajout d'une fonction dans leur librairie Python launchpadlib
• Update de la documentation de l'api graph de software heritage pour refleter les changements apportés.
• Update du lister Launchpad pour utilisation de la lib launchpad Python.