Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
  • Có gì không ổn?
#259 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
55/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
powershell, python, shell
Lĩnh vực
developer-experience, devops

Hướng nghiên cứu

Bắt đầu với app/scripts/start-app.sh và app/scripts/start-app.ps1, theo dõi việc cài đặt các dependency, thời gian chờ cố định năm giây, đầu ra URL của service và các đường dẫn cleanup. Chạy cả hai startup script trong khi mô phỏng lỗi cài đặt Python hoặc Node và lỗi khởi động Flask hoặc Astro; được xem là hoàn tất khi các lỗi có trạng thái khác 0 và rõ ràng, các process được quản lý dừng cùng nhau, URL chỉ xuất hiện sau khi cả hai service đã sẵn sàng, và cleanup vẫn hoạt động khi nhấn Ctrl+C hoặc khi startup dở dang.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.
Ngôn ngữ chính
Python
Star
80
Fork
169
Merge trung bình
31 phút
Pull request đã merge (30 ngày)
1

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github-samples/pets-workshop

Tất cả issue của github-samples/pets-workshop

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.