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.

POST /recipes

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

===

201

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

~~~ Validation

400

"Erreur..."

Liste

GET /recipes

===

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

Suppression

DELETE /recipes/:id

===

204

""

~~~ Id invalide

404

"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

Récupération, permet également de récupérer une recette en spécifiant le format attendu

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

===

Content-Type: ...

...Données...

~~~ Format invalide

400

"Invalid format"

~~~ Id invalide

404

"Invalid id"

~~~ Si authentification invalide

401
WWW-Authenticate: Basic

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

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

• tasks.json
• airport.xml
• recipes.yaml

Conversion

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

...Contenu a convertir...

===

200
Content-Type

...Contenu converti...

~~~

400

...Erreur...

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"}]}]}

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>