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

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. Erlang ежегодно выпускает новую основную версию. Наша цель — поддерживать три последние версии Erlang в момент выпуска Elixir. Таблица совместимости показана ниже.

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. Функция удаляется. Это может произойти только в выпусках MAJOR. Это означает, что устаревшие функции в Elixir v1.x будут удалены только в Elixir v2.x.

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

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