Стиль кода / Python / Хабрахабр

Стиль кода

По просьбам хабраюзеров я сделал перевод текста, составленного abchernin на основе PEP 8 — «Styleguide for Python Code» (см. топик).

Некоторые фразы я переводить не стал, потому что они к сути дела не относятся, но содержат в себе забавную игру слов.

Надеюсь, вам будет полезна моя работа: pdf, 200кб

В google docs (thx to Zubchick)

Исходник в pages и word:
cloud.github.com/downloads/DBudd/public/styleguide.pages
cloud.github.com/downloads/DBudd/public/styleguide.doc

+44

29 ноября 2009, 21:40

Guido van Rossum, Ba…

Budd

комментарии (41)

pda1983 29 ноября 2009, 22:01 #

По-моему, лучше было бы выложить сюда саму статью, а не ссылку.

Budd 29 ноября 2009, 22:05 # ↑

Там больше 10 страниц, примеры разного кода…
Может быть.

pda1983 30 ноября 2009, 11:11 # ↑

Ну, может всю статью и не нужно, но хотя бы часть — основные тезисы, чтобы было понятно без открытия внешних источников о чем речь.

sultee 29 ноября 2009, 22:09 #

главное, чтоб через полгода-год статья с того сервера не потерялась)

Budd 29 ноября 2009, 22:11 # ↑

Я очень надеюсь. Пожалуйста, посоветуйте, куда можно положить «навечно»? А то я думал-думал…

–4

fata1ex 29 ноября 2009, 22:14 # ↑

внешний накопитель :)

–4

fata1ex 29 ноября 2009, 23:38 # ↑

эээ, разве я не прав? хранить вне интернета и при утере в оном обновлять, вот, что имелось в виду. не понимаю почему минусы )

Budd 29 ноября 2009, 23:44 # ↑

Я не знаю, за что минусы. Ведь это была шутка, правда?

–4

fata1ex 30 ноября 2009, 01:09 # ↑

нет )

sultee 29 ноября 2009, 22:15 # ↑

наверно, и правда стоит продублировать текст на хабре (оставив при этом ссылку).
главное, с удобным форматированием )

еще, как вариант, github.com, на котором лежит оригинал статьи.

smsteel 29 ноября 2009, 22:19 # ↑

share.auditory.ru/2010/Alex.Smirnov/python_code_styleguide.pdf
Будет лежать «навечно» ;)

–1

dustin 30 ноября 2009, 00:47 # ↑

Рядом с
Google C++ Style Guide translated.by/you/google-c-style-guide/into-ru/trans/

zw0rk 30 ноября 2009, 22:12 # ↑

гуглдокс? :)

Zubchick 29 ноября 2009, 22:31 #

Держите, надеюсь гугл достаточно «навечен».

Budd 29 ноября 2009, 22:39 # ↑

Спасибо!

Впрочем, я уже поставил git и даже начал коммитить (раньше использовал только svn) — спасибо, sultee.

–1

sultee 29 ноября 2009, 22:43 # ↑

— спасибо, sultee

звучит как упрек :)

Budd 29 ноября 2009, 22:59 # ↑

Закоммитил.

Впрочем, оказалось, что еще проще поделиться файлом, просто сделав upload :)

еще копия: cloud.github.com/downloads/DBudd/public/python_code_styleguide.pdf — исключительно в ознакомительных с github целях.

Amper 29 ноября 2009, 22:36 #

Спасибо вам огромное за перевод…

pento 29 ноября 2009, 22:50 #

Отличная работа!

jcdenton_dx 29 ноября 2009, 22:58 #

Спасибо, автор

tips 29 ноября 2009, 23:00 #

Поместите на issuu.com/, дайте тут ссылку и будет всем счастье.

Budd 29 ноября 2009, 23:06 # ↑

Хм, скоро по комментариям можно будет писать топик «Десять способов разместить небольшую pdf-ку так, чтобы все могли ее прочитать, и хранилась бы она вечно».

Guria 29 ноября 2009, 23:46 #

суффикс ~абель~, хоть и привычен уху компьютерщиков, всё же вполне успешно заменяется более привычным русскому уху ~аем~. В результате из-за слова «читабельный», ваш текст становится менее читаемым.
ЗЫ Кстати в первом же вхождении этого слова пропущена буква

Budd 30 ноября 2009, 00:03 # ↑

Букву пропустил, каюсь (и боюсь, что опечаток в тексте больше).

Насчет «читабельный» я спорить не буду, но считаю, что это слово означает не совсем то же самое, что «читаемый», нет? А словари (Ушаков, Ожегов, Ефремова), кстати, не характериуют это слово как жаргонное, разве что пишут о разговорном оттенке.

Guria 30 ноября 2009, 00:10 # ↑

Спорить тоже не буду, лишь высказываю свою точку зрения. Давайте попробуем сравнить и понять уместность: «Читабельность имеет значение» против «Читаемость имеет значение»
Лично мне, второе кажется и уместным и более благозвучным. Ваше мнение (а также мнение большинства), естественно, может не совпадать.

Budd 30 ноября 2009, 00:25 # ↑

Изменить текст уже поздно :)

Мне казалось, что читаемость чего-то означает «как много и как часто люди читают это», скажем, «За последний год читаемость журнала выросла на треть». А читабельность, как мне кажется, означает то, насколько текст удобно и легко прочесть.

В любом случае, я учту ваше мнение в будущем, спасибо.

Guria 30 ноября 2009, 00:51 # ↑

Мне казалось (до сих пор кажется), что «читаемость» — с успехом может означать и то, и другое, в зависимости от контекста. Но коль уж словари говорят, то да — для устранения двусмысленности можно использовать вариант «читабельность», в случае её возникновения.
Ещё пример, с контекстом: «Читаемость этого кода низка из-за несоблюдения рекомендаций по именованию переменных»
ЗЫ Моё мнение подвержено изменению при хорошей аргументации

Guria 30 ноября 2009, 00:21 # ↑

А вообще спасибо за отсылку к словарям. Пояндексил. Видимо я зря считал, что суффикс абельность отдаёт иностранщиной. Тем не менее, субъективного ощущения чуждости пока не убавилось.

–1

dsCode 29 ноября 2009, 23:50 #

Уже отмечал в предыдущем топике — полезное дело, молодцы ;)

Budd 30 ноября 2009, 00:05 #

Друзья! Пожалуйста, не нужно больше копий, в этой pdf нет сакральных сведений для потомков!

НЛО прилетело и опубликовало эту надпись здесь

Budd 30 ноября 2009, 09:46 # ↑

Простите?

junk 30 ноября 2009, 11:27 #

Небольшо довесок тем, кто использует Django

docs.djangoproject.com/en/dev/internals/contributing/#coding-style

zzerf 30 ноября 2009, 13:56 #

Спасибо за труд, правда хотелось бы видеть принтабельную версию, где количество букв на квадратный дюйм несколько побольше. Реально двадцать страниц можно уместить в семь, а то и меньше.

Budd 30 ноября 2009, 19:42 # ↑

Могу выложить исходник в .pages или .doc, если нужно.

zzerf 30 ноября 2009, 20:44 # ↑

На любой файлообменник, буду весьма признателен!

Budd 30 ноября 2009, 20:52 # ↑

Pages doc: cloud.github.com/downloads/DBudd/public/styleguide.pages
Word doc: cloud.github.com/downloads/DBudd/public/styleguide.doc

rukeba 30 ноября 2009, 19:04 #

А вот как-то я переводил PEP8 для себя. По-русски и очень коротко:
rukeba.com/blog/2008/10/18/pep8-korotko-i-po-russki/

AllySanders 1 декабря 2009, 00:52 #

спасибо, как нельзя кстати!

Только зарегистрированные пользователи могут оставлять комментарии. Войдите, пожалуйста.

Языки программирования ↓

Python