python / python/cpython

Naming consistency for various types

Đang mở
#126,662 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.

stdlib type-feature
Ngôn ngữ chính
Python
Star
77.2k
Fork
35.9k
Chỉ số merge pull request
Chỉ số pull request đang chờ

Mô tả

Feature or enhancement

Proposal:

A number of classes self-report names which are not an importable name for that type.
The inconsistency means that the class itself can’t be pickled, typeshed can’t match their display name, and can cause minor confusion. I’m interested in getting these to be consistent where possible.

An accounting of all the types I know about in the category is available at the linked discuss thread.

Has this already been discussed elsewhere?

I have already discussed this feature proposal on Discourse

Links to previous discussion of this feature:

Recent discuss thread: https://discuss.python.org/t/naming-consistency-for-various-types/70401

Another related discussion for types exposed in the types module is available here: https://github.com/python/cpython/issues/100129

Linked PRs
  • gh-126663
  • gh-126712
  • gh-126721
  • gh-126723
  • gh-126724
  • gh-137122
  • gh-137123

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

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.

Hướng nghiên cứu

Bắt đầu bằng việc đọc các cuộc thảo luận Discourse được liên kết và issue 100129 liên quan, sau đó xem xét các PRs 126663, 126712, 126721, 126723, 126724, 137122 và 137123. Sử dụng danh sách các kiểu bị ảnh hưởng được nêu ở đó để xác định phạm vi đã thống nhất; công việc hoàn tất khi các kiểu được chọn nhất quán báo cáo các tên có thể import và các mối quan ngại đã nêu về pickling và typeshed được giải quyết.

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

Đánh giá

Công nghệ
python
Lĩnh vực
backend
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Cần làm rõ
Mức phù hợp với người mới
20/100

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.