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

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

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

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

Основные релизы Elixir могут содержать несовместимые изменения, и они будут явно указаны в CHANGELOG. В настоящее время нет планов на релиз с новой основной версией 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.3 или более поздней версии.

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

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