Совместимость и устаревшие функции

Elixir имеет версионирование по схеме vMAJOR.MINOR.PATCH.

В настоящее время Elixir находится на основной версии v1. Каждый 6 месяцев происходит выпуск новой совместимой с предыдущими версиями ветви MINOR. Выпуски PATCH не планируются и выполняются при наличии исправления ошибок или патчей безопасности.

Elixir применяет исправления ошибок только к последней ветви MINOR. Патчи безопасности доступны для последних 5 ветвей MINOR:

О новых выпусках объявляется в списке рассылки объявлений. Все релизы безопасности будут помечены с [security].

В настоящее время нет планов на выпуск основной версии v2.

Совместимость между версиями Elixir (не основные)

Выпуски Elixir MINOR и PATCH совместимы с предыдущими версиями: хорошо определённые поведения и документированные API в данной версии будут продолжать работать в будущих версиях.

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

• Безопасность: может возникнуть проблема безопасности в реализации, решение которой требует несовместимых с предыдущими версиями изменений. Мы оставляем за собой право устранять такие проблемы безопасности.

• Ошибки: если у API есть нежелательное поведение, программа, которая зависит от ошибочного поведения, может выйти из строя, если ошибка будет исправлена. Мы оставляем за собой право исправлять такие ошибки.

• Фронтенд компилятора: могут быть улучшены функции компилятора, добавляя новые предупреждения для неоднозначных режимов и предоставляя более подробные сообщения об ошибках. Это может привести к ошибкам компиляции (при запуске с --warning-as-errors) или сбоям инструментов при утверждении определённых сообщений об ошибках (хотя следует избегать такого подхода). Мы оставляем за собой право вносить такие улучшения.

• Импорты: в модуль Kernel, который импортируется автоматически, могут быть добавлены новые функции. Они могут конфликтовать с локальными функциями, определёнными в ваших модулях. Конфликты можно разрешить с помощью import Kernel, except: [...] со списком всех функций, которые вы не хотите импортировать из Kernel. Мы оставляем за собой право добавлять такие функции.

Для продолжения эволюции языка без внесения несовместимых изменений Elixir будет использовать устаревание, чтобы снизить приоритет определённых практик и продвигать новые. Наша политика устаревания изложена в разделе "Устаревшие функции".

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

Совместимость между Elixir и Erlang/OTP

Версионирование Erlang/OTP независимо от версионирования Elixir. Каждая версия Elixir поддерживает определённый диапазон версий Erlang/OTP. Таблица совместимости показана ниже.

Хотя Elixir часто добавляет совместимость с новыми версиями Erlang/OTP в выпущенных ветвях, таких как поддержка Erlang/OTP 20 в v1.4.5, эти релизы обычно содержат минимальные изменения для работы Elixir без ошибок. Только следующий выпуск MINOR, в данном случае v1.5.0, эффективно использует новые возможности, предоставляемые последним выпуском Erlang/OTP.

Устаревшие функции

Политика

Устаревание функций в Elixir происходит в 3 этапа:

1. Функция мягко устаревает. Это означает, что в CHANGELOG и документации функция должна быть указана как устаревшая, но при выполнении кода никакого предупреждения не выдаётся. Мягкое устаревание функции необязательно.

2. Функция эффективно устаревает, выдавая предупреждения при использовании. Это также известно как жёсткое устаревание. Для того, чтобы устареть, предложенная альтернатива ДОЛЖНА существовать ПО КРАЙНЕЙ МЕРЕ в течение трёх версий MINOR. Например, Enum.uniq/2 была мягко устаревшей в пользу Enum.uniq_by/2 в Elixir v1.1. Это означает, что предупреждение об устаревании может быть выведено только Elixir v1.4 или более поздней версии.

3. Функция удаляется. Это может произойти только в крупных выпусках. Это означает, что устаревшие функции в Elixir v1.x будут удалены только в Elixir v2.x.

Таблица устаревших функций

Первый столбец — версия, в которой функция была жёстко устаревшей. Второй столбец кратко описывает устаревшую функцию, а третий столбец объясняет замену и с какой версии доступна замена.