DEV Community: Allef Gomes

Adicionando Boostrap 5 em um projeto Phoenix

Allef Gomes — Mon, 02 Jan 2023 10:58:13 +0000

Olá, pessoas!

Normalmente quando se fala de aplicação phoenix, se fala também de tailwindcss, mas nem todo mundo tem familiaridade com o tailwindcss. Por outro lado, existem muitas aplicações web que usam o bootstrap. Então a ideia desse tutorial é demostrar como aplicar o bootstrap nas suas aplicações phoenix de maneira rápida.

Para utilizarmos o boostrap, faremos a utilização da lib dart_sass que é um instalador e "executor" para sass.

Então vamos lá... No seu arquivo mix.exs na função privada deps, adicione a seguinte linha:

{:dart_sass, "~> 0.5.1"}

No arquivo config/config.exs adicione o código para adicionar as configurações do dart_sass:

config :dart_sass,
  version: "1.43.1",
  default: [
    args: ~w(css/app.scss ../priv/static/assets/app.css),
    cd: Path.expand("../assets", __DIR__)
  ]

Na parte de watchers no arquivo config/dev.exs iremos adicionar o seguinte código para que nossa aplicação phoenix possa assistir os arquivos sass:

sass: {
      DartSass,
      :install_and_run,
      [:default, ~w(--embed-source-map --source-map-urls=absolute --watch)]
    }

Também no arquivo mix.exs iremos alterar os aliases. Na parte chamada assets.deploy iremos adicionar o código "sass default --no-source-map --style=compressed" onde ficará semelhante ao código abaixo:

"assets.deploy": ["esbuild default --minify", "sass default --no-source-map --style=compressed", "phx.digest"]

Para finalizar, faremos mais três alterações na pasta assets. A primeira é rodar o comando npm install boostrap --prefix assets pelo terminal na pasta do seu projeto e após isso, renomear o arquivo assets/css/app.css para assets/css/app.scss e apagar todo o conteúdo do arquivo e adicionar o código

@import "../node_modules/bootstrap/scss/bootstrap";

Por fim, iremos remover o código import "../css/app.css" do arquivo assets/js/app.js e adicionar o

import "bootstrap"

Agora você pode subir a aplicação e ver que toda a sua tela inicial foi alterada.

A linguagem Rust

Allef Gomes — Wed, 14 Dec 2022 20:18:09 +0000

Olá!

Tenho aprendido Rust para poder trazer performance para alguns problemas que tenho enfrentado no trabalho. Então, este é o início de algumas anotações que irei fazer para entender e utilizar rust aqui na empresa.

Rust

A linguagem rust tem foco em eficiência e confiabilidade.
Rust traz um desempenho extremamente rápido, gerencia memória eficientemente, seu sistema de tipos e modelo de ownership garantem segurança de memória e de concorrência. Além disso, possui uma ótima documentação, compilador amigável com mensagens de erros úteis e ferramental de primeira qualidade.

Rust traz uma forma interessante de apresentar seus fundamentos que é por meio do "o livro" que apresenta uma visão geral da linguagem a partir de princípios fundamentais.

Instalação

A instalação do Rust é pelo rustup. No site oficial do rustup você pode ver como instalar no seu sistema operacional. No linux foi bem simples. Bastou rodar o comando curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh no terminal.

Após isso, pode verificar a instalação rodando o comando rustc --version que no meu caso, retornou rustc 1.65.0 (897e37553 2022-11-02).

Além do rustc, também houve a instalação do cargo que é o gerenciador de pacotes do Rust. Além de ser o gerenciador de dependências, cargo compila os seus pacotes, gera pacotes distribuídos e também realiza o upload para o crates, onde ficam as informações de pacotes para aplicações Rust.

Hello World

Presumindo que você esteja em um sistema operacional linux como por exemplo, em um Ubuntu, abra o terminal e crie uma pasta chamada hello_world_rust e entre nela. Os comandos para isso são:

$ mkdir hello_world_rust
$ cd hello_world_rust

Para a edição dos códigos, aconselho você utilizar o vscode. Então, abra o vscode na pasta do projeto. Ou seja, se você tiver entrado na pasta hello_world_rust, basta digitar no terminal code . e o vscode será aberto na pasta atual.

Crie um arquivo chamado main.rs e adicione a função main, pois ela é sempre o primeiro código que será executádo em um programa Rust. Deixe seu main.rs igual ao código abaixo:

fn main() {
    println!("Hello, world!");
}

Para poder reproduzir o código, utilize os comandos:

$ rustc main.rs
$ ./main
Hello, world!

O comando rustc main.rs compilou o código contigo no arquivo main.rs e gerou um executável chamado main.
Com o comando ./main você irá executar o programa compilado e ele irá retornar o "Hello, world!".

Conclusão

Por hoje é isso. Entendemos o que é Rust, aprendemos a instalar e criamos nosso primeiro programa. Em breve venho com mais!

Deus abençoe!

Tipos de Dados em Elixir

Allef Gomes — Tue, 10 May 2022 15:15:11 +0000

Nesse artigo, iremos entender sobre tipos básicos em elixir.
Não diferente de outras linguagens, temos alguns tipos de dados que já conhecemos, como: Inteiro (Integer), Ponto Flutuante (Float), Booleano (Boolean) e as Strings. Também existe um tipo chamado Átomo (Atom) que iremos entender sobre ele mais a frente.

Dado essas informações, vamos entendê-los:

Inteiro - Integers

Os inteiros são qualquer número, positivo ou negativo que não representam parte decimal. No elixir, temos também suporte aos números binários, octal e hexadecimal.

iex(1)> 255 # Exemplo de número inteiro
255
iex(3)> 0b0110 # Exemplo de número octal
6
iex(4)> 0x1F # Exemplo de número hexadecimal
31

Ponto Flutuante - Floats

Em Elixir, os números de ponto flutuante requerem um decimal depois de pelo menos um dígito; estes possuem uma precisão de 64 bits e suportam e para números exponenciais:

iex(1)> 1.4 
1.4
iex(2)> 5.5
5.5
iex(3)> 1.0e-10
1.0e-10

Booleanos - Booleans

Elixir suporta true e false como booleanos; todo valor comporta-se como verdadeiro com exceção de false e nil (nil é a representação de nulo). No exemplo a baixo, utilizo o ! para negar a afirmação; se algo retorna o valor true, quando nego ele retorna false.

iex(1)> true
true
iex(2)> false
false
iex(3)> !nil 
true
iex(4)> !!nil
false

Átomo - Atoms

Um átomo é uma constante cujo o nome é seu valor e é representado por : seguido de seu nome. Se está familiarizado com Ruby, estes são equivalentes aos símbolos.

iex(1)> :development
:development
iex(2)> :elixir
:elixir
iex(3)> true
true
iex(4)> is_atom(true)
true

Strings

As strings em Elixir são codificadas em UTF-8 e são representadas com aspas duplas:

iex(1)> "Hello"
"Hello"
iex(2)> "Olá Fulano"
"Olá Fulano"
iex(3)> "Olá\nMundo!"
"Olá\nMundo!"
iex(4)> "Olá 
...(4)> Mundo"
"Olá\nMundo"

Os tipos básicos são esses. Em breve veremos tipos de dados mais complexos quando aprendermos sobre coleções e funções.

Abraço, pessoal!
Siga-me para ver a continuação dessa série.

Introdução ao Elixir

Allef Gomes — Wed, 04 May 2022 17:25:51 +0000

Olá, devs!
Decidi fazer esse post para compartilhar uma trilha de conhecimentos em Elixir seguindo o próprio Getting Started.

Caso não tenha o Elixir instalado em sua máquina, você pode dar uma olhada no post que escrevi sobre como instalar o Erlang e o Elixir utilizando o asdf.

Com o Elixir instalado, ganhamos três novos executáveis: iex, elixir, elixirc.

IEX

Agora, abra um terminal e rode o comando iex. Isto irá abrir um shell interativo que poderá rodar comandos em Elixir.

ELIXIR

Também é possível rodar um script com o comando elixir PATH_DO_ARQUIVO. Nesse caso, a extensão do arquivo deve ser .exs, o que significa que esse arquivo é um script escrito em Elixir.

Para este exemplo, criaremos um simples arquivo chamado ola_mundo.exs e colocaremos o seguinte comando dentro do arquivo:

IO.puts("Olá mundo!")

Após salvar, é só rodar o comando elixir ola_mundo.exs no terminal e verá um resultado igual ao abaixo:

ELIXIRC

Por fim, temos o comando elixirc que irá compilar um arquivo .ex ou uma pasta que contenha arquivos .ex e irá gerar um .beam para cada módulo criado.
Obs: Iremos entender melhor sobre módulo nos próximos posts.

Primeiro, iremos criar uma pasta chamada primeiro_script e dentro dela vamos criar o arquivo ola_mundo.ex que contém o código abaixo:

defmodule OlaMundo do
  def run do
    "Olá Mundo"
  end
end

Também criaremos dentro da pasta primeiro_script uma pasta chamada core e dentro desta, criaremos o arquivo sucesso.ex que terá o seguinte código:

defmodule Core.Sucesso do
  def run do
    "Sucesso!"
  end
end

Feito isso, teremos uma arquitetura de pastas e arquivos da seguinte forma:

E dentro da pasta primeiro_script iremos rodar o comando que serve para compilar a pasta em que você está no terminal:

elixirc .

Se formos olhar agora, teremos arquivos com a extensão .beam que são os arquivos compilados.

Para finalizarmos, podemos dar um iex dentro da pasta primeiro_script e chamar os módulos compilados e suas funções run para vermos o resultado.

Por hoje é isso, pessoal.
Te vejo no próximo post! :)

CloudWatch e OpenSearch na AWS com multiplos grupos de logs.

Allef Gomes — Thu, 14 Apr 2022 01:52:33 +0000

Exatamente hoje, passei por uns problemas utilizando o CloudWatch da AWS para receber os logs de uma aplicação e uma instância do OpenSearch para visualização dos dados.

Acontece que foi criado o grupo de logs para ambiente de homologação - staging/serice/api_sucesso - e um para produção production/service/api_sucesso.

Acontece que os logs do staging estavam sendo indexados no OpenSearch perfeitamente, porém, quando testamos em ambiente de production os logs não conseguiam ser indexados no OpenSearch. :/

Acontece que por padrão o CloudWatch cria apenas uma função do AWS Lambda para cada domínio do OpenSearch e quando o primeiro grupo invoca a função Lambda, a chamada cria um índice e um campo de tipo no seu domínio.

A solução para isso é alterar a função Lambda na declaração da variável indexName de:

var indexName = [
        'cwl-' + timestamp.getUTCFullYear(), // year
        ('0' + (timestamp.getUTCMonth() + 1)).slice(-2), //month
        ('0' + timestamp.getUTCDate()).slice(-2) // day
        ].join('.');

para:

 var indexName = [
  'cwl-' + payload.logGroup.toLowerCase().split('/').join('-') + '-' // log group name
  + timestamp.getUTCFullYear(), // year
  ('0' + (timestamp.getUTCMonth() + 1)).slice(-2), // month
  ('0' + timestamp.getUTCDate()).slice(-2) // day
].join('.');

Obtendo assim, um prefixo do nome do grupo para indexação.

Para mais detalhes da documentação.

Testes unitários com ExUnit

Allef Gomes — Thu, 07 Apr 2022 23:12:05 +0000

Hoje participei de uma talk muito bacana no #elxpro falando sobre testes unitários utilizando o ExUnit.

Slides: https://speakerdeck.com/allefgomes/testes-unitarios-com-exunit
Código: https://github.com/allefgomes/elxpro

Instalação do Erlang e Elixir com ASDF no Ubuntu

Allef Gomes — Fri, 25 Mar 2022 16:59:25 +0000

Primeiramente vamos entender o que é o ASDF. O ASDF é uma ferramenta CLI que permite o gerenciamento de múltiplas linguagens como elixir, ruby, erlang, python, entre outras...

Para instalação do ASDF, seguimos as orientações encontradas no site https://asdf-vm.com/guide/getting-started.html

Instalação de dependencias e do Erlang
Nesse caso, vamos seguir as configurações referente ao Ubuntu 20.04 LTS. Você pode ver as configurações de diferentes distros no link do github do asdf-erlang

apt-get -y install build-essential autoconf m4 libncurses5-dev libwxgtk3.0-gtk3-dev libwxgtk-webview3.0-gtk3-dev libgl1-mesa-dev libglu1-mesa-dev libpng-dev libssh-dev unixodbc-dev xsltproc fop libxml2-utils libncurses-dev openjdk-11-jdk

Após a instalação das dependencias, instalaremos o plugin do erlang com o seguinte comando:

asdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.git

Com o plugin instalado, você pode ver todas as versões disponíveis para instalação com o comando:

asdf list all erlang

Neste caso, iremos instalar a versão 24.3.2 com o comando:

asdf install erlang 24.3.2

Com o próximo comando, deixaremos a versão 24.3.2 do erlang como a default no nosso sistema operacional.

asdf global erlang 24.3.2

Instalação do elixir
Da mesma forma, instalaremos primeiro o plugin do elixir conforme o github do asdf-elixir.

asdf plugin-add elixir https://github.com/asdf-vm/asdf-elixir.git

Após instalação do plugin, vamos instalar o elixir. Caso seja necessário olhar compatibilidade das versões do erlang e elixir, você pode conferir em https://hexdocs.pm/elixir/master/compatibility-and-deprecations.html#compatibility-between-elixir-and-erlang-otp

Nesse caso, instalaremos a versão 1.13.3-otp-24 que encontramos utilizando o seguinte comando:

asdf list all elixir

Para instalação utilizamos o comando:

asdf install elixir 1.13.3-otp-24

Para deixar essa versão global, utilizamos o comando:

asdf global elixir 1.13.3-otp-24

Agora você pode ver suas configurações do erlang e elixir com o comando elixir -v
Vale a pena ressaltar que com o asdf você pode ter um arquivo em cada projeto para utilizar a versão específica daquele projeto. Basta ter um arquivo chamado .tool-versions na raiz do projeto e o asdf irá utilizar a versão da linguagem especificada nele. Você pode ter mais informações no link.