6.7. Développer des fonctions Python

Lorsque vous créez une fonction Python en utilisant l'interface de programmation Knative (kn), le répertoire du projet ressemble à un projet Python classique. Les fonctions Python ont très peu de restrictions. Les seules exigences sont que votre projet contienne un fichier func.py qui contient une fonction main() et un fichier de configuration func.yaml.

Les développeurs ne sont pas limités aux dépendances fournies dans le fichier modèle requirements.txt. Des dépendances supplémentaires peuvent être ajoutées comme dans tout autre projet Python. Lorsque le projet est construit pour être déployé, ces dépendances seront incluses dans l'image du conteneur d'exécution créé.

Les fonctions de déclenchement http et event ont la même structure de modèle :

fn
├── func.py 1
├── func.yaml 2
├── requirements.txt 3
└── test_func.py 4

Les fonctions Python peuvent être invoquées à l'aide d'une simple requête HTTP. Lorsqu'une requête est reçue, les fonctions sont invoquées avec un objet context comme premier paramètre.

L'objet context est une classe Python dotée de deux attributs :

Les développeurs peuvent accéder à toutes les données de CloudEvent à partir de l'objet contextuel.

def main(context: Context):
    """
    The context parameter contains the Flask request object and any
    CloudEvent received with the request.
    """
    print(f"Method: {context.request.method}")
    print(f"Event data {context.cloud_event.data}")
    # ... business logic here

Les fonctions peuvent renvoyer n'importe quelle valeur prise en charge par Flask. En effet, le cadre d'invocation transmet ces valeurs directement au serveur Flask.

def main(context: Context):
    body = { "message": "Howdy!" }
    headers = { "content-type": "application/json" }
    return body, 200, headers

Les fonctions peuvent définir des en-têtes et des codes de réponse en tant que valeurs de réponse secondaires et tertiaires à partir de l'invocation de la fonction.

@event("event_source"="/my/function", "event_type"="my.type")
def main(context):
    # business logic here
    data = do_something()
    # more data processing
    return data

Vous pouvez tester les fonctions Python localement sur votre ordinateur. Le projet par défaut contient un fichier test_func.py, qui fournit un test unitaire simple pour les fonctions.