Aller au contenu
KendorDocs

Envoyer votre première épreuve de code

Pour les propriétaires et les éditeurs ·

Créez une épreuve de code à partir de votre propre dépôt, vérifiez qu'elle s'exécute et invitez un candidat. Environ 15 minutes.

Avant de commencer

  • Une organisation Kendor. L'accès se fait sur demande : écrivez via le formulaire de contact et vous recevrez un lien pour la configurer.
  • Le rôle Propriétaire ou Éditeur. Les lecteurs peuvent consulter les épreuves mais pas en créer.
  • Un dépôt dans lequel le candidat travaillera, sur n'importe quel hébergeur Git. Pas encore de dépôt ? Partez plutôt d'un projet vierge (étape 2).

Créer une épreuve

Ouvrez Épreuves dans la barre latérale et choisissez Nouvelle épreuve. Donnez-lui le nom que verront les candidats, par exemple Rate limiter, dans le champ Nommez cette épreuve.

Dans les paramètres à droite, choisissez une Limite de temps. 90 minutes est la valeur par défaut et convient à la plupart des tâches backend ; vous pouvez aussi choisir de 30 minutes à 4 heures, ou une durée personnalisée. Une fois le brouillon créé, vos modifications s'enregistrent au fil de l'eau.

Ajouter un défi depuis votre dépôt

Collez l'URL du dépôt dans URL du dépôt et choisissez Vérifier. Kendor affiche un aperçu de l'import : le nombre de fichiers, sa taille et si le dépôt contient déjà un kendor.yaml.

  • Hébergeurs : github.com, gitlab.com et bitbucket.org, ainsi que votre propre GitHub Enterprise Server, GitLab, Gitea ou Forgejo.
  • Dépôts privés : un propriétaire de l'organisation ajoute d'abord un jeton en lecture seule sous Intégrations → Hébergeurs de code. Les jetons sont stockés chiffrés, et Kendor n'en affiche jamais que les quatre derniers caractères.
  • Un seul dossier d'un monorepo : collez un lien vers une branche ou un dossier (par exemple github.com/acme/platform/tree/main/services/billing) et seule cette partie est importée.

Renseignez le Titre, la Langue et les éventuelles Bases de données dont le projet a besoin, puis choisissez Ajouter le défi. L'import est une copie de ce commit : les push ultérieurs sur le dépôt ne modifient pas une épreuve déjà envoyée.

Pas de dépôt ? Sous Ou ajoutez :, choisissez Projet vierge pour partir d'un des modèles de Kendor, ou Fichier unique pour une question de type algorithmique.

Vérifier comment il s'exécute

Un kendor.yaml à la racine du projet indique à Kendor comment l'installer, le démarrer et le tester. Quand le dépôt n'en contient pas, l'éditeur ouvre pour vous la Configuration d'exécution. Remplissez le formulaire, ou passez à YAML brut, puis enregistrez : Kendor écrit kendor.yaml et redémarre le bac à sable avec ce fichier.

Un petit projet avec une base de données PostgreSQL ressemble à ceci :

kendor.yaml
version: 1
runtime:
  type: python
  version: "3.12"
databases:
  - type: postgres
    version: "18"
    init: db/schema.sql
install:
  commands:
    - pip install --user -r requirements.txt
services:
  app:
    dev:
      command: uvicorn main:app --host $HOST --port $PORT --reload
      port: 8000
    test:
      command: pytest --tap-stream
preview:
  service: app

Kendor démarre la base de données dans le bac à sable et transmet sa chaîne de connexion à votre application sous le nom DATABASE_URL. Choisissez Aperçu côté candidat pour voir l'application en cours d'exécution exactement comme la verra un candidat.

S'assurer que les tests s'exécutent

Les candidats lancent eux-mêmes les tests du projet, depuis l'onglet Tests de l'éditeur ou depuis le terminal, aussi souvent qu'ils le souhaitent. Les tests sont de simples fichiers du projet : les candidats peuvent donc aussi les lire.

L'onglet Tests exécute la commande test de kendor.yaml. Pour obtenir une ligne par test au lieu d'un simple réussi ou échoué, faites afficher du TAP par la commande : pytest --tap-stream (le Python de Kendor inclut pytest-tap) ou le node --test intégré à Node le font tous les deux. Lancez la suite une fois dans l'aperçu pour la vérifier.

Lancer l'épreuve

De retour dans les paramètres de l'épreuve, ajoutez des Relecteurs par défaut et vérifiez l'Expiration de l'invitation (7 jours sauf modification). Pour permettre aux candidats d'utiliser des agents de code IA dans le terminal, activez Assistants IA dans le terminal. Avec les propres clés d'API de votre organisation, ils disposent de Claude Code et Codex ; avec leur propre compte, ils peuvent aussi lancer Antigravity, GitHub Copilot, Cline, OpenCode ou Cursor.

La Liste de lancement indique ce qui manque. Une épreuve a besoin d'un titre, d'au moins un défi et d'une configuration d'exécution valide. Choisissez Lancer et l'épreuve passe en Disponible.

Inviter un candidat

Ouvrez Candidats et choisissez Inviter un candidat. Saisissez un ou plusieurs e-mails, choisissez l'épreuve (seules les épreuves disponibles sont listées), puis choisissez Envoyer l'invitation.

Chaque candidat reçoit son propre lien par e-mail. Il n'a pas besoin de compte : il saisit son nom, et le chronomètre démarre lorsqu'il choisit Commencer l’épreuve. Si vous préférez envoyer le lien vous-même, utilisez Copier le lien d'invitation dans la ligne du candidat.

Astuce. Envoyez la première invitation à vous-même pour voir exactement ce que voient les candidats.

Évaluer le rendu

Quand le candidat rend son travail, ouvrez sa fiche depuis Candidats et choisissez Ouvrir la révision. Vous y trouverez son code et son diff sous Solution, ainsi que les onglets Chronologie, Terminal, Agents IA et Activité.

Chaque évaluateur enregistre une recommandation, de Oui, sans réserve à Non, sans réserve, avec une note facultative. Puis quelqu'un tranche : Retenir ou Rejeter. Aucun des deux n'envoie d'e-mail au candidat : c'est vous qui décidez quand et comment il est informé. Marquer comme réussi et Marquer comme non réussi sont différents : ils envoient immédiatement son résultat au candidat par e-mail. Voir Évaluer un rendu.

Cet article vous a-t-il aidé ?