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

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

12 ответов

47 просмотров

лучше делай второй метод, а прошлый пиши как 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 релизов

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

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

Гайс, вопрос для разносторонее развитых: читаю стрим с юарта, нада выделять с него фреймы с определенной структурой, если ли чо готовое, или долбаться с ринг буффером? нада у...
Vitaly
9
Недавно Google Project Zero нашёл багу в SQLite с помощью LLM, о чём достаточно было шумно в определённых интернетах, которые сопровождались рассказами, что скоро всех "ибешни...
Alex Sherbakov
5
длина пакета фиксированная, или меняется?
Okhsunrog
7
Вот еще странный косяк, подскажите как бороться. Я git clone сделал себе всего embassy и примеры там запускаю. Всё хорошо. Но вот решил в cargo.toml зависимости не как в приме...
Lukutin R2AJP
5
А в каком формате фреймы? Сам формат сейчас придумываешь, или что-то готовое нужно распарсить?
Okhsunrog
5
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
Добрый вечер, Пока не совсем понимаю как наладить общение между телеграм ботом и ПО для работы с сим боксом. По самому боту так понял: - Нужен некий баланс, который можно поп...
Magic
6
Всем привет, нужна как никогда, нужна помощь с IO в загрузчике. Пишу в code16 после установки сегментных регистров, пишу вывод символа. Пробовал 2 варианта: # 1 mov $0x0E, %a...
Shadow Akira
14
Раз начали говорить про embassy, то присоединюсь со своими парой вопросов. 1) Есть ли сопоставимые аналоги для асинхронного кода в emdebbed? 2) Можно ли внутри задач embassy ...
NI_isx
6
сделал сайт, прикрутил в боте сайт, и виджет логина. как автоматически логинить пользователя в аккаунт(телеграм), при входе с бота?
Александра Чернивецкая
5
Карта сайта