3. Directories

La distribution Karrigell est organisée en répertoires. Ils sont définis par défaut quand vous installez le paquetage, mais vous pouvez changer ces valeurs dans les fichiers de configuration

3.1 Structure des répertoires par défaut

Fichiers et répertoires Nom du répertoire Commentaires 
  Karrigell.py
  server_config.py
  default_host_conf.py
  hosts
Répertoire Serveur Au niveau le plus élevé de la distribution se trouvent les scripts qui gèrent le serveur web intégré :
  • Karrigell.py et les autres scripts qui lancents les serveurs intégrés
  • server_config.py définit les options du serveur
  • default_host_conf.py décrit les options de configuration par défaut pour les hôtes
  • hosts est un fichier texte qui fait correspondre les noms d'hôte avec l'emplacement de leur fichier de configuration 
+ karrigell
  + core
  + package
  + ...
Répertoire Karrigell Les script du canevas Karrigell
  • core : scripts du "coeur" de Karrigell
  • package : modules qui peuvent être importés par les scripts définis par l'utilisateur 
+ data
  + www
      + sessions
      conf.py
Répertoire de données Stocke toutes les informations liées aux hôtes définis pour le serveur
Les données pour l'hôte par défaut (localhost) est stockée dans le sous-répertoire www
  • conf.py : options de configuration pour cet hôte
  • sessions : un répertoire dans lequel les informations de sessions sont stockées
  • les fichiers de traces, la base de données des utilisateurs sont aussi stockées dans ce sous-répertoire 
+ www
    index.pih
    ...
Répertoire racine pour l'hôte par défaut(localhost) Il s'agit du répertoire racine pour l'hôte par défaut (localhost) : le chemin où on va chercher les fichiers appelés par les urls commençant par http://localhost
Ce répertoire contient le script index.py, qui est utilisé quand on entre l'url http://localhost dans le navigateur (le mécanisme de résolution d'URL recherche des fichiers d'index quand l'URL correspond à un répertoire)
Notez que le nom de ce répertoire racine est www, le même que le nom du sous-répertoire du Répertoire de données où sont stockées les informations relatives à cet hôte		 
+ common
  + admin
  + demo
  + doc
  + ...
Répertoire commun Ce répertoire contient les scripts qui peuvent être utilisés par différents hôtes, par exemple les services d'administration
Bien qu'ils ne soient pas situés dans le répertoire racine d'un hôte particulier, ils peuvent être servis par une url du type http://localhost/admin en utilisant un alias défini dans le fichier de configuration conf.py pour un hôte donné

3.2 Personnalisation

Si vous voulez personnaliser les répertoires dans lesquels vous stockez les informations propres au serveur ou aux hôtes, voici ce qu'il faut faire :

  • pour changer le répertoire du script server_config.py, démarrer le serveur intégré avec un argument additionnel sur la ligne de commande : 

    python Karrigell.py [RepertoireConfigServeur]
  • pour changer le répertoire du fichier hosts, editer la valeur de host_conf_dir dans server_config.py
  • pour changer l'emplacement du répertoire de données pour l'hôte par défaut, éditer la valeur de data_dir dans le script de configuration pour cet hôte