Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

1-hour workshop: Fail startup clearly when dependencies or services do not start

Ouverte
  • Quelque chose ne va pas ?
#259 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
55/100
Type d'issue
Bug
Clarté
Plutôt claire
Activité
Active
Stack technique
powershell, python, shell
Domaine
developer-experience, devops

Piste de recherche

Commencez par app/scripts/start-app.sh et app/scripts/start-app.ps1, en suivant l’installation des dépendances, l’attente fixe de cinq secondes, l’affichage des URL des services et les chemins de nettoyage. Exécutez les deux scripts de démarrage en simulant un échec de l’installation de Python ou de Node ainsi qu’un échec du démarrage de Flask ou d’Astro ; le travail est terminé lorsque les échecs renvoient un statut différent de zéro et explicite, que les processus gérés s’arrêtent ensemble, que les URL n’apparaissent qu’une fois les deux services prêts et que le nettoyage fonctionne toujours avec Ctrl+C ou après un démarrage partiel.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

priority: P0

Problem

The learner setup depends entirely on the startup scripts, but failure handling can report a misleading success state. In app/scripts/start-app.sh, npm install is not checked before npm run dev starts. In app/scripts/start-app.ps1, a failed Node dependency installation emits a warning and continues. Both scripts wait a fixed five seconds and then print both service URLs without checking that Flask and Astro are ready.

This makes common setup failures look like browser or workshop problems and gives independent learners little actionable feedback.

Suggested change

Make both startup scripts stop on dependency installation failures and verify service/process readiness before announcing success.

Acceptance criteria

  • A failed Python or Node dependency install exits nonzero with a clear message.
  • Failure of either Flask or Astro stops the other managed process.
  • URLs are printed only after both services are ready.
  • Cleanup still works on Ctrl+C and partial startup failures.
  • macOS/Linux and Windows paths have equivalent behavior.
Langage dominant
Python
Étoiles
80
Forks
169
Merge moyen
31 min
PR mergées (30 j)
1

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de github-samples/pets-workshop

Toutes les issues de github-samples/pets-workshop

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.