... | ... | @@ -52,16 +52,99 @@ Tout d'abord, il vous faut le code contenant la solution de votre TP pour pouvoi |
|
|
|
|
|
Une annotation est un commentaire sur une ligne dans votre fichier de code contenant des informations utilisées par le serveur. Il existe différentes annotations qui commence toutes par "*@u:*".
|
|
|
|
|
|
#### Annotations d'un bloc de code
|
|
|
Il y a des [annotations de bloc de code](#) afin de décrire ce qui devra être suivi et des [annotations d'indicateur](#) ajoutant des indicateurs à un bloc de code.
|
|
|
|
|
|
| Annotation | Paramètre(s) | Description |
|
|
|
|------------------------|----------------------|--------------------------------------------------------------------------------------|
|
|
|
| @u:file <nom\> | Chaine de caractères | Suivre un fichier complet que l'étudiant devra créer. C'est-à-dire qu'il ne recevera pas ce fichier. |
|
|
|
| @u:start <nom\> | Chaine de caractères | Commencer un bloc de code |
|
|
|
| @u:end <nom\> | Chaine de caractères | Finir un bloc de code |
|
|
|
| @u:add <ligne\> | Chaine de caractères | Ajouter une ligne au bloc que l'étudiant va recevoir. Le contenu écrit est tout ce qu'il y a après le premier espace suivant le @u:add. <br> Plusieurs @u:add pour plusieurs lignes|
|
|
|
| @u:description <ligne\>| Chaine de caractères | Ajouter une description au bloc |
|
|
|
| @u:priority <valeur\> | Entier | Ajouter une priorité au bloc |
|
|
|
#### Annotations de bloc de code
|
|
|
|
|
|
##### file
|
|
|
|
|
|
Cette annotation permet de suivre un fichier complet. Ce fichier ne sera pas récupérer par l'étudiant et devra donc le créer.
|
|
|
|
|
|
Elle devra obligatoirement être suivie d'une chaîne de caractère qui sera le nom du bloc de code.
|
|
|
|
|
|
_Exemple :_
|
|
|
|
|
|
# @u:file mon_bloc
|
|
|
|
|
|
##### start
|
|
|
|
|
|
Cette annotation permet de commencer un bloc de code à suivre.
|
|
|
|
|
|
Elle devra obligatoirement être suivie d'une chaîne de caractère qui sera le nom du bloc de code.
|
|
|
|
|
|
_Exemple :_
|
|
|
|
|
|
# @u:start mon_bloc
|
|
|
|
|
|
# CODE
|
|
|
|
|
|
# @u:end mon_bloc
|
|
|
|
|
|
**Attention : ** Il faudra obligatoirement fermer ce bloc à l'aide de l'annotation [end](#end)
|
|
|
|
|
|
##### end
|
|
|
|
|
|
Cette annotation permet de déterminer la fin du suivi d'un bloc de code.
|
|
|
|
|
|
Elle devra obligatoirement être suivie d'une chaîne de caractère qui sera le nom du bloc de code.
|
|
|
|
|
|
_Exemple :_
|
|
|
|
|
|
# @u:start mon_bloc
|
|
|
|
|
|
# CODE
|
|
|
|
|
|
# @u:end mon_bloc
|
|
|
|
|
|
**Attention : ** Il faudra obligatoirement commencer un bloc avant cette annotation à l'aide de l'annotation [start](#end)
|
|
|
|
|
|
##### add
|
|
|
|
|
|
Cette annotation permet d'ajouter du code à un bloc de code à la version que l'étudiant recevra.
|
|
|
|
|
|
Elle devra obligatoirement être suivie d'une chaîne de caractère qui sera le code à ajouter.
|
|
|
|
|
|
Il faut une annotation _add_ par ligne de code à ajouter.
|
|
|
|
|
|
_Exemple :_
|
|
|
|
|
|
# @u:start mon_bloc
|
|
|
# @u:add ma première ligne à ajouter
|
|
|
# @u:add ma deuxième ligne à ajouter
|
|
|
|
|
|
# CODE
|
|
|
|
|
|
# @u:end mon_bloc
|
|
|
|
|
|
**Attention : ** Les espaces avant et après l'annotation sont pris en compte hormis le premier espace après l'annotation _add_.
|
|
|
|
|
|
##### description
|
|
|
|
|
|
Cette annotation permet d'ajouter une description à un bloc de code.
|
|
|
|
|
|
Elle devra obligatoirement être suivie d'une chaîne de caractère qui sera la description.
|
|
|
|
|
|
_Exemple :_
|
|
|
|
|
|
# @u:start mon_bloc
|
|
|
# @u:description la description
|
|
|
|
|
|
# CODE
|
|
|
|
|
|
# @u:end mon_bloc
|
|
|
|
|
|
##### priority
|
|
|
|
|
|
Cette annotation permet d'ajouter une priorité à un bloc de code.
|
|
|
|
|
|
Elle devra obligatoirement être suivie d'une valueur entière.
|
|
|
|
|
|
# @u:start mon_bloc
|
|
|
# @u:priority 50
|
|
|
|
|
|
# CODE
|
|
|
|
|
|
# @u:end mon_bloc
|
|
|
|
|
|
|
|
|
#### Annotations d'indicateur
|
... | ... | @@ -79,7 +162,9 @@ Une annotation est un commentaire sur une ligne dans votre fichier de code conte |
|
|
|
|
|
Il est possible de rajouter un coéficient aux indicateurs. Il suffit de rajouter "*:<valeur\>*" après le nom de l'indicateur où la valeur est un nombre entier. Par exemple "*@u:CharactersNumber:2*".
|
|
|
|
|
|
<br>
|
|
|
|
|
|
#### Exemples
|
|
|
|
|
|
|
|
|
**Exemple.py de l'enseignant**
|
|
|
|
... | ... | |