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

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

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

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

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

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

Совместимость между версиями Elixir без изменения основной версии

Дополнения и исправления к версиям Elixir совместимы с предыдущими версиями: определённые поведения и документированные 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 без ошибок. Только следующий выпуск дополнительной версии, в данном случае v1.5.0, эффективно использует новые возможности, предоставляемые последним выпуском Erlang/OTP.

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

Политика

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

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

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

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

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