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

     2 

     3 .. _installationGAE:

     4 

     5 Installation de `CubicWeb` pour GoogleAppEngine

     6 ===============================================

     7 

     8 Qu'est-ce que `LAX` ?

     9 =======================

    10 

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

    12 web basé sur `Google AppEngine`.

    13 

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

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

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

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

    18 sur le "datastore" de `Google AppEngine`.

    19 

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

    21 

    22 

    23 Téléchargement des sources

    24 ==========================

    25 

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

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

    28 

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

    30   http://lax.logilab.org/

    31 

    32 

    33 Installation

    34 ============

    35 

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

    37 l'arborescence suivante::

    38   

    39   .

    40   |-- app.yaml

    41   |-- custom.py

    42   |-- data

    43   |-- ginco/

    44   |-- i18n/

    45   |-- logilab/

    46   |-- main.py

    47   |-- mx/

    48   |-- rql/

    49   |-- schema.py

    50   |-- simplejson/

    51   |-- tools/

    52   |   |-- generate_schema_img.py

    53   |   `-- i18ncompile.py

    54   |-- views.py

    55   |-- yams/

    56   `-- yapps/

    57 

    58   

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

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

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

    62 

    63 

    64 Lancement de l'application de base

    65 ==================================

    66 

    67 Plusieurs répertoires doivent être accessibles via la variable 

    68 d'environnement ``PYTHONPATH`` ::

    69 

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

    71 

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

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

    74 

    75 Pour démarrer::

    76 

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

    78 

    79