Зачем в Python .pyi файлы и чем они полезны? Stub файлы в Python

Рет қаралды 30,148

Күн бұрын

Мой курс «Хардкорная веб-разработка» - course.to.digital
Книжный клуб Ботаним!, где мы читаем хорошие ИТ-книги: botanim.to.digital/
Telegram: t0digital.t.me
Сказать спасибо за это видео можно здесь - boosty.to/digitalize.team
Часто в Python библиотеках можно увидеть файлы с расширением .pyi. Что это за файлы и какой код они содержат? Как всегда разберём на конкретном примере!
0:00 Введение, о type hinting в Python
1:20 Какие проблемы решают stub файлы
2:35 Пример
/****************** about ******************/
Меня зовут Алексей Голобурдин, я программирую с 2004 года и на этом канале делюсь своим опытом. Я основатель и руководитель компаний:
- Диджитализируй digitalize.team, разрабатываем сложные IT системы для бизнеса;
- Salesbeat salesbeat.pro, комплексный модуль доставки для интернет магазинов.
Если у вас есть проект на разработку, пишите нам на hi@digitalize.team.
С другими предложениями, а также если вам нужна одна или несколько индивидуальных консультаций/уроков по разработке (3000 руб/час), пишите мне на alexey@salesbeat.pro.
Telegram канал - t.me/t0digital
ВК - digitalize.team
RuTube - rutube.ru/channel/24802975/ab...
Дзен - dzen.ru/id/6235d32cb64df01e6e...

Пікірлер: 256

@user-zk3uo3ti6f 3 жыл бұрын

Белый фон жёстко бьёт по глазам, когда смотришь в темноте особенно. Старый был лучше намного.

@t0digital 3 жыл бұрын

Да, больше так не будем

@RomaxSinergy 3 жыл бұрын

Это в хромакей забыл текстуру

@qbmain1487 3 жыл бұрын

Белый фон. Вот, что значит "попал в рай без очереди"

@ni55an 3 жыл бұрын

Хромакей для расистов

@engsara1610 3 жыл бұрын

На аве у тебя главная героиня в аниме: Девушка на час?

@qbmain1487 3 жыл бұрын

@@engsara1610 да

@kennethdarlington 3 жыл бұрын

Алексей: % рассказывает про pyi файлы в python % Зрители: Стаканчик! Я_вижу_стаканчик! Как отвести взгляд от стаканчика? 🍵😨

@neodzen 3 жыл бұрын

никак, это нативная интеграция :)

@maximmashkin341 3 жыл бұрын

а что с ней не так то?

@artisstm2 3 жыл бұрын

Я: Сраные рекламщики всратой додо пиццы добрались до коментариев

@RomaxSinergy 3 жыл бұрын

- Видишь стаканчик ? И я вижу. А его нет.

@nygeJIbTB 3 жыл бұрын

Пушка! Продолжай радовать нас полезной инфой) Максимально полезная инфа ! :)

@ola_amirova 3 жыл бұрын

Супер! Спасибо! Ждём новую рубрику)

@ola_amirova 3 жыл бұрын

До до крутые

@ansor9775 3 жыл бұрын

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

@olegmlavets5216 3 жыл бұрын

Хотелось бы услышать от тебя об различных реализациях Пайтона, думаю многим будет интересно :)

@x-neimi4493 3 жыл бұрын

+ Вот реализация на JS например, позволяет python в вебе использовать. Или реализация на Rust, в которой насколько я знаю, python код получится скомпилировать

@andrey6104 3 жыл бұрын

Комментарий от python разработчика из Сибири. Видео хорошие, keep it up!

@narekbektashyan 3 жыл бұрын

Было полезно как всегда, спасибо!

@z0uRChannel 3 жыл бұрын

Отлично, так потихоньку, смотря прикольные видео, и питону параллельно можно научиться. Круто, спасибо!

@limonred5283 3 жыл бұрын

Новая рубрика огонь!

@MA-channel1 3 жыл бұрын

Рисковый номер! Впервые на арене Алексей в приветствии не называет всех зрителей котами-котонами!

@user-ee1lx1pe7n 3 жыл бұрын

Очень полезное видео! Продолжайте в том же духе)))

@user-lz3ez3nn4j 3 жыл бұрын

Спасибо за выпуск, лайк!

@valeriivolkov_ua 2 жыл бұрын

Спасибо за практическое видео! Очень интересно и полезно оказалось!

@oZopHuk 3 жыл бұрын

Диджитализируй! - познавательный. Спасибо, теперь знаю что это и зачем.

@grandvidocs 3 жыл бұрын

Спасибо большое за полезные видео!

@user-vg4kj7mx2z 3 жыл бұрын

Спасибо за видео!

@C0oo1D 3 жыл бұрын

Не все пользуются колокольчиками, и я один из них. Но я не пропускаю видео, т.к. подписок, еще и часто публикующих - не так много)

@user-wy5ww5ts8m Жыл бұрын

Всё доходчиво!!! Подача материала супер. Успехов и 1 000 000 пользователей.

@t0digital Жыл бұрын

Спасибо!

@Vlamir_ave_tonna 3 жыл бұрын

Спасибо. Было интересно и понятно.

@user-yb8bn1ur8i 3 жыл бұрын

Агонь! Вообще агонь!

@TgHaCs 3 жыл бұрын

Оч круто! Спасибо)

@user-pt6mt8ml4v 3 жыл бұрын

А на сегодня всё, до новых встреч

@zealot4325 2 жыл бұрын

Большое спасибо за видео

@SUPERustam 3 жыл бұрын

Спасибо за выпуск

@user-ur9fs8cx4f 3 жыл бұрын

Великолепно!

@govdamikhaylo4183 3 жыл бұрын

Можете снять видос как вы просто делаете какой-то проект на django если не сложно. Я буду очень рад:)

@eugeneburdin704 3 жыл бұрын

Спасибо за выпуск! Полезная инфа! Я до этого пользовался :type: в docstring. Тоже норм работает если в проекте не используется тайпинг

@jth.000 3 жыл бұрын

О! У Вас появился спонсор? Поздравляю! :)

@t0digital 3 жыл бұрын

Около 30 спонсоров на бусти, уже давно :) додо нет

@pythonq1060 3 жыл бұрын

Добрый день!, ваши видео дали мне шанс заработать с удовольствием. Спасибо большое )

@cyberblogru 3 жыл бұрын

О как. Круто. Спасибо. Пригодится.

@pukman676 3 жыл бұрын

Больше подобных полезных штук!

@MrDnovik 3 жыл бұрын

Спасибо!

@RustamGuliev 3 жыл бұрын

Добрый день! Спасибо за видео. Парочка вопросов: * Обязан ли pyi файл называться также, как тот файл, который мы описываем? * Как описывать чужую библиотеку, если я не могу класть свои .pyi файлы внутрь библиотеки с таким же названием?

@dmytrokorbanytskyi1586 3 жыл бұрын

теоретически, мы можем импортировать необходимые методы из библиотеки в такой utils-модуль и для него уже создать *.pyi файл.

@alexs7931 3 жыл бұрын

В TypeScript например тайп хинтинги не ограничиваются файлом, ide парсит хинтинг файлы, и сопоставляет хинтинги с обычным js, по имени функции или класса.

@wandos777 2 жыл бұрын

пришел на этот видос с видоса про типизированный пайтон и когда увидел реализацию стаб файлов, точнее как именно они работают и мягко говоря охренел)) какое то время понадобится, чтоб принять новую реальность :D

@Yujin.V 3 жыл бұрын

прикольно не знал, спасибо

@user-cx2vt1dj9d 3 жыл бұрын

Алексей, у вас был такой прекрасный и уютный фон! Подумайте, возможно стоит откатиться!

@t0digital 3 жыл бұрын

Точно стоит, этот не зашёл:)

@alexeyzhurov7747 3 жыл бұрын

Спасибо, хорошая инфа. Алексей, что там с курсами?

@t0digital 3 жыл бұрын

скоро-скоро

@maxzhenzhera 3 жыл бұрын

Познавательно)

@AlexGott 3 жыл бұрын

Агонь!!!

@andytheodorko9874 3 жыл бұрын

1:10 мне нравится идея Uncle Bob-a использовать автоматические тесты чтобы показать как нужно взаимодействовать с функциями и какого типа данные они принимают.

@deusexxi8426 3 жыл бұрын

Оппа, python) спасибо!

@StoGigovo 3 жыл бұрын

Как поставить 100 оайков?) И снова спасибо тебе, как всегда, самые лучшие практики и советы. Выкатывай новую рубрику в продакшен!)

@davidapk323 3 жыл бұрын

топ урок. простой и полезный

@namalnikmisartenko8785 3 жыл бұрын

Реклама ДОДО Продался! =) Не забывай переход строки в конце)) пайчарм ругается) Спасибо за видос. Прикольная штука

@t0digital 3 жыл бұрын

Додоха подняла моё настроение вкусным ореховым латте, душа требовала выразить им благодарность :) переводы да

@caesar5122 3 жыл бұрын

@@t0digital Так и запишем, оплата рекламной интеграции настроением...

@namalnikmisartenko8785 3 жыл бұрын

@@t0digital Тот момент когда в питоне куча всяких новых штук а ты сидишь ковыряешь старые легаси проекты Видимо что-то в этой жизни я делаю не так) Твои видосики подымают настроение) Спасибо)

@kubenet 3 жыл бұрын

Удобная фишка в использовании python)

@dmytroznak8843 3 жыл бұрын

Крутяк)

@SergMirny_yt 3 жыл бұрын

Огонь

@mrbush1872 3 жыл бұрын

Часто бывает необходимо скомпилировать и/или собрать пакет , например rpm кода на python , расскажи , пож-та , про лучшие способы это сделать )

@AyerAbdi 3 жыл бұрын

Спасибо за видео! Может не к месту, но чёт додо пиццу захотелось, вообще не пойму почему

@vladyslavstadnyk2762 3 жыл бұрын

Привет! Клевый канал, смотрю тебя периодически. Больше с точки зрения именно python, чем веб. У тебя есть видео про декораторы? Смысл, как их делать, а главное зачем. Никак не могу найти им применение в реальной жизни. В смысле, понятно, где их можно юзать разработчику библиотек, а разработчику обычных программ есть смысл?

@nikko374 3 жыл бұрын

Лайк за фон

@evgeniymatashkov5808 3 жыл бұрын

Почаще ролики выпускай

@user-hp6wj2fr9m 3 жыл бұрын

Спасибо. Еще один вопрос закрыт.

@senatortre7326 3 жыл бұрын

Кайф. Не по РЕР-кам ли будет рубрика?) их кажется столько, что каждый можно в отдельном видео разгонять... ждем-с.

@t0digital 3 жыл бұрын

Идея хорошая, но ближайшая задумка не по PEP'ам!

@serhiismyk3950 3 жыл бұрын

Сделай видос о правилах для линта и про препуши если юзаешь

@Vorono4ka 3 жыл бұрын

🏃🏃🏃

@t0digital 3 жыл бұрын

надеюсь, вы не выносите описания типов из .py файлов в .pyi файлы - .pyi же только для конкретных задач, в основном типы указываются в самом .py исходнике

@gendalfbeliy1 3 жыл бұрын

вообще-то в расматриваемой функции и float и int можно использовать например. Это как-то можно захинтить чтоб оба варианта принимались?

@dmitriyobidin6049 3 жыл бұрын

2020 - очередной раз объясняем людям преимущества статической типизации :)

@historymemes1344 3 жыл бұрын

Это не статическая типизация а тайп хинтинг, что является разными вещами

@RuchejAlex 3 жыл бұрын

О, мастер джедай использует технику Vim в pycharme :)

@kirillandreev8488 3 жыл бұрын

Подскажите, есть ли какая то информация по поводу ваших курсов? Когда планируется запуск?

@t0digital 3 жыл бұрын

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

@kirillandreev8488 3 жыл бұрын

Диджитализируй! Спасибо, очень хочется посмотреть на результат вашей работы)

@mikisor4372 3 жыл бұрын

Когда же Ваш курс ?

@t0digital 3 жыл бұрын

скоро-скоро

@alexanovoable 3 жыл бұрын

Как раз на крайнем Python Conf++ рассказывали про использование stubs для "обтипизации" Django силами monkeytype и волонтерами - хороший пример как и для чего можно применять сабж.

@t0digital 3 жыл бұрын

Дааа!

@alexanovoable 3 жыл бұрын

kzfaq.info/get/bejne/l9afnMSdndHWcas.html - забыл ссылку добавить

@ynxela 3 жыл бұрын

Привет, котаны!

@siberianwolf777 3 жыл бұрын

На ентерпрайсе за юзаю, даже не верится что так просто и удобно.

@AlexandrSpirit 2 жыл бұрын

Белый фон убивает если смотреть вечером, осенью, в не самой освещенной комнате )

@opusdv3503 3 жыл бұрын

Это по типу заголовочных файлов в СИ что ли?

@mrbush1872 3 жыл бұрын

А можно как-то автоматом генерировать заполнение pyi?

@t0digital 3 жыл бұрын

можно

@xacho86 3 жыл бұрын

Тема интересная, но есть вопрос. Когда мы импортируем сторонние библиотеки, они же помещаются в ExternalLibraries. Как быть в таком случае?

@olehdiatlenko4463 3 жыл бұрын

у меня колокольчик на взводе, не грусти

@t0digital 3 жыл бұрын

О, отлично :)

@andrewslee_channel 3 жыл бұрын

Спасибо за видео! P.S. А где ламповый фон?(

@t0digital 3 жыл бұрын

вернётся;)

@ntvisigoth 2 жыл бұрын

@Диджитализируй! А можешь пояснить,а почему такое кол-во Issues в репозитории Mypy ? Может и не стоит доверять ему? ;)

@t0digital 2 жыл бұрын

Там где нет issues, там просто нет пользователей. Ну и специфика такая, пайтон динамической типизации язык, непросто там сделать хорошую проверку. Проверяторов много, там не только mypy

@Antei98 8 ай бұрын

а как сделать stub file для сторонней установленной библиотеки, которая написана без type хинтингов?

@yexela 3 жыл бұрын

Мы не ищем лёгких путей! :)

@user-zg2bx5cb3d 3 жыл бұрын

Первый раз вижу, как Алексей пишет не в виме

@dmitryvlasov931 3 жыл бұрын

Ибо на это есть причина.

@user-pq2zf7cf5z 3 жыл бұрын

Ага, прям удивилися. Неужели решил наконец-то на ide перейти)

@AB-yl5xi 3 жыл бұрын

у него плагин стоит ideavim, так что по сути он пишет в виме

@aargh95 3 жыл бұрын

Значит не все видео смотрели) Ролик с Pycharm уже был (бизнес логика в джанго)

@ashotvantsyan9028 3 жыл бұрын

С какой версией Python 3 доступны pyi ?

@LewaSGN 3 жыл бұрын

Знаю, умею, практикую! Только я называю это аннотациями, а не тайпхинд... тайпхент... Виму, конечно, плевать, но мне удобнее. За видос лайк, читаемость всегда в приоритете!

@artsiomlazavikou7940 3 жыл бұрын

Вопрос возник. Что если при полиморфном использовании функции в наследниках изменить типы входящих данных - как это отразиться на стаб файлах? Надеюсь понятно изьяснился.

@kai3341 3 жыл бұрын

Спасибо за хорошее видео. Тайпхинтинг -- хорошая штука, но есть один нюанс. Для функции `custom_sum` мы указали, что входные аргументы имеют тип `int`, и функция возвращает `int`. Но работать она будет и с `float`. А потом оказывается, что прожуёт она и `decimal.Decimal`. Ну окей, у нас есть `typing.Union` -- в чём проблема перечислить? То же касается возвращаемого результата. А потом вдруг оказывается, что допустимы и типы `numpy.*` -- их предусмотреть уже нетривиальная задача. Не менее смешно, что функция прожуёт и sqlalchemy.Column -- и как такое предусмотреть? Итого по тайпхинтам у меня вопросов больше, чем ответов.

@shuwiku Жыл бұрын

Ну, если так углубляться, то можно послать всё нахрен и прописать if type(a) != 'int' or type(b) != 'int': raise ValueError('Разраб еблан')

@vktrl736 Жыл бұрын

Всем привет Не у кого не возникала проблема, что при переходе на реализацию (хочешь перейти на описание функции ctrl+клик мыши) переходит на эти pyi файлы?

@evrmk 3 жыл бұрын

Спасибо за очередное годное видео! У меня есть вопрос. При написании кода бывает полезно создавать свои типы с помощью typing, но они часто засоряют код. Как это лучше всего делать? Как раз в этих pyi файлах? Жду новую рубрику🤯

@t0digital 3 жыл бұрын

Спасибо! Pyi файлы только для особых случаев - код, который должен работать на 2 и 3 питоне или постановка типов для кода, внутрь которого нельзя влазить менять его. В остальных случаях целесообразно использовать type hintings внутри самого кода

@evrmk 3 жыл бұрын

@@t0digital Спасибо за ответ! Мне стало интересно, как в Джанге, например, используются type hintnig'и. Я посмотрел исходный код на гитхабе, но не увидел их там. Но IDE ведь даëт подсказки. Как так 😕

@t0digital 3 жыл бұрын

Приведите пример, какие IDE дает подсказки по типам в джанге?

@evrmk 3 жыл бұрын

@@t0digital PyCharm Community, но не везде (видимо, он сам где-то определяет); VS Code

@t0digital 3 жыл бұрын

Имею в виду что именно он подсказывает по типам джанги?

@shalor1k 3 жыл бұрын

Ребят , кто знает , где будут опубликованы итоги розыгрыша книг?

@t0digital 3 жыл бұрын

через неделю-другую

@shalor1k 3 жыл бұрын

@@t0digital Спасибо вам большое , что даёте обратную связь, это очень важно для нас - ваших зрителей

@dizzivoneverec2737 3 жыл бұрын

Годнота! Как раз сегодня с товарищем обсуждал то что Дижитализируй пропал и новых видосиков нету xDD

@zcbesaba 3 жыл бұрын

героическое решение проблемы, которой нету в строго типизированых языках

@t0digital 3 жыл бұрын

Вы же понимаете, что в строго типизированных языках есть свои проблемы, которых нет в динамически типизированных языках?

@Senator93rus 3 жыл бұрын

Оставь, пожалуйста, старый фон, белый тяжёлый для глаз А так, ты как всегда топ

@t0digital 3 жыл бұрын

Да, тут с фоном неудачно

@Senator93rus 3 жыл бұрын

@@t0digital спасибо большое за твое творчество!

@user-xg9wt3he9q 3 жыл бұрын

Хорошая штука, но хинтинги все-таки в питоне не особо строгие, лучше уж сразу же тогда использовать языки со статической типизацией))

@t0digital 3 жыл бұрын

Hint - подсказка, они вообще не строгие, если не накручивать сверху жестких проверок через mypy или еще что-то. Языки со статической типизацией сложны не собственно тем, что надо явно указывать тип для каждой переменной, там куча других сложностей, реально замедляющих разработку

@LoloKsyu 3 жыл бұрын

Как быть если функции с одним и тем же именем? И где ищутся соответствующие функции, внутри той же директории?

@justkrybik 3 жыл бұрын

Колокольчик поставил давно. Вот как ж...й чувствовал, когда на канал подписывался, что начну писать на пайтон... И вот случилось! На работе, пишу утилиты для системы тестирования...

@user-xv1iq3km2w 2 жыл бұрын

Всем привет, подскажите пж, как бороться с циклическими import при указании тайп хинтингов?

@t0digital 2 жыл бұрын

можно указывать подсказку типов как строку. Вместо: user: User можно так: user: "User"

@user-xv1iq3km2w 2 жыл бұрын

@@t0digital спасибо за ответ, ещё я нашёл вариант с TYPE_CHECKING модуля typing и __futute__.annotations чтобы можно было не указывать кавычки. Может кому пригодится

@govdamikhaylo4183 3 жыл бұрын

Почему я не могу отвести глаза от стаканчика:)

@user-hp9ly9qx3p 3 жыл бұрын

Мне пайтон наравится все больше и больше :-) спасибо

@kostyaten 3 жыл бұрын

А расскажи как возвращать dict с описанием типов {"a": 1, "b": "test", "c": {"hello": "word"}} ?

@t0digital 3 жыл бұрын

Я бы это возвращал не диктом, а через dataclass, например. Задав тип каждого атрибута в нём

@f0rzend59 3 жыл бұрын

Интересный видос. Без стаканчика было бы хуже

@aleksandraleksandrov4740 3 жыл бұрын

А почему нельзя в основном файле написать def custom_sum(a : int, b : int): return a + b + 123?

@t0digital 3 жыл бұрын

Можно, если ваш код не подразумевает поддержку питон 2 и если это не код внешней библиотеки, обновления которой ломать не стоит

@evgeniykuts6756 3 жыл бұрын

Алексей, MacBook поменял?

@t0digital 3 жыл бұрын

Нет, тот же, 15" 2015го года

@ntvisigoth 2 жыл бұрын

Мне как новичку в использовании аннотаций не совсем понятно вот что: Допустим у меня есть requests библиотека. То что мне надо сделать? Самому написать pyi файлы к ней и если да, то где потом лучше всего расположить так, чтоб никого из будущих читателей кода не удивлять?

@t0digital 2 жыл бұрын

Как правило на библиотеки не пишут pyi файлы - в хороших либах уже есть прописанные типы внутри. В requests почему-то нет. Ну нет и нет, надо прописывать типы самому в своём коде. У любой переменной можно взять type(var), понять, какого она типа и прописать соответствующий тип в своём коде

@Monte_Cristo_R 3 жыл бұрын

Когда курс ))? И в каком формате все таки он будет ?) уже статистика то есть по анкетам наверно , и решение выработано по-любому )...

@t0digital 3 жыл бұрын

Будет онлайн, побитый по модулям, каждый из которых можно будет прорабатывать отдельно. Первый модуль скоро выйдет.

@Monte_Cristo_R 3 жыл бұрын

@@t0digital спасибо за ответ . Просто пару месяцев как начал изучать 🐍 и немного 🤏 освоил синтаксис , но потом наткнулся на ваше видео где вы рассказываете какими знаниями должен обладать веб разработчик на пайтоне)), выписал на листик себе все пункты , охренел от объема если честно и понял что не с синтаксиса языка я начал а надо было с html и css и общих понятий , в общем начинаю потихоньку, надеюсь все получится - спасибо за ваши видео ! Жду курс , хочется вам доверять , и надеюсь он будет качественным и проработанным. А то все эти школы типа гикбрэйнс, скилфактори и т.д. , более менее сведущие люди в программировании называют сбором денег и логика моя с ними солидарна.