Programmation Python/Karrigell
Karrigell est un canevas (framework) de développement web écrit en Python très simple d'utilisation.
À l'inverse d'autres frameworks écrits en Python, il ne nécessite pas d'apprendre un métalangage, car il reste très proche de la syntaxe python. Le code est donc simple à écrire et facile à maintenir.
Karrigell intègre un serveur web très efficace, mais il peut aussi travailler derrière d'autres serveurs web (Apache, Lighttpd et Xitami...).
Les bases de données courantes (sqlite, MySql, PostGresQL, etc.) peuvent être utilisées, cependant Karrigell inclut la base Buzhug, écrite par l'auteur, dans le même esprit que Karrigell.
Intérêt de Karrigell
[modifier | modifier le wikicode]Tout comme le PHP, Karrigell permet d’intégrer des scripts python à l’intérieur d’un document html en utilisant les symboles "<%" … "%>". Mais on peut également inclure du code HTML dans des scripts python.
Karrigell permet également de créer des sites d'une seule pièce, avec un service Karrigell (fichier .ks) dont les fonctions sont considérées comme des pages. Les fonctions dont le nom commencent par '_' sont privées.
L'utilisation du "karrigell service" (.ks) permet cependant d'avoir une certaine logique d'application dans un seul script. En outre, il est tout à fait possible d'inclure des scripts, ou des modules afin d'améliorer la lisibilité du script.
Karrigell offre un puissant système de template nommé cheetah[1] et propose un module HTMLTags pour des balises HTML valides.
Installation de Karrigell
[modifier | modifier le wikicode]Décompresser le fichier que vous avez téléchargé (au format .zip, .tgz ou .tar.bz2) dans un répertoire tel que /home/myname/karrigell puis se placer dans le répertoire Karrigell-2.4.0.
Ouvrez une fenêtre console (un terminal), mettez-vous dans le Karrigell-2.4.0 (cd /home/myname/karrigell/Karrigell-2.4.0) et exécutez :
python Karrigell.py
Vous devriez voir apparaître le message :
Karrigell 2.4.0 running on port 80 Type Ctrl+C to stop
Configuration de Karrigell, mon premier site
[modifier | modifier le wikicode]Pour tester les exemples suivants, créons le repertoire "monsite" de notre site dans Karrigell-2.4.0/webapps/monsite
Puis se placer dans Karrigell-2.4.0/conf/ et ouvrir le fichier Karrigell.ini
Modifier les variables :
[Directories]
root = /home/myname/karrigell/Karrigell-2.4.0/webapps/monsite
[VirtualHost monsite.net]
root = /home/myname/karrigell/Karrigell-2.4.0/webapps/monsite
[Server]
port=8081
Ainsi lorsqu'on relancera le serveur, dans le terminal :
python Karrigell.py
Il affichera:
Karrigell 2.4.0 running on port 8081 Type Ctrl+C to stop
Il suffit alors de se connecter en localhost via le navigateur: http://localhost:8081
Exemple de script python dans un document HTML
[modifier | modifier le wikicode]Dans le répertoire "monsite", créer un fichier index.html
<h1>
La date courante est:
<%
import time
print time.strftime("%d:%m:%y",time.localtime(time.time()))
%>
</h1>
Puis avec le navigateur : http://localhost:8081
Exemple de code HTML dans un script Python
[modifier | modifier le wikicode]Dans le répertoire "monsite", créer un fichier index.py
telephone={'guitare - chant':'Jean-Louis Aubert',
'guitare':'Louis Bertignac',
'basse':'Corine Marienneau',
'batterie':'Richard Kolinka'}
"""
<table border=1>
<tr backgroundcolor=green>
<td>Le plus grand groupe français</td>
</tr>
</table>
<table>
"""
for item in telephone.keys():
print "<tr><td>%s</td><td>%s</td></tr>" %(item,telephone[item])
"</table>"
Puis avec le navigateur : http://localhost:8081
Exemple de script Karrigell Service
[modifier | modifier le wikicode]Dans le répertoire "monsite", créer un fichier index.ks dans lequel on inclut le code suivant :
def index():
print '<a href="page1?nom=bar">Aller vers foo</a>'
def page1(nom):
print '<IMG SRC="../picture.jpg">'
print nom
Puis avec le navigateur : http://localhost:8081
Exemple d'importation de module dans un script Karrigell Service
[modifier | modifier le wikicode]Dans le répertoire "monsite", créer un fichier conf.cfg, un script index.ks, et un script maconfig.py qui sera le module.
Le fichier conf.cfg :
[DEFAULT]
# Chemin par défaut où sera installée la base buzhug.
# Décommenter pour activer la variable de configuration
# path = /tmp/test
path = /home/monpseudo/karrigell/webapps/monsite/mabase/
le script index.ks
#!/usr/bin/python
# -*- coding: iso-8859-1 -*-
import os, sys
from maconfig import Konfig
def index():
maconfig = Konfig()
print maconfig.lire_chemin_base_config()
Le module maconfig.py:
#!/usr/bin/python
# -*- coding: iso-8859-1 -*-
from ConfigParser import *
import os
class Konfig (object):
"""
Objectif: Lire le fichier de configuration et renvoyer son contenu.
usage :
x.lire_chemin_base_config()
"""
def lire_chemin_base_config(self):
"""
Renvoie la valeur de path du fichier de configuration
"""
# tester si le fichier existe et le lire. Renvoi le résultat
if os.path.exists('conf.cfg'):
configdict = ConfigParser()
configdict.read('conf.cfg')
self.path = configdict.defaults()['path']
return self.path
Karrigell Intègre
[modifier | modifier le wikicode]- Un serveur web
- Implémentation d'un mécanisme d'authentification et de gestion des utilisateurs
- Des sessions
- Accès facile aux données d'environnement, formulaires et base de données (Buzhug)
- Moteur de template Cheetah
Extensions
[modifier | modifier le wikicode]- La liste exclut les extensions normalement prises en charge par un serveur
- .hip : HTML Inside Python
- .pih : Python Inside HTML
- .py : Fichier Python/ironpython
- .ks : "Karrigell service" = script Python dans lequel les fonctions sont associées à une URL