Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

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

未关闭
#259 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
55/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
powershell, python, shell

调研方向

从 app/scripts/start-app.sh 和 app/scripts/start-app.ps1 开始,跟踪依赖安装、固定的五秒等待、服务 URL 输出以及清理路径。运行两个启动脚本,同时模拟 Python 或 Node 安装失败,以及 Flask 或 Astro 启动失败;完成的标准是:失败时返回非零且明确的状态码,受管理的进程一起停止,只有在两个服务都就绪后才显示 URL,并且在 Ctrl+C 或部分启动的情况下清理仍然有效。

由索引模型根据 Issue 内容生成。

描述

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.
主要语言
Python
星标
80
派生
161
平均合并
31 分钟
30 天内合并 PR
1

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

github-samples/pets-workshop 的其他 Issue

查看 github-samples/pets-workshop 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。