paste-py - La documentation

L'interface web de paste est très simple d'utilisation, mais elle contient un bon nombre de features cachées, que personne n'a l'air de connaître. Après avoir lu cette section, paste n'aura plus aucun secret pour toi.

http://paste.awesom.eu/HiT&hl=py3tb

http://paste.awesom.eu/HiT&hl=python

Si jamais tu as envie de faire tourner paste sur ton serveur, c'est très simple. Au niveau des dépendances, tu as besoin de:

• Python 2
• Tornado
• Pygments

Tu peux installer ça via le gestionnaire de paquet de ta distribution ou si tu as les setuptools de python d'installé, via easy_install:

easy_install tornado pygments

Ensuite, récupère les sources de paste-py depuis le git (ou télécharge une snapshot du dépôt):

git clone git://github.com/acieroid/paste-py.git

Et pour lancer (ça listen sur le port 8888):

mkdir pastes/
python paste.py

Si tu veux des « jolies » URL comme sur http://paste.awesom.eu, il faut que tu mettes la variable production à True dans paste.py, et que tu aies un serveur web qui rewrite certaines choses. Dans mon cas, c'est du russe, et la configuration (nginx.conf) ressemble à ça:

server {
    server_name paste.awesom.eu;
    access_log  /var/log/nginx/paste.awesom.eu-access_log;
    error_log   /var/log/nginx/paste.awesom.eu-error_log;
    location ~ ^(.*)/paste.css {
        root /usr/home/paste/paste-py/;
    }   
    location ~ ^(.*)/favicon.ico {
        root /usr/home/paste/paste-py/;
    }   
    location / { 
        rewrite ^/$ / break;
        rewrite ^/user/([^/]+)$ /?user=$1 break;
        rewrite ^/user/([^/]+)/([^&]+)?&(.*)$ /?id=$1/$2&$3 break;
        rewrite ^/([^&]+)&(.*)$ /?id=$1&$2 break;
        rewrite ^/(.*)$ /?id=$1 break;

        proxy_pass http://localhost:8888;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For
        $proxy_add_x_forwarded_for;
    }
}

Et tu peux même utiliser le script daemonize.py (mais il faudra sûrement l'adapter au niveau des chemins) si tu veux lancer paste.py en daemon.

Le fonctionnement de paste est très simple: lorsqu'un nouveau paste est soumis, on génère un nom aléatoire (ici de trois lettres/chiffres, ce qui est largement suffisant: 238328 noms disponibles, alors qu'on est en dessous des 3000 pastes au total aujourd'hui) et on écrit le paste dans le fichier portant ce nom. Ainsi pour retrouver un paste c'est très simple, on lit le fichier correspondant au nom du paste demandé. Ainsi, pas besoin de base de donnée ou de mécanisme compliqué.

Quand l'user d'un paste est spécifié, on mets le fichier du paste dans le sous-dossier qui porte le nom de l'user, et on fait donc bien gaffe qu'il n'y ait pas de caractères sensible genre des /.

Il fut un temps où paste-py utilisait wsgi et gunicorn, mais maintenant il utilise tornado, ce qui lui permet d'avoir un bon petit boost au niveau des performances. En effet, sur les gros paste, wsgi avait tendance à ramer et répondre avec un débit ridicule (en dessous des 20ko/s). Avec un petit coup de siege, on voit que tornado se débrouille beaucoup mieux, autant sur les petit pastes que sur les gros. Les deux résultats suivants ont étés obtenus en laissant tourner siege avec l'option b pendant 100 secondes.

Avec un paste de trois caractères:

	Tornado	WSGI + gunicorn (3 workers)
Transactions	30934 hits	6401 hits
Availability	100.00%	100.00%
Elapsed time	100.03 secs	100.00 secs
Data transferred	12.07 MB	2.62 MB
Response time	0.05 secs	0.23 secs
Transaction rate	309.24 trans/sec	64.01 trans/sec
Throughput	0.12 MB/sec	0.03 MB/sec
Concurrency	14.74	14.45
Successful transactions	30934	6401
Failed transactions	0	0
Longest transaction	0.39	1.48
Shortest transaction	0.00	0.01

Avec un paste de 6.2Mo (récupéré ici):

	Tornado	WSGI + gunicorn (3 workers)
Transactions	107 hits	9 hits
Availability	100.00 %	20.00 %
Elapsed time	100.00 secs	100.02 secs
Data transferred	675.49 MB	2.96MB
Response time	12.64 secs	34.09 secs
Transaction rate	1.07 trans/sec	0.09 trans/sec
Throughput	6.75 MB/sec	0.03 MB/sec
Concurrency	13.52	3.07
Successful transactions	107	9
Failed transactions	0	36
Longest transaction	13.77	37.62
Shortest transaction	0.97	0.00

Pour me contacter, tu /query acieroid sur epiknet ou freenode, tu m'hl sur un chan quelconque où je suis, ou tu m'envoie un mail à acieroid@awesom.eu.