Ce TP a pour but de vous faire créer une premiere application rails et d'en découvrir les premiers concepts, en particulier :
Ce TP a pour but de vous faire créer une première application Rails et d'en découvrir les premiers concepts, en particulier :
* L'arborescence d'une application Ruby on Rails
* L'arborescence
* Les outils en ligne de commande
* Les outils en ligne de commande
* Les routes
* Les routes
* Les modèles
* Les modèles
* Les controllers
* Les migrations
* (....)
* Les contrôleurs
* Les vues
## Préliminaires
## Note importante
Si la commande n'est pas donnée, c'est qu'elle dans le cours ou le lien fourni.
> Si la commande n'est pas donnée, c'est qu'elle est dans le cours ou le lien fourni.
(....)
## 1. Installation de rails
## Installation de rails
* Vérifiez la version de sqlite et de ruby sur votre système
Vérifier la version de sqlite et de ruby sur votre système
* Installez la gemme rails (comme a déjà installé `rspec`) sauf qu'il n'est pas utile d'ajouter quoi que ce soit dans notre `PATH` (c'est déjà fait).
Installer la gem rails (comme a déjà installé rspec) sauf qu'il n'est pas utile d'ajouter quoi que ce soit dans PATH
## 2. The Rails Command Line
## The Rails Command Line
Pour les étapes suivantes, nous allons nous servir des outils en ligne de commande fournis par rails :
Pour les étapes suivantes nous allons nous servir des outils en ligne de commande fournis par rails :
https://guides.rubyonrails.org/command_line.html (vous avez une liste à droite)
https://guides.rubyonrails.org/command_line.htm
### 2.1. Création de l'application
### Création de l'application
Créer une application rails portant le nom "jdlc"
Créer une application rails portant le nom "jdlc"
Observez les fichiers qui sont créés et les dépendances installées
Observez les fichiers qui sont créés et les dépendances installées.
Allez dans le dossier jdlc, vous êtes à la racine de l'application.
Allez dans le dossier jdlc, vous êtes à la racine de l'application.
Vous retrouvez l'arborescence décrite dans le cours, visitez là.
Vous retrouvez l'arborescence décrite dans le cours, **visitez là**.
### Lancement de l'application
### 2.2. Lancement de l'application
`bin/rails server` lance un serveur web sur le port 3000.
`bin/rails server` lance un serveur web sur le port 3000.
C'est fait votre application fonctionne !
C'est fait, votre application fonctionne !
Les logs de l'application sont affichés dans le terminal.
Les logs de l'application sont affichés dans le terminal.
Allez voir à quoi elle ressemble avec votre navigateur préféré sur http://localhost:3000
Allez voir à quoi elle ressemble avec votre navigateur préféré sur http://localhost:3000
### Modifier la page d'accueil
### 2.3. Modifier la page d'accueil
On va commencer par personnaliser la page d'accueil.
On va commencer par personnaliser la page d'accueil.
Créer un controller `HomeController` avec une action `welcome`.
* Créer un contrôleur `HomeController` avec une action `welcome`.
Servez vous du générateur décrit dans la documentation (`bin/rails generate`)
* Servez-vous du générateur décrit dans la documentation (`bin/rails generate`).
Modifier config/routes.rb pour faire pointer la racine (/) sur l'action `welcome` de `HomeController`
* Modifier `config/routes.rb` pour faire pointer la racine (/) sur l'action `welcome` de `HomeController`.
Retournez dans le navigateur et rafraichissez la page (F5)
* Retournez dans le navigateur et rafraichissez la page (F5)
Modifiez maintenant la vue concernée avec un contenu simple tel que :
* Modifiez maintenant la vue concernée avec un contenu simple tel que :
```
```
<h1>Les joyeux de la couronne</h1>
<h1>Les joyeux de la couronne</h1>
@ -73,39 +72,104 @@ Modifiez maintenant la vue concernée avec un contenu simple tel que :
<p>Bienvenue !</p>
<p>Bienvenue !</p>
```
```
Retournez dans le navigateur et rafraichissez la page (F5)
* Retournez dans le navigateur et rafraichissez la page (F5)
Affichez la source HTML de la page
* Affichez la source HTML de la page
Vous remarquerez que la vue ne contient que le `<body>` de la page HTML.
Vous remarquerez que la vue ne contient que le `<body>` de la page HTML.
Si vous souhaitez modifier le layout, pour modifier la balise `<title>` par exemple, vous le trouverez dans `app/views/layouts/application.html.erb`
Si vous souhaitez modifier le layout, pour modifier la balise `<title>` par exemple, vous le trouverez dans `app/views/layouts/application.html.erb`
### Ajouter des créatures
## 3. Créer un modèle Creature
* Générez un modèle `Creature` dotée :
* d'un nom (`name`) en chaine de caractère (type `string`)
* d'un nombre de points de vie (`health_points`) en entier (type `integer`)
* Observez les fichiers créés
* Retournez dans le navigateur et rafraichissez la page (F5) : que se passe t-il ?
* Allez voir le fichier de migration indiqué sur la page.
> Les migrations sont un moyen pratique de modifier votre schéma de base de données au fil du temps de manière cohérente. Elles utilisent un DSL en ruby pour que vous n'ayez pas à écrire du SQL à la main, ce qui permet à votre schéma et à vos modifications d'être indépendants de la base de données.
* Lancez les migrations pour mettre à jour votre base de données.
* Retournez dans le navigateur et rafraichissez la page (F5) : tout est rentré dans l'ordre.
* Ajouter une méthode `to_label` à `Creature` pour la conversion de la créature en texte : "Nom (pv)"
### 3.1. Tester notre modèle Creature
On va se servir de la console rails pour tester notre modèle `Creature`.
Comme irb, elle permet d'executer du code ruby en live, mais au sein de son application Rails.
Pour créer une créature, il faut appeler la méthode create sur classe `Creature`.
Cette méthode, fournie par ActiveRecord, créé une instance de créature et la sauvegarde en base de données.
- d'un nombre de points de vie (health_points) en entier
Observez les fichiers créés
* Lancez une console rails, créez des créatures et testez la méthode `to_label`.
Retournez dans le navigateur et rafraichissez la page (F5) : que se passe t’il ?
* Observez les requêtes SQL correspondantes qui sont exécutées.
Allez voir le fichier de migration indiqué sur la page.
### 3.2. Peupler sa base de donnée avec des créatures (Seeds)
(Explication rapides des migrations rails)
On veut initialiser notre application avec un nombre aléatoire de créature.
Pour ajouter des données initiales après la création d'une base de données, Rails dispose d'une fonctionnalité intégrée appelé "seeds".
Il s'agit d'un script ruby qui va peupler la base de donnée. (`db/seeds.rb`)
#### Gestion de dépendances : bundle
Pour ajouter un peu de réalisme on va donner des noms fantasy à nos créatures, pour ça on va utiliser la gemme https://github.com/folkengine/random_name_generator
* Lire la documentation de bundler https://bundler.io/guides/getting_started.html#getting-started
* Suivez la documentation pour installer la gemme (https://github.com/folkengine/random_name_generator#installation)
* Relancer le serveur
> Les binaires de `./bin` chargent le bundle de dépendances.
#### Faire un peu le ménage
Maintenant, modifiez le fichier `db/seeds.rb` :
* Créez un nombre aléatoire de créature (entre 10 et 20).
* Chaque créature à un nom réaliste (généré grace à la gemme `random_name_generator`) et un nombre de point de vie aléatoire.
* Les seeds doivent afficher chaque créature créée via `to_label`.
Voici un exemple de sortie :
```
$ bin/rails db:seed
Création de Ignacol (14)
Création de Gubress (19)
Création de Dorveds (3)
Création de Gorlduriel (19)
Création de Pabeill (17)
Création de Valdad (9)
Création de Ladakat (15)
Création de Guhanoth (7)
Création de Awbast (2)
Création de Drunafat (20)
Création de Deshignal (16)
Création de Rakbis (18)
```
Lancer les migrations
## 4. Afficher les créatures sur l'accueil
Modifier le modèle pour ajouter une méthode to_label à Créature pour la conversion de la créature en texte : "Nom (pv)"
On souhaite afficher sur l'accueil le nombre de créature en base et leur “labels”.
### Tester
* Chargez les créatures et le count dans le contrôleur
Expliquer #create (lien vers la doc? ou c'est comme le new mais ça créé en base)
* Modifier la vue pour les afficher, avec des `<ul>` / `<li>` (voir cours)
Expliquer la console
On remarque qu’on a en base de données les créatures créées en console en plus des seeds.
Tester de créer des créature et la methode to_label en console (bin/rails c)
tim
2 years ago
committed by