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

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

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

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

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

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

Совместимость между версиями Elixir с одинаковым значением MAJOR

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

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

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

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

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

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

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

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

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

Версионирование Erlang/OTP независимо от версионирования Elixir. Erlang выпускает новую основную версию ежегодно. Наша цель состоит в том, чтобы поддерживать последние три основные версии Erlang к моменту выпуска Elixir. Таблица совместимости показана ниже.

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.4 или более поздней версии.

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

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

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