Aller au contenu
KendorDocs

Un exercice importé se met-il à jour quand le dépôt change ?

Pour les propriétaires et les éditeurs ·

Non. Un import est une copie unique du dépôt à ce moment-là. Les pushs ultérieurs n’atteignent pas l’exercice tant que vous ne le modifiez pas vous-même.

Non. Quand vous ajoutez un exercice à partir d’un dépôt, Kendor télécharge les fichiers une seule fois et stocke sa propre copie avec l’exercice. Les pushs vers le dépôt qui suivent, y compris vers la branche que vous avez importée, ne modifient pas l’exercice, et Kendor ne le synchronise pas en arrière-plan. Pour récupérer les changements, vous pouvez soit modifier l’exercice dans Kendor, soit importer de nouveau le dépôt comme un nouvel exercice.

Ce que capture l’import

Kendor télécharge le dépôt au moment où vous choisissez Ajouter le défi. Il prend la branche, l’étiquette (tag) ou le commit de votre lien, ou la branche par défaut si le lien n’en nomme aucun. Choisir Vérifier n’est qu’un aperçu : les fichiers sont téléchargés de nouveau à l’ajout, donc un push survenu entre les deux est inclus.

La copie ne contient que les fichiers, sans l’historique Git et sans les dossiers de dépendances ou de build comme node_modules, vendor et dist.

Kendor enregistre aussi d’où viennent les fichiers : l’hébergeur, le propriétaire, le dépôt, le dossier, la branche demandée, ce à quoi elle a abouti, et la date d’import. Chez la plupart des hébergeurs, la valeur résolue est le commit exact. Pour les imports publics de github.com sans jeton, et pour Gitea et Forgejo, c’est le nom de la branche ou de l’étiquette.

Où voir la source

  • Avant l’ajout, le résultat de Vérifier affiche l’hébergeur, le dépôt, le dossier et la branche ou le commit, par exemple github.com/acme/platform/services/api @ 4f9c2e1.
  • Après l’ajout, la ligne de l’exercice dans l’épreuve ou l’entretien de codage en direct affiche l’hébergeur et le dépôt, comme github.com/acme/platform, à la place du type d’exercice.

La source reste attachée à l’exercice après que vous avez modifié son code dans Kendor : la ligne continue donc de nommer le dépôt même quand les fichiers ne lui correspondent plus.

Pourquoi la copie reste figée

Une copie figée garde une épreuve équitable et prévisible :

  • Chaque candidat d’une épreuve part des mêmes fichiers, même si quelqu’un pousse vers le dépôt pendant que des invitations sont en cours.
  • Un force-push, une branche supprimée, ou un dépôt rendu privé ou supprimé ne casse pas une épreuve déjà en cours.
  • Supprimer le jeton de votre organisation pour un hébergeur Git n’affecte pas les exercices que vous avez déjà importés. Ils conservent leur code.
  • Chaque session de codage en direct ouvre une copie neuve de l’exercice : un entretien n’hérite donc jamais des modifications d’un autre candidat.

Comment mettre à jour un exercice après un changement du dépôt

Il n’y a pas de bouton pour resynchroniser un exercice existant avec son dépôt. Choisissez l’approche adaptée à l’ampleur du changement.

Petits changements : modifier dans Kendor

Ouvrez l’exercice dans l’éditeur (Ouvrir dans l’éditeur sur la ligne de l’exercice) et faites le changement là. Cela conserve l’exercice, son énoncé et ses paramètres. Votre code enregistré devient le nouveau point de départ de l’exercice.

Changements importants : importer de nouveau comme un nouvel exercice

  1. Poussez les changements vers le dépôt.
  2. Dans la même épreuve de code, collez le lien du dépôt dans Collez l'URL d'un dépôt pour ajouter un exercice, choisissez Vérifier, puis Ajouter le défi.
  3. Configurez le nouvel exercice dans l’éditeur : vérifiez qu’il s’exécute, et reprenez l’énoncé de l’ancien.
  4. Quand le nouvel exercice est prêt, supprimez l’ancien avec son bouton de suppression.

Remarque. Supprimer un exercice supprime aussi ses rendus. Si des candidats ont déjà rendu du travail sur l’ancien exercice, ne le supprimez pas d’une épreuve que vous êtes encore en train de relire. Créez plutôt une nouvelle épreuve pour l’exercice mis à jour, et gardez l’ancienne épreuve pour les candidats déjà invités.

Un entretien de codage en direct contient un seul exercice : le champ de dépôt n’apparaît donc que lorsqu’il n’en a aucun. Pour le remplacer par un nouvel import, supprimez d’abord l’exercice actuel, puis collez de nouveau le lien dans la section Code. Faites-le entre deux entretiens, pas pendant que l’un d’eux se déroule.

Ce qui change pour les candidats

Modifier un exercice ou remplacer son code change le point de départ des candidats à partir de ce moment. Les pushs vers le dépôt n’atteignent jamais les candidats à eux seuls : seul un changement que vous faites dans Kendor les atteint. Si une épreuve est déjà en ligne, planifiez les mises à jour à un moment où vous n’attendez pas de nouveaux candidats, ou placez l’exercice mis à jour dans une nouvelle épreuve.

Cet article vous a-t-il aidé ?