API Deferred para Python 3

En esta página se describe cómo usar la API Deferred, uno de los servicios empaquetados antiguos, con el runtime de Python 3 para el entorno estándar. Tu aplicación puede acceder a los servicios agrupados a través del SDK de servicios de App Engine para Python 3.

Información general

Antes, el paquete Deferred google.appengine.ext.deferred dependía del framework de aplicaciones web en Python 2. Como el framework webapp se ha quitado del SDK de servicios de App Engine para Python 3, debes hacer algunos cambios al actualizar tu aplicación de Python 2 a Python 3.

Habilitar la API Deferred

Para habilitar la API Deferred en Python 3, ya no es necesario definir builtins.deferred en on en el archivo app.yaml. Para habilitar la API, debes pasar use_deferred=True en la llamada a wrap_wsgi_app().

Similitudes y diferencias

De forma predeterminada, la API Deferred para Python 3 usa la misma URL /_ah/queue/deferred y la misma cola predeterminada que en Python 2. Ten en cuenta que, en las aplicaciones que migren a Cloud Tasks, la cola predeterminada no se crea automáticamente y la biblioteca de tareas diferidas no está disponible.

Si tu aplicación usa el endpoint /_ah/queue/deferred predeterminado, usar deferred.defer() en Python 3 sigue siendo igual que en Python 2. Si tu aplicación usa una URL personalizada para ejecutar tareas diferidas, debes hacer algunos cambios, ya que la clase TaskHandler del módulo deferred de Python 2 se ha quitado en la versión de Python 3 de esta API.

Para definir una URL personalizada para la ejecución de tareas diferidas, la aplicación puede anular el método post o el método run_from_request en la clase deferred.Handler (antes deferred.TaskHandler en Python 2) y pasar el parámetro environ, que representa un diccionario que contiene parámetros de solicitud WSGI. Después, se puede llamar al método post desde el endpoint personalizado (como se muestra en los ejemplos de Python 3).

El uso integral de la API Deferred de Python 3, como el enrutamiento de solicitudes y el acceso al diccionario environ, depende del framework web al que se migre la aplicación. Compara los cambios de código realizados en el ejemplo de Python 2 con los ejemplos de Python 3 de las siguientes secciones.

Ejemplos de Python 3

En el siguiente ejemplo se muestra cómo ejecutar una tarea diferida mediante un endpoint predeterminado y un endpoint personalizado en una aplicación Flask y en una aplicación Django.

Flask

import os

from flask import Flask, request
from google.appengine.api import wrap_wsgi_app
from google.appengine.ext import deferred
from google.appengine.ext import ndb

my_key = os.environ.get("GAE_VERSION", "Missing")

app = Flask(__name__)
app.wsgi_app = wrap_wsgi_app(app.wsgi_app, use_deferred=True)


class Counter(ndb.Model):
    count = ndb.IntegerProperty(indexed=False)


def do_something_later(key, amount):
    entity = Counter.get_or_insert(key, count=0)
    entity.count += amount
    entity.put()


@app.route("/counter/increment")
def increment_counter():
    # Use default URL and queue name, no task name, execute ASAP.
    deferred.defer(do_something_later, my_key, 10)

    # Use default URL and queue name, no task name, execute after 1 minute.
    deferred.defer(do_something_later, my_key, 10, _countdown=60)

    # Providing non-default task queue arguments
    deferred.defer(do_something_later, my_key, 10, _url="/custom/path", _countdown=120)

    return "Deferred counter increment."


@app.route("/counter/get")
def view_counter():
    counter = Counter.get_or_insert(my_key, count=0)
    return str(counter.count)


@app.route("/custom/path", methods=["POST"])
def custom_deferred():
    print("Executing deferred task.")
    # request.environ contains the WSGI `environ` dictionary (See PEP 0333)
    return deferred.Handler().post(request.environ)

Django

import os

from django.conf import settings
from django.core.wsgi import get_wsgi_application
from django.http import HttpResponse
from django.urls import path
from google.appengine.api import wrap_wsgi_app
from google.appengine.ext import deferred
from google.appengine.ext import ndb

my_key = os.environ.get("GAE_VERSION", "Missing")


class Counter(ndb.Model):
    count = ndb.IntegerProperty(indexed=False)


def do_something_later(key, amount):
    entity = Counter.get_or_insert(key, count=0)
    entity.count += amount
    entity.put()


def increment_counter(request):
    # Use default URL and queue name, no task name, execute ASAP.
    deferred.defer(do_something_later, my_key, 10)

    # Use default URL and queue name, no task name, execute after 1 minute.
    deferred.defer(do_something_later, my_key, 10, _countdown=60)

    # Providing non-default task queue arguments
    deferred.defer(do_something_later, my_key, 10, _url="/custom/path", _countdown=120)

    return HttpResponse("Deferred counter increment.")


def view_counter(request):
    counter = Counter.get_or_insert(my_key, count=0)
    return HttpResponse(str(counter.count))


def custom_deferred(request):
    print("Executing deferred task.")
    # request.environ contains the WSGI `environ` dictionary (See PEP 0333)
    response, status, headers = deferred.Handler().post(request.environ)
    return HttpResponse(response, status=status.value)


urlpatterns = (
    path("counter/get", view_counter, name="view_counter"),
    path("counter/increment", increment_counter, name="increment_counter"),
    path("custom/path", custom_deferred, name="custom_deferred"),
)

settings.configure(
    DEBUG=True,
    SECRET_KEY="thisisthesecretkey",
    ROOT_URLCONF=__name__,
    MIDDLEWARE_CLASSES=(
        "django.middleware.common.CommonMiddleware",
        "django.middleware.csrf.CsrfViewMiddleware",
        "django.middleware.clickjacking.XFrameOptionsMiddleware",
    ),
    ALLOWED_HOSTS=["*"],
)

app = wrap_wsgi_app(get_wsgi_application(), use_deferred=True)

Sin ningún marco

import os
import re

from google.appengine.api import wrap_wsgi_app
from google.appengine.ext import deferred
from google.appengine.ext import ndb

my_key = os.environ.get("GAE_VERSION", "Missing")


class Counter(ndb.Model):
    count = ndb.IntegerProperty(indexed=False)


def do_something_later(key, amount):
    entity = Counter.get_or_insert(key, count=0)
    entity.count += amount
    entity.put()


def IncrementCounter(environ, start_response):
    # Use default URL and queue name, no task name, execute ASAP.
    deferred.defer(do_something_later, my_key, 10)

    # Use default URL and queue name, no task name, execute after 1 minute.
    deferred.defer(do_something_later, my_key, 10, _countdown=60)

    # Providing non-default task queue arguments
    deferred.defer(do_something_later, my_key, 10, _url="/custom/path", _countdown=120)

    start_response("200 OK", [("Content-Type", "text/html")])
    return [b"Deferred counter increment."]


def ViewCounter(environ, start_response):
    counter = Counter.get_or_insert(my_key, count=0)
    start_response("200 OK", [("Content-Type", "text/html")])
    return [str(counter.count).encode("utf-8")]


class CustomDeferredHandler(deferred.Handler):
    """Deferred task handler that adds additional logic."""

    def post(self, environ):
        print("Executing deferred task.")
        return super().post(environ)


routes = {
    "counter/increment": IncrementCounter,
    "counter/get": ViewCounter,
    "custom/path": CustomDeferredHandler(),
}


class WSGIApplication:
    def __call__(self, environ, start_response):
        path = environ.get("PATH_INFO", "").lstrip("/")
        for regex, handler in routes.items():
            match = re.search(regex, path)
            if match is not None:
                return handler(environ, start_response)

        start_response("404 Not Found", [("Content-Type", "text/plain")])
        return [b"Not found"]


app = wrap_wsgi_app(WSGIApplication(), use_deferred=True)

Códigos de ejemplo

Para ver los ejemplos de código completos de esta guía, consulta GitHub.