Правила именования функций

[@MadMike93]

Отличный доклад) но с некоторыми вещами не могу согласиться) И они были в разделе ответов на вопросы в конце доклада))) 1. Зачем следовать каким-то другим стайлгайдам, если есть PEP8 ? Следуешь PEP8 и не имеешь проблем. 2. Функции на 60 строк кода? Что? Если функция занимает 60 строк кода, то стоит внимательно ее прочесть и понять, что из нее можно вычленить ещё несколько функций))) Я считаю, что функция должна быть МАКСИМУМ 20-25 строк кода, чтоб не читая её бросив только один взгляд было сразу видно что функция принимает, что внутри нее происходит и что она и как возвращает. В идеале одну строку должно занимать название функции и аргументы которая она принимает с тайп хинтами, вторую строку должна занимать строка документации, которая в двух словах доходчиво объясняет что внутри происходит и 1-5 строк тела самой функции, в идеале однострочник, конечно же. Но не стоит писать однострочник ради однострочника, так как главное - читаемость кода.

[@АнимусАнанимус]

kzbin.info/www/bejne/sGa6nHeHi8qMi5Y Григорий Петров хорошо объяснил, почему PEP8 - не серебряная пуля.

[@MadMike93]

@@АнимусАнанимус За Григория Петрова дикое уважение)) за 5 лет прошедших с этого доклада PEP8 стал промышленным стандартом написания кода на Python. Да и язык преобразился. Если у Вас в компании отсутствует текучка кадров как понятие, в штат не набираются новые сотрудники, программисты работают десятками лет и при сформированном годами работы стайлгайде вы внедряете Python как новую технологию, то даже в таком случае стоит задуматься об использовании рекомендаций PEP8. Опять же Григорий ещё тогда говорил, что отходить от PEP8 стоит только в случае крайней необходимости. Потому что когда ты открываешь код написанный НЕ по PEP8 у тебя постоянно крутится мысль в голове: "какого хрена? кто это писал? есть же PEP8, чувак... так сложно отделить визуально два класса друг от друга двумя пустыми строками? это же читать невозможно", вместо того чтоб быстро прочитать, проанализировать код и понять как он работает. Точно так же с двух ног врываются в язык тайп хинты)) всё это делается для того чтоб ты через неделю залетел в код и понял что там происходит, а не сидел 10000 лет пытался вникнуть что же там такое)) Пару месяцев назад мне товарищ принес нерабочий медицинский софт, который он не понимал как запускать. Написан он был на Python 2. Код года из 2004-2006. Причем написан был судя по всему немцами, так как пара комментариев было на немецком, но они были не важными, не описывающими что этот код делает, а так пара заметок о разработчиках. Весь код был строго в соответствии с PEP8, очень хорошо задокументирован (правда такие длинные и подробные докстринги я только в Django обычно наблюдаю) и очень кайфово написан и имена переменных, функций, методов и классов кричали о том кто они и зачем))) По этому понять в чём проблема не зная диалекта Python 2 (я начинал сразу изучать Python 3) не составило труда. Вот почему следует стремиться к PEP8. Чтоб через 15 лет, обычный рядовой программист из захолустья смог моментально разобраться в твоем коде. Я тогда просто сидел, читал и кайфовал от той красоты))) которая оказывается просто не работала, так как использовала какие-то системные вызовы Windows XP))))

[@АнимусАнанимус]

@@MadMike93 не знал про PEP8 как промышленный стандарт, спасибо за информацию :) Большая кодовая база без тайп хинтов - наверняка было бы очень травмирующим опытом. А где-то такое даже практикуют D:"

[@burialstance]

А есть сервис где посмотреть статистику по названиям функции в гите например?)

[@Melevir]

Хорошая идея, кстати. Надо сделать :)

[@Kialsau]

Во!! Другое дело. =)

[@Shamil788]

отлично! пошел подписываться на рассылки спикера