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

Версии Elixir имеют схему vMAJOR.MINOR.PATCH.

В настоящее время Elixir находится на версии 1. Новый обратный совместимый выпуск minor происходит каждые 6 месяцев. Выпуски 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 в выпусках patch, например, поддержку 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.

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

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