Cambios¶
Versión 2.2.0¶
No publicado
Elimina el código previamente obsoleto. #4337
Se han eliminado los antiguos nombres de algunos parámetros de
send_file
.download_name
sustituye aattachment_filename
,max_age
sustituye acache_timeout
, yetag
sustituye aadd_etags
. Además,path
sustituye afilename
ensend_from_directory
.Se elimina la propiedad
RequestContext.g
que devuelveAppContext.g
.
Los contextos de la aplicación y de la petición se gestionan utilizando directamente las varas de contexto de Python en lugar de la
LocalStack
de Werkzeug. Esto debería dar lugar a un mejor rendimiento y uso de la memoria. #4682Mantenedores de extensiones, tened en cuenta que
_app_ctx_stack.top
y_request_ctx_stack.top
están obsoletos. Almacena los datos eng
en su lugar utilizando un prefijo único, comog._extension_name_attr
.
Añade nuevos puntos de personalización al objeto de aplicación
Flask
para muchos comportamientos anteriormente globales.Refactorizar
register_error_handler
para consolidar la comprobación de errores. Reescribir algunos mensajes de error para que sean más consistentes. #4559El uso de decoradores y funciones de Blueprint destinados a la configuración después de registrar el blueprint mostrará una advertencia. En la próxima versión, esto se convertirá en un error al igual que los métodos de configuración de la aplicación. #4571
before_first_request
está obsoleto. En su lugar, ejecute el código de configuración al crear la aplicación. #4605Se ha añadido el atributo de clase
View.init_every_request
. Si una subclase de la vista lo establece enFalse
, la vista no creará una nueva instancia en cada petición. #2520.Un grupo de Click
flask.cli.FlaskGroup
puede anidarse como subcomando en una CLI personalizada. #3263Añadir las opciones
--app
,--env
y--debug
a la CLI deflask
, en lugar de requerir que se establezcan a través de variables de entorno. #2836Añadir la opción
--env-file
al CLI deflask
. Esto permite especificar un archivo dotenv para cargar además de.env
y.flaskenv
. #3108Ya no es necesario decorar los comandos CLI personalizados en
app.cli
oblueprint.cli
con@with_appcontext
, un contexto de aplicación ya estará activo en ese punto. #2410SessionInterface.get_expiration_time
utiliza un valor que tiene en cuenta la zona horaria. #4645Las funciones de vista pueden devolver generadores directamente en lugar de envolverlos en una
Response
. #4629Añade las funciones
stream_template
ystream_template_string
para representar una plantilla como un flujo de piezas. #4629Una nueva implementación de la preservación del contexto durante la depuración y las pruebas. #4666
request
,g
y otras localizaciones de contexto apuntan a los datos correctos cuando se ejecuta código en la consola del depurador interactivo. #2836Las funciones de desmontaje se ejecutan siempre al final de la solicitud, incluso si el contexto se conserva. También se ejecutan después de que el contexto preservado se desprenda.
stream_with_context
preserva el contexto por separado de un bloquewith client
. Se limpiará cuando se llame aresponse.get_data()
oresponse.close()
.
Permitir la devolución de una lista desde una función de vista, para convertirla en una respuesta JSON como lo es un dict. #4672
Versión 2.1.3¶
No publicado
Versión 2.1.2¶
Lanzamiento 2022-04-28
Versión 2.1.1¶
Lanzamiento 2022-03-30
Establece la versión mínima requerida de importlib_metadata a 3.6.0, que es necesaria en Python < 3.10. #4502
Versión 2.1.0¶
Lanzamiento 2022-03-28
Deja de ser compatible con Python 3.6. #4335
Actualizar la dependencia de Click a >= 8.0. #4008
Elimina el código previamente obsoleto. #4337
La CLI no pasa
script_info
a las funciones de fábrica de la aplicación.config.from_json
se sustituye porconfig.from_file(name, load=json.load)
.Las funciones
json
ya no toman el parámetroencoding
.Se ha eliminado
safe_join
, utilice en su lugarwerkzeug.utils.safe_join
.Se ha eliminado
total_seconds
, utilicetimedelta.total_seconds
en su lugar.No se puede registrar el mismo plano con el mismo nombre. Utiliza
name=
cuando te registres para especificar un nombre único.Se elimina el parámetro
as_tuple
del cliente de prueba. Utilizaresponse.request.environ
en su lugar. #4417
Algunos parámetros de
send_file
ysend_from_directory
fueron renombrados en la 2.0. El periodo de depreciación de los nombres antiguos se extiende hasta la 2.2. Asegúrese de probar con las advertencias de depreciación visibles.attachment_filename
es renombrado adownload_name
.cache_timeout
es renombrado amax_age
.add_etags
es renombrado aetag
.filename
es renombrado apath
.
La propiedad
RequestContext.g
está obsoleta. Utiliceg
directamente oAppContext.g
en su lugar. #3898copy_current_request_context
puede decorar funciones async. #4303La CLI utiliza
importlib.metadata
en lugar desetuptools
para cargar puntos de entrada de comandos. #4419Anular
FlaskClient.open
no causará un error en la redirección. #3396Añade una opción
--exclude-patterns
al comando CLIflask run
para especificar patrones que serán ignorados por el recargador. #4188Cuando se utiliza la carga perezosa (por defecto con el depurador), el contexto Click del comando
flask run
permanece disponible en el hilo del cargador. #4460La eliminación de la cookie de sesión utiliza la bandera
httponly
. #4485Relajar la tipificación de
errorhandler
para permitir al usuario utilizar tipos más precisos y decorar la misma función varias veces. #4095, #4295, #4297Corregir la tipificación de los métodos
__exit__
para mejorar la compatibilidad conExitStack
. #4474Desde Werkzeug, para las respuestas de redirección la URL de la cabecera
Location
seguirá siendo relativa, y excluirá el esquema y el dominio, por defecto. #4496Añade
Config.from_prefixed_env()
para cargar los valores de configuración de las variables de entorno que comienzan conFLASK_
u otro prefijo. Esto analiza los valores como JSON por defecto, y permite establecer claves en dictos anidados. #4479
Versión 2.0.3¶
Publicado el 2022-02-14
El parámetro
as_tuple
del cliente de pruebas está obsoleto y se eliminará en Werkzeug 2.1. Ahora también está obsoleto en Flask, que se eliminará en Flask 2.1, aunque seguirá siendo compatible con ambos en 2.0.x. Utilizaresponse.request.environ
en su lugar. #4341Corrige la anotación de tipo para el decorador
errorhandler
. #4295Revierte un cambio en la CLI que provocaba que se ocultaran los tracebacks de
ImportError
al importar la aplicación. #4307app.json_encoder
yjson_decoder
sólo se pasan adumps
yloads
si tienen un comportamiento personalizado. Esto mejora el rendimiento, principalmente en PyPy. #4349Mensaje de error más claro cuando se utiliza
after_this_request
fuera de un contexto de solicitud. #4333
Versión 2.0.2¶
Publicado el 2021-10-04
Corrige la anotación de tipo para los métodos
teardown_*
. #4093Corrige la anotación de tipo para los decoradores
before_request
ybefore_app_request
. #4104Solucionado el problema por el que la escritura requiere que los decoradores globales de las plantillas acepten funciones sin argumentos. #4098
Soporta las instancias View y MethodView con manejadores asíncronos. #4112
Mejora la tipificación del decorador
app.errorhandler
. #4095Corrige el registro de un blueprint dos veces con nombres diferentes. #4124
Corrige el tipo de
static_folder
para aceptarpathlib.Path
. #4150jsonify
manejadecimal.Decimal
codificando astr
. #4157Manejar correctamente el levantamiento de errores diferidos en la carga retardada de la CLI. #4096
El cargador CLI maneja
**kwargs
en una funcióncreate_app
. #4170Corregido el orden de
before_request
y otros callbacks que se activan antes de que vuelva la vista. Se llaman desde la aplicación hasta el blueprint anidado más cercano. #4229
Versión 2.0.1¶
Publicado el 2021-05-21
Vuelve a añadir el parámetro
filename
ensend_from_directory
. El parámetrofilename
ha sido renombrado apath
, el antiguo nombre está obsoleto. #4019Marcar los nombres de nivel superior como exportados para que la comprobación de tipo entienda las importaciones en los proyectos de usuario. #4024
Corrige la anotación de tipo para
g
e informar a mypy de que es un objeto de espacio de nombres que tiene atributos arbitrarios. #4020Corrige algunos tipos que no estaban disponibles en Python 3.6.0. #4040
Mejora la tipificación de
send_file
,send_from_directory
yget_send_file_max_age
. #4044, #4026Muestra un error cuando un nombre de blueprint contiene un punto. El
.
tiene un significado especial, se utiliza para separar los nombres de los blueprints (anidados) y el nombre del punto final. #4041Combina prefijos de URL al anidar blueprints creados con un valor
url_prefix
. #4037Revertir un cambio en el orden en que se realizaba la coincidencia de URLs. La URL vuelve a coincidir después de cargar la sesión, por lo que la sesión está disponible en los conversores de URL personalizados. #4053
Vuelve a añadir el obsoleto
Config.from_json
, que fue eliminado accidentalmente antes. #4078Mejora la tipificación de algunas funciones que utilizan
Callable
en sus firmas de tipo, centrándose en las fábricas de decoradores. #4060Los blueprints anidados se registran con su nombre punteado. Esto permite anidar diferentes blueprints con el mismo nombre en diferentes lugares. #4069
register_blueprint
toma una opciónname
para cambiar el nombre (pre-punteado) con el que se registra el blueprint. Esto permite registrar el mismo blueprint varias veces con nombres únicos paraurl_for
. Registrar el mismo blueprint con el mismo nombre varias veces está obsoleto. #1091Mejora la tipificación de
stream_with_context
. #4052
Versión 2.0.0¶
Released 2021-05-11
Deja de ser compatible con Python 2 y 3.5.
Aumenta las versiones mínimas de otros proyectos de Pallets: Werkzeug >= 2, Jinja2 >= 3, MarkupSafe >= 2, ItsDangerous >= 2, Click >= 8. Asegúrese de comprobar los registros de cambios de cada proyecto. Para una mejor compatibilidad con otras aplicaciones (por ejemplo, Celery) que todavía requieren Click 7, todavía no hay dependencia dura de Click 8, pero el uso de Click 7 activará un DeprecationWarning y Flask 2.1 dependerá de Click 8.
El soporte de JSON ya no utiliza simplejson. Para utilizar otro módulo JSON, anule
app.json_encoder
yjson_decoder
. #3555La opción
encoding
de las funciones JSON está obsoleta. #3562Pasa
script_info
a las funciones de fábrica de la aplicación está obsoleto. Esto no era portable fuera del comandoflask
. Usaclick.get_current_context().obj
si es necesario. #3552La CLI muestra mejores mensajes de error cuando la aplicación no se carga al buscar comandos. #2741
Añadir
sessions.SessionInterface.get_cookie_name()
para permitir establecer el nombre de la cookie de sesión de forma dinámica. #3369Añade
Config.from_file()
para cargar la configuración utilizando cargadores de archivos arbitrarios, comotoml.load
ojson.load
.Config.from_json()
está obsoleto en favor de esto. #3398El comando
flask run
sólo aplazará los errores en la recarga. Los errores que se produzcan durante la llamada inicial harán que el servidor salga con el rastreo inmediatamente. #3431send_file()
genera unValueError
cuando se le pasa un objetoio
en modo texto. Anteriormente, respondía con 200 OK y un archivo vacío. #3358Al utilizar certificados ad-hoc, compruebe la biblioteca de criptografía en lugar de PyOpenSSL. #3492
Al especificar una función de fábrica con
FLASK_APP
, se puede pasar el argumento de la palabra clave. #3553Al cargar un archivo
.env
o.flaskenv
, el directorio de trabajo actual ya no se cambia a la ubicación del archivo. #3560Cuando se devuelve una tupla
(response, headers)
desde una vista, las cabeceras reemplazan en lugar de extender las cabeceras existentes en la respuesta. Por ejemplo, esto permite establecer elContent-Type
parajsonify()
. Utilizaresponse.headers.extend()
si deseas extenderla. #3628La clase
Scaffold
proporciona una API común para las clasesFlask
yBlueprint
. La información deBlueprint
se almacena en atributos al igual queFlask
, en lugar de funciones lambda opacas. Esto pretende mejorar la consistencia y la capacidad de mantenimiento. #3215Incluye las opciones
samesite
ysecure
al eliminar la cookie de sesión. #3726Soporta pasar un
pathlib.Path
astatic_folder
. #3579send_file
ysend_from_directory
son envolturas alrededor de las implementaciones enwerkzeug.utils
. #3828Algunos parámetros de
send_file
han sido renombrados, los antiguos nombres están obsoletos. El nombre deattachment_filename
ha cambiado adownload_name
. El nombre decache_timeout
ha cambiado amax_age
.add_etags
pasa a llamarseetag
. #3828, #3883send_file
pasadownload_name
incluso sias_attachment=False
utilizandoContent-Disposition: inline
. #3828send_file
establececonditional=True
ymax_age=None
por defecto.Cache-Control
se establece comono-cache
simax_age
no se establece, en caso contrariopublic
. Esto indica a los navegadores que validen las peticiones condicionales en lugar de utilizar una caché temporizada. #3828helpers.safe_join
está obsoleto. Utilizawerkzeug.utils.safe_join
en su lugar. #3828El contexto de la solicitud hace la coincidencia de la ruta antes de abrir la sesión. Esto podría permitir que una interfaz de sesión cambie de comportamiento basándose en
request.endpoint
. #3776Utiliza la implementación de Jinja del filtro
|tojson
. #3881Añade decoradores de ruta para métodos HTTP comunes. Por ejemplo,
@app.post("/login")
es un atajo para@app.route("/login", methods=["POST"])
. #3907Soporta vistas asíncronas, manejadores de error, antes y después de la solicitud, y funciones de desmontaje. #3412
Establece la codificación por defecto en «UTF-8» al cargar los archivos
.env
y.flaskenv
para permitir el uso de caracteres no ASCII. #3931flask shell
configura el completamiento de pestañas e historial como el shellpython
por defecto sireadline
está instalado. #3941helpers.total_seconds()
está obsoleto. Utilicetimedelta.total_seconds()
en su lugar. #3962Añade una pista de tipo #3973.
Versión 1.1.4¶
Publicado el 2021-05-13
Actualiza
static_folder
para utilizar_compat.fspath
en lugar deos.fspath
para seguir soportando Python < 3.6 #4050
Versión 1.1.3¶
Publicado el 2021-05-13
Versión 1.1.2¶
Lanzamiento 2020-04-03
Versión 1.1.1¶
Lanzamiento 2019-07-08
Se ha vuelto a añadir la bandera
flask.json_available
por compatibilidad con algunas extensiones. Se emitirá una advertencia de desaprobación cuando se utilice, y se eliminará en la versión 2.0.0. #3288
Versión 1.1.0¶
Lanzamiento 2019-07-04
Aumenta la versión mínima de la herramienta a >= 0.15.
Deja de ser compatible con Python 3.4.
A los manejadores de errores para
InternalServerError
o500
siempre se les pasará una instancia deInternalServerError
. Si son invocados debido a una excepción no manejada, esa excepción original está ahora disponible comoe.original_exception
en lugar de ser pasada directamente al manejador. Lo mismo ocurre si el manejador es para la baseHTTPException
. Esto hace que el comportamiento del manejador de errores sea más consistente. #3266Flask.finalize_request()
es llamado para todas las excepciones no manejadas incluso si no hay un manejador de errores500
.
Flask.logger
toma el mismo nombre queFlask.name
(el valor pasado comoFlask(import_name)
. Esto revierte el comportamiento de la versión 1.0 de registrar siempre en"flask.app"
, con el fin de soportar múltiples aplicaciones en el mismo proceso. Se mostrará una advertencia si se detecta una configuración antigua que debe ser movida. #2866flask.RequestContext.copy()
incluye el objeto de sesión actual en la copia del contexto de petición. Esto evita quesesión
apunte a un objeto obsoleto. #2935Utilizando el RequestContext incorporado, los caracteres Unicode no imprimibles en la cabecera Host darán lugar a una respuesta HTTP 400 y no HTTP 500 como anteriormente. #2994
send_file()
soporta objetosPathLike
como se describe en PEP 0519, para soportarpathlib
en Python 3. #3059send_file()
soportaBytesIO
contenido parcial. #2957open_resource()
acepta el modo de archivo «rt». Esto sigue haciendo lo mismo que «r». #3163El atributo
MethodView.methods
establecido en una clase base es utilizado por las subclases. #3138Flask.jinja_options
es undict
en lugar de unImmutableDict
para permitir una configuración más fácil. Los cambios deben realizarse antes de crear el entorno. #3190El
JSONMixin
de Flask para las envolturas de solicitud y respuesta fue trasladado a Werkzeug. Utiliza la versión de Werkzeug con soporte específico para Flask. Esto eleva la dependencia de Werkzeug a >= 0.15. #3125El entry point del comando
flask
se ha simplificado para aprovechar el mejor soporte del recargador de Werkzeug 0.15. Esto eleva la dependencia de Werkzeug a >= 0.15. #3022Soporta
static_url_path
que termina con una barra diagonal. #3134Soporta
static_folder
vacía sin necesidad de establecer también unastatic_url_path
vacía. #3124jsonify()
soporta objetosdataclasses.dataclass
. #3195Permite personalizar el
Flask.url_map_class
utilizado para el enrutamiento. #3069El puerto del servidor de desarrollo puede establecerse en 0, lo que indica al sistema operativo que elija un puerto disponible. #2926
El valor de retorno de
cli.load_dotenv()
es más consistente con la documentación. DevolveráFalse
si python-dotenv no está instalado, o si la ruta dada no es un archivo. #2937El soporte de señalización tiene un stub para el método
connect_via
cuando la biblioteca Blinker no está instalada. #3208Añade una opción
--extra-files
al comando CLIflask run
para especificar archivos extra que activarán el recargador al cambiar. #2897Permite devolver un diccionario desde una función de vista. Al igual que devolver una cadena producirá una respuesta
text/html
, devolver un dict llamará ajsonify
para producir una respuestaapplication/json
. #3111Los blueprints tienen un grupo de clics
cli
comoapp.cli
. Los comandos CLI registrados con un blueprint estarán disponibles como grupo bajo el comandoflask
. #1357.Cuando se utiliza el cliente de prueba como gestor de contextos (
with client:
), todos los contextos de solicitud conservados se eliminan al salir del bloque, asegurando que los contextos anidados se limpien correctamente. #3157Muestra un mejor mensaje de error cuando el tipo de retorno de la vista no es compatible. #3214
flask.testing.make_test_environ_builder()
ha quedado obsoleta en favor de una nueva claseflask.testing.EnvironBuilder
. #3232El comando
flask run
ya no falla si Python no está construido con soporte SSL. El uso de la opción--cert
mostrará un mensaje de error apropiado. #3211La coincidencia de URLs se produce ahora después de que el contexto de solicitud sea empujado, en lugar de cuando se crea. Esto permite que los convertidores de URL personalizados accedan a la aplicación y a los contextos de solicitud, como por ejemplo para consultar una base de datos para un id. #3088
Versión 1.0.4¶
Lanzamiento 2019-07-04
La información de la clave para
BadRequestKeyError
ya no se borra fuera del modo de depuración, por lo que los gestores de errores pueden seguir accediendo a ella. Esto requiere la actualización a Werkzeug 0.15.5. #3249La url
send_file
entrecomilla los caracteres «:» y «/» para hacer más compatible el nombre de archivo UTF-8 en algunos navegadores. #3074Correcciones para los cargadores de importación PEP451 y pytest 5.x. #3275
Muestra mensaje sobre dotenv en stderr en lugar de stdout. #3285
Versión 1.0.3¶
Lanzamiento 2019-05-17
send_file()
codifica los nombres de archivo como ASCII en lugar de Latin-1 (ISO-8859-1). Esto corrige la compatibilidad con Gunicorn, que es más estricto con las codificaciones de cabecera que el PEP 3333. #2766Permitir que las CLIs personalizadas que utilizan
FlaskGroup
establezcan la bandera de depuración sin que se sobrescriba siempre en función de las variables de entorno. #2765flask --version
da como resultado la versión de Werkzeug y simplifica la versión de Python. #2825send_file()
maneja unattachment_filename
que es una cadena nativa de Python 2 (bytes) con bytes codificados en UTF-8. #2933Un manejador de errores registrado para
HTTPException
no manejaráRoutingException
, que se utiliza internamente durante el enrutamiento. Esto corrige el comportamiento inesperado que se había introducido en la versión 1.0. #2986Pasa el argumento
json
aapp.test_client
no hace push/pop de un contexto de aplicación extra. #2900
Versión 1.0.2¶
Publicado el 2018-05-02
Versión 1.0.1¶
Publicado 2018-04-29
Corrige el registro de parciales (sin
__name__
) como funciones de vista. #2730No se tratan las listas devueltas por las funciones de vista igual que las tuplas. Sólo las tuplas se interpretan como datos de respuesta. #2736
Se han fusionado las barras inclinadas adicionales entre el
url_prefix
de un blueprint y la URL de una ruta. Esto corrige algunos problemas de compatibilidad con el cambio en 1.0. #2731, #2742Sólo se atrapan los errores
BadRequestKeyError
en modo de depuración, no todos los erroresBadRequest
. Esto permite queabort(400)
siga funcionando como se espera. #2735La variable de entorno
FLASK_SKIP_DOTENV
puede establecerse en1
para omitir la carga automática de archivos dotenv. #2722
Versión 1.0¶
Publicado 2018-04-26
Python 2.6 y 3.3 ya no son compatibles.
Aumenta las versiones mínimas de las dependencias a las últimas versiones estables: Werkzeug >= 0.14, Jinja >= 2.10, itsdangerous >= 0.24, Click >= 5.1. #2586
Omite
app.run
cuando se ejecuta una aplicación Flask desde la línea de comandos. Esto evita algunos comportamientos que eran confusos de depurar.Cambia el valor por defecto de
JSONIFY_PRETTYPRINT_REGULAR
aFalse
.jsonify()
devuelve un formato compacto por defecto, y un formato indentado en modo depuración. #2193Flask.__init__
acepta el argumentohost_matching
y lo establece enurl_map
. #1559Flask.__init__
acepta el argumentostatic_host
y lo pasa como argumentohost
al definir la ruta estática. #1559send_file()
soporta Unicode enattachment_filename
. #2223Pasa el argumento
scheme
deurl_for()
ahandle_url_build_error()
. #2017add_url_rule()
acepta el argumentoprovide_automatic_options
para desactivar la adición del métodoOPTIONS
. #1489MethodView
las subclases heredan los manejadores de métodos de las clases base. #1936Los errores causados al abrir la sesión al inicio de la solicitud son manejados por los manejadores de errores de la aplicación. #2254
Los blueprints han adquirido los atributos
json_encoder
yjson_decoder
para anular el codificador y decodificador de la aplicación. #1898Flask.make_response()
lanzaTypeError
en lugar deValueError
para tipos de respuesta incorrectos. Se han mejorado los mensajes de error para describir por qué el tipo no es válido. #2256Añade el comando CLI
routes
para dar salida a las rutas registradas en la aplicación. #2259Mostrar una advertencia cuando el dominio de la cookie de sesión es un nombre de host desnudo o una dirección IP, ya que estos pueden no comportarse correctamente en algunos navegadores, como Chrome. #2282
Permitir la dirección IP como dominio exacto de la cookie de sesión. #2282
SESSION_COOKIE_DOMAIN
se establece si se detecta a través deSERVER_NAME
. #2282Detecta automáticamente la fábrica de aplicaciones sin argumentos llamada
create_app
omake_app
deFLASK_APP
. #2297Las funciones de fábrica no necesitan tomar un parámetro
script_info
para trabajar con el comandoflask
. Si toman un solo parámetro o un parámetro llamadoscript_info
, se pasará el objetoScriptInfo`
. #2319FLASK_APP
puede establecerse en una fábrica de aplicaciones, con argumentos si es necesario, por ejemploFLASK_APP=myproject.app:create_app('dev')
. #2326FLASK_APP
puede apuntar a paquetes locales que no están instalados en modo editable, aunque sigue siendo preferiblepip install -e
. #2414El atributo de clase
View
provide_automatic_options
se establece enas_view()
, para ser detectado poradd_url_rule()
. #2316El manejo de errores probará los manejadores registrados para
blueprint, code
,app, code
,blueprint, exception
,app, exception
. #2314Se añade
Cookie
a la cabeceraVary
de la respuesta si se accede a la sesión durante la solicitud (y no se borra). #2288test_request_context()
acepta los argumentossubdomain
yurl_scheme
para utilizarlos al construir la URL base. #1621Establece
APPLICATION_ROOT
como'/'
por defecto. Esto ya era el valor implícito por defecto cuando se estableció enNone
.TRAP_BAD_REQUEST_ERRORS
está activado por defecto en el modo de depuración.BadRequestKeyError
tiene un mensaje con la clave errónea en modo de depuración en lugar del mensaje genérico de solicitud errónea. #2348Permitir el registro de nuevas etiquetas con
TaggedJSONSerializer
para soportar el almacenamiento de otros tipos en la cookie de sesión. #2352Sólo abre la sesión si la solicitud no ha sido empujada a la pila de contexto todavía. Esto permite a los generadores de
stream_with_context()
acceder a la misma sesión que utiliza la vista contenedora. #2354Añade el argumento de la palabra clave
json
para los métodos de solicitud del cliente de prueba. Esto volcará el objeto dado como JSON y establecerá el tipo de contenido apropiado. #2358Extrae el manejo de JSON a un mixin aplicado a las clases
Request
yResponse
. Esto añade los métodosis_json()
yget_json()
a la respuesta para facilitar las pruebas de la respuesta JSON. #2358Eliminado el almacenamiento en caché de los manejadores de error porque provocaba resultados inesperados en algunas jerarquías de herencia de excepciones. Registre los manejadores explícitamente para cada excepción si quiere evitar atravesar el MRO. #2362
Corrige la codificación JSON incorrecta de las fechas conscientes, no UTC. #2374
La recarga automática de plantillas respetará el modo de depuración incluso si ya se ha accedido a
jinja_env
. #2373Eliminado el siguiente código obsoleto. #2385
flask.ext
- importar extensiones directamente por su nombre en lugar de a través del espacio de nombresflask.ext
. Por ejemplo,import flask.ext.sqlalchemy
se convierte enimport flask_sqlalchemy
.Flask.init_jinja_globals
- extiende deFlask.create_jinja_environment()
en su lugar.Flask.error_handlers
- rastreado porFlask.error_handler_spec
, usaFlask.errorhandler()
para registrar manejadores.Flask.request_globals_class
- utilizaFlask.app_ctx_globals_class
en su lugar.Flask.static_path
- utilizaFlask.static_url_path
en su lugar.Request.module
- utilizaRequest.blueprint
en su lugar.
La propiedad
Request.json
ya no está obsoleta. #1421Soporta pasar un
EnvironBuilder
odict
atest_client.open
. #2412El comando
flask
yFlask.run()
cargarán las variables de entorno de los archivos.env
y.flaskenv
si python-dotenv está instalado. #2416Cuando se pasa una URL completa al cliente de prueba, se utiliza el esquema de la URL en lugar de
PREFERRED_URL_SCHEME
. #2430Flask.logger
se ha simplificado. Se ha eliminado la configuración deLOGGER_NAME
yLOGGER_HANDLER_POLICY
. El registrador se llama siempreflask.app
. El nivel sólo se establece en el primer acceso, no compruebaFlask.debug
cada vez. Sólo se utiliza un formato, no diferentes dependiendo deFlask.debug
. No se eliminan manejadores, y sólo se añade un manejador si no hay ninguno configurado. #2436Los nombres de las funciones de la vista Blueprint no pueden contener puntos. #2450
Corregido un
ValueError
causado por peticiones deRange
no válidas en algunos casos. #2526El servidor de desarrollo utiliza hilos por defecto. #2529
La carga de archivos de configuración con
silent=True
ignorará los erroresENOTDIR
. #2581Pasa las opciones
--cert
y--key
aflask run
para ejecutar el servidor de desarrollo sobre HTTPS. #2606Añadido
SESSION_COOKIE_SAMESITE
para controlar el atributoSameSite
en la cookie de sesión. #2607Añadido
test_cli_runner()
para crear un Click runner que pueda invocar los comandos de la CLI de Flask para las pruebas. #2636La coincidencia de subdominios está deshabilitada por defecto y establecer
SERVER_NAME
no la habilita implícitamente. Puede activarse pasandosubdomain_matching=True
al constructor deFlask
. #2635Se elimina una sola barra al final del plano
url_prefix
cuando se registra en la aplicación. #2629Request.get_json()
no almacena en caché el resultado si el análisis sintáctico falla cuandosilent
es verdadero. #2651Request.get_json()
ya no acepta codificaciones arbitrarias. El JSON entrante debe codificarse utilizando UTF-8 según RFC 8259, pero Flask autodetectará UTF-8, -16 o -32. #2691Añadido
MAX_COOKIE_SIZE
yResponse.max_cookie_size
para controlar cuándo Werkzeug avisa de las cookies grandes que los navegadores pueden ignorar. #2693Actualizado el tema de la documentación para que los documentos se vean mejor en ventanas pequeñas. #2709
Ha sido reescrita la documentación del tutorial y el proyecto de ejemplo para adoptar un enfoque más estructurado que ayude a los nuevos usuarios a evitar los errores más comunes. #2676
Versión 0.12.5¶
Lanzamiento 2020-02-10
Fijado Werkzeug a < 1.0.0. #3497
Versión 0.12.4¶
Publicado 2018-04-29
Reempaquetado de la versión 0.12.3 para solucionar un problema de diseño del paquete. #2728
Versión 0.12.3¶
Publicado 2018-04-26
Request.get_json()
ya no acepta codificaciones arbitrarias. El JSON entrante debe codificarse con UTF-8 según RFC 8259, pero Flask detectará automáticamente UTF-8, -16 o -32. #2692Corrige una advertencia de Python sobre las importaciones cuando se utiliza
python -m flask
. #2666Corrige un
ValueError
causado por peticiones deRange
no válidas en algunos casos.
Versión 0.12.2¶
Lanzamiento 2017-05-16
Corrige un error en
safe_join
en Windows.
Versión 0.12.1¶
Lanzamiento 2017-03-31
Evita que
flask run
muestre unaNoAppException
cuando se produce unImportError
dentro del módulo de aplicación importado.Corrige el comportamiento de codificación de
app.config.from_pyfile
para Python 3. #2118Utiliza la configuración
SERVER_NAME
si está presente como valor por defecto paraapp.run
. #2109, #2152Llama a
ctx.auto_pop
con el objeto de excepción en lugar deNone
, en el caso de que unaBaseException
comoKeyboardInterrupt
sea lanzada en un manejador de peticiones.
Versión 0.12¶
Lanzamiento 2016-12-21, codename Punsch
El comando cli ahora responde a
--versión
.Se ha eliminado la adivinación del tipo de letra y la generación de ETag para los objetos tipo archivo en
send_file
. #104, :pr`1849`La conjetura sobre el tipo de archivo en
send_file
ahora falla de forma estrepitosa y no vuelve a pasar aapplication/octet-stream
. #1988Hace que
flask.safe_join
pueda unir múltiples rutas comoos.path.join
#1730Revertir un cambio de comportamiento que hacía que el servidor de desarrollo se bloqueara en lugar de devolver un Error Interno del Servidor. #2006
Invocar correctamente los manejadores de respuesta tanto para el despacho de solicitudes regulares como para los manejadores de errores.
Desactiva la propagación del logger por defecto para el logger de la app.
Añade soporte para peticiones de rango en
send_file
.app.test_client
incluye un entorno predeterminado, que ahora se puede establecer directamente, en lugar de porclient.get
.Corrige el fallo cuando se ejecuta bajo PyPy3. #1814
Versión 0.11.1¶
Lanzamiento 2016-06-07
Se ha corregido un error que impedía el funcionamiento de
FLASK_APP=foobar/__init__.py
. #1872
Versión 0.11¶
Lanzamiento 2016-05-29, codename Absinthe
Se ha añadido soporte para serializar arrays de nivel superior a
flask.jsonify()
. Esto introduce un riesgo de seguridad en los navegadores antiguos.Añadida la señal before_render_template.
Se ha añadido
**kwargs
aflask.Test.test_client()
para soportar el paso de argumentos de palabras clave adicionales al constructor deflask.Flask.test_client_class
.Se ha añadido la clave de configuración
SESSION_REFRESH_EACH_REQUEST
que controla el comportamiento de las cookies. Si se establece enTrue
una sesión permanente se refrescará cada vez que se solicite y se extenderá su vida útil, si se establece enFalse
sólo se modificará si la sesión se modifica realmente. Las sesiones no permanentes no se ven afectadas por esto y siempre expirarán si la ventana del navegador se cierra.Flask soportará mimetypes JSON personalizados para los datos entrantes.
Se ha añadido soporte para devolver tuplas de la forma
(response, headers)
desde una función de vista.Se ha añadido
flask.Config.from_json()
.Se ha añadido
flask.Flask.config_class
.Se ha añadido
flask.Config.get_namespace()
.Las plantillas ya no se recargan automáticamente fuera del modo de depuración. Esto se puede configurar con la nueva clave de configuración
TEMPLATES_AUTO_RELOAD
.Se ha añadido una solución a una limitación del cargador de espacios de nombres de Python 3.3.
Se ha añadido soporte para rutas raíz explícitas cuando se utilizan los paquetes de espacio de nombres de Python 3.3.
Se ha añadido flask y el módulo
flask.cli
para iniciar el servidor de depuración local a través del sistema CLI de click. Esto se recomienda sobre el antiguo métodoflask.run()
ya que funciona más rápido y más fiable debido a un diseño diferente y también sustituye aFlask-Script
.Los manejadores de error que coinciden con clases específicas ahora se comprueban primero, permitiendo así atrapar excepciones que son subclases de excepciones HTTP (en
werkzeug.exceptions
). Esto hace posible que el autor de una extensión cree excepciones que, por defecto, darán lugar al error HTTP que elija, pero que pueden ser capturadas con un manejador de errores personalizado si así lo desea.Se ha añadido
flask.Config.from_mapping()
.Flask ahora registrará por defecto incluso si la depuración está desactivada. El formato de registro está ahora codificado, pero el manejo del registro por defecto puede ser desactivado a través de la clave de configuración
LOGGER_HANDLER_POLICY
.Se ha eliminado la funcionalidad del módulo obsoleto.
Se ha añadido la bandera de configuración
EXPLAIN_TEMPLATE_LOADING
que, cuando se activa, indica a Flask que explique cómo localiza las plantillas. Esto debería ayudar a los usuarios a depurar cuando se cargan las plantillas equivocadas.Aplicar el manejo de los planos en el orden en que fueron registrados para la carga de la plantilla.
Porteada la suite de tests a py.test.
Se ha eliminado
request.json
en favor derequest.get_json()
.Añade definiciones de separadores «bonitos» y «comprimidos» en el método jsonify(). Reduce el tamaño de la respuesta JSON cuando
JSONIFY_PRETTYPRINT_REGULAR=False
eliminando los espacios en blanco innecesarios incluidos por defecto después de los separadores.Las respuestas JSON ahora terminan con un carácter de nueva línea, porque es una convención que los archivos de texto UNIX terminen con una nueva línea y algunos clientes no se comportan bien cuando falta esta nueva línea. Esto surgió originalmente como parte de https://github.com/postmanlabs/httpbin/issues/168. #1262
El método
OPTIONS
proporcionado automáticamente está ahora correctamente desactivado si el usuario registró una regla de anulación con la versión minúsculaoptions
. #1288flask.json.jsonify
ahora soporta el tipodatetime.date
. #1326No se filtra la información de las excepciones ya capturadas a los manejadores de desmontaje de contexto. #1393
Permitir subclases de entorno Jinja personalizadas. #1422
Actualización de las directrices de desarrollo de la extensión.
flask.g
tiene ahora los métodospop()
ysetdefault
.Activa el autoescape para
flask.templating.render_template_string
por defecto. #1515flask.ext
está ahora obsoleto. #1484send_from_directory
ahora lanza BadRequest si el nombre del archivo no es válido en el SO del servidor. #1763Añadida la variable de configuración
JSONIFY_MIMETYPE
. #1728Las excepciones durante el manejo del desmontaje ya no dejarán que los contextos de aplicación malos se queden por ahí.
Corregido el caso de prueba roto
test_appcontext_signals()
.Lanza un
AttributeError
enflask.helpers.find_package()
con un mensaje útil que explica por qué se lanza cuando se utiliza un hook de importación PEP 302 sin un métodois_package()
.Se ha corregido un problema que provocaba que las excepciones que se producían antes de entrar en un contexto de solicitud o de aplicación se pasaran a los gestores de desmontaje.
Se ha corregido un problema por el que los parámetros de consulta se eliminaban de las solicitudes en el cliente de prueba cuando se solicitaban URLs absolutas.
Convirtió a
@before_first_request
en un decorador como se pretendía.Se ha corregido un error de etiquetado al enviar un flujo de archivos con un nombre.
Se ha corregido que
send_from_directory
no se expande a la ruta raíz de la aplicación correctamente.Se ha cambiado la lógica de los manejadores de la primera solicitud para que se voltee la bandera después de la invocación. Esto permitirá algunos usos que son potencialmente peligrosos pero que probablemente deberían permitirse.
Se ha corregido el error de Python 3 cuando un manejador de
app.url_build_error_handlers
devuelve elBuildError
.
Versión 0.10.1¶
Lanzamiento 2013-06-14
Se ha corregido un problema por el que
|tojson
no se citaba entre comillas simples, lo que hacía que el filtro no funcionara correctamente en los atributos HTML. Ahora es posible usar ese filtro en atributos con comillas simples. Esto debería facilitar el uso de ese filtro con angular.js.Se ha añadido soporte para cadenas de bytes al sistema de sesiones. Esto rompió la compatibilidad con el caso común de personas que ponen datos binarios para la verificación de tokens en la sesión.
Se ha solucionado un problema por el que el registro del mismo método dos veces para el mismo punto final provocaba una excepción de forma incorrecta.
Versión 0.10¶
Lanzamiento 2013-06-13, codename Limoncello
Se ha cambiado el formato de serialización de cookies por defecto de pickle a JSON para limitar el impacto que un atacante puede hacer si se filtra la clave secreta.
Se han añadido métodos
template_test
además de la familia de métodostemplate_filter
ya existente.Se han añadido métodos
template_global
además de la familia de métodostemplate_filter
ya existente.Establece la cabecera content-length para x-sendfile.
El filtro
tojson
ahora no escapa a los bloques de script en los analizadores de HTML5.tojson
utilizado en las plantillas es ahora seguro por defecto. Esto se permitía debido al diferente comportamiento de escape.Flask ahora lanzará un error si se intenta registrar una nueva función en un punto final ya utilizado.
Se ha añadido un módulo de envoltura alrededor de simplejson y se ha añadido la serialización por defecto de los objetos datetime. Esto permite una personalización mucho más fácil de cómo JSON es manejado por Flask o cualquier extensión de Flask.
Se ha eliminado el alias del módulo interno
flask.session
. Utilizaflask.sessions
en su lugar para obtener el módulo de sesión. Esto no debe confundirse conflask.session
el proxy de sesión.Las plantillas ahora pueden ser renderizadas sin contexto de petición. El comportamiento es ligeramente diferente ya que los objetos
request
,session
yg
no estarán disponibles y los procesadores de contexto del blueprint no son llamados.El objeto config está ahora disponible para la plantilla como un global real y no a través de un procesador de contexto que lo hace disponible incluso en las plantillas importadas por defecto.
Se ha añadido una opción para generar JSON no codificado en ascii, lo que debería dar lugar a que se transmitan menos bytes por la red. Está desactivada por defecto para no causar confusión con las bibliotecas existentes que podrían esperar que
flask.json.dumps
devolviera bytes por defecto.flask.g
se almacena ahora en el contexto de la aplicación en lugar del contexto de la solicitud.flask.g
ahora tiene un métodoget()
para que no se produzcan errores en elementos no existentes.flask.g
ahora se puede utilizar con el operadorin
para ver lo que está definido y ahora es iterable y dará todos los atributos almacenados.flask.Flask.request_globals_class
fue renombrado aflask.Flask.app_ctx_globals_class
que es un nombre mejor para lo que hace desde 0.10.request
,session
yg
ahora también se añaden como proxies al contexto de la plantilla, lo que hace que estén disponibles en las plantillas importadas. Sin embargo, hay que tener mucho cuidado con ellos, ya que su uso fuera de las macros puede provocar el almacenamiento en caché.Flask ya no invocará los manejadores de error equivocados si se pasa una excepción de proxy.
Se ha añadido una solución para que las cookies de Chrome en localhost no funcionen como es debido con los nombres de dominio.
Se ha cambiado la lógica para elegir los valores predeterminados de las cookies de las sesiones para que funcionen mejor con Google Chrome.
Se ha añadido la señal
message_flashed
que simplifica las pruebas de flasheo.Se ha añadido soporte para la copia de contextos de solicitud para trabajar mejor con los greenlets.
Eliminadas las subclases de excepción JSON HTTP personalizadas. Si dependías de ellas, puedes reintroducirlas tú mismo de forma trivial. Sin embargo, se desaconseja encarecidamente su uso, ya que la interfaz era defectuosa.
Los requisitos de Python han cambiado: ahora se requiere Python 2.6 o 2.7 para preparar el puerto de Python 3.3.
Se ha cambiado la forma en que se informa al sistema de desmontaje sobre las excepciones. Esto es ahora más fiable en caso de que algo maneje una excepción a mitad del proceso de manejo de errores.
La preservación del contexto de la solicitud en el modo de depuración ahora mantiene la información de la excepción, lo que significa que los manipuladores de desmontaje son capaces de distinguir los casos de error de los de éxito.
Añadida la variable de configuración
JSONIFY_PRETTYPRINT_REGULAR
.Flask ahora ordena las claves JSON por defecto para no destrozar las cachés HTTP debido a diferentes semillas hash entre diferentes workers.
Añadidas las señales
appcontext_pushed
yappcontext_popped
.El método de ejecución incorporado ahora tiene en cuenta el
SERVER_NAME
al elegir el puerto por defecto para ejecutar.Se ha añadido
flask.request.get_json()
en sustitución de la antigua propiedadflask.request.json
.
Versión 0.9¶
Lanzamiento 2012-07-01, codename Campari
La función
flask.Request.on_json_loading_failed()
ahora devuelve una respuesta con formato JSON por defecto.La función
flask.url_for()
ahora puede generar anclas a los enlaces generados.La función
flask.url_for()
ahora también puede generar explícitamente reglas de URL específicas para un método HTTP determinado.El registrador ahora sólo devuelve la configuración del registro de depuración si no se estableció explícitamente.
Desregistra una dependencia circular entre el entorno WSGI y el objeto request al cerrar la petición. Esto significa que el entorno
werkzeug.request
seráNone
después de que la respuesta haya sido devuelta al servidor WSGI pero tiene la ventaja de que el recolector de basura no es necesario en CPython para derribar la petición a menos que el usuario haya creado dependencias circulares por sí mismo.La sesión se almacena ahora después de las devoluciones de llamada, de modo que si la carga útil de la sesión se almacena en la sesión, todavía se puede modificar en una devolución de llamada posterior a la solicitud.
La clase
flask.Flask
evitará importar el nombre de importación proporcionado si puede (el primer parámetro requerido), para beneficiar a las herramientas que construyen instancias de Flask programáticamente. La clase Flask volverá a utilizar la importación en sistemas con ganchos de módulo personalizados, por ejemplo, Google App Engine, o cuando el nombre de importación esté dentro de un archivo zip (normalmente un .egg) anterior a Python 2.7.Los Blueprints tienen ahora un decorador para añadir filtros de plantilla personalizados en toda la aplicación,
flask.Blueprint.app_template_filter()
.Las clases Flask y Blueprint tienen ahora un método no decorador para añadir filtros de plantilla personalizados en toda la aplicación,
flask.Flask.add_template_filter()
yflask.Blueprint.add_app_template_filter()
.La función
flask.get_flashed_messages()
permite ahora mostrar las categorías de mensajes flash en bloques separados, mediante un argumentocategory_filter
.El método
flask.Flask.run()
ahora aceptaNone
para los argumentoshost
yport
, utilizando los valores por defecto cuandoNone
. Esto permite llamar a la ejecución utilizando valores de configuración, por ejemploapp.run(app.config.get('MYHOST'), app.config.get('MYPORT'))
, con un comportamiento adecuado tanto si se proporciona un fichero de configuración como si no.El método
flask.render_template()
acepta ahora una iterable de nombres de plantillas o un único nombre de plantilla. Anteriormente, sólo aceptaba un único nombre de plantilla. En un iterable, se renderiza la primera plantilla encontrada.Se ha añadido
flask.Flask.app_context()
que funciona de forma muy similar al contexto de petición pero sólo proporciona acceso a la aplicación actual. Esto también añade soporte para la generación de URL sin un contexto de solicitud activo.Las funciones de vista ahora pueden devolver una tupla con la primera instancia siendo una instancia de
flask.Response
. Esto permite devolverjsonify(error="error msg"), 400
desde una función de vista.Flask
yBlueprint
proporcionan ahora un ganchoget_send_file_max_age()
para que las subclases puedan anular el comportamiento de servir archivos estáticos desde Flask cuando se utilizaflask.Flask.send_static_file()
(utilizado para el manejador de archivos estáticos por defecto) ysend_file()
. A este gancho se le proporciona un nombre de archivo, que por ejemplo permite cambiar los controles de la caché por la extensión del archivo. La edad máxima por defecto parasend_file
y archivos estáticos puede configurarse a través de una nueva variable de configuraciónSEND_FILE_MAX_AGE_DEFAULT
, que se utiliza en la implementación por defecto deget_send_file_max_age
.Se ha corregido una suposición en la implementación de las sesiones que podía romper el parpadeo de los mensajes en las implementaciones de las sesiones que utilizan el almacenamiento externo.
Se ha cambiado el comportamiento de los valores de retorno de las funciones. Ya no son argumentos del objeto de respuesta, ahora tienen un significado definido.
Se ha añadido
flask.Flask.request_globals_class
para permitir que se utilice una clase específica en la creación de la instanciag
de cada solicitud.Se ha añadido el atributo
required_methods
a las funciones de vista para forzar la adición de métodos al registrarse.Añadido
flask.after_this_request()
.Se ha añadido
flask.stream_with_context()
y la capacidad de empujar contextos múltiples veces sin producir un comportamiento inesperado.
Versión 0.8.1¶
Lanzamiento 2012-07-01
Se ha corregido un problema con el módulo no documentado
flask.session
para que no funcione correctamente en Python 2.5. No debería usarse, pero causaba algunos problemas a los gestores de paquetes.
Versión 0.8¶
Lanzamiento 2011-09-29, codename Rakija
Refactorizado el soporte de sesiones en una interfaz de sesión para que la implementación de las sesiones pueda ser cambiada sin tener que sobreescribir la clase Flask.
Las cookies de sesión vacías ahora se eliminan correctamente de forma automática.
Las funciones de visualización ahora pueden optar por no recibir la implementación automática de OPTIONS.
Las excepciones HTTP y los errores de solicitud incorrecta ahora pueden ser atrapados para que se muestren normalmente en el rastreo.
Flask en modo de depuración ahora detecta algunos problemas comunes y trata de advertirte sobre ellos.
Flask en modo de depuración ahora se quejará con un error de aserción si una vista fue adjuntada después de que la primera solicitud fue manejada. Esto da una respuesta más temprana cuando los usuarios se olvidan de importar el código de la vista antes de tiempo.
Se ha añadido la posibilidad de registrar callbacks que sólo se activan una vez al principio de la primera petición. (
before_first_request
)Los datos JSON mal formados provocarán ahora una excepción HTTP de solicitud incorrecta en lugar de un error de valor que normalmente daría lugar a un error 500 interno del servidor si no se gestiona. Este es un cambio incompatible con el pasado.
Las aplicaciones ahora no sólo tienen una ruta raíz donde se encuentran los recursos y los módulos, sino también una ruta de instancia que es el lugar designado para dejar los archivos que se modifican en tiempo de ejecución (cargas, etc.). Además, esto es conceptualmente sólo dependiendo de la instancia y fuera del control de versiones, por lo que es el lugar perfecto para poner los archivos de configuración, etc.
Se ha añadido la variable de configuración
APPLICATION_ROOT
.Implementado
session_transaction()
para modificar fácilmente las sesiones desde el entorno de pruebas.Refactorizado el cliente de prueba internamente. La variable de configuración
APPLICATION_ROOT
así comoSERVER_NAME
son ahora utilizadas correctamente por el cliente de prueba como valores por defecto.Añadido
flask.views.View.decorators
para soportar una decoración más sencilla de las vistas enchufables (basadas en clases).Se ha solucionado un problema por el que el cliente de prueba, si se utiliza con la sentencia «with», no desencadena la ejecución de los manejadores de desmontaje.
Se ha añadido un control más fino sobre los parámetros de las cookies de sesión.
Las peticiones HEAD a una vista de método ahora se envían automáticamente al método
get
si no se ha implementado ningún manejador.Implementado el paquete virtual
flask.ext
para importar extensiones.La preservación del contexto en las excepciones es ahora un componente integral de Flask y no del cliente de prueba. Esto ha limpiado parte de la lógica interna y disminuye las probabilidades de que los contextos de solicitud se desborden en las pruebas unitarias.
Corregido el método
list_templates
del entorno Jinja2 que no devolvía los nombres correctos cuando se trataba de blueprints o módulos.
Versión 0.7.2¶
Lanzamiento 2011-07-06
Se ha solucionado un problema con los procesadores de URL que no funcionaban correctamente en los planos.
Versión 0.7.1¶
Lanzamiento 2011-06-29
Se ha añadido la importación future que faltaba y que rompía la compatibilidad con 2.5.
Se ha corregido un problema de redirección infinita con los blueprints.
Versión 0.7¶
Lanzamiento 2011-06-28, codename Grappa
Añadido
make_default_options_response()
que puede ser utilizado por subclases para alterar el comportamiento por defecto de las respuestasOPTIONS
.Los locales no vinculados ahora lanzan un
RuntimeError
apropiado en lugar de unAttributeError
.La suposición del mimetype y el soporte de etags basado en objetos de archivo está ahora obsoleto para
flask.send_file()
porque no era fiable. En su lugar, pasa los nombres de los archivos o adjunta tus propios etags y proporciona un mimetype adecuado a mano.El manejo de archivos estáticos para los módulos ahora requiere que el nombre de la carpeta static sea suministrado explícitamente. La autodetección anterior no era fiable y causaba problemas en el App Engine de Google. Hasta la versión 1.0, el comportamiento anterior seguirá funcionando pero emitirá advertencias de dependencia.
Se ha corregido un problema para que Flask se ejecute en jython.
Se ha añadido una variable de configuración
PROPAGATE_EXCEPTIONS
que puede utilizarse para cambiar la configuración de la propagación de excepciones, que antes estaba vinculada únicamente aDEBUG
y ahora está vinculada aDEBUG
o aTESTING
.Flask ya no depende internamente de las reglas que se añaden a través de la función
add_url_rule
y ahora también puede aceptar reglas regulares de werkzeug añadidas al mapa de url.Se ha añadido un método
endpoint
al objeto de aplicación flask que permite registrar una devolución de llamada a un endpoint arbitrario con un decorador.Se utiliza Last-Modified para el envío de archivos estáticos en lugar de Date que fue introducido incorrectamente en 0.6.
Se ha añadido
create_jinja_loader
para anular el proceso de creación del cargador.Se ha implementado una señal silenciosa para
config.from_pyfile
.Se ha añadido el decorador
teardown_request
, para las funciones que deben ejecutarse al final de una petición, independientemente de si se ha producido una excepción. También se ha cambiado el comportamiento deafter_request
. Ahora ya no se ejecuta cuando se produce una excepción.Implementado
flask.has_request_context()
Se ha obviado
init_jinja_globals
. Anule el métodocreate_jinja_environment()
para conseguir la misma funcionalidad.Añadido
flask.safe_join()
El desempaquetado automático de los datos de la solicitud JSON ahora busca el parámetro charset mimetype.
No se modifica la sesión en
flask.get_flashed_messages()
si no hay mensajes en la sesión.Los manejadores
before_request
son ahora capaces de abortar las solicitudes con errores.No es posible definir manejadores de excepción de usuario. De este modo, puede proporcionar mensajes de error personalizados desde un centro para determinados errores que pueden producirse durante el procesamiento de las solicitudes (por ejemplo, errores de conexión a la base de datos, tiempos de espera de los recursos remotos, etc.).
Los blueprints pueden proporcionar manejadores de error específicos para cada blueprint.
Implementación de vistas genéricas basadas en clases.
Versión 0.6.1¶
Lanzamiento 2010-12-31
Se ha solucionado un problema por el que la respuesta por defecto
OPTIONS
no exponía todos los métodos válidos en la cabeceraAllow
.La sintaxis de carga de plantillas de Jinja2 ahora permite «./» delante de una ruta de carga de plantillas. Anteriormente esto causaba problemas con las configuraciones de los módulos.
Se ha solucionado un problema por el que se ignoraba la configuración del subdominio para los módulos en la carpeta static.
Se ha corregido un problema de seguridad que permitía a los clientes descargar archivos arbitrarios si el servidor anfitrión era un sistema operativo basado en Windows y el cliente utilizaba barras invertidas para escapar del directorio desde el que se exponían los archivos.
Versión 0.6¶
Lanzamiento 2010-07-27, codename Whisky
Las funciones posteriores a la solicitud se llaman ahora en orden inverso al registro.
OPTIONS es ahora implementado automáticamente por Flask a menos que la aplicación añada explícitamente “OPTIONS” como método a la regla de la URL. En este caso, no se aplica la gestión automática de OPTIONS.
Las reglas estáticas están ahora incluso en su lugar si no hay una carpeta estática para el módulo. Esto se implementó para ayudar a GAE que eliminará la carpeta estática si es parte de un mapeo en el archivo .yml.
El
config
está ahora disponible en las plantillas comoconfig
.Los procesadores de contexto ya no anularán los valores pasados directamente a la función de renderización.
Añadida la posibilidad de limitar los datos de la solicitud entrante con el nuevo valor de configuración
MAX_CONTENT_LENGTH
.El punto final del método
flask.Module.add_url_rule()
es ahora opcional para ser coherente con la función del mismo nombre en el objeto de aplicación.Añadida una función
flask.make_response()
que simplifica la creación de instancias de objetos de respuesta en las vistas.Añadido soporte de señalización basado en el blinker. Esta característica es actualmente opcional y se supone que debe ser utilizada por las extensiones y aplicaciones. Si quieres usarlo, asegúrate de tener blinker instalado.
Refactorizada la forma en que se crean los adaptadores de URL. Este proceso es ahora totalmente personalizable con el método
create_url_adapter()
.Ahora los módulos pueden registrarse para un subdominio en lugar de sólo un prefijo de URL. Esto permite vincular un módulo completo a un subdominio configurable.
Versión 0.5.2¶
Lanzamiento 2010-07-15
Solucionado otro problema con la carga de plantillas desde los directorios cuando se utilizan módulos.
Versión 0.5.1¶
Lanzamiento 2010-07-06
Se corrige un problema con la carga de plantillas desde los directorios cuando se utilizan módulos.
Versión 0.5¶
Lanzamiento 2010-07-06, codename Calvados
Corregido un error con los subdominios que era causado por la imposibilidad de especificar el nombre del servidor. Ahora el nombre del servidor se puede establecer con la clave de configuración
SERVER_NAME
. Esta clave también se utiliza ahora para establecer la cookie de sesión en todos los subdominios.El autoescapado ya no está activo para todas las plantillas. En su lugar, sólo está activo para
.html
,.htm
,.xml
y.xhtml
. Dentro de las plantillas este comportamiento se puede cambiar con la etiquetaautoescape
.Refactorizado Flask internamente. Ahora consta de más de un archivo.
flask.send_file()
ahora emite etags y tiene la capacidad de hacer respuestas condicionales incorporadas.Suprimida (temporalmente) la compatibilidad con las aplicaciones comprimidas. Se trataba de una función poco utilizada y daba lugar a comportamientos confusos.
Añadido soporte para plantillas por paquete y directorios de archivos estáticos.
Eliminada la compatibilidad con
create_jinja_loader
, que ya no se utiliza en la versión 0.5 debido a la mejora del soporte de los módulos.Añadida una función de ayuda para exponer archivos de cualquier directorio.
Versión 0.4¶
Lanzamiento 2010-06-18, codename Rakia
Añadida la posibilidad de registrar los gestores de errores de toda la aplicación desde los módulos.
after_request()
ahora también se invoca si la solicitud muere con una excepción y se inicia una página de gestión de errores.El cliente de pruebas no tiene la capacidad de preservar el contexto de la solicitud por un poco más de tiempo. Esto también se puede utilizar para desencadenar las solicitudes personalizadas que no saltan la pila de solicitudes para las pruebas.
Debido a que la biblioteca estándar de Python almacena en caché los registradores, el nombre del registrador es ahora configurable para soportar mejor los unittests.
Añadido el interruptor
TESTING
que puede activar los ayudantes de unitesting.El registrador cambia al modo
DEBUG
si la depuración está activada.
Versión 0.3.1¶
Lanzamiento 2010-05-28
Corregido un error de información con
flask.Config.from_envvar()
Se ha eliminado parte del código no utilizado de flask
La versión ya no incluye los archivos sobrantes de desarrollo (carpeta .git para los temas, documentación construida en zip y archivo pdf y algunos archivos .pyc)
Versión 0.3¶
Lanzamiento 2010-05-28, codename Schnaps
Añadido soporte para las categorías de los mensajes flash.
La aplicación ahora configura un
logging.Handler
y registrará las excepciones de manejo de solicitudes en ese logger cuando no esté en modo de depuración. Esto hace posible recibir correos sobre errores del servidor, por ejemplo.Añadido soporte para la vinculación contextual que no requiere el uso de la sentencia with para jugar en la consola.
El contexto de la solicitud está ahora disponible dentro de la sentencia with, lo que hace posible empujar el contexto de la solicitud o hacerlo desaparecer.
Añadido soporte para las configuraciones.
Versión 0.2¶
Lanzamiento 2010-05-12, codename J?germeister
Varias correcciones de errores
Soporte JSON integrado
Añadida la función de ayuda
get_template_attribute()
.add_url_rule()
ahora también puede registrar una función de vista.Refactorización del envío de solicitudes internas.
El servidor escucha en 127.0.0.1 por defecto para solucionar problemas con Chrome.
Añadido soporte de URLs externas.
Añadido soporte para
send_file()
Soporte de módulos y refactorización del manejo de solicitudes internas para soportar mejor las aplicaciones conectables.
Ahora se puede establecer que las sesiones sean permanentes en función de cada una de ellas.
Mejora de los informes de error sobre la falta de claves secretas.
Añadido soporte para Google Appengine.
Versión 0.1¶
Lanzamiento 2010-04-16
Primer lanzamiento público.