Если я меняю аргументы в методах АПИ моей либы -

это менять мажорную версию?

12 ответов

44 просмотра

лучше делай второй метод, а прошлый пиши как deprecated и поясняй "использовать второй метод" старый deprec в коде будет вызывать новый. а так надо хорошо поднимать версию

Йеп

на раннем єтапе, когда нет большого количества пользоватклей библиотеки - можешь тупо менять все что угодно, просто напиши в ридми work in progress ))

Если у тебя 0.х.х версии то в теории можно, но пользователи от такого матерятся если что. Лучше еще в ридме расписать что активно развивается и не годится для прода, могут менять методы в минорных релизах. А если 1.х.х уже есть то по семверу надо новый мажорный релиз чтобы поменять интерфейс метода, да (если ты следуешь семверу). Это так же может относиться и к набору полей структур которые принимают методы. Для структур есть маркер non exhaustive чтобы намекнуть что набор полей может дополниться, но лично я с него бешусь.

Alex Ilizarov
Если у тебя 0.х.х версии то в теории можно, но пол...

Я чтобы ломать всё что хочу каждый релиз использую версию 0.0.x)

Alex Ilizarov
Если у тебя 0.х.х версии то в теории можно, но пол...

версии с 1.x.x уже считаются "стабильными" более-менее готовыми к использованию а тут у человека еще этап сплошной разработки..

Денис Котляров
версии с 1.x.x уже считаются "стабильными" более-м...

Человек может по глупости релизить 1.х.х. По семверу в мажорных версиях допускаются breaking changes. Но на практике часто сначала что то депрекейтят в минорном или мажорном, а лишь потом удаляют

Alex Ilizarov
Человек может по глупости релизить 1.х.х. По семве...

В таком случае нужно релизнуть 2.0 и заморозить его API. После этого чётные версии стабильные, а в нечётных можно ломать что угодно 😁

ᛒ ᛖ ᚱ ᚲ ᚢ ᛊ ᛞ ᛖ ᚲ ᛖ ᚱ
Семвер не так работает, не вздумай

Вообще в семвере главное мажор инкрементить на каждом сломе апишки. Вон условная убунта у себя .04 версии под lts отдает, между мажорными проходит несколько не lts релизов

Похожие вопросы

Обсуждают сегодня

Недавно Google Project Zero нашёл багу в SQLite с помощью LLM, о чём достаточно было шумно в определённых интернетах, которые сопровождались рассказами, что скоро всех "ибешни...
Alex Sherbakov
5
Вот еще странный косяк, подскажите как бороться. Я git clone сделал себе всего embassy и примеры там запускаю. Всё хорошо. Но вот решил в cargo.toml зависимости не как в приме...
Lukutin R2AJP
1
https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_h_common.erl#L174 https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_olp.erl#L76 15 лет назад...
Maksim Lapshin
20
Раз начали говорить про embassy, то присоединюсь со своими парой вопросов. 1) Есть ли сопоставимые аналоги для асинхронного кода в emdebbed? 2) Можно ли внутри задач embassy ...
NI_isx
6
Всем привет, нужна как никогда, нужна помощь с IO в загрузчике. Пишу в code16 после установки сегментных регистров, пишу вывод символа. Пробовал 2 варианта: # 1 mov $0x0E, %a...
Shadow Akira
14
Добрый вечер, Пока не совсем понимаю как наладить общение между телеграм ботом и ПО для работы с сим боксом. По самому боту так понял: - Нужен некий баланс, который можно поп...
Magic
6
Коллеги, я тут для личных нужд пошел ставить MQTT сервер, пощупал mosquitto, но ужаснулся отсутствию такой банальности, как HTTP API для посмотреть список топиков. А тут что,...
Maksim Lapshin
14
У меня задача: написать брокер сообщений. Очереди и потребители. Очереди поддерживают приоритеты. Очередь отдает сообщения, только обработчикам с соответствующими характеристи...
Aleksandr Filippov
2
Решил тут попробовать embassy на bluepill. Все установил, собрал blink и успешно залил с помощью St link 2 китайского. Но после этого чип шиться перестал. На форумах прочел, ч...
Lukutin R2AJP
6
Немного оффтопа: а кто на чем сидит для осдева в плане ide/редактора? Последнее время сидел на vscode, но я его прям не могу нормально воспринимать, перешел на сlion, но меня...
Evg Resh
29
Карта сайта