.. -*- coding: utf-8 -*-

.. _installationGAE:

Installation de `CubicWeb` pour GoogleAppEngine

===============================================

Qu'est-ce que `LAX` ?

=======================

`LAX` (Logilab Appengine eXtension) est un framework d'application

web basé sur `Google AppEngine`.

`LAX` est un portage de la partie web de la plate-forme applicative

développée par Logilab depuis 2001.  Cette plate-forme publie des

données tirées de bases SQL, d'annuaires LDAP et de systèmes de

gestion de version. En avril 2008, elle a été portée pour fonctionner

sur le "datastore" de `Google AppEngine`.

XXX: faire un parallèle entre Django/GAE et LAX/GAE

Téléchargement des sources

==========================

- Les sources de `Google AppEngine` peuvent être récupérées à l'adresse

  suivante : http://code.google.com/appengine/downloads.html

- Les sources de `LAX` se trouvent à l'adresse suivante :

  http://lax.logilab.org/

Installation

============

Une fois décompactée, l'archive `lax-0.1.0-alpha.tar.gz`, on obtient

l'arborescence suivante::

  .

  |-- app.yaml

  |-- custom.py

  |-- data

  |-- ginco/

  |-- i18n/

  |-- logilab/

  |-- main.py

  |-- mx/

  |-- rql/

  |-- schema.py

  |-- simplejson/

  |-- tools/

  |   |-- generate_schema_img.py

  |   `-- i18ncompile.py

  |-- views.py

  |-- yams/

  `-- yapps/

On retrouve le squelette d'une application web de `Google AppEngine`

(fichiers ``app.yaml``, ``main.py`` en particulier) avec les dépendances

supplémentaires nécessaires à l'utilisation du framework `LAX`

Lancement de l'application de base

==================================

Plusieurs répertoires doivent être accessibles via la variable 

d'environnement ``PYTHONPATH`` ::

  $ export PYTHONPATH=/path/to/google_appengine:/path/to/google_appengine/lib/yaml/lib:/path/to/myapp/

Le répertoire yaml n'est nécessaire que pour le lancement des scripts

qui se trouvent dans lax/tools et pour l'exécution des tests unitaires.

Pour démarrer::

  $ python /path/to/google_appengine/dev_appserver.py /path/to/lax