EEx.eval_file :functions option in eval is deprecated


I am studying《Build Your Own Web Framework in Elixir》, In about chapter 7 when I follow the book write code like this:

  def render(view_module, conn, file, assigns) do
    functions = view_module.__info__(:functions)

    contents =
      |> html_file_path()
      |> EEx.eval_file([assigns: assigns], functions: [{view_module, functions}])

    Controller.render(conn, :html, contents)

I get a warning: warning: :functions option in eval is deprecated, and I checked the official document EEx.html#module-options, which doesn’t have functions options, I also check Elixir version before v1.10.0, also don’t have this option, my question is:

  1. In EEx.eval_file if I want to pass a functions option, what should I do?
  2. Where does the functions option come from at the beginning? seems the document never wrote about this option, so how does the author of this book know this?

One can always look at the code, not just the documentation. Though it it hadn’t been documented it likely wasn’t supposed to be used.

I followed your suggestion, find out the source code here: do_eval, after that I cannot go further, It is not easy for me. :smiling_face_with_tear: Also, nothing mentioned cannot use :functions as an option.

This part is in the parser itself:

Thank you so much! I will try to follow your step to see how to do without using :functions

This option was there in Elixir 1.12.3 for the last time (see Code — Elixir v1.12.3)

It was then deprecated in the version 1.13.0 (see

Thank you so much! my searching ability is so weak… :sweat_smile:

The changelog just say:

  • [Code] Environment options in Code.eval_quoted/3 and Code.eval_string/3, such as :aliases and :tracers, have been deprecated in favor of passing an environment

I still don’t know what to do, if I cannot solve it, I have to just mark it and move on, until one day I can. :smiling_face_with_tear:

First of all, I was dealing with a same/similar problem few weeks back, so your searching ability is not weak, I just already invested some time in it previously. :slight_smile:

This :functions option is just a list of functions that will be automatically imported thus available to be used in your view without the full module path needed. For example, if you would provide something like functions: [{MyApp.MyModule, [hello: 0]}], (0 being the arity (number of args) of the foo function) then you can use <%= foo() %> in your template. Without the :functions option, you just have to do <%= %>, that is all.

Hope this helps a bit.

Thank you for your explanation again, :sweat_smile:

I understand you now, but I still don’t know what the alternative way to do if the official doesn’t suggest we pass functions option? How to do that with env? I cannot just do EEx.eval_file("xxx.html.eex", [assigns: assigns], __ENV__). :smiling_face_with_tear:

Sorry, I have no knowledge of that and have no time to research it. Maybe someone else could help with that. :pray:

1 Like

That expects there to be an alternative. Maybe there is none and you’re expected to instead update the templates to not depend on the deprecated functionality.

Thank you for your answer, I will try to refactor the code not to do this.