Softwareheritage-2020

= Equipe =

=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.