PEP - Python Enhancement Proposal

PEP расшифровывается как Python Enhancement Proposal. PEP - это проектный документ, предоставляющий информацию сообществу Python или описывающий новую функцию для Python, его процессов или среды. PEP должен содержать краткую техническую спецификацию функции и ее обоснование. В этой категории находятся переводы PEP на русский язык.

Часть категории Продвинутый Python.

PEP 257 - Соглашения для строк документации (docstrings)

Аннотация

Этот PEP описывает семантику и соглашения, связанные со строками документации Python.

Обоснование

Целью данного PEP является стандартизация структуры строк документации: что они должны содержать и что они должны объяснять (не затрагивая синтаксис разметки внутри строк документации). PEP содержит соглашения, а не законы или синтаксис.

“Универсальное соглашение обеспечивает удобство сопровождения …

PEP 20 – The Zen of Python (Дзен Python)

Давний Python-разработчик Тим Питерс лаконично изложил основные принципы великодушного пожизненного диктатора Гвидо ван Россума по разработке Python в 20 афоризмах, из которых только 19 были записаны.

The Zen of Python (оригинал)

Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than …

PEP 8 - руководство по написанию кода

Этот документ описывает соглашение о том, как писать код для языка Python, включая стандартную библиотеку, входящую в состав Python.

Этот документ и PEP 257 (Docstring Conventions) были адаптированы из оригинальных рекомендаций Гвидо ван Россума "Руководство по стилю Python", с некоторыми дополнениями из руководства по стилю Барри.

Многие проекты имеют свои …