zifter Jan 10 2020 at 20:30

Разработка идеального pypi пакета с поддержкой разных версий python

15 min

22K

Python*

Tutorial

From sandbox

+35

Comments 16

stalker1984 Jan 10 2020 at 21:19

210 k пакетов. Интересна статистика. К примеру, кто сколько человек написали основные используемые библиотеки? Или сколько человек придерживают свои пакеты более 2-3 лет? И всё в таком духе, а то может половина пакетов это конвертация "hello world" в шестнадцетиричное значение.

longclaps Jan 12 2020 at 01:13

а то может половина пакетов это конвертация «hello world» в шестнадцетиричное значение.

Так и есть.
Огромное количество пакетов — результат разовой потуги что-нибудь залить, встречаются пакеты, состоящие лишь из что-то обещающего readme.md
Да и пакет топикстартера — не луч света в тёмном царстве, а упражнение в духе «натяни побольше сов на глобус».
Афтор, для кого твой пакет?

zifter Jan 12 2020 at 17:30

В статье два раза явно указал, что это мануал. Да и сама статья помечена как Tutorial.

GamePad64 Jan 11 2020 at 13:09

Mypy (как и остальной типизированный Python) внедрить — дело хорошее. Он сразу создаёт контракт правильного использования библиотеки, что как бы дополняет документацию.

zifter Jan 12 2020 at 17:24

Согласен!
Правда, мне кажется, что имеет смысл интегрировать для python3.5+.
Если опыт использования для 2.7?

prostomarkeloff Jan 13 2020 at 02:41

Есть. И много где. Только хинты в комментариях надо указывать ;(

GamePad64 Jan 14 2020 at 03:31

Да, у mypy есть режим для работы с 2.7, в котором хинты в комментариях указываются. Особенно интересно, что есть пакет typing для Python 2.7 с портированными типами из 3.4.

sobolevn Jan 12 2020 at 01:39

Можно взять например github.com/wemake-services/wemake-python-package

Там есть все из списка, но и еще куча дополнительных ништяков вроде: `wemake-python-styleguide`, `mypy`, правильный набор плагинов для `pytest`, `poetry` для управления зависимостями, куча всего для безопасности (`bandit`, `safety`, `snyk`)

Meklon Jan 12 2020 at 20:02

Персональный плюс в карму за репозиторий) Благодарю.

Meklon Jan 13 2020 at 01:52

Блин. Мне придется переписывать код) можно интегрировать этот вариант flake8 в pycharm?

sobolevn Jan 13 2020 at 10:34

Да, можно: plugins.jetbrains.com/plugin/11563-flake8-support

Meklon Jan 12 2020 at 03:10

Спасибо огромное! Мне очень пригодилось.

prostomarkeloff Jan 13 2020 at 02:40

П.С поддержка 2.7 продлена до апреля

zifter Jan 14 2020 at 22:34

Спасибо!
Долго искал пруфов, нашел таки:
http://pyfound.blogspot.com/2019/12/python-2-sunset.html

S0mbre Jan 14 2020 at 15:52

Спасибо за статью. И все же, не покидает ощущение, что это немного из области "из пушки по воробьям". Конечно, это мануал, и для крупных пакетов большинство из этого может пригодиться… Но мне лично (ленивому питонисту) легче написать, отладить, прогнать базовые тесты и залить (например на тот же гитхаб) используя штатные решения. И позволить пользователям с наслаждением пинать мой код в багтрекере, если что-то вдруг не поддерживается :)

zifter Jan 14 2020 at 22:32

Согласен, для простых пакетов — это сильное переусложнение. Но как понять, что проект становится крупным?..

Для ленивых питонистов (к коим я себя так же отношу) старался сделать так, чтобы копирования tox.ini было достаточно для старта разработки нового пакета. Таким образом будет автоматизирован прогон тестов, линтеров и форматеров, что, согласитесь, уже не мало :)