title = {\href{https://en.wikipedia.org/w/index.php?title=International_Federation_of_Digital_Seismograph_Networks&oldid=679383746}{International Federation of Digital Seismograph Networks --- {Wikipedia}{,} The Free Encyclopedia}},
title = {{International Federation of Digital Seismograph Networks --- {Wikipedia}{,} The Free Encyclopedia}},
author = {Catherine Péquegnat and Jonathan Schaeffer and Claudio Satriano and Helle A. Pedersen and Jérôme Touvier and Jean-Marie Saurel and Marie Calvet and Laurent Stehly and Patrick Arnoul and Philippe Bollard and Olivier Dewée and Fabien Engels and Marc Grunberg and Constanza Pardo and David Wolyniec and Grégory Arneodo and Rima Bouazzouz and Olivier Geber and Coralie Aubert and Mickaël Langlais and Sandrine Roussel and Florent Brenguier and Wayne C. Crawford and Arnaud Lemarchand and Emeline Maufroy and Serge Olivier and Diane Rivet and Martin Vallée and Jerôme Vergne and Jérôme Chèze and Eric Debayle and Bertrand Delouis and Philippe Gueguen and Sophie Lambotte and Antoine Mocquet and Anne Paul and Fabrice Peix and François Schindelé and Nikolai M Shapiro and Eléonore Stutzmann and Pierre Volcke and Andrea Walpersdorf},
title = {\href{http://fr.wikipedia.org/w/index.php?title=Unit%C3%A9_mixte_de_recherche&oldid=193595932}{Unité mixte de recherche --- Wikipédia, l'encyclopédie libre}},
title = {{Unité mixte de recherche --- Wikipédia, l'encyclopédie libre}},
note = "[En ligne; Page disponible le 11-mai-2022]"
}
@website{gitlab,
author = {gitlab},
title = {\href{https://about.gitlab.com}{gitlab}},
url = {https://about.gitlab.com}
title = {{gitlab home page}},
howpublished = {\url{https://about.gitlab.com}}
}
@misc{osu,
@misc{osu,
author = "Wikipédia",
title = {\href{http://fr.wikipedia.org/w/index.php?title=Observatoire_des_sciences_de_l%27univers&oldid=180038548}{Observatoire des sciences de l'univers --- Wikipédia, l'encyclopédie libre}},
title = {{Observatoire des sciences de l'univers --- Wikipédia, l'encyclopédie libre}},
RÉSIF-DC est géré par différents organismes qui sont sous la tutelle du ministère de la transition écologique ainsi que par le ministère de l'enseignement supperieur, de la recherche et de l'inovation\cite{resifOrga}. Quand j'ai signé ma convention, je l'ai fait avec l'Unitée Mixte de Recherche (UMR) ISTerre. En effet, le bureau dans lequel je travaillais se situait dans les locaux de cette UMR. Toutefois, le personnel travaillant dans l'équipe RÉSIF-DC est sous la direction de l'OSUG et de RÉSIF-EPOS. Ainsi, j'ai été amené a integrer une équipe d'ingénieurs OSUG (cf. Figure~\ref{fig:orgaResifDC}).
\begin{figure}[H]
\caption{Répartition des organismes contribuant à RÉSIF-DC}
Pour organiser ces tâches, j'ai utilisé les \textit{issues} de \textit{gitlab} (cf. Chapitre~\ref{chap:gitlab}). En effet, les super tâches étaient modélisées par des \textit{labels} combinables. Par exemple, pour la tâche \textit{scenario Dataselect}, les labels étaient \textit{Scénario} et \textit{WS-Dataselect} (cf. Figure~\ref{fig:task}).
Pour pouvoir avoir une vision globale du projet ainsi que pour la transmission de ma production, j'ai dû la documenter. Pour cela, j'ai utilisé plusieurs outils. Tout d'abord, pour avoir une documentation de mon code en lui même, expliquer le rôle de chaque classe, chaque methode, j'ai utilisé l'outil \textit{pydoc}, qui permet de générer une documentation HTML en lisant les \textit{docstings} de mon code. Une \textit{docstring} est une sorte de paragraphe, placé en haut de l'item à documenter (classe, methode, \dots) expliquant l'utilité et le fonctionement de ce dernier. Cependant, je n'ai pas commencer à documenter mon code dès le début de sa production, j'ai donc pris une journée pour l'écrire, à la fin de l'implémentation des tests sur le deuxieme \textit{web service} que j'ai traité, c'est-à-dire, vers le début du mois de mai.
\begin{figure}
\caption{Extrais de la classe \textit{Query} comportent des docstrings}
\caption{Extrait de la classe \textit{Query} comportent des docstrings}
\begin{verbatim}
class Query:
"""
Abstract class representing a Query sent to ws.resif.fr
Attributes:
args (dict): argument for the request (ex.: {'network': 'FR', 'start': '2020-12-12'})
args (dict): argument for the request (ex.: {'network': 'FR',
'start': '2020-12-12'})
refreshCache (bool): is the cach refreshed ?
response (Response): response of the web service
getUrl (str): complete URL if the method id GET
@ -606,7 +611,20 @@ class Query:
Returns:
Response: the response of the GET request
"""
response = requests.get(self.ws, params=self.args, headers=self._header, auth=requests.auth.HTTPDigestAuth(self.__digestTuple[0], self.__digestTuple[1])) if not self.headerOnly else requests.head(self.getUrl, auth=requests.auth.HTTPDigestAuth(self.__digestTuple[0], self.__digestTuple[1]))
Érina Point
3 years ago