РУС | EN

14 июня(суббота) 2014 Москва

Телефон: +7 (499) 403-10-11 (многокан)
E-mail: 2014@devconf.ru

Разбор типичных ошибок при создании Open Source библиотеки

Андрей Светлов - python Core Developer или просто committer в http://hg.python.org/.

Сейчас архитектор в LevelUp http://levelupers.com/.

Доклад(45 мин)

Вы запилили нечто очень полезное и даже выложили на github.
Только этим никто не пользуется.

Разбираем проблемы, ищем решение.

Чтобы на поделку обратили внимание нужны:

-- Социальность и публичность
-- Документация
-- Тесты
-- Система контроля версий (версии, релизы) и багтрекер
-- setup.py, pypi и readthedocs

Подробно:
И, наконец, Программный Код.

-- Ясность интерфейсов и абстракций
-- Четкое разделение на Public API и детали реализации.
-- Напишешь пером -- не вырубишь и топором
-- Менять Public API в следующем релизе -- верный способ узнать всех своих пользователей поименно.
-- Docstrings
-- Выбор хороших имен классов-методов
-- Естественная полнота Public API
-- Следование устоявшимся соглашениям
-- магические методы
-- collections.abc
-- предметная область или почему нельзя перегружать "+" для матрицы.

Каждый пункт снабжен примерами и антипримерами.


Программа конференции