# ★ Django-ROA, pour une architecture orientée ressources

Il y a un projet sur lequel je travaille depuis un moment maintenant dans le cadre de mes prestations et que j'ai décidé de libérer (sous licence BSD) car je pense qu'il peut être utile à pas mal de monde : Django-ROA.

## Qu'est-ce que ça fait ?

Il s'agit de pouvoir gérer ses ressources distantes normalement accessibles en REST directement via l'ORM et les modèles de Django. Le module va s'occuper (comme le montre le merveilleux schéma ci-dessous) de convertir la requête Django initiale en une requête HTTP et de convertir/déserializer la réponse en un objet Django :

Ok pour le fonctionnement mais qu'en est-il des applications ?

Le module a originellement été développé pour s'intégrer dans les architectures orientées services (SOA) ayant une contrainte REST (d'où le ROA). Cela signifie que vous pouvez brancher votre application sur une base de données métier sous réserve qu'elle ait une interface HTTP. Ce qui ouvre la porte aux bases non supportées par Django nativement, aux entrepôts de données et aux multi-databases puisque vous pouvez spécifier une URI par modèle... Soyons encore plus fous, CouchDB parle le HTTP, et bien il suffirait d'un connecteur approprié pour pouvoir accéder aux documents via des modèles Django !

Lors d'EuroDjangoCon, Jesper venait de sortir django-piston (qui est utilisé pour les tests de django-roa) et faisait des tests d'application sur Pinax. J'ai pu vérifier en communiquant avec l'API mise en place sur sa machine que je pouvais éditer des objets Pinax via une interface d'administration de Django qui était lancée sur ma machine. Ce qui signifie que l'on pourrait imaginer une interface d'administration commune à plusieurs projets (pas forcément Django) présentant des API.

Si vous avez d'autres idées d'applications, n'hésitez pas à laisser libre cours à votre imagination. Je n'ai pas parlé de RDF mais vous pensez bien que ce module est une partie intégrante de ce que j'ai appelé architecture moderne et agile ;-).

## Comment l'utiliser ?

Je ne vais pas reproduire la doc ici mais c'est relativement simple, il suffit d'hériter du Model de django-roa et de définir l'URL de la ressource avec la méthode get_resource_url_list.

Après, il y a beaucoup de settings et méthodes pour configurer tout ça, le plus intéressant pour découvrir le module est probablement ROA_MODELS qui permet de passer facilement d'une architecture locale (pour développer) à une architecture orientée ressources (pour tester grandeur nature). Sinon la lecture des tests peut être d'une grande aide.

Notez qu'il est nécessaire de patcher Django (du moins pour l'instant) avec le patch lié au ticket #10109 pour pouvoir utiliser le module avec les relations ManyToMany.

## Comment participer ?

En testant le module dans un premier temps, en enrichissant la documentation au besoin (je peux facilement vous laisser des droits si vous avez un compte BitBucket), en proposant des patchs ou tout simplement en discutant des concepts.

J'aurais le plaisir d'en présenter brièvement les détails lors de Pycon-fr (dimanche après-midi) où j'espère vous retrouver nombreux. Il y aura aussi un atelier Django le samedi après-midi pour ceux et celles qui voudraient s'y mettre !

### Articles peut-être en rapport

- Rencontres Django à Marseille le WE du 24/25 avril
- ★ Pourquoi Python et Django
- ★ Astuces et bonnes pratiques Django

### Commentaires

NiKo le 26/05/2009 :

Tu devrais publier ça en anglais !

Wim Leers le 26/05/2009 :

Premièrement: le Django pony, c'est magnifique! :D J'aimerais que la communauté de Drupal avais une telle pony irrésistible :) :P

Puis, c'est un projet que vraiment ouvre des nouvelles portes. Je ne sais pas beaucoup (ni assez) à être suffisamment capable de juger ceci, mais ça semble impressionnant!

P.S.: Je m'excuse pour mon français terrible, il y a eu trop longtemps que j'ai pu la pratiquer :(

汇率网 le 26/05/2009 :

Django rocks!

David, biologeek le 26/05/2009 :

@NiKo : j'ai fait mon possible pour diffuser aussi l'info en anglais mais je voudrais rester en français ici :(

@Wim Leers : Merci pour l'effort d'avoir écrit en français ! Il faut l'essayer pour se faire une idée du potentiel à mon avis.

@汇率网 : indeed ;)

Gilles le 26/05/2009 :

T'es un dieu du poney ! *Super boulot*.

nautilebleu le 26/05/2009 :

Une tendance du déploiement web actuel est me semble-t-il de remplacer de gros sites monolithiques par plusieurs petits sites (~ un projet django), car c'est plus facile à développer, plus simple à maintenir (système de droit plus simples, volumes de données à servir, etc) Mais parfois on a aussi besoin d'avoir une vue d'ensemble, notamment pour les administrateurs. J'aime donc assez bien l'idée de "méta-admin"

Martin Catty le 26/05/2009 :

Si j'ai bien compris, c'est l'équivalent d'ActiveResource qu'on utilise avec Ruby on Rails.

Quand on commence à y goûter on ne veut plus faire que des archis orientées ressources.

Beau boulot en tout cas.

David, biologeek le 26/05/2009 :

@Gilles : wow, merci :)

@nautilebleu : oui, c'est d'ailleurs avec ce cas d'utilisation qu'a été développé django-roa (appli monolithique à scinder). Et effectivement, c'est ce que Joe Stump a répondu lors d'EuroDjangoCon lorsqu'on lui a demandé comment est-ce qu'il voyait l'évolution de Django : comme un tableau de contrôle.

@Martin Catty : oui je viens de re-jeter un œil à ActiveResource et c'est très proche en effet, d'ailleurs je vais voir comment ils ont résolu certains problèmes auxquels je suis confronté ;)

david le 26/05/2009 :

beau boulot en effet.
je vote pour la traduction anglaise

et également pour un portage app engine ;-) (certes y a du boulot avec les foreign keys ;-)

汇率计算器 le 27/05/2009 :

Nice article about django.

Troll le 04/11/2009 :

"...c'est ce que Joe Stump a répondu lors..."

Joe Stump ? Le guitariste copié/collé d'Yngwie Malmsteen ? Ok je sors...

Jean-André Santoni le 05/01/2010 :

J'ai eu l'occasion de tester Django-ROA, c'est impressionnant ! Je suis impatient de la sortie du prochain pony (Django-ROA sur un store RDF).

D'après vous, serait il facile d'introduire du versionning dans Django-ROA ? J'entend par là permettre au client de stocker localement des entrées, et de pouvoir les proposer au serveur (ou pas).

J'ai croisé plusieurs projets (OpenAnzo et SemVersion) qui permettent de faire du versionning sur un store RDF. C'est justement ce que je cherche à faire avec Django.

David, biologeek le 05/01/2010 :

@Jean-André Santoni : merci pour ce retour ! :-)

Concernant le store RDF, il y a des personnes qui s'y intéressent de près dernièrement pour pouvoir parler à Virtuoso notamment. De mon côté je bataille pour rendre ROA compatible Django 1.2.

Pour le versionning, je ne me suis pas posé la question, il faudrait que je regarde comment ces projets fonctionnent. En tout cas si tu as des propositions de patchs pour faciliter ça, n'hésite pas !