Семантическое версионирование - человечья нумерация версий пакетов

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

Версия указывается в формате X.Y.Z-STATE.

🔸 X - мажорная/старшая версия пакета. Увеличиваем ее когда в пакете происходят изменения без обратной совместимости, при этом удаляем все deprecate-методы. Изменение X ведет за собой обнуление Y и Z.

🔸 Y - минорная/младшая версия пакета. Увеличиваем, когда в пакете появляется новая функциональность. Придержите коней, и не удаляйте старевшие методы, помечайте их как deprecated, тем самым вы подготовите пользователей к их удалению.

🔸 Z - версия патча. Увеличивайте, выпуская каждый патч, исправляющий ошибки или улучшающий функциональность.

🔸 STATE - опциональная мета-информация о состоянии пакета: alpha, beta, rc и т.д.

Более подробно почитать можно тут и на хабре.

#пишемхорошийкод

Proxyman - дебаггер/снифер запросов, который делает вашу профессию интереснее.

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

Вот ты изучил API сервера, написал прекрасный код, создал нужные структуры, подписанные на протокол Codable, далее пульнул все это в URLSession и наслаждаешься результатом. Но внезапно что-то пошло не так: то ли запрос неверный, то ли ответ кривой (что более вероятно, твой код конечно же идеален).

И на этом этапе вступает в дело дебаггер сетевых запросов Proxyman, или один из его аналогов: Postman и Charles. Ты смотришь тело запроса и ответа и определяешь, что идет не так, где твой код неверно кодирует JSON. Это очень полезная тулза, которая должна быть наготове у каждого разработчика. Установка и настройка с установкой сертификатов, занимает всего пару минут, а удовольствие от использования не проходит никогда.

Кстати в последнем опросе от Devcrowd Proxyman вошел в топ инструментов разработчика. А узнал о нем в свое время от основателя Coffee&Code Сергея и моего питерского коллеги по VK - Артема. За что им огромное спасибо.

#инструменты

Книга Наука DevOps. Ускоряйся

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

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

Самая важная мысль - если разработчик видит результаты своей работы, то работу он делает с удовольствием. Валяние в болоте, постоянные переделки, не позволяющие довести продукт до потребителя - все это отрицательно сказывается на разработчике, продукте и бизнесе в целом.

#книга

NEOVIM - идеальный консольный текстовый редактор с максимальным уровнем кастомизации

NeoVim - это форк хорошо известного VIM. И если в вашей жизни есть что-то кроме Xcode или Android Studio, или вы просто любите используете Терминал, то вам стоит попробовать.

Как было сказано в одном из обзоров - увеличение производительности особенно прочувствуют те, кто обладает десятипальцевым способом печати. В этом случае мышка совершенно не нужна (да она и не поддерживается в редакторе), а все операции производятся практически без смещения кистей. То есть вам не нужно постоянно двигать руку с клавиатуры к мышке и обратно. Звучит на самом деле интересно. А в купе с максимальным уровнем кастомизации и возможностями iTerm + Oh My Zsh - NeoVim может стать буквально продолжением ваших пальцев.

Ну а если Vim и так ваш любимый редактор, то просто попробуйте. Установка через Brew, MacPorts или самостоятельная сборка из исходников.

https://github.com/neovim/neovim

#инструменты

Network Link Conditioner
Теперь встроенный в 14 хкоде)

@_spi - атрибут для тех, кто пишет фреймворки.

Как вы добиваетесь того, чтобы ваша библиотека содержала и общедоступный, и приватный код? Под приватным я имею ввиду ту часть кода, которая доступна «особым» пользователям библиотеки, например сервисные функции для дебага, не нужные обычному пользователю, или какие-то скрытые функции, которые нужны вам в своем проекте, но не должны быть доступны сторонним пользователям.

Обычно используют следующие варианты решения:
1) «Нет никаких приватных функций, пусть все функции будут общедоступными». Но так вы перегружаете список доступных функций, окно автодополнения и вызываете у пользователя библиотеки вопросы.
2) «Сервисные функции начинаются с _», вроде _enableDebugMode(). Итог как и в пункте 1.
3) Самый радикальный, но наиболее безопасный - выпуск нескольких версий библиотеки, одна со скрытым функционал, и одна только с общедоступным.

Но есть и другой способ - атрибут @_spi, который позволяет скрывать часть функционала вашего фреймворка и делать его доступным только при определенных условиях.

Так например вы можете пометить любые функции, методы, а возможно и свойства (не знаю, не проверял) с помощью @_spi(имя), и данный элемент станет доступным пользователю только если он импортирует библиотеку с помощью конструкции ```@_spi(имя) import ВашаБиблиотека```.

Пример смотрите в картинке ниже поста.

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

Обратите внимание, что нижнее подчеркивание в названии означает, что атрибут все еще экспериментальный, правда эксперимент затянулся, а сам атрибут довольно активно используется сообществом.

SPI - System Programming Interface. Это тот же API, только «системный» или «сервисный».

Почитать можно тут. Так же обратите внимание на @_spiOnly и @_spi_available по той же ссылке.

🎧🎙️Подкаст Кофе и Код с моим участием «ушел на золото».

Получилось интересно, не только и не столько о разработке, сколько о пути к ней, причем не о моем, а о вашем. А еще про то, как писались книги, о работе в ВК, и мысли о том, кому нужно идти в разработку.

Спасибо, что пишите и даете обратную связь по вашим успехам.

https://coffeecodepodcast.mave.digital

Тут ссылки на все доступные подкастерские платформы

📕 LLVM: Инфраструктура для разработки компилятора

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

Компилятор Swift основан на проекте LLVM. Это целая инфраструктура программных решений, на ее основе существуют решения для C, C++, Objective-C, JavaScript, Kotlin и многих других языков.

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