Не читается по-английски
Анти-паттерн
Неправильный порядок слов в названиях или неестественное их сочетание усложняет чтение. Слова должны располагаться в том порядке и сочетании, в котором они были бы расположены в правильной английской речи.
Пример 1¶
Плохо:
num_active_users = ...
Хорошо:
active_users_num = ...
Пример 2¶
Плохо:
def user_info_get(user_id):
...
Хорошо:
def get_user_info(user_id):
...
Пример 3¶
Плохо:
class ConverterCurrency:
def __init__(self, exchange_rate):
self.exchange_rate = exchange_rate
def convert_amount(self, amount):
return amount * self.exchange_rate
Хорошо:
class CurrencyConverter:
def __init__(self, exchange_rate):
self.exchange_rate = exchange_rate
def convert_amount(self, amount):
return amount * self.exchange_rate
Пример 4¶
Для английского языка такое словосочетание является неествественным.
Плохо:
class EmployeePerson:
...
Хорошо:
class Employee:
...
Пример 5¶
Плохо:
def get_statistics_salary(all_vacancies):
...
Хорошо:
def get_salary_statistics(all_vacancies):
...
Пример 6¶
Плохо:
def soon_birthday(args):
...
return birthday_datetime
Хорошо:
def calculate_birthday(args):
...
return birthday_datetime
Пример 7¶
Плохо:
ENABLE_CALCULATE_COMMISSION_APPLICATION: bool = Field(...)
Хорошо:
ENABLE_APPLICATION_COMMISSION_CALCULATION: bool = Field(...)
Пример 8¶
Плохо:
ENABLE_CALCULATE_INCOME_RUB_DEAL: bool = Field(...)
Хорошо:
ENABLE_DEAL_INCOME_RUB_CALCULATION: bool = Field(...)