Style Guide for Python Code: A Foolish Consistency is the Hobgoblin of Little Minds
| Английский оригинал | Перевод на русский | |
|---|---|---|
Сожалеем, но текст оригинала доступен только зарегистрированным пользователям. |
Один из принципов Guido - код читается намного чаще, чем пишется. 2tl 17.02.09 в 20:13 Один из принципов Гвидо - код читается намного чаще, чем пишется. sevenov 18.02.09 в 17:17 |
+1 |
|
Рекомендации приведенные здесь призваны улучшить удобочитаемость кода и сделать его совместимым с широким спектром Python кода. 2tl 17.02.09 в 20:15 |
||
|
Как написано в PEP 20, "Удобочитаемость важна". svartalf 17.02.09 в 14:47 Как написано в PEP 20, "Читаемость имеет значение". rnd0011 07.03.11 в 19:57 |
||
|
Руководство про согласованность. Guria 12.03.09 в 13:17 |
||
|
Согласованность с руководством - важна. Guria 12.03.09 в 13:17 |
||
|
Согласованность в рамках проекта - ещё важнее. Guria 12.03.09 в 13:17 |
||
|
Согласованность в рамках функции или модуля - наиболее важно. Guria 12.03.09 в 13:18 |
||
|
Но самое важное: когда не будет согласовываться знать -- иногда руководство просто не применимо. Guria 12.03.09 в 13:23 |
||
|
Когда сомневаетесь, используйте ваше лучшее суждение. Guria 12.03.09 в 13:24 |
||
|
Смотрите на другие примеры и решите которое выглядит лучше. Guria 12.03.09 в 13:24 |
||
|
И не стесняйтесь спрашивать! Guria 12.03.09 в 13:25 |
||
|
Две хороших причины нарушить определённое правило: Guria 12.03.09 в 13:26 |
||
|
1. Если применение правила сделает код менее читаемым, даже для кого-то, кто привык читать код следующий правилам. Guria 12.03.09 в 13:29 |
||
|
2. Что бы быть согласованным с окружающим кодом, который также нарушает их (возможно по историческим причинам) -- хотя это также удобный случай подчистить чей-то ещё беспорядок (в истинном стиле XP). Guria 12.03.09 в 13:34 |
+1 |