Premiers pas avec cherrypy

Bonjour tout le monde dans CherryPy

Si vous avez un virtualenv et que CherryPy y est déjà installé, créez un fichier hello.py :

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

import cherrypy

class HelloWorld(object):
    @cherrypy.expose
    def index(self):
        return 'Hello World!'

    @cherrypy.expose
    def greet(self, name):
        return 'Hello {}!'.format(name)

cherrypy.quickstart(HelloWorld())

Exécutez ensuite le fichier : $ hello.py ou $ python hello.py. Vous devriez voir une sortie semblable à celle-ci :

[email protected] /develop/myapp $ python hello.py
[06/Nov/2016:05:58:44] ENGINE Listening for SIGTERM.
[06/Nov/2016:05:58:44] ENGINE Bus STARTING
[06/Nov/2016:05:58:44] ENGINE Set handler for console events.
CherryPy Checker:
The Application mounted at '' has an empty config.

[06/Nov/2016:05:58:44] ENGINE Started monitor thread '_TimeoutMonitor'.
[06/Nov/2016:05:58:44] ENGINE Started monitor thread 'Autoreloader'.
[06/Nov/2016:05:58:45] ENGINE Serving on http://127.0.0.1:8080
[06/Nov/2016:05:58:45] ENGINE Bus STARTED

Instructions d’installation

Conditions préalables

  • Ces instructions supposent que vous avez n’importe quel type de Linux, Unix, Mac avec bash ou Git-bash Windows.
  • Windows : téléchargez et installez [Git-bash pour Windows][1], puis exécutez “bash” à partir de la ligne de commande.
  • D’autres shells que bash conviennent également, remplacez simplement la commande activate ci-dessous par activate.csh ou Google : “[virtualenv activate your-shell-name][2]”.

Avant de commencer, vérifiez que Python, virtualenv et pip sont installés :

  • $python --version
  • $ virtualenv --version
  • $ pip --version

Installer

Créez un répertoire avec votre site Web/application, créez un environnement et installez le package CherryPy.

  • $ mkdir /develop/monapp/
  • $ cd /develop/monapp/
  • $ virtualenv venv
  • $ source venv/bin/activate
    • On Windows in Git-bash: $ source venv/Scripts/activate
  • (venv) $ pip install cherrypy
  • (venv) $python
Python 3.5.2 ...
>>> import cherrypy
>>> cherrypy
<module 'cherrypy' from '... venv/site-packages/cherrypy/__init__.py'>

Toutes nos félicitations! Vous êtes maintenant prêt pour votre première application CherryPy.

[1] : https://git-scm.com/download/win [2] : https://www.google.com/search?q=virtualenv%20activate%20tcsh

Téléchargement de fichiers avec CherryPy

Cet exemple se compose de trois parties :

  • server.py - Application CherryPy qui peut recevoir et enregistrer un fichier.
  • webpage.html - Exemple de téléchargement d’un fichier sur server.py à partir d’une page Web.
  • cli.py - Exemple de téléchargement d’un fichier sur server.py à partir d’un outil de ligne de commande.
  • Bonus - upload.txt - fichier que vous téléchargerez.

serveur.py

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

import os
import cherrypy

config = {
    'global' : {
        'server.socket_host' : '127.0.0.1',
        'server.socket_port' : 8080
    }
}


class App:

    @cherrypy.expose
    def upload(self, ufile):
        # Either save the file to the directory where server.py is
        # or save the file to a given path:
        # upload_path = '/path/to/project/data/'
        upload_path = os.path.dirname(__file__)

        # Save the file to a predefined filename
        # or use the filename sent by the client:
        # upload_filename = ufile.filename
        upload_filename = 'saved.txt'

        upload_file = os.path.normpath(
            os.path.join(upload_path, upload_filename))
        size = 0
        with open(upload_file, 'wb') as out:
            while True:
                data = ufile.file.read(8192)
                if not data:
                    break
                out.write(data)
                size += len(data)
        out = '''
File received.
Filename: {}
Length: {}
Mime-type: {}
''' .format(ufile.filename, size, ufile.content_type, data)
        return out


if __name__ == '__main__':
    cherrypy.quickstart(App(), '/', config)

pageweb.html

<form method="post" action="http://127.0.0.1:8080/upload" enctype="multipart/form-data">
    <input type="file" name="ufile" />
    <input type="submit" />
</form>

#cli.py #

Cet exemple nécessite le package [Python requests][1], mais le fichier peut être envoyé au serveur en Python ordinaire.

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

import requests

url = 'http://127.0.0.1:8080/upload'
files = {'ufile': open('file.txt', 'rb')}

r = requests.post(url, files=files)

print(r)
print(r.text)

upload.txt

Hello! This file was uploaded to CherryPy.

Télécharger depuis le navigateur

  • Exécutez $ server.py
  • Ouvrez webpage.html dans votre navigateur Web.
  • Après avoir sélectionné le fichier sur votre lecteur et l’avoir soumis, il sera enregistré sous le nom “saved.txt”.

Télécharger depuis la ligne de commande

  • Ouvrez une console et exécutez $ server.py
  • Ouvrez une autre console et exécutez $ cli.py
    • Note: Test file upload.txt should be in the same directory with cli.py
  • Le fichier upload.txt doit être téléchargé et enregistré sous saved.txt.

[1] : http://docs.python-requests.org/