Spec Change : Additional detail and option for platform checks.

Đang mở
#52 0 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ó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Đình trệ
Công nghệ
python
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với đề xuất đặc tả được liên kết PR #2173, sau đó đọc Discussion và Q&A trước đó để nắm bối cảnh. Xem xét các câu hỏi còn bỏ ngỏ về các dạng iterable, các kiểm tra not-in, việc so sánh phiên bản triển khai và các kiểm tra kết hợp; công việc hoàn tất khi đề xuất phản ánh các quyết định đã được giải quyết và PR được cập nhật tương ứng.

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

Mô tả

Hello Typing council,

Please consider the proposal in the PR and Discussion below.

The Discussion has overal positive feedback, but did not receive concrete feedback on the refinement and implementation questions posed, so Ill repeat them here so the PR can be adjusted as needed based on the feedback.

Open Questions:

Scope of sys.platform collections:

  • Should typecheckers support any iterable, or limit to tuple or set literals?
    Recommend: Only tuple literals; Optionally set literals if feasible for type checkers

  • Should typecheckers support not in checks?
    Recommend: Yes

sys.implementation attributes:

  • Should typecheckers support sys.implementation.version comparisons (similar to sys.version_info)?
    No preference.

Combining version, platform, and implementation checks:

  • Should typecheckers explicitly allow combined checks , (e.g., if sys.platform == "linux" and sys.implementation.name == "pypy":)?
    Recommend: Yes, as long as each individual check is supported. This is not explicitly specified in the proposed text, as the implementation complexity for type checkers needs further assessment.
Ngôn ngữ chính
Không có dữ liệu ngôn ngữ
Star
57
Fork
2
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

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

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 python/typing-council

Tất cả issue của python/typing-council

Issue tương tự

Thêm issue về Documentation

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.