Trích dẫn https://www.python.org/dev/peps/pep-0008/#package-and-module-names :
Các mô-đun nên có tên ngắn, tất cả chữ thường. Dấu gạch dưới có thể được sử dụng trong tên mô-đun nếu nó cải thiện khả năng đọc. Các gói Python cũng nên có tên viết tắt, tất cả chữ thường, mặc dù việc sử dụng dấu gạch dưới không được khuyến khích.
Đối với các lớp học :
Tên lớp thường sử dụng quy ước Capemme.
Và tên và hàm biến (cục bộ) phải là:
chữ thường, với các từ được phân tách bằng dấu gạch dưới là cần thiết để cải thiện khả năng đọc
Xem câu trả lời này cho sự khác biệt giữa một mô-đun, lớp và gói:
- Một mô-đun Python chỉ đơn giản là một tệp nguồn Python, có thể hiển thị các lớp, hàm và biến toàn cục.
- Gói Python chỉ đơn giản là một thư mục của mô-đun Python.
Vì vậy, PEP 8 cho bạn biết rằng :
- các mô-đun (tên tệp) phải có tên viết tắt, tất cả chữ thường và chúng có thể chứa dấu gạch dưới;
- các gói (thư mục) nên có tên viết tắt, tất cả chữ thường , tốt nhất là không có dấu gạch dưới;
- các lớp nên sử dụng quy ước Capemme.
PEP 8 nói rằng tên nên ngắn gọn ; câu trả lời này cung cấp một cái nhìn tổng quan tốt về những gì cần tính đến khi tạo tên biến, cũng áp dụng cho các tên khác (cho các lớp, gói, v.v.):
- tên biến không phải là mô tả đầy đủ;
- đưa chi tiết vào bình luận;
- tên quá cụ thể có thể có nghĩa là mã quá cụ thể;
- giữ phạm vi ngắn để tra cứu nhanh chóng;
- dành thời gian suy nghĩ về khả năng đọc.
Để kết thúc, một tổng quan tốt về các quy ước đặt tên được đưa ra trong Hướng dẫn về Phong cách Python của Google .
FooBar
vàFooBiz
cả hai có thể đi vào tệpsomepkg/foobar.py
(vì vậyfrom somepkg.foobar import FooBar
:) nhưng lớpTimerError
có thể đi vàoexcept/timer_error.py
(do đófrom except.timer_error import TimerError
), vì việc loại bỏCamelCase
đôi khi làm cho từ khó đọc hơn, do đósnake_case
có thể được sử dụng cho tên tệp.