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