1 Qu'est-ce que ``LAX`` ?

     2 =======================

     3 

     4 ``LAX`` (Logilab Application engine eXtension) est un framework 

     5 d'application web qui facilite les développements faits pour

     6 ``Google AppEngine``.

     7 

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

     9 applicative développée par Logilab depuis 2001. Cette plate-forme 

    10 publie des données que la partie stockage tire de bases SQL, 

    11 d'annuaires LDAP et de systèmes de gestion de version. Depuis mai 

    12 2008, elle fonctionne sur le "datastore" de ``Google AppEngine``.

    13 

    14 ``LAX`` est pour le moment en version alpha.

    15 

    16 Django/GAE vs. LAX/GAE

    17 =======================

    18 

    19 NotImplementedError()

    20 

    21 

    22 Téléchargement des sources

    23 ==========================

    24 

    25 - Les sources de ``Google AppEngine`` peuvent être obtenues à l'adresse

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

    27 

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

    29   http://lax.logilab.org/

    30 

    31 

    32 Installation

    33 ============

    34 

    35 Les sources de ``Google AppEngine`` doivent être décompressées et le

    36 répertoire `google` qui s'y trouve doit être accessible par la variable

    37 d'environnement ``PYTHONPATH``. Correctement définir le ``PYTHONPATH`` 

    38 n'est pas nécessaire pour le lancement de l'application elle-même mais 

    39 pour l'utilisation des scripts fournis par ``LAX`` ou pour l'exécution 

    40 des tests unitaires.

    41 

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

    43 l'arborescence suivante::

    44   

    45   .

    46   |-- app.yaml

    47   |-- custom.py

    48   |-- data

    49   |-- cubicweb/

    50   |-- i18n/

    51   |-- logilab/

    52   |-- main.py

    53   |-- mx/

    54   |-- rql/

    55   |-- schema.py

    56   |-- simplejson/

    57   |-- tools/

    58   |   |-- generate_schema_img.py

    59   |   `-- i18ncompile.py

    60   |-- views.py

    61   |-- yams/

    62   `-- yapps/

    63 

    64   

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

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

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

    68 

    69 

    70 Lancement de l'application de base

    71 ==================================

    72 

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

    74 

    75