Módulos

Precisamos de um lugar para nossas funções morarem, senão, elas podem se perder.

Módulos são onde nossas funções vivem. Elas não podem estar por ai sem um lugar para ficar, pois poderiam se perder e nunca mais ser utilizadas. Elixir obriga todas as funções estarem em módulos.

Para definir um modulo, utilizamos a palavra chave defmodule seguido do nome e da abertura de seu contexto usando do. No exemplo criado na seção Meu "Hello, world" podemos vê-lo no arquivo hello_world.ex

lib/hello_world.ex

defmodule HelloWorld do # aqui está o nome do nosso módulo
  def hello do
    :world
  end
end

Isso serve para quando chamarmos nossas funções. Ao invés de somente hello, temos HelloWorld.hello e facilmente sabemos quem ela é.

No arquivo de teste podemos ver como o código é executado utilizando a chamada do modulo e depois a função.

test/hello_world_test.exs

defmodule HelloWorldTest do
  use ExUnit.Case
  doctest HelloWorld

  test "greets the world" do
    assert HelloWorld.hello() == :new_world # Chamada do modulo e função
  end
end

Podemos definir diversas funções dentro de um modulo (mas não façam isso, precisamos de organização certo?). Alguns bons exemplos de módulos e funções:

• Authentication.login(user, password)

• Authentication.logout(user)

• Article.save(content)

• Article.delete(id)

• Article.update(article, new_content)

Percebem como as funções são organizadas dentro de módulos? Isso facilita a leitura e organização do código e deixa as coisas mais intuitivas.

Temos por regra:

• Todo módulo deve começar com letra maiúscula, no estilo CamelCase;
• O modulo deve conter apenas o que é necessário para sua execução;

Nome de módulos podem ter mais de uma nível de profundidade, exemplo Project.Authentication.Meta.Token e geralmente seguem a estrutura de pastas.

lib/authenticatin/meta/token.ex

Atributos de módulo

Podemos definir atributos no módulo. São um tipo de variáveis que vivem apenas dentro do módulo e nunca veem a luz do dia. Útil para utilização interna. Para declarar ela, utilizamos o arroba(@) seguido do nome do atributo e logo após o valor (sem sinal de igual). Exemplo @attribute_name 10

Vamos alterar nosso programa para concatenar o atributo de módulo em nossa resposta. Primeiro nosso teste:

test/hello_world_test.exs

defmodule HelloWorldTest do
  use ExUnit.Case
  doctest HelloWorld

  test "greets the world" do
    assert HelloWorld.hello() == "Hello, new world"
  end
end

Rode o programa e voce terá o relatório de erro

mix test
1) test greets the world (HelloWorldTest)
     test/hello_world_test.exs:5
     Assertion with == failed
     code:  assert HelloWorld.hello() == "Hello, new world"
     left:  :world
     right: "Hello, new world"
     stacktrace:
       test/hello_world_test.exs:6: (test)

Precisamos alterar nosso programa para atender a nova resposta e para isso, utilizaremos atributos de módulo, apenas para exemplificar

lib/hello_world.ex

defmodule HelloWorld do
  @message "Hello, new world" # definição do atributo de módulo
  
  def hello do
    @message # Utilização do atributo de módulo
  end
end

Basta rodar novamente o teste e tudo estará funcionando.

mix test
Compiling 1 file (.ex)
.
Finished in 0.01 seconds (0.00s async, 0.01s sync)
1 test, 0 failures

Para se manter atento

• Atributo de módulo não pode ser acessado do lado de fora do módulo.

• Suporta apenas tipos primitivos, então não poderá executar uma função para obter uma resposta diretamente nele.

Conclusão

Módulos são formas de agregar funções a fim de deixa-las próximas por contexto, facilitando a utilização e criação da mesma.