Synthèse

Elixir

Logo Elixir

Présentation

Elixir est un langage de programmation fonctionnelle et dynamique. Il repose sur la machine virtuelle Erlang (BEAM) et sa syntaxe est inspirée de Ruby, bien qu'il reprenne également quelques fonctionnalités intéressantes de d'autres langages comme Python. Elixir implémente également la philosophie Let It Crash. Il est également possible de mettre à jour du code sans que les connexions existantes soient interrompues.

• Crée en 2011 par José Valim, qui est un contributeur reconnu de Ruby
• La première version d'Elixir (1.0) est sortie en 2014
• Licence Apache

Cas d'utilisation

Elixir est recommandé pour les logiciels dont le trafic est important et qui ont besoin de temps de réponse très bas. L'utilisation de websockets et de channels avec Elixir va permettre de réaliser des communication en temps réel.

• Discord

• Pinterest

• WhatsApp (codé en Erlang)

Avantages

Grâce au support de la machine virtuelle Erlang (BEAM), Elixir fournit également les services suivants :

• Une haute disponibilité
• Des fonctionnalités en temps réel
• Une résistance aux erreurs
• Une faible latence (des temps de réponse très bas)
• Tolérance à la panne : si un processus crash, cela ne fera pas crasher l'ensemble des processus. Une illustration serait pour des appels téléphoniques, un appel qui coupe ne fera pas couper tous les autres appels qui ont lieu en même temps.
• Rechargement à chaud : la publication de mise à jour se fera après avoir terminé l'utilisation du processus. Ainsi, si un processus est en cours d'utilisation (par exemple un appel passé avec WhatsApp), la mise à jour ne se fera pas pendant cette utilisation mais à la fin (après avoir raccroché).

• Les commentaires dans le code et la possibilité de spécifier des exemples génèrent de la documentation automatiquement ainsi que des tests unitaires

Licence

MIT License, Copyright (c) 2014 Chris McCord

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Phoenix

Présentation

Phoenix est le framework de référence pour Elixir. Grâce à des channels, il permet de simplifier l'implémentation d'applications web en temps réel. Grâce à la haute disponibilité d'Elixir et de la machine virtuelle Erlang, environ 2 millions de connexions en simultanée peuvent se faire sur une seule machine. Phoenix est l'équivalent pour Elixir de Ruby on Rails pour Ruby. Afin de comparer les deux, le temps de réponse d'accès à une page qui est en interaction avec une base de données est de l'ordre de millisecondes, tandis que pour Ruby on Rails cela serait de l'ordre de dizaines de millisecondes.

• Licence MIT

Installation

Les commandes suivantes sont à lancer dans un Terminal.

Elixir

Vérifier la version d'Elixir installée : elixir --version

Erlang permet de compiler du code Elixir. Vérifier que Erlang a bien été installé en lançant : erl

Sous MacOS

Homebrew

brew update
brew install elixir

MacPorts

sudo port install elixir

Sous Ubuntu / Debian

wget https://packages.erlang-solutions.com/erlang-solutions_1.0_all.deb
sudo dpkg -i erlang-solutions_1.0_all.deb
sudo apt-get update
sudo apt-get install esl-erlang
sudo apt-get install elixir

Outils fournis par Elixir

• Iex est une console shell interactive.
• ExUnit est un framework de test / cadriciel de test qui permet d'écrire et générer des tests concis. Ainsi, les rapports d'erreurs sont compréhensibles et facilement repérables.
• Mix est un outil pour le build, la création, la compilation, le test et pour gérer les dépendances.

Hex

Hex est un gestionnaire de paquets dont la documentation est générée automatiquement à partir du code. Elle est ainsi toujours à jour.

mix local.hex

Phoenix

mix archive install hex phx_new
mix archive.install https://github.com/phoenixframework/archives/raw/master/phoenix_new.ez

Node.js

Lien de téléchargement sur le site officiel

Vérifier la version installée : node --version

PostgreSQL

Lien de téléchargement sur le site officiel

Client PostgreSQL (optionnel)

Plusieurs clients PostgreSQL peuvent être trouvés sur le lien suivant.
Celui testé dans le cadre de notre découverte d'Elixir et Phoenix est Postico, disponible sous MacOS, qui fournit une interface graphique permettant de visualiser la base de donnée.

Extensions VSCode

code --install-extension mjmcloug.vscode-elixir
code --install-extension joshjg.vscode-credo
code --install-extension iampeterbanjo.elixirlinter

Documentation officielle

• Phoenix Framework
• Elixir

Génération d'un nouveau projet

Création

La commande phx.new crée un nouveau projet dans le dossier hello-phoenix dont le nom du module principal est helloPhoenix.

mix phx.new hello-phoenix --app helloPhoenix`

Lancement du serveur HTTP (Cowboy)

mix phx.server

sur le serveur local localhost:4000. Le port 4000 est modifiable dans le fichier config/dev.exs.

Lancement des tests

mix test

Base de données

Avec l'image docker Postgres

Cela permet de stocker les données de l'API.

docker run -d -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres

Initialisation

mix ecto.create

Il est également possible d'utiliser le langage MySQL au lieu de PostgreSQL en ajoutant --database mysql à l'initialisation.

Générer un CRUD

On peut générer automatiquement une entité Utilisateur pour gérer des comptes utilisateurs. Les champs sont personnalisables, la liste de tous les champs est disponible ici.

mix phoenix.gen.html Accounts user users name:string age:integer

Cette commande permet de générer plusieurs fichiers tels qu'un Controller, un Module, une Vue, un Template. La seule action à réaliser est d'ajouter dans le router router.ex le chemin vers la page /user.

 scope "/", helloPhoenix do
        pipe_through :browser

        get "/", PageController, :index
        resources "/user", AccountsController # À ajouter
    end

Ne pas oublier de migrer la base de données avec la commande mix ecto.migrate

Quelques erreurs rencontrées lors de l'utilisation de Phoenix et leurs solutions

Commande	Erreur	Solution
mix excto.create	FATAL 3D000: database "postgres" does not exist. The database couldn't be created, database "postgres" does not exist	createdb postgres
mix ecto.migrate	ERROR 42P07 (duplicate_table): relation "table" already exists	Depuis Postico, supprimer la base de donnée en question

Bibliographie

• https://linuxfr.org/news/elixir-phoenix-et-membrane
• https://www.julienrollin.com/posts/decouverte-du-langage-langage-elixir-et-du-framework-phoenix/ (+++)
• https://riptutorial.com/fr/phoenix-framework
• https://www.youtube.com/watch?v=1hl_z9-QO9c
• https://www.youtube.com/watch?v=ZUNzXbIP_FQ
• https://hexdocs.pm/phoenix/Mix.Tasks.Phx.Gen.Html.html