Как я начал open source фреймворк разрабатывать

 Публичный пост
21 ноября 2026  26

Предыстория

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

И вот на последней работе свершилось долгожданное: основная часть продукта - опен сорсная. Классно показывать другим какие клевые штуки мы делаем, будь-то какой-то функционал или фича в продукте, но как по мне, еще круче, когда можно рассказать и показать как это устроено под капотом. Более того, я заметил, что это заставляет думать немного по-другому (по крайней мере, меня).

Хочется сделать все качественно, красиво, с минимумом костылей или если уж ставить их, то делать это осознанно и по-возможности переделывать, не откладывая в слишком уж долгий ящик. Хочется иметь чистую и понятную архитектуру, побольше комментариев, ибо есть ощущение, что читать этот код буду не только я и условный ревьювер, но вполне себе могут зайти сторонние люди, для которых важным фактором в принятии решений об использовании продукта будет открытый код и его качество, могут быть и желающие поконтрибьютить, всем им хотелось показать хороший, читаемый и понятный проект.

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

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

Кажется, я созрел...

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

Попробовал зайти с другой стороны: в любой компании вполне нормальная часть работы - заниматься велосипедостроением под решение какой-то конкретной задачи, где готового подходящего решения нету. Обычно такие велосипеды строят исключительно под свои нужды и они вот вообще не факт, что могут быть полезны условно в другой компании, и уж тем более не всегда их готовы выкладывать в паблик - и это нормально. Но что, если все же попытаться сделать такой велосипед, который действительно закрывает какие-то относительно узкие задачи, но так, что бы он был достаточно модульным и его можно было относительно удобно разобрать и подкрутить под свои нужды более или менее широкому кругу потенциально заинтересованных? Уже получше.

По итогу, подобных задач (а соответственно и идей их решения) у меня было 2: библиотека-прослойка с унификацией API под разные биржи (типа binance/kraken/okx/etc) и фреймворк для написания event-driven сервисов (определение ивентов, удобные broker-agnostic интерфейсы для отправки и подписки + там сверху еще паттернов всяких можно прикрутить). Крипта меня к тому моменту, признаться, несколько подзаебала, а делать хотелось для души, поэтому выбор пал на второе.

Если что, я не то что бы спецом выбирал идеи только для библиотек, я был вполне не против написать и какой-то сервис/утилиту/что-то запускаемое, но просто идей под это в тот момент не было совершенно.

Ну, понеслась

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

Поначалу все было очень кайфово. Я занимался любимым делом: изучал, проектировал, реализовывал. Я здесь специально не буду вдаваться в подробности, ибо это все же не пост-презентация проекта. Хочу лишь сказать, что у меня сформировалось видение того, что я хочу сделать и я это делал. Этот период я называю конфетно-букетным.

Я доделал первую версию, описал несколько примеров использования, в целом мне все нравилось. Но вообще, по-нормальному надо бы добавить документацию для проекта, а не только примеры. А документацию кода я изначально практически не писал. Ох блять, какая же это была ошибка...

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

Примерно неделю спустя... Разорвав на груди последнюю рубашку, а на жопе волосы я таки добил документацию до достойного уровня. Все же хотелось, что бы на docs.rs красовалась красивая циферка покрытия документацией 90%+, да и если проект кому-то презентовать, отсутствие документации сразу стало бы ред флагом и поводом к этому проекту больше не возвращаться никогда.

Пора показать себя миру

И вот настал великий день, мне дали в руки бюлютень я зарелизил первую версию своей библиотеки. Костяк проекта готов, тесты проходят, документация написана, очень общий роадмап и понимание куда двигаться дальше тоже есть. Но лучший толчок для развития любого проекта - это фидбэк от реальных пользователей. Значится, пора таковых искать и привлекать.

Внезапно я понял, что понятия не имею как показывать проект и искать потенциальных пользователей. Дело усложняется еще и тем, что это фреймворк, а не условная утилита или сервис. Аудитория сужается до разработчиков, которые пишут на конкретном языке, решают определенные относительно узкопрофильные задачи и, что немало важно, еще не имеют собственного велосипеда. Так же, поскольку фреймворк работает с определенными технологиями (базы данных, брокеры), теоретически аудитория сужается еще и этими факторами (хоть и новые коннекторы добавлять можно относительно несложно, при необходимости пользователь может даже сделать это в своем коде, без необходимости релизить апдейт моей библиотеки).

Окей, аудитория неширока, но более или менее определена. Надо искать среду обитания. Поскольку я и сам разраб, несколько таких мест я уже знал - всяческие дискорды, разработческие форумы да и банально телеграмм чатики, ну и тот же реддит. В теории, можно попробовать еще затесаться в условный awesome-rust (awesome "anything" - достаточно популярные списки различных утилит/библиотек/да чего угодно), но там есть требование, что бы проект был не новым ноунеймом, а уже хотя бы с какой-то аудиторией (зачастую смотрят на количество звездочек/скачиваний и подобные метрики).

Хорошо, куда писать тоже более или менее понятно. Надо писать пост. Пробовал поискать какие-то хорошие практики, но тут все достаточно банально: хотелось бы написать не очень много текста, обязательно приложить какой-то базовый пример, ну и разумеется, четко описать какие проблемы этот фреймворк призван решать. Пост был написан достаточно быстро, по-сути собран из кусочков readme и немножко адаптирован под разные платформы (где-то писал на русском, где-то на английском, где-то были ограничения по количеству символов и тому подобное).

Публикуем!

Промежуточные итоги

Пожалуй, для понимания картины следует описать мои (ни на чем не основанные, если что) ожидания: я надеялся, что в течении недели под постами наберется какое-то количество лайков (показывает потенциальную заинтересованность), будет несколько комментариев с вопросами. Если кто-то начнет пользоваться (одно или несколько скачиваний) - это победа.

Собственно, неделя прошла, а активности оказалось минимум. Было меньше десятка лайков, 0 комментариев, 0 скачиваний. Затесалась мысль, что я где-то подобосрался. То ли все же тема никому вот прям совсем неинтересна, то ли посты оформил хреново... начал ресерчить что и как вообще другие публиковали в недавнее время, какая активность там. Оказалось, что все примерно так же: посты оформлены по-разному, где-то лучше где-то хуже, но активность везде околонулевая. То, что я набрал вообще хоть каких-то лайков, по сравнению с некоторыми выглядело даже каким-то своеобразным унылым всратеньким успехом.

Чуть позже я понял в чем причина. Буквально через несколько дней после публикации моего поста, на одном из форумов решили вообще подурезать категорию анонсов. На какое-то время посты из этой категории просто замютили, но самое интересное, что по этому поводу там же завели обсуждение с объяснением проблематики. Дело в том, что посты-анонсы многих очень заебали. На форуме по несколько раз в неделю регались новые юзеры, писали свои анонсы с каким-то нейрослопом без нормального описания что оно такое и зачем вообще нужно, после чего пропадали из поля видимости на форуме буквально навсегда. Собственно, людям надоело смотреть все эти анонсы, а уж тем более тратить время на то, что бы отличить - это что-то самописное, с какой-то идеей и развитием или очередное нейрохрючево сделанное на коленке с херовой кучей багов и будет забыто самим же автором уже завтра.

Примечание: разумеется я утрирую и очень жестко делю на самописное хорошее и нагенеренное херовое, реальность же чуть комплекснее. Но тут именно хотелось передать общую усталость от таких вот безответственных горе-авторов, которые пытаются добиться внимания здесь и сейчас за счет чего-то сделанного на отъебись и забывают про свой же проект на следующий день не получив достаточного по их мнению хайпа. Хуже только те, кто потом переехал с подобными "анонсами" в категорию "код ревью", но это отдельная история.

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

Вместо послесловия

Послесловия нету, ибо история не окончена (тут, кстати, игра слов, ибо фреймворк, что я пишу, называется historia). Я продложаю развивать проект, пытаюсь мониторить релевантные площадки на предмет вопросов, где мои наработки могли бы закрыть чью-то боль, периодически отчитываюсь об апдейтах во всяческих тематических тредах вида "кто чем занят на этой неделе". У фреймворка есть какие-то скачивания, по несколько раз в неделю. Не исключено, что это один или несколько уже реальных пользователей.

Так что история продолжается...

Откомментируйте первым 👇

😎

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

Что вообще здесь происходит?


Войти  или  Вступить в Клуб