本稿は「Elixir の互換性について」をもとに加筆・補正し、文章を整えました。
非推奨の機能の警告表示
Elixirは互換性を大事にしている言語です。そのため、古い機能も比較的長く残っています。
たとえば、HashDictを使うことは、Elixir 1.4から推奨されなくなりました(deprecated)。けれど、Elixir 1.7.4でも警告は出るものの、削除されていません。
iex> HashDict.new()
warning: HashDict.new/0 is deprecated. Use maps and the Map module instead
#HashDict<[]>
また、Elixir 1.3まであったEnum.partition/2という関数は、Elixir 1.4からひっそりとドキュメントから消されました。しかし、今でも呼び出して使えます。
iex> Enum.partition([1, 2, 3], fn(x) -> rem(x, 2) == 0 end)
warning: Enum.partition/2 is deprecated. Use Enum.split_with/2 instead
{[2], [1, 3]}
さらに、Code.load_file/2やCode.loaded_files/0およびCode.unload_files/1などの関数は、Elixir 1.7から非推奨とされてドキュメントから除かれたものの、使っても警告は出ません。
deprecatedの警告がいつから出て、それらの機能がいつまで残っているのか気になるところです。
互換性のポリシー
答えはElixir公式ドキュメント「Compatibility and Deprecations」の「Deprecations」に示されています。機能の廃止は、つぎの3つの段階を踏んで進められるということです。
- 機能をやわらかな非推奨(soft-deprecation)とします。CHANGELOGとドキュメントの機能リストでは非推奨とするものの、コードを効果的に動作させるため、警告は出しません。機能を使わないよう強いられることはないのです。
- 機能を使ったとき警告を出して、非推奨であることが告げられます(hard-deprecation)。機能が円滑に削除できるよう、必ず代替手段が示されなければなりません。そのあと少なくとも2マイナーバージョンが経過してから警告が示されます。
- メジャーバージョンがリリースされたとき、非推奨の機能は削除されます。つまり、現在のElixir 1.xで非推奨とされている機能は、Elixir 2.xで除かれるということです。
Elixir 1.5のHashDictにdeprecated の警告が出るのは、Elixir 1.2でMapという代替機能が追加されてsoft-deprecatedになり、２マイナーバージョンを経たElixir 1.4以降になったからです。
これに対して、Elixir 1.7で非推奨とされたCode.load_file/2やCode.loaded_files/0およびCode.unload_files/1などは、代替機能としてそれぞれCode.compile_file/2とCode.required_files/0そしてCode.unrequire_files/1が備わったものの、２マイナーバージョンが経過していないため、soft-deprecatedとされているのです。
これらの機能は Elixir 2.0で削除されます。逆にいえば、ドキュメントから消えたりdeprecatedの警告が出るものの、Elixir 2.0までは残っていることが保証されています。
なぜsoft-deprecationの段階があるのか
多くのユーザは、わざわざCHANGELOGを見ないでしょうし、これまで動いているモジュールのドキュメントを改めて調べることは少ないと思われます。ユーザが気づくのは deprecatedの警告が出たときです。その前に、わざわざsoft-deprecationという段階を経るのはなぜでしょうか。
おそらく、警告にしたがってただちに機能を削ったとき、古いバージョンで動かなくなってしまうことを防ぐためだと推測されます。
たとえばElixir 1.5からAtom.to_char_list/1やInteger.to_char_list/1といった.*char_list.*系の関数やアトムがすべて.*charlist.*に改められています。これによって、多くのライブラリが警告を出すようになりました。だからといって、すぐに直すとElixir 1.4で動かなくなってしまうなら、もう少し先に延ばそうということになるかもしれません。
しかし、.*charlist.*周りの実装は、実はElixir 1.3から入っています。つまり、警告が出た時点ですぐ直しても、過去２マイナーバージョンで動作することが保証されているのです。それが理由だとすれば、soft-deprecationはよくできた仕組みだと考えられます。
まとめ
以上のとおり、Elixirは互換性をかなり大事にしています。Elixir 2.0までは、古いコードも動くようです。安心して計画的にアップデートを行いましょう。
Top comments (0)