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

     2 

     3 Installation de `LAX`

     4 =====================

     5 

     6 Qu'est-ce que `LAX` ?

     7 =======================

     8 

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

    10 web basé sur `Google AppEngine`.

    11 

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

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

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

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

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

    17 

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

    19 

    20 

    21 Téléchargement des sources

    22 ==========================

    23 

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

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

    26 

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

    28   http://lax.logilab.org/

    29 

    30 

    31 Installation

    32 ============

    33 

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

    35 l'arborescence suivante::

    36   

    37   .

    38   |-- app.yaml

    39   |-- custom.py

    40   |-- data

    41   |-- ginco/

    42   |-- i18n/

    43   |-- logilab/

    44   |-- main.py

    45   |-- mx/

    46   |-- rql/

    47   |-- schema.py

    48   |-- simplejson/

    49   |-- tools/

    50   |   |-- generate_schema_img.py

    51   |   `-- i18ncompile.py

    52   |-- views.py

    53   |-- yams/

    54   `-- yapps/

    55 

    56   

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

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

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

    60 

    61 

    62 Lancement de l'application de base

    63 ==================================

    64 

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

    66 d'environnement ``PYTHONPATH`` ::

    67 

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

    69 

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

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

    72 

    73 Pour démarrer::

    74 

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

    76 

    77