Совместимость и устаревание

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. Функция фактически устаревает, выдавая предупреждения при использовании. Это также известно как жёсткое устаревание. Для устаревания функции предлагаемая альтернатива ДОЛЖНА существовать В ТЕЧЕНИЕ МИНУМУ 3 незначительных версий. Например, Enum.uniq/2 была мягко устаревшей в пользу Enum.uniq_by/2 в Elixir v1.1. Это означает, что предупреждение об устаревании может быть выдано только Elixir v1.4 или более поздней версией.

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

Таблица устаревания

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