Recipeasy

Développer un service web permettant d'enregistrer des recettes.

Tester les fonctionnalités du serveur via des requêtes brutes dans un client Ruby

Ajout

Seul le nom est requis
Un id unique est généré pour la nouvelle recette
Les autres valeurs doivent avoir une valeur par défaut
La duration est un entier qui représente des minutes. ingredients et steps sont des tableaux de string.

http

Ajout

POST /recipes 
Content-Type: application/json

{
    name: ...,
    ?description: ...,
    ?ingredients: ...,
    ?steps: ...,
    ?duration: ...
}

===

201
Content-Type: application/json

{
    id: ...
    name: ...,
    description: ...,
    ingredients: ...,
    steps: ...,
    duration: ...
}

~~~ Validation

400
Content-Type: text/plain

"Erreur..."

Formatter la duration au format XXhYY

http

Liste

GET /recipes 

===
Content-Type: application/json

[
    {
        id: ...,
        name: ...,
        description: ...,
        ingredients: [...],
        steps: [...],
        duration: "XXhYY"
    },
    ...
]

http

Suppression

DELETE /recipes/:id 

===

204

~~~ Id invalide

404
Content-Type: text/plain

"Invalid id"

Recipeasy, suite

À partir de l'exercice Recipeasy précédent, ajouter la gestion de plusieurs usagers et l'authentification.

Chaque utilisateur ne doit pouvoir manipuler que les recettes qui lui appartiennent.
Toutes les routes demandent une authentification valide
On peut créer les utilisateurs manuellement via un tableau hard-codé pour tester

ROUTE
Authorization: Basic ...

...

~~~ Si authentification invalide

401
WWW-Authenticate: Basic

On peut également récupérer une recette, en précisant le format attendu.

http

Récupération

GET /recipes/:id 
Accept: application/json | application/yaml

===

200
Content-Type: ...

...Données...

~~~ Format invalide

400
Content-Type: text/plain

"Invalid format"

~~~ Id invalide

404
Content-Type: text/plain

"Invalid id"

Converty

Développer une application Sinatra permettant de convertir du contenu json, xml ou yaml vers l'un ou l'autre de ces formats. Compléter ce client qui utilisera les informations de l'utilisateur pour envoyer la requête de conversion au serveur.

Le serveur reçoit les informations des formats à convertir dans les headers Content-Type et Accept
- Valider que les formats sont supportés: application/json, application/xml, application/yaml
Le contenu à convertir est fourni via le body de la requète et retourné dans le body de la réponse
- Le serveur doit préciser le format de la réponse via le header Content-Type
- Si la conversion échoue, les méthodes fournies génèrent une exception que vous pouvez intercepter

Importer le fichier converty.rb dans votre application serveur et exploiter les fonctions de conversion fournies

copier

Converty::Json::to_json("le contenu a convertir")
Converty::Json::to_xml("le contenu a convertir")
Converty::Json::to_yaml("le contenu a convertir")

Converty::Xml::to_json("le contenu a convertir")
Converty::Xml::to_xml("le contenu a convertir")
Converty::Xml::to_yaml("le contenu a convertir")

Converty::Yaml::to_json("le contenu a convertir")
Converty::Yaml::to_xml("le contenu a convertir")
Converty::Yaml::to_yaml("le contenu a convertir")

Ces fichiers vous permettront de tester vos programmes

http

Conversion

POST / 
Content-Type: ...
Accept: ...

...Contenu a convertir...

===

200
Content-Type: ...

...Contenu converti...

~~~

400
Content-Type: ...

...Erreur...

bash

Utilisation du client interactif

Enter filename: airport.xml
Enter output type (json, xml, yaml): json
{"flight":[{"plane":"A380","number":"F9876","origin":"canada","destination":"usa","departure":"2022-03-12 11
:34","pilot":[{"firstname":"alice","lastname":"smith"}]},{"plane":"B737","number":"K2038","origin":"france",
"destination":"mexico","departure":"2020-09-21 17:35","pilot":[{"firstname":"bob","lastname":"jones"}]},{"pl
ane":"B747","number":"E3957","origin":"spain","destination":"france","departure":"2021-06-14 21:47","pilot":
[{"firstname":"charlie","lastname":"anderson"}]},{"plane":"A330","number":"M2775","origin":"usa","destinatio
n":"canada","departure":"2020-01-19 06:12","pilot":[{"firstname":"alice","lastname":"smith"}]},{"plane":"A38
0","number":"T3845","origin":"italy","destination":"france","departure":"2022-03-04 19:28","pilot":[{"firstn
ame":"bob","lastname":"jones"}]}]}

bash

Utilication du client CLI avec paramètres

etd@vm: ruby client.rb recipes.json xml
<opt>
<anon name="Club sandwich" description="Pain garni de poulet avec condiments" category="repas">
    <ingredients>pain</ingredients>
    <ingredients>poulet</ingredients>
    <ingredients>bacon</ingredients>
    <ingredients>laitue</ingredients>
    <ingredients>tomate</ingredients>
    <ingredients>mayonnaise</ingredients>
    <steps>Cuire et couper le poulet</steps>
    <steps>Assembler la sandwich</steps>
</anon>
<anon name="Fromage" description="Produit laitier" category="collation" />
<anon name="Canapé de saumon fumé" description="Biscuit de blé garni de saumon fumé" category="entrée">
    <ingredients>Filet de saumon fumé</ingredients>
    <ingredients>Biscuits de blé</ingredients>
    <ingredients>Fromage Brie</ingredients>
    <steps>Assembler le canapé</steps>
</anon>
<anon name="Crème de brocoli" description="Crème de brocoli cheddar bacon" category="entrée">
    <ingredients>brocoli</ingredients>
    <ingredients>crème</ingredients>
    <ingredients>cheddar</ingredients>
    <ingredients>bacon</ingredients>
    <steps>Cuire le brocoli</steps>
    <steps>Mélanger au robot avec la crème</steps>
    <steps>Servir dans un bol</steps>
    <steps>Garnir de minces tranches de cheddar et bacon haché</steps>
</anon>
</opt>

James Hoffman

Échange de données 1

Échange de données 1

4.3- Exercices

Recipeasy

Recipeasy, suite

Converty