Quy ước đặt tên

Bài học 3 trên 28 trong khóa học Clean Code: viết code tốt hơn với Python của Coddy.

Đặt tên là một phần quan trọng khi viết code. Bạn đặt tên cho biến, hàm, lớp và nhiều thứ khác...

Python đưa ra một số kiểu đặt tên được gợi ý:

Loại	Quy ước	Ví dụ
Biến	Snake case	`x`, `index`, `max_number`
Hàm	Snake case	`calculate`, `convert_to_int`
Lớp	Pascal case	`Person`, `JavaCompiler`
Phương thức	Snake case	`print`, `make_sound`
Hằng số	Snake case (chữ in hoa)	`PI`, `MAX_TIMEOUT`, `MIN_AGE`
Module	Snake case	`script.py`, `my_app.py`
Package	Snake case (không có dấu gạch dưới)	`package`, `mypackage`

Snake case (snake_case): chữ thường, các từ được ngăn cách bằng dấu gạch dưới.
Pascal case (PascalCase): các từ viết hoa chữ cái đầu.

Ví dụ chi tiết hơn về cách kết hợp tất cả:

import my_module


class ImportantClass:
	MY_CONSTANT = 3.14
	def good_function(self, variable):
		return variable
		
	def better_function(self):
		return MY_CONSTANT
		

def __name__ == '__main__':
	var = my_module.secret()
	important_class = ImportantClass()
	important_class.good_function(var)
	print(important_class.better_function())

Hãy chú ý đến tất cả các kiểu khác nhau ở đây!